@mtcute/core 0.6.0 → 0.7.0

package/cjs/highlevel/methods/dialogs/iter-dialogs.d.ts

@@ -0,0 +1,103 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { Dialog, InputDialogFolder } from '../../types/index.js';
+/**
+ * Iterate over dialogs.
+ *
+ * Note that due to Telegram API limitations,
+ * ordering here can only be anti-chronological
+ * (i.e. newest - first), and draft update date
+ * is not considered when sorting.
+ *
+ * @param params  Fetch parameters
+ */
+export declare function iterDialogs(client: ITelegramClient, params?: {
+    /**
+     * Offset message date used as an anchor for pagination.
+     */
+    offsetDate?: Date | number;
+    /**
+     * Offset message ID used as an anchor for pagination
+     */
+    offsetId?: number;
+    /**
+     * Offset peer used as an anchor for pagination
+     */
+    offsetPeer?: tl.TypeInputPeer;
+    /**
+     * Limits the number of dialogs to be received.
+     *
+     * @default  `Infinity`, i.e. all dialogs are fetched
+     */
+    limit?: number;
+    /**
+     * Chunk size which will be passed to `messages.getDialogs`.
+     * You shouldn't usually care about this.
+     *
+     * @default  100.
+     */
+    chunkSize?: number;
+    /**
+     * How to handle pinned dialogs?
+     *
+     * Whether to `include` them at the start of the list,
+     * `exclude` them at all, or `only` return pinned dialogs.
+     *
+     * Additionally, for folders you can specify
+     * `keep`, which will return pinned dialogs
+     * ordered by date among other non-pinned dialogs.
+     *
+     * > **Note**: When using `include` mode with folders,
+     * > pinned dialogs will only be fetched if all offset
+     * > parameters are unset.
+     *
+     * @default  `include`.
+     */
+    pinned?: 'include' | 'exclude' | 'only' | 'keep';
+    /**
+     * How to handle archived chats?
+     *
+     * Whether to `keep` them among other dialogs,
+     * `exclude` them from the list, or `only`
+     * return archived dialogs
+     *
+     * Ignored for folders, since folders
+     * themselves contain information about archived chats.
+     *
+     * > **Note**: when `pinned=only`, `archived=keep` will act as `only`
+     * > because of Telegram API limitations.
+     *
+     * @default  `exclude`
+     */
+    archived?: 'keep' | 'exclude' | 'only';
+    /**
+     * Folder from which the dialogs will be fetched.
+     *
+     * You can pass folder object, id or title
+     *
+     * Note that passing anything except object will
+     * cause the list of the folders to be fetched,
+     * and passing a title may fetch from
+     * a wrong folder if you have multiple with the same title.
+     *
+     * Also note that fetching dialogs in a folder is
+     * *orders of magnitudes* slower than normal because
+     * of Telegram API limitations - we have to fetch all dialogs
+     * and filter the ones we need manually. If possible,
+     * use {@link Dialog.filterFolder} instead.
+     *
+     * When a folder with given ID or title is not found,
+     * {@link MtArgumentError} is thrown
+     *
+     * @default  <empty> (fetches from "All" folder)
+     */
+    folder?: InputDialogFolder;
+    /**
+     * Additional filtering for the dialogs.
+     *
+     * If `folder` is not provided, this filter is used instead.
+     * If `folder` is provided, fields from this object are used
+     * to override filters inside the folder.
+     */
+    filter?: Partial<Omit<tl.RawDialogFilter, '_' | 'id' | 'title'>>;
+}): AsyncIterableIterator<Dialog>;

package/cjs/highlevel/methods/dialogs/iter-dialogs.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iterDialogs = void 0;
+const long_1 = __importDefault(require("long"));
+const errors_js_1 = require("../../../types/errors.js");
+const index_js_1 = require("../../types/index.js");
+const misc_utils_js_1 = require("../../utils/misc-utils.js");
+const get_folders_js_1 = require("./get-folders.js");
+/**
+ * Iterate over dialogs.
+ *
+ * Note that due to Telegram API limitations,
+ * ordering here can only be anti-chronological
+ * (i.e. newest - first), and draft update date
+ * is not considered when sorting.
+ *
+ * @param params  Fetch parameters
+ */
+async function* iterDialogs(client, params) {
+    if (!params)
+        params = {};
+    const { limit = Infinity, chunkSize = 100, folder, filter, pinned = 'include' } = params;
+    let { offsetId = 0, offsetPeer = { _: 'inputPeerEmpty' }, archived = 'exclude' } = params;
+    let offsetDate = (0, misc_utils_js_1.normalizeDate)(params.offsetDate) ?? 0;
+    let localFilters_;
+    if (folder) {
+        localFilters_ = await (0, get_folders_js_1._normalizeInputFolder)(client, folder);
+    }
+    if (filter) {
+        if (localFilters_ && localFilters_._ !== 'dialogFilterDefault') {
+            localFilters_ = {
+                ...localFilters_,
+                ...filter,
+            };
+        }
+        else {
+            localFilters_ = {
+                _: 'dialogFilter',
+                id: 0,
+                title: '',
+                pinnedPeers: [],
+                includePeers: [],
+                excludePeers: [],
+                ...params.filter,
+            };
+        }
+    }
+    if (localFilters_?._ === 'dialogFilterDefault') {
+        localFilters_ = undefined;
+    }
+    if (localFilters_?._ === 'dialogFilterChatlist') {
+        throw new errors_js_1.MtUnsupportedError('Shared chat folders are not supported yet');
+    }
+    const localFilters = localFilters_;
+    if (localFilters) {
+        archived = localFilters.excludeArchived ? 'exclude' : 'keep';
+    }
+    const fetchPinnedDialogsFromFolder = async () => {
+        if (!localFilters || !localFilters.pinnedPeers.length) {
+            return null;
+        }
+        const res = await client.call({
+            _: 'messages.getPeerDialogs',
+            peers: localFilters.pinnedPeers.map((peer) => ({
+                _: 'inputDialogPeer',
+                peer,
+            })),
+        });
+        res.dialogs.forEach((dialog) => (dialog.pinned = true));
+        return res;
+    };
+    if (pinned === 'only') {
+        let res;
+        if (localFilters) {
+            res = await fetchPinnedDialogsFromFolder();
+        }
+        else {
+            res = await client.call({
+                _: 'messages.getPinnedDialogs',
+                folderId: archived === 'exclude' ? 0 : 1,
+            });
+        }
+        if (res)
+            yield* index_js_1.Dialog.parseTlDialogs(res, limit);
+        return;
+    }
+    let current = 0;
+    if (localFilters?.pinnedPeers.length &&
+        pinned === 'include' &&
+        offsetId === 0 &&
+        offsetDate === 0 &&
+        offsetPeer._ === 'inputPeerEmpty') {
+        const res = await fetchPinnedDialogsFromFolder();
+        if (res) {
+            const dialogs = index_js_1.Dialog.parseTlDialogs(res, limit);
+            for (const d of dialogs) {
+                yield d;
+                if (++current >= limit)
+                    return;
+            }
+        }
+    }
+    // if pinned is `only`, this wouldn't be reached
+    // if pinned is `exclude`, we want to exclude them
+    // if pinned is `include`, we already yielded them, so we also want to exclude them
+    // if pinned is `keep`, we want to keep them
+    const filterFolder = localFilters ? index_js_1.Dialog.filterFolder(localFilters, pinned !== 'keep') : undefined;
+    let folderId;
+    if (archived === 'keep') {
+        folderId = undefined;
+    }
+    else if (archived === 'only') {
+        folderId = 1;
+    }
+    else {
+        folderId = 0;
+    }
+    for (;;) {
+        const dialogs = index_js_1.Dialog.parseTlDialogs(await client.call({
+            _: 'messages.getDialogs',
+            excludePinned: params.pinned === 'exclude',
+            folderId,
+            offsetDate,
+            offsetId,
+            offsetPeer,
+            limit: filterFolder ? chunkSize : Math.min(limit - current, chunkSize),
+            hash: long_1.default.ZERO,
+        }));
+        if (!dialogs.length)
+            return;
+        const last = dialogs[dialogs.length - 1];
+        offsetPeer = last.chat.inputPeer;
+        offsetId = last.raw.topMessage;
+        offsetDate = last.lastMessage.raw.date;
+        for (const d of dialogs) {
+            if (filterFolder && !filterFolder(d))
+                continue;
+            yield d;
+            if (++current >= limit)
+                return;
+        }
+    }
+}
+exports.iterDialogs = iterDialogs;
+//# sourceMappingURL=iter-dialogs.js.map

package/cjs/highlevel/methods/dialogs/iter-dialogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iter-dialogs.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/dialogs/iter-dialogs.ts"],"names":[],"mappings":"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","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { MtUnsupportedError } from '../../../types/errors.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { Dialog, InputDialogFolder } from '../../types/index.js'\nimport { normalizeDate } from '../../utils/misc-utils.js'\nimport { _normalizeInputFolder } from './get-folders.js'\n\n/**\n * Iterate over dialogs.\n *\n * Note that due to Telegram API limitations,\n * ordering here can only be anti-chronological\n * (i.e. newest - first), and draft update date\n * is not considered when sorting.\n *\n * @param params  Fetch parameters\n */\nexport async function* iterDialogs(\n    client: ITelegramClient,\n    params?: {\n        /**\n         * Offset message date used as an anchor for pagination.\n         */\n        offsetDate?: Date | number\n\n        /**\n         * Offset message ID used as an anchor for pagination\n         */\n        offsetId?: number\n\n        /**\n         * Offset peer used as an anchor for pagination\n         */\n        offsetPeer?: tl.TypeInputPeer\n\n        /**\n         * Limits the number of dialogs to be received.\n         *\n         * @default  `Infinity`, i.e. all dialogs are fetched\n         */\n        limit?: number\n\n        /**\n         * Chunk size which will be passed to `messages.getDialogs`.\n         * You shouldn't usually care about this.\n         *\n         * @default  100.\n         */\n        chunkSize?: number\n\n        /**\n         * How to handle pinned dialogs?\n         *\n         * Whether to `include` them at the start of the list,\n         * `exclude` them at all, or `only` return pinned dialogs.\n         *\n         * Additionally, for folders you can specify\n         * `keep`, which will return pinned dialogs\n         * ordered by date among other non-pinned dialogs.\n         *\n         * > **Note**: When using `include` mode with folders,\n         * > pinned dialogs will only be fetched if all offset\n         * > parameters are unset.\n         *\n         * @default  `include`.\n         */\n        pinned?: 'include' | 'exclude' | 'only' | 'keep'\n\n        /**\n         * How to handle archived chats?\n         *\n         * Whether to `keep` them among other dialogs,\n         * `exclude` them from the list, or `only`\n         * return archived dialogs\n         *\n         * Ignored for folders, since folders\n         * themselves contain information about archived chats.\n         *\n         * > **Note**: when `pinned=only`, `archived=keep` will act as `only`\n         * > because of Telegram API limitations.\n         *\n         * @default  `exclude`\n         */\n        archived?: 'keep' | 'exclude' | 'only'\n\n        /**\n         * Folder from which the dialogs will be fetched.\n         *\n         * You can pass folder object, id or title\n         *\n         * Note that passing anything except object will\n         * cause the list of the folders to be fetched,\n         * and passing a title may fetch from\n         * a wrong folder if you have multiple with the same title.\n         *\n         * Also note that fetching dialogs in a folder is\n         * *orders of magnitudes* slower than normal because\n         * of Telegram API limitations - we have to fetch all dialogs\n         * and filter the ones we need manually. If possible,\n         * use {@link Dialog.filterFolder} instead.\n         *\n         * When a folder with given ID or title is not found,\n         * {@link MtArgumentError} is thrown\n         *\n         * @default  <empty> (fetches from \"All\" folder)\n         */\n        folder?: InputDialogFolder\n\n        /**\n         * Additional filtering for the dialogs.\n         *\n         * If `folder` is not provided, this filter is used instead.\n         * If `folder` is provided, fields from this object are used\n         * to override filters inside the folder.\n         */\n        filter?: Partial<Omit<tl.RawDialogFilter, '_' | 'id' | 'title'>>\n    },\n): AsyncIterableIterator<Dialog> {\n    if (!params) params = {}\n\n    const { limit = Infinity, chunkSize = 100, folder, filter, pinned = 'include' } = params\n\n    let { offsetId = 0, offsetPeer = { _: 'inputPeerEmpty' }, archived = 'exclude' } = params\n\n    let offsetDate = normalizeDate(params.offsetDate) ?? 0\n\n    let localFilters_: tl.TypeDialogFilter | undefined\n\n    if (folder) {\n        localFilters_ = await _normalizeInputFolder(client, folder)\n    }\n\n    if (filter) {\n        if (localFilters_ && localFilters_._ !== 'dialogFilterDefault') {\n            localFilters_ = {\n                ...localFilters_,\n                ...filter,\n            }\n        } else {\n            localFilters_ = {\n                _: 'dialogFilter',\n                id: 0,\n                title: '',\n                pinnedPeers: [],\n                includePeers: [],\n                excludePeers: [],\n                ...params.filter,\n            }\n        }\n    }\n\n    if (localFilters_?._ === 'dialogFilterDefault') {\n        localFilters_ = undefined\n    }\n\n    if (localFilters_?._ === 'dialogFilterChatlist') {\n        throw new MtUnsupportedError('Shared chat folders are not supported yet')\n    }\n\n    const localFilters = localFilters_\n\n    if (localFilters) {\n        archived = localFilters.excludeArchived ? 'exclude' : 'keep'\n    }\n\n    const fetchPinnedDialogsFromFolder = async (): Promise<tl.messages.RawPeerDialogs | null> => {\n        if (!localFilters || !localFilters.pinnedPeers.length) {\n            return null\n        }\n        const res = await client.call({\n            _: 'messages.getPeerDialogs',\n            peers: localFilters.pinnedPeers.map((peer) => ({\n                _: 'inputDialogPeer' as const,\n                peer,\n            })),\n        })\n\n        res.dialogs.forEach((dialog: tl.Mutable<tl.TypeDialog>) => (dialog.pinned = true))\n\n        return res\n    }\n\n    if (pinned === 'only') {\n        let res\n\n        if (localFilters) {\n            res = await fetchPinnedDialogsFromFolder()\n        } else {\n            res = await client.call({\n                _: 'messages.getPinnedDialogs',\n                folderId: archived === 'exclude' ? 0 : 1,\n            })\n        }\n        if (res) yield* Dialog.parseTlDialogs(res, limit)\n\n        return\n    }\n\n    let current = 0\n\n    if (\n        localFilters?.pinnedPeers.length &&\n        pinned === 'include' &&\n        offsetId === 0 &&\n        offsetDate === 0 &&\n        offsetPeer._ === 'inputPeerEmpty'\n    ) {\n        const res = await fetchPinnedDialogsFromFolder()\n\n        if (res) {\n            const dialogs = Dialog.parseTlDialogs(res, limit)\n\n            for (const d of dialogs) {\n                yield d\n                if (++current >= limit) return\n            }\n        }\n    }\n    // if pinned is `only`, this wouldn't be reached\n    // if pinned is `exclude`, we want to exclude them\n    // if pinned is `include`, we already yielded them, so we also want to exclude them\n    // if pinned is `keep`, we want to keep them\n    const filterFolder = localFilters ? Dialog.filterFolder(localFilters, pinned !== 'keep') : undefined\n\n    let folderId\n\n    if (archived === 'keep') {\n        folderId = undefined\n    } else if (archived === 'only') {\n        folderId = 1\n    } else {\n        folderId = 0\n    }\n\n    for (;;) {\n        const dialogs = Dialog.parseTlDialogs(\n            await client.call({\n                _: 'messages.getDialogs',\n                excludePinned: params.pinned === 'exclude',\n                folderId,\n                offsetDate,\n                offsetId,\n                offsetPeer,\n                limit: filterFolder ? chunkSize : Math.min(limit - current, chunkSize),\n                hash: Long.ZERO,\n            }),\n        )\n        if (!dialogs.length) return\n\n        const last = dialogs[dialogs.length - 1]\n        offsetPeer = last.chat.inputPeer\n        offsetId = last.raw.topMessage\n        offsetDate = last.lastMessage.raw.date\n\n        for (const d of dialogs) {\n            if (filterFolder && !filterFolder(d)) continue\n\n            yield d\n            if (++current >= limit) return\n        }\n    }\n}\n"]}

package/cjs/highlevel/methods/dialogs/set-folders-order.d.ts

@@ -0,0 +1,7 @@
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Reorder folders
+ *
+ * @param order  New order of folders (folder IDs, where default = 0)
+ */
+export declare function setFoldersOrder(client: ITelegramClient, order: number[]): Promise<void>;

package/cjs/highlevel/methods/dialogs/set-folders-order.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setFoldersOrder = void 0;
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+/**
+ * Reorder folders
+ *
+ * @param order  New order of folders (folder IDs, where default = 0)
+ */
+async function setFoldersOrder(client, order) {
+    const r = await client.call({
+        _: 'messages.updateDialogFiltersOrder',
+        order,
+    });
+    (0, type_assertions_js_1.assertTrue)('messages.updateDialogFiltersOrder', r);
+}
+exports.setFoldersOrder = setFoldersOrder;
+//# sourceMappingURL=set-folders-order.js.map

package/cjs/highlevel/methods/dialogs/set-folders-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-folders-order.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/dialogs/set-folders-order.ts"],"names":[],"mappings":";;;AAAA,0EAA8D;AAG9D;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAAC,MAAuB,EAAE,KAAe;IAC1E,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QACxB,CAAC,EAAE,mCAAmC;QACtC,KAAK;KACR,CAAC,CAAA;IAEF,IAAA,+BAAU,EAAC,mCAAmC,EAAE,CAAC,CAAC,CAAA;AACtD,CAAC;AAPD,0CAOC","sourcesContent":["import { assertTrue } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\n\n/**\n * Reorder folders\n *\n * @param order  New order of folders (folder IDs, where default = 0)\n */\nexport async function setFoldersOrder(client: ITelegramClient, order: number[]): Promise<void> {\n    const r = await client.call({\n        _: 'messages.updateDialogFiltersOrder',\n        order,\n    })\n\n    assertTrue('messages.updateDialogFiltersOrder', r)\n}\n"]}

package/cjs/highlevel/methods/files/_platform.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._handleNodeStream = exports._extractFileStreamMeta = exports._isFileStream = exports._createFileStream = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_stream_1 = require("node:stream");
+const stream_utils_js_1 = require("../../utils/stream-utils.js");
+/** @internal */
+function _createFileStream(path) {
+    return (0, node_fs_1.createReadStream)(path);
+}
+exports._createFileStream = _createFileStream;
+/** @internal */
+function _isFileStream(stream) {
+    return stream instanceof node_fs_1.ReadStream;
+}
+exports._isFileStream = _isFileStream;
+/** @internal */
+async function _extractFileStreamMeta(stream) {
+    const fileName = (0, node_path_1.basename)(stream.path.toString());
+    const fileSize = await node_fs_1.promises.stat(stream.path.toString()).then((stat) => stat.size);
+    return [fileName, fileSize];
+}
+exports._extractFileStreamMeta = _extractFileStreamMeta;
+/** @internal */
+function _handleNodeStream(val) {
+    if (val instanceof node_stream_1.Readable) {
+        return (0, stream_utils_js_1.nodeReadableToWeb)(val);
+    }
+    return val;
+}
+exports._handleNodeStream = _handleNodeStream;
+//# sourceMappingURL=_platform.js.map

package/cjs/highlevel/methods/files/_platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_platform.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/_platform.ts"],"names":[],"mappings":";;;AAAA,qCAAgE;AAChE,yCAAoC;AACpC,6CAAsC;AAEtC,iEAA+D;AAE/D,gBAAgB;AAChB,SAAgB,iBAAiB,CAAC,IAAY;IAC1C,OAAO,IAAA,0BAAgB,EAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAFD,8CAEC;AAED,gBAAgB;AAChB,SAAgB,aAAa,CAAC,MAAe;IACzC,OAAO,MAAM,YAAY,oBAAU,CAAA;AACvC,CAAC;AAFD,sCAEC;AAED,gBAAgB;AACT,KAAK,UAAU,sBAAsB,CAAC,MAAkB;IAC3D,MAAM,QAAQ,GAAG,IAAA,oBAAQ,EAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;IACjD,MAAM,QAAQ,GAAG,MAAM,kBAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEtF,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAC/B,CAAC;AALD,wDAKC;AAED,gBAAgB;AAChB,SAAgB,iBAAiB,CAAI,GAAiB;IAClD,IAAI,GAAG,YAAY,sBAAQ,EAAE;QACzB,OAAO,IAAA,mCAAiB,EAAC,GAAG,CAAC,CAAA;KAChC;IAED,OAAO,GAAG,CAAA;AACd,CAAC;AAND,8CAMC","sourcesContent":["import { createReadStream, promises, ReadStream } from 'node:fs'\nimport { basename } from 'node:path'\nimport { Readable } from 'node:stream'\n\nimport { nodeReadableToWeb } from '../../utils/stream-utils.js'\n\n/** @internal */\nexport function _createFileStream(path: string): ReadStream {\n    return createReadStream(path)\n}\n\n/** @internal */\nexport function _isFileStream(stream: unknown): stream is ReadStream {\n    return stream instanceof ReadStream\n}\n\n/** @internal */\nexport async function _extractFileStreamMeta(stream: ReadStream): Promise<[string, number]> {\n    const fileName = basename(stream.path.toString())\n    const fileSize = await promises.stat(stream.path.toString()).then((stat) => stat.size)\n\n    return [fileName, fileSize]\n}\n\n/** @internal */\nexport function _handleNodeStream<T>(val: T | Readable): T | ReadableStream<Uint8Array> {\n    if (val instanceof Readable) {\n        return nodeReadableToWeb(val)\n    }\n\n    return val\n}\n"]}

package/cjs/highlevel/methods/files/_platform.web.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._handleNodeStream = exports._extractFileStreamMeta = exports._isFileStream = exports._createFileStream = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+/** @internal */
+function _createFileStream() {
+    throw new errors_js_1.MtArgumentError('Cannot create file stream on web platform');
+}
+exports._createFileStream = _createFileStream;
+/** @internal */
+function _isFileStream() {
+    return false;
+}
+exports._isFileStream = _isFileStream;
+/** @internal */
+function _extractFileStreamMeta() {
+    throw new Error('UNREACHABLE');
+}
+exports._extractFileStreamMeta = _extractFileStreamMeta;
+/** @internal */
+function _handleNodeStream(val) {
+    return val;
+}
+exports._handleNodeStream = _handleNodeStream;
+// all the above functions shall be inlined by terser
+//# sourceMappingURL=_platform.web.js.map

package/cjs/highlevel/methods/files/_platform.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_platform.web.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/_platform.web.ts"],"names":[],"mappings":";;;AAAA,wDAA0D;AAE1D,gBAAgB;AAChB,SAAgB,iBAAiB;IAC7B,MAAM,IAAI,2BAAe,CAAC,2CAA2C,CAAC,CAAA;AAC1E,CAAC;AAFD,8CAEC;AAED,gBAAgB;AAChB,SAAgB,aAAa;IACzB,OAAO,KAAK,CAAA;AAChB,CAAC;AAFD,sCAEC;AAED,gBAAgB;AAChB,SAAgB,sBAAsB;IAClC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAA;AAClC,CAAC;AAFD,wDAEC;AAED,gBAAgB;AAChB,SAAgB,iBAAiB,CAAC,GAAY;IAC1C,OAAO,GAAG,CAAA;AACd,CAAC;AAFD,8CAEC;AAED,qDAAqD","sourcesContent":["import { MtArgumentError } from '../../../types/errors.js'\n\n/** @internal */\nexport function _createFileStream(): never {\n    throw new MtArgumentError('Cannot create file stream on web platform')\n}\n\n/** @internal */\nexport function _isFileStream() {\n    return false\n}\n\n/** @internal */\nexport function _extractFileStreamMeta(): never {\n    throw new Error('UNREACHABLE')\n}\n\n/** @internal */\nexport function _handleNodeStream(val: unknown) {\n    return val\n}\n\n// all the above functions shall be inlined by terser\n"]}

package/cjs/highlevel/methods/files/download-buffer.d.ts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { FileDownloadLocation, FileDownloadParameters } from '../../types/index.js';
+/**
+ * Download a file and return its contents as a Buffer.
+ *
+ * > **Note**: This method _will_ download the entire file
+ * > into memory at once. This might cause an issue, so use wisely!
+ *
+ * @param params  File download parameters
+ */
+export declare function downloadAsBuffer(client: ITelegramClient, location: FileDownloadLocation, params?: FileDownloadParameters): Promise<Uint8Array>;

package/cjs/highlevel/methods/files/download-buffer.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadAsBuffer = void 0;
+const buffer_utils_js_1 = require("../../../utils/buffer-utils.js");
+const index_js_1 = require("../../types/index.js");
+const download_iterable_js_1 = require("./download-iterable.js");
+/**
+ * Download a file and return its contents as a Buffer.
+ *
+ * > **Note**: This method _will_ download the entire file
+ * > into memory at once. This might cause an issue, so use wisely!
+ *
+ * @param params  File download parameters
+ */
+async function downloadAsBuffer(client, location, params) {
+    if (location instanceof index_js_1.FileLocation && ArrayBuffer.isView(location.location)) {
+        return location.location;
+    }
+    const chunks = [];
+    for await (const chunk of (0, download_iterable_js_1.downloadAsIterable)(client, location, params)) {
+        chunks.push(chunk);
+    }
+    return (0, buffer_utils_js_1.concatBuffers)(chunks);
+}
+exports.downloadAsBuffer = downloadAsBuffer;
+//# sourceMappingURL=download-buffer.js.map

package/cjs/highlevel/methods/files/download-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-buffer.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/download-buffer.ts"],"names":[],"mappings":";;;AAAA,oEAA8D;AAE9D,mDAAiG;AACjG,iEAA2D;AAE3D;;;;;;;GAOG;AACI,KAAK,UAAU,gBAAgB,CAClC,MAAuB,EACvB,QAA8B,EAC9B,MAA+B;IAE/B,IAAI,QAAQ,YAAY,uBAAY,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAC3E,OAAO,QAAQ,CAAC,QAAQ,CAAA;KAC3B;IAED,MAAM,MAAM,GAAG,EAAE,CAAA;IAEjB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAA,yCAAkB,EAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;QACpE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;KACrB;IAED,OAAO,IAAA,+BAAa,EAAC,MAAM,CAAC,CAAA;AAChC,CAAC;AAhBD,4CAgBC","sourcesContent":["import { concatBuffers } from '../../../utils/buffer-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { FileDownloadLocation, FileDownloadParameters, FileLocation } from '../../types/index.js'\nimport { downloadAsIterable } from './download-iterable.js'\n\n/**\n * Download a file and return its contents as a Buffer.\n *\n * > **Note**: This method _will_ download the entire file\n * > into memory at once. This might cause an issue, so use wisely!\n *\n * @param params  File download parameters\n */\nexport async function downloadAsBuffer(\n    client: ITelegramClient,\n    location: FileDownloadLocation,\n    params?: FileDownloadParameters,\n): Promise<Uint8Array> {\n    if (location instanceof FileLocation && ArrayBuffer.isView(location.location)) {\n        return location.location\n    }\n\n    const chunks = []\n\n    for await (const chunk of downloadAsIterable(client, location, params)) {\n        chunks.push(chunk)\n    }\n\n    return concatBuffers(chunks)\n}\n"]}

package/cjs/highlevel/methods/files/download-file.d.ts

@@ -0,0 +1,10 @@
+import { ITelegramClient } from '../../client.types.js';
+import { FileDownloadLocation, FileDownloadParameters } from '../../types/index.js';
+/**
+ * Download a remote file to a local file (only for NodeJS).
+ * Promise will resolve once the download is complete.
+ *
+ * @param filename  Local file name to which the remote file will be downloaded
+ * @param params  File download parameters
+ */
+export declare function downloadToFile(client: ITelegramClient, filename: string, location: FileDownloadLocation, params?: FileDownloadParameters): Promise<void>;

package/cjs/highlevel/methods/files/download-file.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadToFile = void 0;
+// eslint-disable-next-line no-restricted-imports
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const index_js_1 = require("../../types/index.js");
+const download_iterable_js_1 = require("./download-iterable.js");
+/**
+ * Download a remote file to a local file (only for NodeJS).
+ * Promise will resolve once the download is complete.
+ *
+ * @param filename  Local file name to which the remote file will be downloaded
+ * @param params  File download parameters
+ */
+async function downloadToFile(client, filename, location, params) {
+    if (location instanceof index_js_1.FileLocation && ArrayBuffer.isView(location.location)) {
+        // early return for inline files
+        await (0, promises_1.writeFile)(filename, location.location);
+    }
+    const output = (0, fs_1.createWriteStream)(filename);
+    if (params?.abortSignal) {
+        params.abortSignal.addEventListener('abort', () => {
+            client.log.debug('aborting file download %s - cleaning up', filename);
+            output.destroy();
+            (0, fs_1.rmSync)(filename);
+        });
+    }
+    for await (const chunk of (0, download_iterable_js_1.downloadAsIterable)(client, location, params)) {
+        output.write(chunk);
+    }
+    output.end();
+}
+exports.downloadToFile = downloadToFile;
+//# sourceMappingURL=download-file.js.map

package/cjs/highlevel/methods/files/download-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-file.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/download-file.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,2BAA8C;AAC9C,0CAAuC;AAGvC,mDAAiG;AACjG,iEAA2D;AAE3D;;;;;;GAMG;AACI,KAAK,UAAU,cAAc,CAChC,MAAuB,EACvB,QAAgB,EAChB,QAA8B,EAC9B,MAA+B;IAE/B,IAAI,QAAQ,YAAY,uBAAY,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAC3E,gCAAgC;QAChC,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;KAC/C;IAED,MAAM,MAAM,GAAG,IAAA,sBAAiB,EAAC,QAAQ,CAAC,CAAA;IAE1C,IAAI,MAAM,EAAE,WAAW,EAAE;QACrB,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC9C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,yCAAyC,EAAE,QAAQ,CAAC,CAAA;YACrE,MAAM,CAAC,OAAO,EAAE,CAAA;YAChB,IAAA,WAAM,EAAC,QAAQ,CAAC,CAAA;QACpB,CAAC,CAAC,CAAA;KACL;IAED,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAA,yCAAkB,EAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;QACpE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;KACtB;IAED,MAAM,CAAC,GAAG,EAAE,CAAA;AAChB,CAAC;AA1BD,wCA0BC","sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport { createWriteStream, rmSync } from 'fs'\nimport { writeFile } from 'fs/promises'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport { FileDownloadLocation, FileDownloadParameters, FileLocation } from '../../types/index.js'\nimport { downloadAsIterable } from './download-iterable.js'\n\n/**\n * Download a remote file to a local file (only for NodeJS).\n * Promise will resolve once the download is complete.\n *\n * @param filename  Local file name to which the remote file will be downloaded\n * @param params  File download parameters\n */\nexport async function downloadToFile(\n    client: ITelegramClient,\n    filename: string,\n    location: FileDownloadLocation,\n    params?: FileDownloadParameters,\n): Promise<void> {\n    if (location instanceof FileLocation && ArrayBuffer.isView(location.location)) {\n        // early return for inline files\n        await writeFile(filename, location.location)\n    }\n\n    const output = createWriteStream(filename)\n\n    if (params?.abortSignal) {\n        params.abortSignal.addEventListener('abort', () => {\n            client.log.debug('aborting file download %s - cleaning up', filename)\n            output.destroy()\n            rmSync(filename)\n        })\n    }\n\n    for await (const chunk of downloadAsIterable(client, location, params)) {\n        output.write(chunk)\n    }\n\n    output.end()\n}\n"]}

package/cjs/highlevel/methods/files/download-file.web.d.ts

@@ -0,0 +1 @@
+export declare function downloadToFile(): void;

package/cjs/highlevel/methods/files/download-file.web.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadToFile = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+function downloadToFile() {
+    throw new errors_js_1.MtUnsupportedError('Downloading to file is only supported in NodeJS');
+}
+exports.downloadToFile = downloadToFile;
+//# sourceMappingURL=download-file.web.js.map

package/cjs/highlevel/methods/files/download-file.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-file.web.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/download-file.web.ts"],"names":[],"mappings":";;;AAAA,wDAA6D;AAE7D,SAAgB,cAAc;IAC1B,MAAM,IAAI,8BAAkB,CAAC,iDAAiD,CAAC,CAAA;AACnF,CAAC;AAFD,wCAEC","sourcesContent":["import { MtUnsupportedError } from '../../../types/errors.js'\n\nexport function downloadToFile() {\n    throw new MtUnsupportedError('Downloading to file is only supported in NodeJS')\n}\n"]}

package/cjs/highlevel/methods/files/download-iterable.d.ts

@@ -0,0 +1,10 @@
+import { ITelegramClient } from '../../client.types.js';
+import { FileDownloadLocation, FileDownloadParameters } from '../../types/index.js';
+/**
+ * Download a file and return it as an iterable, which yields file contents
+ * in chunks of a given size. Order of the chunks is guaranteed to be
+ * consecutive.
+ *
+ * @param params  Download parameters
+ */
+export declare function downloadAsIterable(client: ITelegramClient, input: FileDownloadLocation, params?: FileDownloadParameters): AsyncIterableIterator<Uint8Array>;