@mtcute/core 0.5.0 → 0.7.0

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

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFile = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+const long_utils_js_1 = require("../../../utils/long-utils.js");
+const file_type_js_1 = require("../../utils/file-type.js");
+const file_utils_js_1 = require("../../utils/file-utils.js");
+const stream_utils_js_1 = require("../../utils/stream-utils.js");
+const _platform_js_1 = require("./_platform.js");
+const OVERRIDE_MIME = {
+    // tg doesn't interpret `audio/opus` files as voice messages for some reason
+    'audio/opus': 'audio/ogg',
+};
+// small files (less than 128 kb) are uploaded using the current connection and not the "upload" pool
+const SMALL_FILE_MAX_SIZE = 131072;
+const BIG_FILE_MIN_SIZE = 10485760; // files >10 MB are considered "big"
+const DEFAULT_FILE_NAME = 'unnamed';
+const REQUESTS_PER_CONNECTION = 3;
+const MAX_PART_COUNT = 4000; // 512 kb * 4000 = 2000 MiB
+const MAX_PART_COUNT_PREMIUM = 8000; // 512 kb * 8000 = 4000 MiB
+// @available=both
+/**
+ * Upload a file to Telegram servers, without actually
+ * sending a message anywhere. Useful when an `InputFile` is required.
+ *
+ * This method is quite low-level, and you should use other
+ * methods like {@link sendMedia} that handle this under the hood.
+ *
+ * @param params  Upload parameters
+ */
+async function uploadFile(client, params) {
+    // normalize params
+    let file = params.file;
+    let fileSize = -1; // unknown
+    let fileName = DEFAULT_FILE_NAME;
+    let fileMime = params.fileMime;
+    if (ArrayBuffer.isView(file)) {
+        fileSize = file.length;
+        file = (0, stream_utils_js_1.bufferToStream)(file);
+    }
+    if (typeof File !== 'undefined' && file instanceof File) {
+        fileName = file.name;
+        fileSize = file.size;
+        // file is now ReadableStream
+        file = file.stream();
+    }
+    if (typeof file === 'string') {
+        file = (0, _platform_js_1._createFileStream)(file);
+    }
+    if ((0, _platform_js_1._isFileStream)(file)) {
+        [fileName, fileSize] = await (0, _platform_js_1._extractFileStreamMeta)(file);
+        // fs.ReadStream is a subclass of Readable, will be handled below
+    }
+    if (typeof file === 'object' && 'headers' in file && 'body' in file && 'url' in file) {
+        // fetch() response
+        const length = parseInt(file.headers.get('content-length') || '0');
+        if (!isNaN(length) && length)
+            fileSize = length;
+        fileMime = file.headers.get('content-type')?.split(';')[0];
+        const disposition = file.headers.get('content-disposition');
+        if (disposition) {
+            const idx = disposition.indexOf('filename=');
+            if (idx > -1) {
+                const raw = disposition.slice(idx + 9).split(';')[0];
+                fileName = JSON.parse(raw);
+            }
+        }
+        if (fileName === DEFAULT_FILE_NAME) {
+            // try to infer from url
+            const url = new URL(file.url);
+            const name = url.pathname.split('/').pop();
+            if (name && name.includes('.')) {
+                fileName = name;
+            }
+        }
+        if (!file.body) {
+            throw new errors_js_1.MtArgumentError('Fetch response contains `null` body');
+        }
+        file = file.body;
+    }
+    file = (0, _platform_js_1._handleNodeStream)(file);
+    if (!(file instanceof ReadableStream)) {
+        throw new errors_js_1.MtArgumentError('Could not convert input `file` to stream!');
+    }
+    // override file name and mime (if any)
+    if (params.fileName)
+        fileName = params.fileName;
+    // set file size if not automatically inferred
+    if (fileSize === -1 && params.fileSize)
+        fileSize = params.fileSize;
+    if (fileSize === -1 && params.requireFileSize) {
+        // buffer the entire stream in memory, then convert it back to stream (bruh)
+        const buffer = await (0, stream_utils_js_1.streamToBuffer)(file);
+        fileSize = buffer.length;
+        file = (0, stream_utils_js_1.bufferToStream)(buffer);
+    }
+    let partSizeKb = params.partSize;
+    if (!partSizeKb) {
+        if (fileSize === -1) {
+            partSizeKb = params.estimatedSize ? (0, file_utils_js_1.determinePartSize)(params.estimatedSize) : 64;
+        }
+        else {
+            partSizeKb = (0, file_utils_js_1.determinePartSize)(fileSize);
+        }
+    }
+    if (partSizeKb > 512) {
+        throw new errors_js_1.MtArgumentError(`Invalid part size: ${partSizeKb}KB`);
+    }
+    const partSize = partSizeKb * 1024;
+    let partCount = fileSize === -1 ? -1 : ~~((fileSize + partSize - 1) / partSize);
+    const maxPartCount = client.storage.self.getCached()?.isPremium ? MAX_PART_COUNT_PREMIUM : MAX_PART_COUNT;
+    if (partCount > maxPartCount) {
+        throw new errors_js_1.MtArgumentError(`File is too large (max ${maxPartCount} parts, got ${partCount})`);
+    }
+    const isBig = fileSize === -1 || fileSize > BIG_FILE_MIN_SIZE;
+    const isSmall = fileSize !== -1 && fileSize < SMALL_FILE_MAX_SIZE;
+    const connectionKind = isSmall ? 'main' : 'upload';
+    // streamed uploads must be serialized, otherwise we'll get FILE_PART_SIZE_INVALID
+    const connectionPoolSize = Math.min(await client.getPoolSize(connectionKind), partCount);
+    const requestsPerConnection = params.requestsPerConnection ?? REQUESTS_PER_CONNECTION;
+    client.log.debug('uploading %d bytes file in %d chunks, each %d bytes in %s connection pool of size %d', fileSize, partCount, partSize, connectionKind, connectionPoolSize);
+    // why is the file id generated by the client?
+    // isn't the server supposed to generate it and handle collisions?
+    const fileId = (0, long_utils_js_1.randomLong)();
+    const stream = file;
+    let pos = 0;
+    let idx = 0;
+    const reader = (0, stream_utils_js_1.createChunkedReader)(stream, partSize);
+    const uploadNextPart = async () => {
+        const thisIdx = idx++;
+        let part = await reader.read();
+        if (!part && fileSize !== -1) {
+            throw new errors_js_1.MtArgumentError(`Unexpected EOS (there were only ${idx - 1} parts, but expected ${partCount})`);
+        }
+        if (fileSize === -1 && (reader.ended() || !part)) {
+            fileSize = pos + (part?.length ?? 0);
+            partCount = ~~((fileSize + partSize - 1) / partSize);
+            if (!part)
+                part = new Uint8Array(0);
+            client.log.debug('readable ended, file size = %d, part count = %d', fileSize, partCount);
+        }
+        if (!ArrayBuffer.isView(part)) {
+            throw new errors_js_1.MtArgumentError(`Part ${thisIdx} was not a Uint8Array!`);
+        }
+        if (part.length > partSize) {
+            throw new errors_js_1.MtArgumentError(`Part ${thisIdx} had invalid size (expected ${partSize}, got ${part.length})`);
+        }
+        if (thisIdx === 0 && fileMime === undefined) {
+            const mime = (0, file_type_js_1.guessFileMime)(part);
+            if (mime) {
+                fileMime = mime;
+            }
+            else {
+                // either plain text or random binary gibberish
+                // make an assumption based on the first 8 bytes
+                // if all 8 bytes are printable ASCII characters,
+                // the entire file is probably plain text
+                const isPlainText = (0, file_utils_js_1.isProbablyPlainText)(part.slice(0, 8));
+                fileMime = isPlainText ? 'text/plain' : 'application/octet-stream';
+            }
+        }
+        // why
+        const request = isBig ?
+            ({
+                _: 'upload.saveBigFilePart',
+                fileId,
+                filePart: thisIdx,
+                fileTotalParts: partCount,
+                bytes: part,
+            }) :
+            ({
+                _: 'upload.saveFilePart',
+                fileId,
+                filePart: thisIdx,
+                bytes: part,
+            });
+        const result = await client.call(request, { kind: connectionKind });
+        if (!result)
+            throw new Error(`Failed to upload part ${idx}`);
+        pos += part.length;
+        params.progressCallback?.(pos, fileSize);
+        if (idx === partCount)
+            return;
+        return uploadNextPart();
+    };
+    let poolSize = partCount === -1 ? 1 : connectionPoolSize * requestsPerConnection;
+    if (partCount !== -1 && poolSize > partCount)
+        poolSize = partCount;
+    await Promise.all(Array.from({ length: poolSize }, uploadNextPart));
+    let inputFile;
+    if (isBig) {
+        inputFile = {
+            _: 'inputFileBig',
+            id: fileId,
+            parts: partCount,
+            name: fileName,
+        };
+    }
+    else {
+        inputFile = {
+            _: 'inputFile',
+            id: fileId,
+            parts: partCount,
+            name: fileName,
+            md5Checksum: '', // tdlib doesn't do this, why should we?
+        };
+    }
+    if (fileMime in OVERRIDE_MIME)
+        fileMime = OVERRIDE_MIME[fileMime];
+    return {
+        inputFile,
+        size: fileSize,
+        mime: fileMime,
+    };
+}
+exports.uploadFile = uploadFile;
+//# sourceMappingURL=upload-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/upload-file.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtArgumentError } from '../../../types/errors.js'\nimport { randomLong } from '../../../utils/long-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { UploadedFile, UploadFileLike } from '../../types/index.js'\nimport { guessFileMime } from '../../utils/file-type.js'\nimport { determinePartSize, isProbablyPlainText } from '../../utils/file-utils.js'\nimport { bufferToStream, createChunkedReader, streamToBuffer } from '../../utils/stream-utils.js'\nimport { _createFileStream, _extractFileStreamMeta, _handleNodeStream, _isFileStream } from './_platform.js'\n\nconst OVERRIDE_MIME: Record<string, string> = {\n    // tg doesn't interpret `audio/opus` files as voice messages for some reason\n    'audio/opus': 'audio/ogg',\n}\n\n// small files (less than 128 kb) are uploaded using the current connection and not the \"upload\" pool\nconst SMALL_FILE_MAX_SIZE = 131072\nconst BIG_FILE_MIN_SIZE = 10485760 // files >10 MB are considered \"big\"\nconst DEFAULT_FILE_NAME = 'unnamed'\nconst REQUESTS_PER_CONNECTION = 3\nconst MAX_PART_COUNT = 4000 // 512 kb * 4000 = 2000 MiB\nconst MAX_PART_COUNT_PREMIUM = 8000 // 512 kb * 8000 = 4000 MiB\n\n// @available=both\n/**\n * Upload a file to Telegram servers, without actually\n * sending a message anywhere. Useful when an `InputFile` is required.\n *\n * This method is quite low-level, and you should use other\n * methods like {@link sendMedia} that handle this under the hood.\n *\n * @param params  Upload parameters\n */\nexport async function uploadFile(\n    client: ITelegramClient,\n    params: {\n        /**\n         * Upload file source.\n         *\n         * > **Note**: `fs.ReadStream` is a subclass of `stream.Readable` and contains\n         * > info about file name, thus you don't need to pass them explicitly.\n         */\n        file: UploadFileLike\n\n        /**\n         * File name for the uploaded file. Is usually inferred from path,\n         * but should be provided for files sent as `Buffer` or stream.\n         *\n         * When file name can't be inferred, it falls back to \"unnamed\"\n         */\n        fileName?: string\n\n        /**\n         * Total file size. Automatically inferred for Buffer, File and local files.\n         */\n        fileSize?: number\n\n        /**\n         * If the file size is unknown, you can provide an estimate,\n         * which will be used to determine appropriate part size.\n         */\n        estimatedSize?: number\n\n        /**\n         * File MIME type. By default is automatically inferred from magic number\n         * If MIME can't be inferred, it defaults to `application/octet-stream`\n         */\n        fileMime?: string\n\n        /**\n         * Upload part size (in KB).\n         *\n         * By default, automatically selected by file size.\n         * Must not be bigger than 512 and must not be a fraction.\n         */\n        partSize?: number\n\n        /**\n         * Number of parts to be sent in parallel per connection.\n         */\n        requestsPerConnection?: number\n\n        /**\n         * Function that will be called after some part has been uploaded.\n         *\n         * @param uploaded  Number of bytes already uploaded\n         * @param total  Total file size, if known\n         */\n        progressCallback?: (uploaded: number, total: number) => void\n\n        /**\n         * When using `inputMediaUploadedPhoto` (e.g. when sending an uploaded photo) require\n         * the file size to be known beforehand.\n         *\n         * In case this is set to `true`, a stream is passed as `file` and the file size is unknown,\n         * the stream will be buffered in memory and the file size will be inferred from the buffer.\n         */\n        requireFileSize?: boolean\n    },\n): Promise<UploadedFile> {\n    // normalize params\n    let file = params.file\n    let fileSize = -1 // unknown\n    let fileName = DEFAULT_FILE_NAME\n    let fileMime = params.fileMime\n\n    if (ArrayBuffer.isView(file)) {\n        fileSize = file.length\n        file = bufferToStream(file)\n    }\n\n    if (typeof File !== 'undefined' && file instanceof File) {\n        fileName = file.name\n        fileSize = file.size\n        // file is now ReadableStream\n        file = file.stream()\n    }\n\n    if (typeof file === 'string') {\n        file = _createFileStream(file)\n    }\n\n    if (_isFileStream(file)) {\n        [fileName, fileSize] = await _extractFileStreamMeta(file)\n        // fs.ReadStream is a subclass of Readable, will be handled below\n    }\n\n    if (typeof file === 'object' && 'headers' in file && 'body' in file && 'url' in file) {\n        // fetch() response\n        const length = parseInt(file.headers.get('content-length') || '0')\n        if (!isNaN(length) && length) fileSize = length\n\n        fileMime = file.headers.get('content-type')?.split(';')[0]\n\n        const disposition = file.headers.get('content-disposition')\n\n        if (disposition) {\n            const idx = disposition.indexOf('filename=')\n\n            if (idx > -1) {\n                const raw = disposition.slice(idx + 9).split(';')[0]\n                fileName = JSON.parse(raw) as string\n            }\n        }\n\n        if (fileName === DEFAULT_FILE_NAME) {\n            // try to infer from url\n            const url = new URL(file.url)\n            const name = url.pathname.split('/').pop()\n\n            if (name && name.includes('.')) {\n                fileName = name\n            }\n        }\n\n        if (!file.body) {\n            throw new MtArgumentError('Fetch response contains `null` body')\n        }\n\n        file = file.body\n    }\n\n    file = _handleNodeStream(file)\n\n    if (!(file instanceof ReadableStream)) {\n        throw new MtArgumentError('Could not convert input `file` to stream!')\n    }\n\n    // override file name and mime (if any)\n    if (params.fileName) fileName = params.fileName\n\n    // set file size if not automatically inferred\n    if (fileSize === -1 && params.fileSize) fileSize = params.fileSize\n\n    if (fileSize === -1 && params.requireFileSize) {\n        // buffer the entire stream in memory, then convert it back to stream (bruh)\n        const buffer = await streamToBuffer(file)\n        fileSize = buffer.length\n        file = bufferToStream(buffer)\n    }\n\n    let partSizeKb = params.partSize\n\n    if (!partSizeKb) {\n        if (fileSize === -1) {\n            partSizeKb = params.estimatedSize ? determinePartSize(params.estimatedSize) : 64\n        } else {\n            partSizeKb = determinePartSize(fileSize)\n        }\n    }\n\n    if (partSizeKb > 512) {\n        throw new MtArgumentError(`Invalid part size: ${partSizeKb}KB`)\n    }\n    const partSize = partSizeKb * 1024\n\n    let partCount = fileSize === -1 ? -1 : ~~((fileSize + partSize - 1) / partSize)\n    const maxPartCount = client.storage.self.getCached()?.isPremium ? MAX_PART_COUNT_PREMIUM : MAX_PART_COUNT\n\n    if (partCount > maxPartCount) {\n        throw new MtArgumentError(`File is too large (max ${maxPartCount} parts, got ${partCount})`)\n    }\n\n    const isBig = fileSize === -1 || fileSize > BIG_FILE_MIN_SIZE\n    const isSmall = fileSize !== -1 && fileSize < SMALL_FILE_MAX_SIZE\n    const connectionKind = isSmall ? 'main' : 'upload'\n    // streamed uploads must be serialized, otherwise we'll get FILE_PART_SIZE_INVALID\n    const connectionPoolSize = Math.min(await client.getPoolSize(connectionKind), partCount)\n    const requestsPerConnection = params.requestsPerConnection ?? REQUESTS_PER_CONNECTION\n\n    client.log.debug(\n        'uploading %d bytes file in %d chunks, each %d bytes in %s connection pool of size %d',\n        fileSize,\n        partCount,\n        partSize,\n        connectionKind,\n        connectionPoolSize,\n    )\n\n    // why is the file id generated by the client?\n    // isn't the server supposed to generate it and handle collisions?\n    const fileId = randomLong()\n    const stream = file\n\n    let pos = 0\n    let idx = 0\n    const reader = createChunkedReader(stream, partSize)\n\n    const uploadNextPart = async (): Promise<void> => {\n        const thisIdx = idx++\n\n        let part = await reader.read()\n\n        if (!part && fileSize !== -1) {\n            throw new MtArgumentError(`Unexpected EOS (there were only ${idx - 1} parts, but expected ${partCount})`)\n        }\n\n        if (fileSize === -1 && (reader.ended() || !part)) {\n            fileSize = pos + (part?.length ?? 0)\n            partCount = ~~((fileSize + partSize - 1) / partSize)\n            if (!part) part = new Uint8Array(0)\n            client.log.debug('readable ended, file size = %d, part count = %d', fileSize, partCount)\n        }\n\n        if (!ArrayBuffer.isView(part)) {\n            throw new MtArgumentError(`Part ${thisIdx} was not a Uint8Array!`)\n        }\n        if (part.length > partSize) {\n            throw new MtArgumentError(`Part ${thisIdx} had invalid size (expected ${partSize}, got ${part.length})`)\n        }\n\n        if (thisIdx === 0 && fileMime === undefined) {\n            const mime = guessFileMime(part)\n\n            if (mime) {\n                fileMime = mime\n            } else {\n                // either plain text or random binary gibberish\n                // make an assumption based on the first 8 bytes\n                // if all 8 bytes are printable ASCII characters,\n                // the entire file is probably plain text\n                const isPlainText = isProbablyPlainText(part.slice(0, 8))\n                fileMime = isPlainText ? 'text/plain' : 'application/octet-stream'\n            }\n        }\n\n        // why\n        const request = isBig ?\n            ({\n                _: 'upload.saveBigFilePart',\n                fileId,\n                filePart: thisIdx,\n                fileTotalParts: partCount,\n                bytes: part,\n            } satisfies tl.upload.RawSaveBigFilePartRequest) :\n            ({\n                _: 'upload.saveFilePart',\n                fileId,\n                filePart: thisIdx,\n                bytes: part,\n            } satisfies tl.upload.RawSaveFilePartRequest)\n\n        const result = await client.call(request, { kind: connectionKind })\n        if (!result) throw new Error(`Failed to upload part ${idx}`)\n\n        pos += part.length\n\n        params.progressCallback?.(pos, fileSize)\n\n        if (idx === partCount) return\n\n        return uploadNextPart()\n    }\n\n    let poolSize = partCount === -1 ? 1 : connectionPoolSize * requestsPerConnection\n    if (partCount !== -1 && poolSize > partCount) poolSize = partCount\n\n    await Promise.all(Array.from({ length: poolSize }, uploadNextPart))\n\n    let inputFile: tl.TypeInputFile\n\n    if (isBig) {\n        inputFile = {\n            _: 'inputFileBig',\n            id: fileId,\n            parts: partCount,\n            name: fileName,\n        }\n    } else {\n        inputFile = {\n            _: 'inputFile',\n            id: fileId,\n            parts: partCount,\n            name: fileName,\n            md5Checksum: '', // tdlib doesn't do this, why should we?\n        }\n    }\n\n    if (fileMime! in OVERRIDE_MIME) fileMime = OVERRIDE_MIME[fileMime!]\n\n    return {\n        inputFile,\n        size: fileSize,\n        mime: fileMime!,\n    }\n}\n"]}

package/cjs/highlevel/methods/files/upload-media.d.ts

@@ -0,0 +1,28 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputMediaLike, InputPeerLike, MessageMedia, Photo, RawDocument } from '../../types/index.js';
+/**
+ * Upload a media to Telegram servers, without actually
+ * sending a message anywhere. Useful when File ID is needed.
+ *
+ * The difference with {@link uploadFile} is that
+ * the returned object will act like a message media
+ * and contain fields like File ID.
+ *
+ * @param media  Media to upload
+ * @param params  Upload parameters
+ */
+export declare function uploadMedia(client: ITelegramClient, media: InputMediaLike, params?: {
+    /**
+     * Peer to associate this media with.
+     *
+     * @default  `self`
+     */
+    peer?: InputPeerLike;
+    /**
+     * Upload progress callback
+     *
+     * @param uploaded  Number of bytes uploaded
+     * @param total  Total file size
+     */
+    progressCallback?: (uploaded: number, total: number) => void;
+}): Promise<Extract<MessageMedia, Photo | RawDocument>>;

package/cjs/highlevel/methods/files/upload-media.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadMedia = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+const utils_js_1 = require("../../../types/utils.js");
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const index_js_1 = require("../../types/index.js");
+const document_utils_js_1 = require("../../types/media/document-utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+const normalize_input_media_js_1 = require("./normalize-input-media.js");
+/**
+ * Upload a media to Telegram servers, without actually
+ * sending a message anywhere. Useful when File ID is needed.
+ *
+ * The difference with {@link uploadFile} is that
+ * the returned object will act like a message media
+ * and contain fields like File ID.
+ *
+ * @param media  Media to upload
+ * @param params  Upload parameters
+ */
+async function uploadMedia(client, media, params = {}) {
+    const normMedia = await (0, normalize_input_media_js_1._normalizeInputMedia)(client, media, params, false);
+    switch (normMedia._) {
+        case 'inputMediaEmpty':
+        case 'inputMediaGeoPoint':
+        case 'inputMediaGeoLive':
+        case 'inputMediaContact':
+        case 'inputMediaVenue':
+        case 'inputMediaGame':
+        case 'inputMediaInvoice':
+        case 'inputMediaPoll':
+        case 'inputMediaDice':
+            throw new errors_js_1.MtArgumentError("This media can't be uploaded");
+    }
+    const res = await client.call({
+        _: 'messages.uploadMedia',
+        peer: params.peer ?
+            await (0, resolve_peer_js_1.resolvePeer)(client, params.peer) :
+            {
+                _: 'inputPeerSelf',
+            },
+        media: normMedia,
+    });
+    (0, type_assertions_js_1.assertTypeIsNot)('uploadMedia', res, 'messageMediaEmpty');
+    switch (normMedia._) {
+        case 'inputMediaUploadedPhoto':
+        case 'inputMediaPhoto':
+        case 'inputMediaPhotoExternal':
+            (0, type_assertions_js_1.assertTypeIs)('uploadMedia', res, 'messageMediaPhoto');
+            (0, type_assertions_js_1.assertTypeIs)('uploadMedia', res.photo, 'photo');
+            return new index_js_1.Photo(res.photo);
+        case 'inputMediaUploadedDocument':
+        case 'inputMediaDocument':
+        case 'inputMediaDocumentExternal':
+            (0, type_assertions_js_1.assertTypeIs)('uploadMedia', res, 'messageMediaDocument');
+            (0, type_assertions_js_1.assertTypeIs)('uploadMedia', res.document, 'document');
+            // eslint-disable-next-line
+            return (0, document_utils_js_1.parseDocument)(res.document, res);
+        case 'inputMediaStory':
+        case 'inputMediaWebPage':
+            throw new errors_js_1.MtArgumentError(`This media (${normMedia._}) can't be uploaded`);
+        default:
+            (0, utils_js_1.assertNever)(normMedia);
+    }
+}
+exports.uploadMedia = uploadMedia;
+//# sourceMappingURL=upload-media.js.map

package/cjs/highlevel/methods/files/upload-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-media.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/upload-media.ts"],"names":[],"mappings":";;;AAAA,wDAA0D;AAC1D,sDAAqD;AACrD,0EAAiF;AAEjF,mDAAsG;AACtG,2EAAmE;AACnE,8DAAsD;AACtD,yEAAiE;AAEjE;;;;;;;;;;GAUG;AACI,KAAK,UAAU,WAAW,CAC7B,MAAuB,EACvB,KAAqB,EACrB,SAeI,EAAE;IAEN,MAAM,SAAS,GAAG,MAAM,IAAA,+CAAoB,EAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IAE1E,QAAQ,SAAS,CAAC,CAAC,EAAE;QACjB,KAAK,iBAAiB,CAAC;QACvB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,mBAAmB,CAAC;QACzB,KAAK,mBAAmB,CAAC;QACzB,KAAK,iBAAiB,CAAC;QACvB,KAAK,gBAAgB,CAAC;QACtB,KAAK,mBAAmB,CAAC;QACzB,KAAK,gBAAgB,CAAC;QACtB,KAAK,gBAAgB;YACjB,MAAM,IAAI,2BAAe,CAAC,8BAA8B,CAAC,CAAA;KAChE;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,sBAAsB;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACf,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACxC;gBACI,CAAC,EAAE,eAAe;aACrB;QACL,KAAK,EAAE,SAAS;KACnB,CAAC,CAAA;IAEF,IAAA,oCAAe,EAAC,aAAa,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAA;IAExD,QAAQ,SAAS,CAAC,CAAC,EAAE;QACjB,KAAK,yBAAyB,CAAC;QAC/B,KAAK,iBAAiB,CAAC;QACvB,KAAK,yBAAyB;YAC1B,IAAA,iCAAY,EAAC,aAAa,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAA;YACrD,IAAA,iCAAY,EAAC,aAAa,EAAE,GAAG,CAAC,KAAM,EAAE,OAAO,CAAC,CAAA;YAEhD,OAAO,IAAI,gBAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC/B,KAAK,4BAA4B,CAAC;QAClC,KAAK,oBAAoB,CAAC;QAC1B,KAAK,4BAA4B;YAC7B,IAAA,iCAAY,EAAC,aAAa,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAA;YACxD,IAAA,iCAAY,EAAC,aAAa,EAAE,GAAG,CAAC,QAAS,EAAE,UAAU,CAAC,CAAA;YAEtD,2BAA2B;YAC3B,OAAO,IAAA,iCAAa,EAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAQ,CAAA;QAClD,KAAK,iBAAiB,CAAC;QACvB,KAAK,mBAAmB;YACpB,MAAM,IAAI,2BAAe,CAAC,eAAe,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAA;QAC9E;YACI,IAAA,sBAAW,EAAC,SAAS,CAAC,CAAA;KAC7B;AACL,CAAC;AArED,kCAqEC","sourcesContent":["import { MtArgumentError } from '../../../types/errors.js'\nimport { assertNever } from '../../../types/utils.js'\nimport { assertTypeIs, assertTypeIsNot } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputMediaLike, InputPeerLike, MessageMedia, Photo, RawDocument } from '../../types/index.js'\nimport { parseDocument } from '../../types/media/document-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { _normalizeInputMedia } from './normalize-input-media.js'\n\n/**\n * Upload a media to Telegram servers, without actually\n * sending a message anywhere. Useful when File ID is needed.\n *\n * The difference with {@link uploadFile} is that\n * the returned object will act like a message media\n * and contain fields like File ID.\n *\n * @param media  Media to upload\n * @param params  Upload parameters\n */\nexport async function uploadMedia(\n    client: ITelegramClient,\n    media: InputMediaLike,\n    params: {\n        /**\n         * Peer to associate this media with.\n         *\n         * @default  `self`\n         */\n        peer?: InputPeerLike\n\n        /**\n         * Upload progress callback\n         *\n         * @param uploaded  Number of bytes uploaded\n         * @param total  Total file size\n         */\n        progressCallback?: (uploaded: number, total: number) => void\n    } = {},\n): Promise<Extract<MessageMedia, Photo | RawDocument>> {\n    const normMedia = await _normalizeInputMedia(client, media, params, false)\n\n    switch (normMedia._) {\n        case 'inputMediaEmpty':\n        case 'inputMediaGeoPoint':\n        case 'inputMediaGeoLive':\n        case 'inputMediaContact':\n        case 'inputMediaVenue':\n        case 'inputMediaGame':\n        case 'inputMediaInvoice':\n        case 'inputMediaPoll':\n        case 'inputMediaDice':\n            throw new MtArgumentError(\"This media can't be uploaded\")\n    }\n\n    const res = await client.call({\n        _: 'messages.uploadMedia',\n        peer: params.peer ?\n            await resolvePeer(client, params.peer) :\n            {\n                _: 'inputPeerSelf',\n            },\n        media: normMedia,\n    })\n\n    assertTypeIsNot('uploadMedia', res, 'messageMediaEmpty')\n\n    switch (normMedia._) {\n        case 'inputMediaUploadedPhoto':\n        case 'inputMediaPhoto':\n        case 'inputMediaPhotoExternal':\n            assertTypeIs('uploadMedia', res, 'messageMediaPhoto')\n            assertTypeIs('uploadMedia', res.photo!, 'photo')\n\n            return new Photo(res.photo)\n        case 'inputMediaUploadedDocument':\n        case 'inputMediaDocument':\n        case 'inputMediaDocumentExternal':\n            assertTypeIs('uploadMedia', res, 'messageMediaDocument')\n            assertTypeIs('uploadMedia', res.document!, 'document')\n\n            // eslint-disable-next-line\n            return parseDocument(res.document, res) as any\n        case 'inputMediaStory':\n        case 'inputMediaWebPage':\n            throw new MtArgumentError(`This media (${normMedia._}) can't be uploaded`)\n        default:\n            assertNever(normMedia)\n    }\n}\n"]}

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

@@ -0,0 +1,36 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Message } from '../../types/index.js';
+/**
+ * Create a topic in a forum
+ *
+ * Only admins with `manageTopics` permission can do this.
+ *
+ * @returns  Service message for the created topic
+ */
+export declare function createForumTopic(client: ITelegramClient, params: {
+    /** Chat ID or username */
+    chatId: InputPeerLike;
+    /**
+     * Topic title
+     */
+    title: string;
+    /**
+     * Icon of the topic.
+     *
+     * Can be a number (color in RGB, see {@link ForumTopic} static members for allowed values)
+     * or a custom emoji ID.
+     *
+     * Icon color can't be changed after the topic is created.
+     */
+    icon?: number | tl.Long;
+    /**
+     * Send as a specific channel
+     */
+    sendAs?: InputPeerLike;
+    /**
+     * Whether to dispatch the returned service message (if any)
+     * to the client's update handler.
+     */
+    shouldDispatch?: true;
+}): Promise<Message>;

package/cjs/highlevel/methods/forums/create-forum-topic.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createForumTopic = void 0;
+const long_utils_js_1 = require("../../../utils/long-utils.js");
+const find_in_update_js_1 = require("../messages/find-in-update.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+/**
+ * Create a topic in a forum
+ *
+ * Only admins with `manageTopics` permission can do this.
+ *
+ * @returns  Service message for the created topic
+ */
+async function createForumTopic(client, params) {
+    const { chatId, title, icon, sendAs, shouldDispatch } = params;
+    const res = await client.call({
+        _: 'channels.createForumTopic',
+        channel: await (0, resolve_peer_js_1.resolveChannel)(client, chatId),
+        title,
+        iconColor: typeof icon === 'number' ? icon : undefined,
+        iconEmojiId: typeof icon !== 'number' ? icon : undefined,
+        sendAs: sendAs ? await (0, resolve_peer_js_1.resolvePeer)(client, sendAs) : undefined,
+        randomId: (0, long_utils_js_1.randomLong)(),
+    });
+    return (0, find_in_update_js_1._findMessageInUpdate)(client, res, false, !shouldDispatch);
+}
+exports.createForumTopic = createForumTopic;
+//# sourceMappingURL=create-forum-topic.js.map

package/cjs/highlevel/methods/forums/create-forum-topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-forum-topic.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/forums/create-forum-topic.ts"],"names":[],"mappings":";;;AAEA,gEAAyD;AAGzD,qEAAoE;AACpE,8DAAsE;AAEtE;;;;;;GAMG;AACI,KAAK,UAAU,gBAAgB,CAClC,MAAuB,EACvB,MA6BC;IAED,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAAA;IAE9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,2BAA2B;QAC9B,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,MAAM,EAAE,MAAM,CAAC;QAC7C,KAAK;QACL,SAAS,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACtD,WAAW,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACxD,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9D,QAAQ,EAAE,IAAA,0BAAU,GAAE;KACzB,CAAC,CAAA;IAEF,OAAO,IAAA,wCAAoB,EAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,cAAc,CAAC,CAAA;AACpE,CAAC;AA9CD,4CA8CC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { randomLong } from '../../../utils/long-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, Message } from '../../types/index.js'\nimport { _findMessageInUpdate } from '../messages/find-in-update.js'\nimport { resolveChannel, resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Create a topic in a forum\n *\n * Only admins with `manageTopics` permission can do this.\n *\n * @returns  Service message for the created topic\n */\nexport async function createForumTopic(\n    client: ITelegramClient,\n    params: {\n        /** Chat ID or username */\n        chatId: InputPeerLike\n\n        /**\n         * Topic title\n         */\n        title: string\n\n        /**\n         * Icon of the topic.\n         *\n         * Can be a number (color in RGB, see {@link ForumTopic} static members for allowed values)\n         * or a custom emoji ID.\n         *\n         * Icon color can't be changed after the topic is created.\n         */\n        icon?: number | tl.Long\n\n        /**\n         * Send as a specific channel\n         */\n        sendAs?: InputPeerLike\n\n        /**\n         * Whether to dispatch the returned service message (if any)\n         * to the client's update handler.\n         */\n        shouldDispatch?: true\n    },\n): Promise<Message> {\n    const { chatId, title, icon, sendAs, shouldDispatch } = params\n\n    const res = await client.call({\n        _: 'channels.createForumTopic',\n        channel: await resolveChannel(client, chatId),\n        title,\n        iconColor: typeof icon === 'number' ? icon : undefined,\n        iconEmojiId: typeof icon !== 'number' ? icon : undefined,\n        sendAs: sendAs ? await resolvePeer(client, sendAs) : undefined,\n        randomId: randomLong(),\n    })\n\n    return _findMessageInUpdate(client, res, false, !shouldDispatch)\n}\n"]}

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

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import type { ForumTopic, InputPeerLike } from '../../types/index.js';
+/**
+ * Delete a forum topic and all its history
+ *
+ * @param chat  Chat or user ID, username, phone number, `"me"` or `"self"`
+ * @param topicId  ID of the topic (i.e. its top message ID)
+ */
+export declare function deleteForumTopicHistory(client: ITelegramClient, chat: InputPeerLike, topicId: number | ForumTopic): Promise<void>;

package/cjs/highlevel/methods/forums/delete-forum-topic-history.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteForumTopicHistory = void 0;
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const utils_js_1 = require("../../updates/utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+/**
+ * Delete a forum topic and all its history
+ *
+ * @param chat  Chat or user ID, username, phone number, `"me"` or `"self"`
+ * @param topicId  ID of the topic (i.e. its top message ID)
+ */
+async function deleteForumTopicHistory(client, chat, topicId) {
+    const channel = await (0, resolve_peer_js_1.resolveChannel)(client, chat);
+    (0, type_assertions_js_1.assertTypeIsNot)('deleteForumTopicHistory', channel, 'inputChannelEmpty');
+    const res = await client.call({
+        _: 'channels.deleteTopicHistory',
+        channel,
+        topMsgId: typeof topicId === 'number' ? topicId : topicId.id,
+    });
+    client.handleClientUpdate((0, utils_js_1.createDummyUpdate)(res.pts, res.ptsCount, channel.channelId));
+}
+exports.deleteForumTopicHistory = deleteForumTopicHistory;
+//# sourceMappingURL=delete-forum-topic-history.js.map

package/cjs/highlevel/methods/forums/delete-forum-topic-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-forum-topic-history.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/forums/delete-forum-topic-history.ts"],"names":[],"mappings":";;;AAAA,0EAAmE;AAGnE,qDAA0D;AAC1D,8DAAyD;AAEzD;;;;;GAKG;AACI,KAAK,UAAU,uBAAuB,CACzC,MAAuB,EACvB,IAAmB,EACnB,OAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,IAAA,gCAAc,EAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAClD,IAAA,oCAAe,EAAC,yBAAyB,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAA;IAExE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,6BAA6B;QAChC,OAAO;QACP,QAAQ,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;KAC/D,CAAC,CAAA;IAEF,MAAM,CAAC,kBAAkB,CAAC,IAAA,4BAAiB,EAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;AAC1F,CAAC;AAfD,0DAeC","sourcesContent":["import { assertTypeIsNot } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport type { ForumTopic, InputPeerLike } from '../../types/index.js'\nimport { createDummyUpdate } from '../../updates/utils.js'\nimport { resolveChannel } from '../users/resolve-peer.js'\n\n/**\n * Delete a forum topic and all its history\n *\n * @param chat  Chat or user ID, username, phone number, `\"me\"` or `\"self\"`\n * @param topicId  ID of the topic (i.e. its top message ID)\n */\nexport async function deleteForumTopicHistory(\n    client: ITelegramClient,\n    chat: InputPeerLike,\n    topicId: number | ForumTopic,\n): Promise<void> {\n    const channel = await resolveChannel(client, chat)\n    assertTypeIsNot('deleteForumTopicHistory', channel, 'inputChannelEmpty')\n\n    const res = await client.call({\n        _: 'channels.deleteTopicHistory',\n        channel,\n        topMsgId: typeof topicId === 'number' ? topicId : topicId.id,\n    })\n\n    client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount, channel.channelId))\n}\n"]}

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

@@ -0,0 +1,34 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import type { ForumTopic, InputPeerLike, Message } from '../../types/index.js';
+/**
+ * Modify a topic in a forum
+ *
+ * Only admins with `manageTopics` permission can do this.
+ *
+ * @param chatId  Chat ID or username
+ * @param topicId  ID of the topic (i.e. its top message ID)
+ * @returns  Service message about the modification
+ */
+export declare function editForumTopic(client: ITelegramClient, params: {
+    /** Chat ID or username */
+    chatId: InputPeerLike;
+    /** ID of the topic (i.e. its top message ID) */
+    topicId: number | ForumTopic;
+    /**
+     * New topic title
+     */
+    title?: string;
+    /**
+     * New icon of the topic.
+     *
+     * Can be a custom emoji ID, or `null` to remove the icon
+     * and use static color instead
+     */
+    icon?: tl.Long | null;
+    /**
+     * Whether to dispatch the returned service message (if any)
+     * to the client's update handler.
+     */
+    shouldDispatch?: true;
+}): Promise<Message>;

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

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.editForumTopic = void 0;
+const long_1 = __importDefault(require("long"));
+const find_in_update_js_1 = require("../messages/find-in-update.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+/**
+ * Modify a topic in a forum
+ *
+ * Only admins with `manageTopics` permission can do this.
+ *
+ * @param chatId  Chat ID or username
+ * @param topicId  ID of the topic (i.e. its top message ID)
+ * @returns  Service message about the modification
+ */
+async function editForumTopic(client, params) {
+    const { chatId, topicId, title, icon, shouldDispatch } = params;
+    const res = await client.call({
+        _: 'channels.editForumTopic',
+        channel: await (0, resolve_peer_js_1.resolveChannel)(client, chatId),
+        topicId: typeof topicId === 'number' ? topicId : topicId.id,
+        title,
+        iconEmojiId: icon ? icon ?? long_1.default.ZERO : undefined,
+    });
+    return (0, find_in_update_js_1._findMessageInUpdate)(client, res, false, shouldDispatch);
+}
+exports.editForumTopic = editForumTopic;
+//# sourceMappingURL=edit-forum-topic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit-forum-topic.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/forums/edit-forum-topic.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAuB;AAMvB,qEAAoE;AACpE,8DAAyD;AAEzD;;;;;;;;GAQG;AACI,KAAK,UAAU,cAAc,CAChC,MAAuB,EACvB,MAyBC;IAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,CAAA;IAE/D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,yBAAyB;QAC5B,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,MAAM,EAAE,MAAM,CAAC;QAC7C,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;QAC3D,KAAK;QACL,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,cAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACpD,CAAC,CAAA;IAEF,OAAO,IAAA,wCAAoB,EAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,CAAA;AACnE,CAAC;AAxCD,wCAwCC","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport type { ForumTopic, InputPeerLike, Message } from '../../types/index.js'\nimport { _findMessageInUpdate } from '../messages/find-in-update.js'\nimport { resolveChannel } from '../users/resolve-peer.js'\n\n/**\n * Modify a topic in a forum\n *\n * Only admins with `manageTopics` permission can do this.\n *\n * @param chatId  Chat ID or username\n * @param topicId  ID of the topic (i.e. its top message ID)\n * @returns  Service message about the modification\n */\nexport async function editForumTopic(\n    client: ITelegramClient,\n    params: {\n        /** Chat ID or username */\n        chatId: InputPeerLike\n\n        /** ID of the topic (i.e. its top message ID) */\n        topicId: number | ForumTopic\n\n        /**\n         * New topic title\n         */\n        title?: string\n\n        /**\n         * New icon of the topic.\n         *\n         * Can be a custom emoji ID, or `null` to remove the icon\n         * and use static color instead\n         */\n        icon?: tl.Long | null\n\n        /**\n         * Whether to dispatch the returned service message (if any)\n         * to the client's update handler.\n         */\n        shouldDispatch?: true\n    },\n): Promise<Message> {\n    const { chatId, topicId, title, icon, shouldDispatch } = params\n\n    const res = await client.call({\n        _: 'channels.editForumTopic',\n        channel: await resolveChannel(client, chatId),\n        topicId: typeof topicId === 'number' ? topicId : topicId.id,\n        title,\n        iconEmojiId: icon ? icon ?? Long.ZERO : undefined,\n    })\n\n    return _findMessageInUpdate(client, res, false, shouldDispatch)\n}\n"]}

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

@@ -0,0 +1,9 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { ForumTopic, InputPeerLike } from '../../types/index.js';
+/**
+ * Get forum topics by their IDs
+ *
+ * @param chatId  Chat ID or username
+ */
+export declare function getForumTopicsById(client: ITelegramClient, chatId: InputPeerLike, ids: MaybeArray<number>): Promise<ForumTopic[]>;

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getForumTopicsById = void 0;
+const index_js_1 = require("../../types/index.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+/**
+ * Get forum topics by their IDs
+ *
+ * @param chatId  Chat ID or username
+ */
+async function getForumTopicsById(client, chatId, ids) {
+    if (!Array.isArray(ids))
+        ids = [ids];
+    const res = await client.call({
+        _: 'channels.getForumTopicsByID',
+        channel: await (0, resolve_peer_js_1.resolveChannel)(client, chatId),
+        topics: ids,
+    });
+    return index_js_1.ForumTopic.parseTlForumTopics(res);
+}
+exports.getForumTopicsById = getForumTopicsById;
+//# sourceMappingURL=get-forum-topics-by-id.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-forum-topics-by-id.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/forums/get-forum-topics-by-id.ts"],"names":[],"mappings":";;;AAEA,mDAAgE;AAChE,8DAAyD;AAEzD;;;;GAIG;AACI,KAAK,UAAU,kBAAkB,CACpC,MAAuB,EACvB,MAAqB,EACrB,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,6BAA6B;QAChC,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,MAAM,EAAE,MAAM,CAAC;QAC7C,MAAM,EAAE,GAAG;KACd,CAAC,CAAA;IAEF,OAAO,qBAAU,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAA;AAC7C,CAAC;AAdD,gDAcC","sourcesContent":["import { MaybeArray } from '../../../types/utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { ForumTopic, InputPeerLike } from '../../types/index.js'\nimport { resolveChannel } from '../users/resolve-peer.js'\n\n/**\n * Get forum topics by their IDs\n *\n * @param chatId  Chat ID or username\n */\nexport async function getForumTopicsById(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    ids: MaybeArray<number>,\n): Promise<ForumTopic[]> {\n    if (!Array.isArray(ids)) ids = [ids]\n\n    const res = await client.call({\n        _: 'channels.getForumTopicsByID',\n        channel: await resolveChannel(client, chatId),\n        topics: ids,\n    })\n\n    return ForumTopic.parseTlForumTopics(res)\n}\n"]}

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

@@ -0,0 +1,28 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayPaginated, ForumTopic, InputPeerLike } from '../../types/index.js';
+export interface GetForumTopicsOffset {
+    date: number;
+    id: number;
+    topic: number;
+}
+/**
+ * Get forum topics
+ *
+ * @param chatId  Chat ID or username
+ */
+export declare function getForumTopics(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * Search query
+     */
+    query?: string;
+    /**
+     * Offset for pagination
+     */
+    offset?: GetForumTopicsOffset;
+    /**
+     * Maximum number of topics to return.
+     *
+     * @default  100
+     */
+    limit?: number;
+}): Promise<ArrayPaginated<ForumTopic, GetForumTopicsOffset>>;