@mtcute/core 0.5.0 → 0.7.0

package/esm/highlevel/methods/messages/send-copy.js

@@ -0,0 +1,53 @@
+import { MtArgumentError } from '../../../types/errors.js';
+import { getMarkedPeerId } from '../../../utils/peer-utils.js';
+import { MtMessageNotFoundError } from '../../types/index.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { getMessages } from './get-messages.js';
+import { sendMedia } from './send-media.js';
+import { sendText } from './send-text.js';
+/**
+ * Copy a message (i.e. send the same message, but do not forward it).
+ *
+ * Note that if the message contains a webpage,
+ * it will be copied simply as a text message,
+ * and if the message contains an invoice,
+ * it can't be copied.
+ */
+export async function sendCopy(client, params) {
+    const { toChatId, ...rest } = params;
+    let msg;
+    if ('fromChatId' in params) {
+        const fromPeer = await resolvePeer(client, params.fromChatId);
+        [msg] = await getMessages(client, fromPeer, params.message);
+        if (!msg) {
+            throw new MtMessageNotFoundError(getMarkedPeerId(fromPeer), params.message, 'to copy');
+        }
+    }
+    else {
+        msg = params.message;
+    }
+    if (msg.raw._ === 'messageService') {
+        throw new MtArgumentError("Service messages can't be copied");
+    }
+    if (msg.media && msg.media.type !== 'webpage' && msg.media.type !== 'invoice') {
+        let caption = params.caption;
+        if (!caption) {
+            if (msg.raw.entities?.length) {
+                caption = {
+                    text: msg.raw.message,
+                    entities: msg.raw.entities,
+                };
+            }
+            else {
+                caption = msg.raw.message;
+            }
+        }
+        return sendMedia(client, toChatId, {
+            type: 'auto',
+            file: msg.media.inputMedia,
+            caption,
+        }, rest);
+    }
+    return sendText(client, toChatId, msg.raw.message, rest);
+}
+//# sourceMappingURL=send-copy.js.map

package/esm/highlevel/methods/messages/send-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-copy.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,EAAqC,sBAAsB,EAAe,MAAM,sBAAsB,CAAA;AAC7G,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAmBzC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,MAAuB,EACvB,MASK;IAEL,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;IAEpC,IAAI,GAAG,CAAA;IAEP,IAAI,YAAY,IAAI,MAAM,EAAE;QACxB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAE5D;QAAA,CAAC,GAAG,CAAC,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QAE5D,IAAI,CAAC,GAAG,EAAE;YACN,MAAM,IAAI,sBAAsB,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;SACzF;KACJ;SAAM;QACH,GAAG,GAAG,MAAM,CAAC,OAAO,CAAA;KACvB;IAED,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,gBAAgB,EAAE;QAChC,MAAM,IAAI,eAAe,CAAC,kCAAkC,CAAC,CAAA;KAChE;IAED,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE;QAC3E,IAAI,OAAO,GAA0B,MAAM,CAAC,OAAO,CAAA;QAEnD,IAAI,CAAC,OAAO,EAAE;YACV,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE;gBAC1B,OAAO,GAAG;oBACN,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO;oBACrB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ;iBAC7B,CAAA;aACJ;iBAAM;gBACH,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAA;aAC5B;SACJ;QAED,OAAO,SAAS,CACZ,MAAM,EACN,QAAQ,EACR;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU;YAC1B,OAAO;SACV,EACD,IAAI,CACP,CAAA;KACJ;IAED,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AAC5D,CAAC","sourcesContent":["import { MtArgumentError } from '../../../types/errors.js'\nimport { getMarkedPeerId } from '../../../utils/peer-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, InputText, Message, MtMessageNotFoundError, ReplyMarkup } from '../../types/index.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { getMessages } from './get-messages.js'\nimport { CommonSendParams } from './send-common.js'\nimport { sendMedia } from './send-media.js'\nimport { sendText } from './send-text.js'\n\n// @exported\nexport interface SendCopyParams extends CommonSendParams {\n    /** Target chat ID */\n    toChatId: InputPeerLike\n\n    /**\n     * New message caption (only used for media)\n     */\n    caption?: InputText\n\n    /**\n     * For bots: inline or reply markup or an instruction\n     * to hide a reply keyboard or to force a reply.\n     */\n    replyMarkup?: ReplyMarkup\n}\n\n/**\n * Copy a message (i.e. send the same message, but do not forward it).\n *\n * Note that if the message contains a webpage,\n * it will be copied simply as a text message,\n * and if the message contains an invoice,\n * it can't be copied.\n */\nexport async function sendCopy(\n    client: ITelegramClient,\n    params: SendCopyParams &\n        (\n            | {\n                  /** Source chat ID */\n                  fromChatId: InputPeerLike\n                  /** Message ID to forward */\n                  message: number\n              }\n            | { message: Message }\n        ),\n): Promise<Message> {\n    const { toChatId, ...rest } = params\n\n    let msg\n\n    if ('fromChatId' in params) {\n        const fromPeer = await resolvePeer(client, params.fromChatId)\n\n        ;[msg] = await getMessages(client, fromPeer, params.message)\n\n        if (!msg) {\n            throw new MtMessageNotFoundError(getMarkedPeerId(fromPeer), params.message, 'to copy')\n        }\n    } else {\n        msg = params.message\n    }\n\n    if (msg.raw._ === 'messageService') {\n        throw new MtArgumentError(\"Service messages can't be copied\")\n    }\n\n    if (msg.media && msg.media.type !== 'webpage' && msg.media.type !== 'invoice') {\n        let caption: InputText | undefined = params.caption\n\n        if (!caption) {\n            if (msg.raw.entities?.length) {\n                caption = {\n                    text: msg.raw.message,\n                    entities: msg.raw.entities,\n                }\n            } else {\n                caption = msg.raw.message\n            }\n        }\n\n        return sendMedia(\n            client,\n            toChatId,\n            {\n                type: 'auto',\n                file: msg.media.inputMedia,\n                caption,\n            },\n            rest,\n        )\n    }\n\n    return sendText(client, toChatId, msg.raw.message, rest)\n}\n"]}

package/esm/highlevel/methods/messages/send-media-group.d.ts

@@ -0,0 +1,35 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputMediaLike } from '../../types/media/input-media.js';
+import { Message } from '../../types/messages/message.js';
+import { InputPeerLike } from '../../types/peers/index.js';
+import { CommonSendParams } from './send-common.js';
+/**
+ * Send a group of media.
+ *
+ * To add a caption to the group, add caption to the first
+ * media in the group and don't add caption for any other.
+ *
+ * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+ * @param medias  Medias contained in the message.
+ * @param params  Additional sending parameters
+ * @link InputMedia
+ */
+export declare function sendMediaGroup(client: ITelegramClient, chatId: InputPeerLike, medias: (InputMediaLike | string)[], params?: CommonSendParams & {
+    /**
+     * Whether to invert media position.
+     *
+     * Currently only supported for web previews and makes the
+     * client render the preview above the caption and not below.
+     */
+    invertMedia?: boolean;
+    /**
+     * Function that will be called after some part has been uploaded.
+     * Only used when a file that requires uploading is passed,
+     * and not used when uploading a thumbnail.
+     *
+     * @param index  Index of the media in the original array
+     * @param uploaded  Number of bytes already uploaded
+     * @param total  Total file size
+     */
+    progressCallback?: (index: number, uploaded: number, total: number) => void;
+}): Promise<Message[]>;

package/esm/highlevel/methods/messages/send-media-group.js

@@ -0,0 +1,72 @@
+import { randomLong } from '../../../utils/long-utils.js';
+import { Message } from '../../types/messages/message.js';
+import { PeersIndex } from '../../types/peers/index.js';
+import { assertIsUpdatesGroup } from '../../updates/utils.js';
+import { _normalizeInputMedia } from '../files/normalize-input-media.js';
+import { _normalizeInputText } from '../misc/normalize-text.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { _processCommonSendParameters } from './send-common.js';
+/**
+ * Send a group of media.
+ *
+ * To add a caption to the group, add caption to the first
+ * media in the group and don't add caption for any other.
+ *
+ * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+ * @param medias  Medias contained in the message.
+ * @param params  Additional sending parameters
+ * @link InputMedia
+ */
+export async function sendMediaGroup(client, chatId, medias, params) {
+    if (!params)
+        params = {};
+    const { peer, replyTo, scheduleDate, chainId } = await _processCommonSendParameters(client, chatId, params);
+    const multiMedia = [];
+    for (let i = 0; i < medias.length; i++) {
+        let media = medias[i];
+        if (typeof media === 'string') {
+            media = {
+                type: 'auto',
+                file: media,
+            };
+        }
+        const inputMedia = await _normalizeInputMedia(client, media, {
+            progressCallback: params.progressCallback?.bind(null, i),
+            // i have no fucking clue why we should upload it manually,
+            // but otherwise Telegram throws MEDIA_INVALID
+            // fuck my life
+            uploadPeer: peer,
+        }, true);
+        const [message, entities] = await _normalizeInputText(client, 
+        // some types dont have `caption` field, and ts warns us,
+        // but since it's JS, they'll just be `undefined` and properly handled by the method
+        media.caption);
+        multiMedia.push({
+            _: 'inputSingleMedia',
+            randomId: randomLong(),
+            media: inputMedia,
+            message,
+            entities,
+        });
+    }
+    const res = await client.call({
+        _: 'messages.sendMultiMedia',
+        peer,
+        multiMedia,
+        silent: params.silent,
+        replyTo,
+        scheduleDate,
+        clearDraft: params.clearDraft,
+        noforwards: params.forbidForwards,
+        sendAs: params.sendAs ? await resolvePeer(client, params.sendAs) : undefined,
+        invertMedia: params.invertMedia,
+    }, { chainId });
+    assertIsUpdatesGroup('sendMediaGroup', res);
+    client.handleClientUpdate(res);
+    const peers = PeersIndex.from(res);
+    const msgs = res.updates
+        .filter((u) => u._ === 'updateNewMessage' || u._ === 'updateNewChannelMessage' || u._ === 'updateNewScheduledMessage')
+        .map((u) => new Message(u.message, peers, u._ === 'updateNewScheduledMessage'));
+    return msgs;
+}
+//# sourceMappingURL=send-media-group.js.map

package/esm/highlevel/methods/messages/send-media-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-media-group.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-media-group.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { randomLong } from '../../../utils/long-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputMediaLike } from '../../types/media/input-media.js'\nimport { Message } from '../../types/messages/message.js'\nimport { InputPeerLike, PeersIndex } from '../../types/peers/index.js'\nimport { assertIsUpdatesGroup } from '../../updates/utils.js'\nimport { _normalizeInputMedia } from '../files/normalize-input-media.js'\nimport { _normalizeInputText } from '../misc/normalize-text.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { _getDiscussionMessage } from './get-discussion-message.js'\nimport { _processCommonSendParameters, CommonSendParams } from './send-common.js'\n\n/**\n * Send a group of media.\n *\n * To add a caption to the group, add caption to the first\n * media in the group and don't add caption for any other.\n *\n * @param chatId  ID of the chat, its username, phone or `\"me\"` or `\"self\"`\n * @param medias  Medias contained in the message.\n * @param params  Additional sending parameters\n * @link InputMedia\n */\nexport async function sendMediaGroup(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    medias: (InputMediaLike | string)[],\n    params?: CommonSendParams & {\n        /**\n         * Whether to invert media position.\n         *\n         * Currently only supported for web previews and makes the\n         * client render the preview above the caption and not below.\n         */\n        invertMedia?: boolean\n\n        /**\n         * Function that will be called after some part has been uploaded.\n         * Only used when a file that requires uploading is passed,\n         * and not used when uploading a thumbnail.\n         *\n         * @param index  Index of the media in the original array\n         * @param uploaded  Number of bytes already uploaded\n         * @param total  Total file size\n         */\n        progressCallback?: (index: number, uploaded: number, total: number) => void\n    },\n): Promise<Message[]> {\n    if (!params) params = {}\n\n    const { peer, replyTo, scheduleDate, chainId } = await _processCommonSendParameters(client, chatId, params)\n\n    const multiMedia: tl.RawInputSingleMedia[] = []\n\n    for (let i = 0; i < medias.length; i++) {\n        let media = medias[i]\n\n        if (typeof media === 'string') {\n            media = {\n                type: 'auto',\n                file: media,\n            }\n        }\n\n        const inputMedia = await _normalizeInputMedia(\n            client,\n            media,\n            {\n                progressCallback: params.progressCallback?.bind(null, i),\n                // i have no fucking clue why we should upload it manually,\n                // but otherwise Telegram throws MEDIA_INVALID\n                // fuck my life\n                uploadPeer: peer,\n            },\n            true,\n        )\n\n        const [message, entities] = await _normalizeInputText(\n            client,\n            // some types dont have `caption` field, and ts warns us,\n            // but since it's JS, they'll just be `undefined` and properly handled by the method\n            (media as Extract<typeof media, { caption?: unknown }>).caption,\n        )\n\n        multiMedia.push({\n            _: 'inputSingleMedia',\n            randomId: randomLong(),\n            media: inputMedia,\n            message,\n            entities,\n        })\n    }\n\n    const res = await client.call(\n        {\n            _: 'messages.sendMultiMedia',\n            peer,\n            multiMedia,\n            silent: params.silent,\n            replyTo,\n            scheduleDate,\n            clearDraft: params.clearDraft,\n            noforwards: params.forbidForwards,\n            sendAs: params.sendAs ? await resolvePeer(client, params.sendAs) : undefined,\n            invertMedia: params.invertMedia,\n        },\n        { chainId },\n    )\n\n    assertIsUpdatesGroup('sendMediaGroup', res)\n    client.handleClientUpdate(res)\n\n    const peers = PeersIndex.from(res)\n\n    const msgs = res.updates\n        .filter(\n            (u): u is tl.RawUpdateNewMessage | tl.RawUpdateNewChannelMessage | tl.RawUpdateNewScheduledMessage =>\n                u._ === 'updateNewMessage' || u._ === 'updateNewChannelMessage' || u._ === 'updateNewScheduledMessage',\n        )\n        .map((u) => new Message(u.message, peers, u._ === 'updateNewScheduledMessage'))\n\n    return msgs\n}\n"]}

package/esm/highlevel/methods/messages/send-media.d.ts

@@ -0,0 +1,48 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ReplyMarkup } from '../../types/bots/keyboards.js';
+import { InputMediaLike } from '../../types/media/input-media.js';
+import { Message } from '../../types/messages/message.js';
+import { InputText } from '../../types/misc/entities.js';
+import { InputPeerLike } from '../../types/peers/index.js';
+import { CommonSendParams } from './send-common.js';
+/**
+ * Send a single media (a photo or a document-based media)
+ *
+ * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+ * @param media
+ *     Media contained in the message. You can also pass TDLib
+ *     and Bot API compatible File ID, which will be wrapped
+ *     in {@link InputMedia.auto}
+ * @param params  Additional sending parameters
+ * @link InputMedia
+ */
+export declare function sendMedia(client: ITelegramClient, chatId: InputPeerLike, media: InputMediaLike | string, params?: CommonSendParams & {
+    /**
+     * For bots: inline or reply markup or an instruction
+     * to hide a reply keyboard or to force a reply.
+     */
+    replyMarkup?: ReplyMarkup;
+    /**
+     * Whether to invert media position.
+     *
+     * Currently only supported for web previews and makes the
+     * client render the preview above the caption and not below.
+     */
+    invert?: boolean;
+    /**
+     * Override caption for `media`.
+     *
+     * Can be used, for example. when using File IDs
+     * or when using existing InputMedia objects.
+     */
+    caption?: InputText;
+    /**
+     * Function that will be called after some part has been uploaded.
+     * Only used when a file that requires uploading is passed,
+     * and not used when uploading a thumbnail.
+     *
+     * @param uploaded  Number of bytes already uploaded
+     * @param total  Total file size
+     */
+    progressCallback?: (uploaded: number, total: number) => void;
+}): Promise<Message>;

package/esm/highlevel/methods/messages/send-media.js

@@ -0,0 +1,54 @@
+import { randomLong } from '../../../utils/long-utils.js';
+import { BotKeyboard } from '../../types/bots/keyboards.js';
+import { _normalizeInputMedia } from '../files/normalize-input-media.js';
+import { _normalizeInputText } from '../misc/normalize-text.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { _findMessageInUpdate } from './find-in-update.js';
+import { _processCommonSendParameters } from './send-common.js';
+/**
+ * Send a single media (a photo or a document-based media)
+ *
+ * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+ * @param media
+ *     Media contained in the message. You can also pass TDLib
+ *     and Bot API compatible File ID, which will be wrapped
+ *     in {@link InputMedia.auto}
+ * @param params  Additional sending parameters
+ * @link InputMedia
+ */
+export async function sendMedia(client, chatId, media, params) {
+    if (!params)
+        params = {};
+    if (typeof media === 'string') {
+        media = {
+            type: 'auto',
+            file: media,
+        };
+    }
+    const inputMedia = await _normalizeInputMedia(client, media, params);
+    const [message, entities] = await _normalizeInputText(client, 
+    // some types dont have `caption` field, and ts warns us,
+    // but since it's JS, they'll just be `undefined` and properly handled by the method
+    params.caption || media.caption);
+    const replyMarkup = BotKeyboard._convertToTl(params.replyMarkup);
+    const { peer, replyTo, scheduleDate, chainId } = await _processCommonSendParameters(client, chatId, params);
+    const res = await client.call({
+        _: 'messages.sendMedia',
+        peer,
+        media: inputMedia,
+        silent: params.silent,
+        replyTo,
+        randomId: randomLong(),
+        scheduleDate,
+        replyMarkup,
+        message,
+        entities,
+        clearDraft: params.clearDraft,
+        noforwards: params.forbidForwards,
+        sendAs: params.sendAs ? await resolvePeer(client, params.sendAs) : undefined,
+        invertMedia: params.invert,
+    }, { chainId });
+    const msg = _findMessageInUpdate(client, res, false, !params.shouldDispatch);
+    return msg;
+}
+//# sourceMappingURL=send-media.js.map

package/esm/highlevel/methods/messages/send-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-media.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAEzD,OAAO,EAAE,WAAW,EAAe,MAAM,+BAA+B,CAAA;AAKxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,4BAA4B,EAAoB,MAAM,kBAAkB,CAAA;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,MAAuB,EACvB,MAAqB,EACrB,KAA8B,EAC9B,MAgCC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,EAAE,CAAA;IAExB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC3B,KAAK,GAAG;YACJ,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,KAAK;SACd,CAAA;KACJ;IAED,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IAEpE,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,mBAAmB,CACjD,MAAM;IACN,yDAAyD;IACzD,oFAAoF;IACpF,MAAM,CAAC,OAAO,IAAK,KAAsD,CAAC,OAAO,CACpF,CAAA;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAChE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,MAAM,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAE3G,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CACzB;QACI,CAAC,EAAE,oBAAoB;QACvB,IAAI;QACJ,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO;QACP,QAAQ,EAAE,UAAU,EAAE;QACtB,YAAY;QACZ,WAAW;QACX,OAAO;QACP,QAAQ;QACR,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,cAAc;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5E,WAAW,EAAE,MAAM,CAAC,MAAM;KAC7B,EACD,EAAE,OAAO,EAAE,CACd,CAAA;IAED,MAAM,GAAG,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IAE5E,OAAO,GAAG,CAAA;AACd,CAAC","sourcesContent":["import { randomLong } from '../../../utils/long-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { BotKeyboard, ReplyMarkup } from '../../types/bots/keyboards.js'\nimport { InputMediaLike } from '../../types/media/input-media.js'\nimport { Message } from '../../types/messages/message.js'\nimport { InputText } from '../../types/misc/entities.js'\nimport { InputPeerLike } from '../../types/peers/index.js'\nimport { _normalizeInputMedia } from '../files/normalize-input-media.js'\nimport { _normalizeInputText } from '../misc/normalize-text.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { _findMessageInUpdate } from './find-in-update.js'\nimport { _getDiscussionMessage } from './get-discussion-message.js'\nimport { _processCommonSendParameters, CommonSendParams } from './send-common.js'\n\n/**\n * Send a single media (a photo or a document-based media)\n *\n * @param chatId  ID of the chat, its username, phone or `\"me\"` or `\"self\"`\n * @param media\n *     Media contained in the message. You can also pass TDLib\n *     and Bot API compatible File ID, which will be wrapped\n *     in {@link InputMedia.auto}\n * @param params  Additional sending parameters\n * @link InputMedia\n */\nexport async function sendMedia(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    media: InputMediaLike | string,\n    params?: CommonSendParams & {\n        /**\n         * For bots: inline or reply markup or an instruction\n         * to hide a reply keyboard or to force a reply.\n         */\n        replyMarkup?: ReplyMarkup\n\n        /**\n         * Whether to invert media position.\n         *\n         * Currently only supported for web previews and makes the\n         * client render the preview above the caption and not below.\n         */\n        invert?: boolean\n\n        /**\n         * Override caption for `media`.\n         *\n         * Can be used, for example. when using File IDs\n         * or when using existing InputMedia objects.\n         */\n        caption?: InputText\n\n        /**\n         * Function that will be called after some part has been uploaded.\n         * Only used when a file that requires uploading is passed,\n         * and not used when uploading a thumbnail.\n         *\n         * @param uploaded  Number of bytes already uploaded\n         * @param total  Total file size\n         */\n        progressCallback?: (uploaded: number, total: number) => void\n    },\n): Promise<Message> {\n    if (!params) params = {}\n\n    if (typeof media === 'string') {\n        media = {\n            type: 'auto',\n            file: media,\n        }\n    }\n\n    const inputMedia = await _normalizeInputMedia(client, media, params)\n\n    const [message, entities] = await _normalizeInputText(\n        client,\n        // some types dont have `caption` field, and ts warns us,\n        // but since it's JS, they'll just be `undefined` and properly handled by the method\n        params.caption || (media as Extract<typeof media, { caption?: unknown }>).caption,\n    )\n\n    const replyMarkup = BotKeyboard._convertToTl(params.replyMarkup)\n    const { peer, replyTo, scheduleDate, chainId } = await _processCommonSendParameters(client, chatId, params)\n\n    const res = await client.call(\n        {\n            _: 'messages.sendMedia',\n            peer,\n            media: inputMedia,\n            silent: params.silent,\n            replyTo,\n            randomId: randomLong(),\n            scheduleDate,\n            replyMarkup,\n            message,\n            entities,\n            clearDraft: params.clearDraft,\n            noforwards: params.forbidForwards,\n            sendAs: params.sendAs ? await resolvePeer(client, params.sendAs) : undefined,\n            invertMedia: params.invert,\n        },\n        { chainId },\n    )\n\n    const msg = _findMessageInUpdate(client, res, false, !params.shouldDispatch)\n\n    return msg\n}\n"]}

package/esm/highlevel/methods/messages/send-quote.d.ts

@@ -0,0 +1,33 @@
+import { ITelegramClient } from '../../client.types.js';
+import { Message } from '../../types/messages/message.js';
+import { InputPeerLike } from '../../types/peers/peer.js';
+import { sendMedia } from './send-media.js';
+import { sendMediaGroup } from './send-media-group.js';
+import { sendText } from './send-text.js';
+export type QuoteParamsFrom<T> = Omit<NonNullable<T>, 'quoteText' | 'quoteEntities'> & {
+    /**
+     * Destination chat ID, username, phone, `"me"` or `"self"`
+     *
+     * @default  `message.chat`
+     */
+    toChatId?: InputPeerLike;
+    /** Index of the first character to quote (inclusive) */
+    start: number;
+    /** Index of the last character to quote (exclusive) */
+    end: number;
+};
+/** Send a text in reply to a given quote */
+export declare function quoteWithText(client: ITelegramClient, message: Message, params: QuoteParamsFrom<Parameters<typeof sendText>[3]> & {
+    /** Text to send */
+    text: Parameters<typeof sendText>[2];
+}): ReturnType<typeof sendText>;
+/** Send a media in reply to a given quote */
+export declare function quoteWithMedia(client: ITelegramClient, message: Message, params: QuoteParamsFrom<Parameters<typeof sendMedia>[3]> & {
+    /** Media to send */
+    media: Parameters<typeof sendMedia>[2];
+}): ReturnType<typeof sendMedia>;
+/** Send a media group in reply to a given quote */
+export declare function quoteWithMediaGroup(client: ITelegramClient, message: Message, params: QuoteParamsFrom<Parameters<typeof sendMediaGroup>[3]> & {
+    /** Media group to send */
+    medias: Parameters<typeof sendMediaGroup>[2];
+}): ReturnType<typeof sendMediaGroup>;

package/esm/highlevel/methods/messages/send-quote.js

@@ -0,0 +1,60 @@
+import { MtArgumentError } from '../../../types/errors.js';
+import { sendMedia } from './send-media.js';
+import { sendMediaGroup } from './send-media-group.js';
+import { sendText } from './send-text.js';
+function extractQuote(message, from, to) {
+    const { raw } = message;
+    if (raw._ === 'messageService')
+        throw new MtArgumentError('Cannot quote service message');
+    if (!raw.message)
+        throw new MtArgumentError('Cannot quote empty message');
+    const text = raw.message;
+    if (from < 0)
+        from = 0;
+    if (to > text.length)
+        to = text.length;
+    if (from >= to)
+        throw new MtArgumentError('Invalid quote range');
+    if (!raw.entities)
+        return { text: text.slice(from, to), entities: undefined };
+    const entities = [];
+    for (const ent of raw.entities) {
+        const start = ent.offset;
+        const end = ent.offset + ent.length;
+        if (start >= to || end <= from)
+            continue;
+        const newStart = Math.max(start, from) - from;
+        const newEnd = Math.min(end, to) - from;
+        const newEnt = { ...ent, offset: newStart, length: newEnd - newStart };
+        entities.push(newEnt);
+    }
+    return { text: text.slice(from, to), entities };
+}
+/** Send a text in reply to a given quote */
+export function quoteWithText(client, message, params) {
+    const { toChatId = message.chat, start, end, text, ...params__ } = params;
+    const params_ = params__;
+    params_.replyTo = message;
+    params_.quote = extractQuote(message, params.start, params.end);
+    params_.quoteOffset = params.start;
+    return sendText(client, toChatId, text, params_);
+}
+/** Send a media in reply to a given quote */
+export function quoteWithMedia(client, message, params) {
+    const { toChatId = message.chat, start, end, media, ...params__ } = params;
+    const params_ = params__;
+    params_.replyTo = message;
+    params_.quote = extractQuote(message, params.start, params.end);
+    params_.quoteOffset = params.start;
+    return sendMedia(client, toChatId, media, params_);
+}
+/** Send a media group in reply to a given quote */
+export function quoteWithMediaGroup(client, message, params) {
+    const { toChatId, start, end, medias, ...params__ } = params;
+    const params_ = params__;
+    params_.replyTo = message;
+    params_.quote = extractQuote(message, params.start, params.end);
+    params_.quoteOffset = params.start;
+    return sendMediaGroup(client, message.chat.inputPeer, medias, params_);
+}
+//# sourceMappingURL=send-quote.js.map

package/esm/highlevel/methods/messages/send-quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-quote.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-quote.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtArgumentError } from '../../../types/errors.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { Message } from '../../types/messages/message.js'\nimport { TextWithEntities } from '../../types/misc/entities.js'\nimport { InputPeerLike } from '../../types/peers/peer.js'\nimport { sendMedia } from './send-media.js'\nimport { sendMediaGroup } from './send-media-group.js'\nimport { sendText } from './send-text.js'\n\n// @exported\nexport type QuoteParamsFrom<T> = Omit<NonNullable<T>, 'quoteText' | 'quoteEntities'> & {\n    /**\n     * Destination chat ID, username, phone, `\"me\"` or `\"self\"`\n     *\n     * @default  `message.chat`\n     */\n    toChatId?: InputPeerLike\n\n    /** Index of the first character to quote (inclusive) */\n    start: number\n\n    /** Index of the last character to quote (exclusive) */\n    end: number\n}\n\nfunction extractQuote(message: Message, from: number, to: number): TextWithEntities {\n    const { raw } = message\n    if (raw._ === 'messageService') throw new MtArgumentError('Cannot quote service message')\n\n    if (!raw.message) throw new MtArgumentError('Cannot quote empty message')\n\n    const text = raw.message\n    if (from < 0) from = 0\n    if (to > text.length) to = text.length\n\n    if (from >= to) throw new MtArgumentError('Invalid quote range')\n\n    if (!raw.entities) return { text: text.slice(from, to), entities: undefined }\n\n    const entities: tl.TypeMessageEntity[] = []\n\n    for (const ent of raw.entities) {\n        const start = ent.offset\n        const end = ent.offset + ent.length\n\n        if (start >= to || end <= from) continue\n\n        const newStart = Math.max(start, from) - from\n        const newEnd = Math.min(end, to) - from\n\n        const newEnt = { ...ent, offset: newStart, length: newEnd - newStart }\n        entities.push(newEnt)\n    }\n\n    return { text: text.slice(from, to), entities }\n}\n\n/** Send a text in reply to a given quote */\nexport function quoteWithText(\n    client: ITelegramClient,\n    message: Message,\n    params: QuoteParamsFrom<Parameters<typeof sendText>[3]> & {\n        /** Text to send */\n        text: Parameters<typeof sendText>[2]\n    },\n): ReturnType<typeof sendText> {\n    const { toChatId = message.chat, start, end, text, ...params__ } = params\n    const params_ = params__ as NonNullable<Parameters<typeof sendText>[3]>\n    params_.replyTo = message\n    params_.quote = extractQuote(message, params.start, params.end)\n    params_.quoteOffset = params.start\n\n    return sendText(client, toChatId, text, params_)\n}\n\n/** Send a media in reply to a given quote */\nexport function quoteWithMedia(\n    client: ITelegramClient,\n    message: Message,\n    params: QuoteParamsFrom<Parameters<typeof sendMedia>[3]> & {\n        /** Media to send */\n        media: Parameters<typeof sendMedia>[2]\n    },\n): ReturnType<typeof sendMedia> {\n    const { toChatId = message.chat, start, end, media, ...params__ } = params\n    const params_ = params__ as NonNullable<Parameters<typeof sendMedia>[3]>\n    params_.replyTo = message\n    params_.quote = extractQuote(message, params.start, params.end)\n    params_.quoteOffset = params.start\n\n    return sendMedia(client, toChatId, media, params_)\n}\n\n/** Send a media group in reply to a given quote */\nexport function quoteWithMediaGroup(\n    client: ITelegramClient,\n    message: Message,\n    params: QuoteParamsFrom<Parameters<typeof sendMediaGroup>[3]> & {\n        /** Media group to send */\n        medias: Parameters<typeof sendMediaGroup>[2]\n    },\n): ReturnType<typeof sendMediaGroup> {\n    const { toChatId, start, end, medias, ...params__ } = params\n    const params_ = params__ as NonNullable<Parameters<typeof sendMediaGroup>[3]>\n    params_.replyTo = message\n    params_.quote = extractQuote(message, params.start, params.end)\n    params_.quoteOffset = params.start\n\n    return sendMediaGroup(client, message.chat.inputPeer, medias, params_)\n}\n"]}

package/esm/highlevel/methods/messages/send-reaction.d.ts

@@ -0,0 +1,21 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { InputMessageId, InputReaction, Message } from '../../types/index.js';
+/**
+ * Send or remove a reaction.
+ *
+ * @returns
+ *   Message to which the reaction was sent, if available.
+ *   The message is normally available for users, but may not be available for bots in PMs.
+ */
+export declare function sendReaction(client: ITelegramClient, params: InputMessageId & {
+    /** Reaction emoji (or `null` to remove reaction) */
+    emoji?: MaybeArray<InputReaction> | null;
+    /** Whether to use a big reaction */
+    big?: boolean;
+    /**
+     * Whether to dispatch the returned edit message event
+     * to the client's update handler.
+     */
+    shouldDispatch?: true;
+}): Promise<Message | null>;

package/esm/highlevel/methods/messages/send-reaction.js

@@ -0,0 +1,35 @@
+import { normalizeInputMessageId, normalizeInputReaction, } from '../../types/index.js';
+import { assertIsUpdatesGroup } from '../../updates/utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { _findMessageInUpdate } from './find-in-update.js';
+/**
+ * Send or remove a reaction.
+ *
+ * @returns
+ *   Message to which the reaction was sent, if available.
+ *   The message is normally available for users, but may not be available for bots in PMs.
+ */
+export async function sendReaction(client, params) {
+    const { emoji, big } = params;
+    const { chatId, message } = normalizeInputMessageId(params);
+    const emojis = Array.isArray(emoji) ? emoji : [emoji];
+    const reactions = emojis.map(normalizeInputReaction);
+    const res = await client.call({
+        _: 'messages.sendReaction',
+        peer: await resolvePeer(client, chatId),
+        msgId: message,
+        reaction: reactions,
+        big,
+    });
+    assertIsUpdatesGroup('messages.sendReaction', res);
+    // normally the group contains 2 updates:
+    // updateEdit(Channel)Message
+    // updateMessageReactions
+    // idk why, they contain literally the same data
+    // so we can just return the message from the first one
+    //
+    // for whatever reason, sendReaction for bots returns empty updates
+    // group in pms, so we should handle that too
+    return _findMessageInUpdate(client, res, true, !params.shouldDispatch, true);
+}
+//# sourceMappingURL=send-reaction.js.map

package/esm/highlevel/methods/messages/send-reaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-reaction.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-reaction.ts"],"names":[],"mappings":"AAEA,OAAO,EAIH,uBAAuB,EACvB,sBAAsB,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAuB,EACvB,MAWC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;IAC7B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAE3D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;IAEpD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,uBAAuB;QAC1B,IAAI,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;QACvC,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,SAAS;QACnB,GAAG;KACN,CAAC,CAAA;IAEF,oBAAoB,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAA;IAElD,yCAAyC;IACzC,6BAA6B;IAC7B,yBAAyB;IACzB,gDAAgD;IAChD,uDAAuD;IACvD,EAAE;IACF,mEAAmE;IACnE,6CAA6C;IAE7C,OAAO,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;AAChF,CAAC","sourcesContent":["import { MaybeArray } from '../../../types/utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport {\n    InputMessageId,\n    InputReaction,\n    Message,\n    normalizeInputMessageId,\n    normalizeInputReaction,\n} from '../../types/index.js'\nimport { assertIsUpdatesGroup } from '../../updates/utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { _findMessageInUpdate } from './find-in-update.js'\n\n/**\n * Send or remove a reaction.\n *\n * @returns\n *   Message to which the reaction was sent, if available.\n *   The message is normally available for users, but may not be available for bots in PMs.\n */\nexport async function sendReaction(\n    client: ITelegramClient,\n    params: InputMessageId & {\n        /** Reaction emoji (or `null` to remove reaction) */\n        emoji?: MaybeArray<InputReaction> | null\n        /** Whether to use a big reaction */\n        big?: boolean\n\n        /**\n         * Whether to dispatch the returned edit message event\n         * to the client's update handler.\n         */\n        shouldDispatch?: true\n    },\n): Promise<Message | null> {\n    const { emoji, big } = params\n    const { chatId, message } = normalizeInputMessageId(params)\n\n    const emojis = Array.isArray(emoji) ? emoji : [emoji]\n    const reactions = emojis.map(normalizeInputReaction)\n\n    const res = await client.call({\n        _: 'messages.sendReaction',\n        peer: await resolvePeer(client, chatId),\n        msgId: message,\n        reaction: reactions,\n        big,\n    })\n\n    assertIsUpdatesGroup('messages.sendReaction', res)\n\n    // normally the group contains 2 updates:\n    // updateEdit(Channel)Message\n    // updateMessageReactions\n    // idk why, they contain literally the same data\n    // so we can just return the message from the first one\n    //\n    // for whatever reason, sendReaction for bots returns empty updates\n    // group in pms, so we should handle that too\n\n    return _findMessageInUpdate(client, res, true, !params.shouldDispatch, true)\n}\n"]}

package/esm/highlevel/methods/messages/send-reply.d.ts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { Message } from '../../types/messages/message.js';
+import { ParametersSkip2 } from '../../types/utils.js';
+import { sendMedia } from './send-media.js';
+import { sendMediaGroup } from './send-media-group.js';
+import { sendText } from './send-text.js';
+/** Send a text in reply to a given message */
+export declare function replyText(client: ITelegramClient, message: Message, ...params: ParametersSkip2<typeof sendText>): ReturnType<typeof sendText>;
+/** Send a media in reply to a given message */
+export declare function replyMedia(client: ITelegramClient, message: Message, ...params: ParametersSkip2<typeof sendMedia>): ReturnType<typeof sendMedia>;
+/** Send a media group in reply to a given message */
+export declare function replyMediaGroup(client: ITelegramClient, message: Message, ...params: ParametersSkip2<typeof sendMediaGroup>): ReturnType<typeof sendMediaGroup>;

package/esm/highlevel/methods/messages/send-reply.js

@@ -0,0 +1,22 @@
+import { sendMedia } from './send-media.js';
+import { sendMediaGroup } from './send-media-group.js';
+import { sendText } from './send-text.js';
+/** Send a text in reply to a given message */
+export function replyText(client, message, ...params) {
+    const [text, params_ = {}] = params;
+    params_.replyTo = message.id;
+    return sendText(client, message.chat.inputPeer, text, params_);
+}
+/** Send a media in reply to a given message */
+export function replyMedia(client, message, ...params) {
+    const [media, params_ = {}] = params;
+    params_.replyTo = message.id;
+    return sendMedia(client, message.chat.inputPeer, media, params_);
+}
+/** Send a media group in reply to a given message */
+export function replyMediaGroup(client, message, ...params) {
+    const [media, params_ = {}] = params;
+    params_.replyTo = message.id;
+    return sendMediaGroup(client, message.chat.inputPeer, media, params_);
+}
+//# sourceMappingURL=send-reply.js.map

package/esm/highlevel/methods/messages/send-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-reply.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-reply.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,8CAA8C;AAC9C,MAAM,UAAU,SAAS,CACrB,MAAuB,EACvB,OAAgB,EAChB,GAAG,MAAwC;IAE3C,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;IACnC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAA;IAE5B,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAClE,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CACtB,MAAuB,EACvB,OAAgB,EAChB,GAAG,MAAyC;IAE5C,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;IACpC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAA;IAE5B,OAAO,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;AACpE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,eAAe,CAC3B,MAAuB,EACvB,OAAgB,EAChB,GAAG,MAA8C;IAEjD,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;IACpC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAA;IAE5B,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;AACzE,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { Message } from '../../types/messages/message.js'\nimport { ParametersSkip2 } from '../../types/utils.js'\nimport { sendMedia } from './send-media.js'\nimport { sendMediaGroup } from './send-media-group.js'\nimport { sendText } from './send-text.js'\n\n/** Send a text in reply to a given message */\nexport function replyText(\n    client: ITelegramClient,\n    message: Message,\n    ...params: ParametersSkip2<typeof sendText>\n): ReturnType<typeof sendText> {\n    const [text, params_ = {}] = params\n    params_.replyTo = message.id\n\n    return sendText(client, message.chat.inputPeer, text, params_)\n}\n\n/** Send a media in reply to a given message */\nexport function replyMedia(\n    client: ITelegramClient,\n    message: Message,\n    ...params: ParametersSkip2<typeof sendMedia>\n): ReturnType<typeof sendMedia> {\n    const [media, params_ = {}] = params\n    params_.replyTo = message.id\n\n    return sendMedia(client, message.chat.inputPeer, media, params_)\n}\n\n/** Send a media group in reply to a given message */\nexport function replyMediaGroup(\n    client: ITelegramClient,\n    message: Message,\n    ...params: ParametersSkip2<typeof sendMediaGroup>\n): ReturnType<typeof sendMediaGroup> {\n    const [media, params_ = {}] = params\n    params_.replyTo = message.id\n\n    return sendMediaGroup(client, message.chat.inputPeer, media, params_)\n}\n"]}

package/esm/highlevel/methods/messages/send-scheduled.d.ts

@@ -0,0 +1,14 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Message } from '../../types/index.js';
+/**
+ * Send previously scheduled message(s)
+ *
+ * Note that if the message belongs to a media group,
+ * the entire group will be sent, and all the messages
+ * will be returned.
+ *
+ * @param peer  Chat where the messages were scheduled
+ * @param ids  ID(s) of the messages
+ */
+export declare function sendScheduled(client: ITelegramClient, peer: InputPeerLike, ids: MaybeArray<number>): Promise<Message[]>;

package/esm/highlevel/methods/messages/send-scheduled.js

@@ -0,0 +1,30 @@
+import { Message, PeersIndex } from '../../types/index.js';
+import { assertIsUpdatesGroup } from '../../updates/utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Send previously scheduled message(s)
+ *
+ * Note that if the message belongs to a media group,
+ * the entire group will be sent, and all the messages
+ * will be returned.
+ *
+ * @param peer  Chat where the messages were scheduled
+ * @param ids  ID(s) of the messages
+ */
+export async function sendScheduled(client, peer, ids) {
+    if (!Array.isArray(ids))
+        ids = [ids];
+    const res = await client.call({
+        _: 'messages.sendScheduledMessages',
+        peer: await resolvePeer(client, peer),
+        id: ids,
+    });
+    assertIsUpdatesGroup('sendScheduled', res);
+    client.handleClientUpdate(res, true);
+    const peers = PeersIndex.from(res);
+    const msgs = res.updates
+        .filter((u) => u._ === 'updateNewMessage' || u._ === 'updateNewChannelMessage')
+        .map((u) => new Message(u.message, peers));
+    return msgs;
+}
+//# sourceMappingURL=send-scheduled.js.map

package/esm/highlevel/methods/messages/send-scheduled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-scheduled.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-scheduled.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,MAAuB,EACvB,IAAmB,EACnB,GAAuB;IAEvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;IAEpC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,gCAAgC;QACnC,IAAI,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC;QACrC,EAAE,EAAE,GAAG;KACV,CAAC,CAAA;IAEF,oBAAoB,CAAC,eAAe,EAAE,GAAG,CAAC,CAAA;IAC1C,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAEpC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAElC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO;SACnB,MAAM,CACH,CAAC,CAAC,EAAkF,EAAE,CAClF,CAAC,CAAC,CAAC,KAAK,kBAAkB,IAAI,CAAC,CAAC,CAAC,KAAK,yBAAyB,CACtE;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAE9C,OAAO,IAAI,CAAA;AACf,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MaybeArray } from '../../../types/utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, Message, PeersIndex } from '../../types/index.js'\nimport { assertIsUpdatesGroup } from '../../updates/utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Send previously scheduled message(s)\n *\n * Note that if the message belongs to a media group,\n * the entire group will be sent, and all the messages\n * will be returned.\n *\n * @param peer  Chat where the messages were scheduled\n * @param ids  ID(s) of the messages\n */\nexport async function sendScheduled(\n    client: ITelegramClient,\n    peer: InputPeerLike,\n    ids: MaybeArray<number>,\n): Promise<Message[]> {\n    if (!Array.isArray(ids)) ids = [ids]\n\n    const res = await client.call({\n        _: 'messages.sendScheduledMessages',\n        peer: await resolvePeer(client, peer),\n        id: ids,\n    })\n\n    assertIsUpdatesGroup('sendScheduled', res)\n    client.handleClientUpdate(res, true)\n\n    const peers = PeersIndex.from(res)\n\n    const msgs = res.updates\n        .filter(\n            (u): u is Extract<typeof u, tl.RawUpdateNewMessage | tl.RawUpdateNewChannelMessage> =>\n                u._ === 'updateNewMessage' || u._ === 'updateNewChannelMessage',\n        )\n        .map((u) => new Message(u.message, peers))\n\n    return msgs\n}\n"]}

package/esm/highlevel/methods/messages/send-text.d.ts

@@ -0,0 +1,31 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ReplyMarkup } from '../../types/bots/keyboards.js';
+import { Message } from '../../types/messages/message.js';
+import { InputText } from '../../types/misc/entities.js';
+import { InputPeerLike } from '../../types/peers/index.js';
+import { CommonSendParams } from './send-common.js';
+/**
+ * Send a text message
+ *
+ * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+ * @param text  Text of the message
+ * @param params  Additional sending parameters
+ */
+export declare function sendText(client: ITelegramClient, chatId: InputPeerLike, text: InputText, params?: CommonSendParams & {
+    /**
+     * For bots: inline or reply markup or an instruction
+     * to hide a reply keyboard or to force a reply.
+     */
+    replyMarkup?: ReplyMarkup;
+    /**
+     * Whether to disable links preview in this message
+     */
+    disableWebPreview?: boolean;
+    /**
+     * Whether to invert media position.
+     *
+     * Currently only supported for web previews and makes the
+     * client render the preview above the caption and not below.
+     */
+    invertMedia?: boolean;
+}): Promise<Message>;