@mtcute/core 0.5.0 → 0.7.0

package/esm/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,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,IAAI,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC,OAAO,EAAgD,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAuB,EACvB,QAAgB,EAChB,QAA8B,EAC9B,MAA+B;IAE/B,IAAI,QAAQ,YAAY,YAAY,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAC3E,gCAAgC;QAChC,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;KAC/C;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,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,MAAM,CAAC,QAAQ,CAAC,CAAA;QACpB,CAAC,CAAC,CAAA;KACL;IAED,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;QACpE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;KACtB;IAED,MAAM,CAAC,GAAG,EAAE,CAAA;AAChB,CAAC","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/esm/highlevel/methods/files/download-file.web.d.ts

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

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

@@ -0,0 +1,5 @@
+import { MtUnsupportedError } from '../../../types/errors.js';
+export function downloadToFile() {
+    throw new MtUnsupportedError('Downloading to file is only supported in NodeJS');
+}
+//# sourceMappingURL=download-file.web.js.map

package/esm/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,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAE7D,MAAM,UAAU,cAAc;IAC1B,MAAM,IAAI,kBAAkB,CAAC,iDAAiD,CAAC,CAAA;AACnF,CAAC","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/esm/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>;

package/esm/highlevel/methods/files/download-iterable.js

@@ -0,0 +1,180 @@
+import { parseFileId } from '@mtcute/file-id';
+import { tl } from '@mtcute/tl';
+import { MtArgumentError, MtUnsupportedError } from '../../../types/errors.js';
+import { ConditionVariable } from '../../../utils/condition-variable.js';
+import { FileLocation } from '../../types/index.js';
+import { fileIdToInputFileLocation, fileIdToInputWebFileLocation } from '../../utils/convert-file-id.js';
+import { determinePartSize } from '../../utils/file-utils.js';
+// small files (less than 128 kb) are downloaded using the "downloadSmall" pool
+// furthermore, if the file is small and is located on our main DC, it will be downloaded
+// using the current main connection
+const SMALL_FILE_MAX_SIZE = 131072;
+const REQUESTS_PER_CONNECTION = 3; // some arbitrary magic value that seems to work best
+/**
+ * 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 async function* downloadAsIterable(client, input, params) {
+    const offset = params?.offset ?? 0;
+    if (offset % 4096 !== 0) {
+        throw new MtArgumentError(`Invalid offset: ${offset}. Must be divisible by 4096`);
+    }
+    let dcId = params?.dcId;
+    let fileSize = params?.fileSize;
+    const abortSignal = params?.abortSignal;
+    let aborted = false;
+    let location;
+    if (input instanceof FileLocation) {
+        let locationInner = input.location;
+        if (typeof locationInner === 'function') {
+            locationInner = locationInner();
+        }
+        if (ArrayBuffer.isView(locationInner)) {
+            yield locationInner;
+            return;
+        }
+        if (!dcId)
+            dcId = input.dcId;
+        if (!fileSize)
+            fileSize = input.fileSize;
+        location = locationInner;
+    }
+    else if (typeof input === 'string') {
+        const parsed = parseFileId(input);
+        if (parsed.location._ === 'web') {
+            location = fileIdToInputWebFileLocation(parsed);
+        }
+        else {
+            location = fileIdToInputFileLocation(parsed);
+        }
+    }
+    else
+        location = input;
+    const isWeb = tl.isAnyInputWebFileLocation(location);
+    // we will receive a FileMigrateError in case this is invalid
+    const primaryDcId = await client.getPrimaryDcId();
+    if (!dcId)
+        dcId = primaryDcId;
+    const partSizeKb = params?.partSize ?? (fileSize ? determinePartSize(fileSize) : 64);
+    if (partSizeKb % 4 !== 0) {
+        throw new MtArgumentError(`Invalid part size: ${partSizeKb}. Must be divisible by 4.`);
+    }
+    const chunkSize = partSizeKb * 1024;
+    let limitBytes = params?.limit ?? fileSize ?? Infinity;
+    if (limitBytes === 0)
+        return;
+    let numChunks = limitBytes === Infinity ? Infinity : ~~((limitBytes + chunkSize - offset - 1) / chunkSize);
+    let nextChunkIdx = 0;
+    let nextWorkerChunkIdx = 0;
+    const nextChunkCv = new ConditionVariable();
+    const buffer = {};
+    const isSmall = fileSize && fileSize <= SMALL_FILE_MAX_SIZE;
+    let connectionKind;
+    if (isSmall) {
+        connectionKind = dcId === primaryDcId ? 'main' : 'downloadSmall';
+    }
+    else {
+        connectionKind = 'download';
+    }
+    const poolSize = await client.getPoolSize(connectionKind, dcId);
+    client.log.debug('Downloading file of size %d from dc %d using %s connection pool (pool size: %d)', limitBytes, dcId, connectionKind, poolSize);
+    const downloadChunk = async (chunk = nextWorkerChunkIdx++) => {
+        let result;
+        if (aborted) {
+            return;
+        }
+        try {
+            result = await client.call({
+                _: isWeb ? 'upload.getWebFile' : 'upload.getFile',
+                // eslint-disable-next-line
+                location: location,
+                offset: chunkSize * chunk,
+                limit: chunkSize,
+            }, {
+                dcId,
+                kind: connectionKind,
+                maxRetryCount: Infinity,
+                abortSignal,
+            });
+        }
+        catch (e) {
+            if (e instanceof DOMException && e.name === 'AbortError')
+                return;
+            if (!tl.RpcError.is(e))
+                throw e;
+            if (e.is('FILE_MIGRATE_%d')) {
+                dcId = e.newDc;
+                return downloadChunk(chunk);
+            }
+            else if (e.is('FILEREF_UPGRADE_NEEDED')) {
+                // todo: implement someday
+                // see: https://github.com/LonamiWebs/Telethon/blob/0e8bd8248cc649637b7c392616887c50986427a0/telethon/client/downloads.py#L99
+                throw new MtUnsupportedError('File ref expired!');
+            }
+            else
+                throw e;
+        }
+        if (result._ === 'upload.fileCdnRedirect') {
+            // we shouldnt receive them since cdnSupported is not set in the getFile request.
+            // also, i couldnt find any media that would be downloaded from cdn, so even if
+            // i implemented that, i wouldnt be able to test that, so :shrug:
+            throw new MtUnsupportedError('Received CDN redirect, which is not supported (yet)');
+        }
+        if (aborted) {
+            return;
+        }
+        if (result._ === 'upload.webFile' && result.size && limitBytes === Infinity) {
+            limitBytes = result.size;
+            numChunks = ~~((limitBytes + chunkSize - offset - 1) / chunkSize);
+        }
+        buffer[chunk] = result.bytes;
+        if (chunk === nextChunkIdx) {
+            nextChunkCv.notify();
+        }
+        if (nextWorkerChunkIdx < numChunks && result.bytes.length === chunkSize) {
+            return downloadChunk();
+        }
+    };
+    let error = undefined;
+    void Promise.all(Array.from({ length: Math.min(poolSize * REQUESTS_PER_CONNECTION, numChunks) }, downloadChunk))
+        .catch((e) => {
+        client.log.debug('download workers errored: %s', e.message);
+        error = e;
+        aborted = true; // not really aborted, but we dont want to download more chunks
+        nextChunkCv.notify();
+    })
+        .then(() => {
+        client.log.debug('download workers finished');
+    });
+    // to avoid MaxListenersExceededWarning we do this instead
+    // already sent requests can go to hell (they will get ignored)
+    abortSignal?.addEventListener('abort', () => {
+        client.log.debug('download aborted');
+        error = abortSignal.reason;
+        aborted = true;
+        nextChunkCv.notify();
+    });
+    let position = offset;
+    while (position < limitBytes) {
+        await nextChunkCv.wait();
+        // eslint-disable-next-line @typescript-eslint/no-throw-literal
+        if (error)
+            throw error;
+        while (nextChunkIdx in buffer) {
+            const buf = buffer[nextChunkIdx];
+            delete buffer[nextChunkIdx];
+            position += buf.length;
+            params?.progressCallback?.(position, limitBytes);
+            yield buf;
+            nextChunkIdx++;
+            if (buf.length < chunkSize) {
+                // we received the last chunk
+                return;
+            }
+        }
+    }
+}
+//# sourceMappingURL=download-iterable.js.map

package/esm/highlevel/methods/files/download-iterable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-iterable.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/download-iterable.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseFileId } from '@mtcute/file-id'\nimport { tl } from '@mtcute/tl'\n\nimport { ConnectionKind } from '../../../network/network-manager.js'\nimport { MtArgumentError, MtUnsupportedError } from '../../../types/errors.js'\nimport { ConditionVariable } from '../../../utils/condition-variable.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { FileDownloadLocation, FileDownloadParameters, FileLocation } from '../../types/index.js'\nimport { fileIdToInputFileLocation, fileIdToInputWebFileLocation } from '../../utils/convert-file-id.js'\nimport { determinePartSize } from '../../utils/file-utils.js'\n\n// small files (less than 128 kb) are downloaded using the \"downloadSmall\" pool\n// furthermore, if the file is small and is located on our main DC, it will be downloaded\n// using the current main connection\nconst SMALL_FILE_MAX_SIZE = 131072\nconst REQUESTS_PER_CONNECTION = 3 // some arbitrary magic value that seems to work best\n\n/**\n * Download a file and return it as an iterable, which yields file contents\n * in chunks of a given size. Order of the chunks is guaranteed to be\n * consecutive.\n *\n * @param params  Download parameters\n */\nexport async function* downloadAsIterable(\n    client: ITelegramClient,\n    input: FileDownloadLocation,\n    params?: FileDownloadParameters,\n): AsyncIterableIterator<Uint8Array> {\n    const offset = params?.offset ?? 0\n\n    if (offset % 4096 !== 0) {\n        throw new MtArgumentError(`Invalid offset: ${offset}. Must be divisible by 4096`)\n    }\n\n    let dcId = params?.dcId\n    let fileSize = params?.fileSize\n\n    const abortSignal = params?.abortSignal\n    let aborted = false\n\n    let location: tl.TypeInputFileLocation | tl.TypeInputWebFileLocation\n    if (input instanceof FileLocation) {\n        let locationInner = input.location\n\n        if (typeof locationInner === 'function') {\n            locationInner = locationInner()\n        }\n\n        if (ArrayBuffer.isView(locationInner)) {\n            yield locationInner\n\n            return\n        }\n        if (!dcId) dcId = input.dcId\n        if (!fileSize) fileSize = input.fileSize\n        location = locationInner\n    } else if (typeof input === 'string') {\n        const parsed = parseFileId(input)\n\n        if (parsed.location._ === 'web') {\n            location = fileIdToInputWebFileLocation(parsed)\n        } else {\n            location = fileIdToInputFileLocation(parsed)\n        }\n    } else location = input\n\n    const isWeb = tl.isAnyInputWebFileLocation(location)\n\n    // we will receive a FileMigrateError in case this is invalid\n    const primaryDcId = await client.getPrimaryDcId()\n    if (!dcId) dcId = primaryDcId\n\n    const partSizeKb = params?.partSize ?? (fileSize ? determinePartSize(fileSize) : 64)\n\n    if (partSizeKb % 4 !== 0) {\n        throw new MtArgumentError(`Invalid part size: ${partSizeKb}. Must be divisible by 4.`)\n    }\n\n    const chunkSize = partSizeKb * 1024\n\n    let limitBytes = params?.limit ?? fileSize ?? Infinity\n    if (limitBytes === 0) return\n\n    let numChunks = limitBytes === Infinity ? Infinity : ~~((limitBytes + chunkSize - offset - 1) / chunkSize)\n\n    let nextChunkIdx = 0\n    let nextWorkerChunkIdx = 0\n    const nextChunkCv = new ConditionVariable()\n    const buffer: Record<number, Uint8Array> = {}\n\n    const isSmall = fileSize && fileSize <= SMALL_FILE_MAX_SIZE\n    let connectionKind: ConnectionKind\n\n    if (isSmall) {\n        connectionKind = dcId === primaryDcId ? 'main' : 'downloadSmall'\n    } else {\n        connectionKind = 'download'\n    }\n    const poolSize = await client.getPoolSize(connectionKind, dcId)\n\n    client.log.debug(\n        'Downloading file of size %d from dc %d using %s connection pool (pool size: %d)',\n        limitBytes,\n        dcId,\n        connectionKind,\n        poolSize,\n    )\n\n    const downloadChunk = async (chunk = nextWorkerChunkIdx++): Promise<void> => {\n        let result: tl.RpcCallReturn['upload.getFile'] | tl.RpcCallReturn['upload.getWebFile']\n\n        if (aborted) {\n            return\n        }\n\n        try {\n            result = await client.call(\n                {\n                    _: isWeb ? 'upload.getWebFile' : 'upload.getFile',\n                    // eslint-disable-next-line\n                    location: location as any,\n                    offset: chunkSize * chunk,\n                    limit: chunkSize,\n                },\n                {\n                    dcId,\n                    kind: connectionKind,\n                    maxRetryCount: Infinity, // retry until explicitly aborted (or finished)\n                    abortSignal,\n                },\n            )\n        } catch (e: unknown) {\n            if (e instanceof DOMException && e.name === 'AbortError') return\n            if (!tl.RpcError.is(e)) throw e\n\n            if (e.is('FILE_MIGRATE_%d')) {\n                dcId = e.newDc\n\n                return downloadChunk(chunk)\n            } else if (e.is('FILEREF_UPGRADE_NEEDED')) {\n                // todo: implement someday\n                // see: https://github.com/LonamiWebs/Telethon/blob/0e8bd8248cc649637b7c392616887c50986427a0/telethon/client/downloads.py#L99\n                throw new MtUnsupportedError('File ref expired!')\n            } else throw e\n        }\n\n        if (result._ === 'upload.fileCdnRedirect') {\n            // we shouldnt receive them since cdnSupported is not set in the getFile request.\n            // also, i couldnt find any media that would be downloaded from cdn, so even if\n            // i implemented that, i wouldnt be able to test that, so :shrug:\n            throw new MtUnsupportedError('Received CDN redirect, which is not supported (yet)')\n        }\n\n        if (aborted) {\n            return\n        }\n\n        if (result._ === 'upload.webFile' && result.size && limitBytes === Infinity) {\n            limitBytes = result.size\n            numChunks = ~~((limitBytes + chunkSize - offset - 1) / chunkSize)\n        }\n\n        buffer[chunk] = result.bytes\n\n        if (chunk === nextChunkIdx) {\n            nextChunkCv.notify()\n        }\n\n        if (nextWorkerChunkIdx < numChunks && result.bytes.length === chunkSize) {\n            return downloadChunk()\n        }\n    }\n\n    let error: unknown = undefined\n    void Promise.all(Array.from({ length: Math.min(poolSize * REQUESTS_PER_CONNECTION, numChunks) }, downloadChunk))\n        .catch((e) => {\n            client.log.debug('download workers errored: %s', e.message)\n            error = e\n            aborted = true // not really aborted, but we dont want to download more chunks\n            nextChunkCv.notify()\n        })\n        .then(() => {\n            client.log.debug('download workers finished')\n        })\n\n    // to avoid MaxListenersExceededWarning we do this instead\n    // already sent requests can go to hell (they will get ignored)\n    abortSignal?.addEventListener('abort', () => {\n        client.log.debug('download aborted')\n        error = abortSignal.reason\n        aborted = true\n        nextChunkCv.notify()\n    })\n\n    let position = offset\n\n    while (position < limitBytes) {\n        await nextChunkCv.wait()\n\n        // eslint-disable-next-line @typescript-eslint/no-throw-literal\n        if (error) throw error\n\n        while (nextChunkIdx in buffer) {\n            const buf = buffer[nextChunkIdx]\n            delete buffer[nextChunkIdx]\n\n            position += buf.length\n\n            params?.progressCallback?.(position, limitBytes)\n\n            yield buf\n\n            nextChunkIdx++\n\n            if (buf.length < chunkSize) {\n                // we received the last chunk\n                return\n            }\n        }\n    }\n}\n"]}

package/esm/highlevel/methods/files/download-stream.d.ts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { FileDownloadLocation, FileDownloadParameters } from '../../types/index.js';
+/**
+ * Download a file and return it as a readable stream,
+ * streaming file contents.
+ *
+ * @param params  File download parameters
+ */
+export declare function downloadAsStream(client: ITelegramClient, location: FileDownloadLocation, params?: FileDownloadParameters): ReadableStream<Uint8Array>;

package/esm/highlevel/methods/files/download-stream.js

@@ -0,0 +1,34 @@
+import { FileLocation } from '../../types/index.js';
+import { bufferToStream } from '../../utils/stream-utils.js';
+import { downloadAsIterable } from './download-iterable.js';
+/**
+ * Download a file and return it as a readable stream,
+ * streaming file contents.
+ *
+ * @param params  File download parameters
+ */
+export function downloadAsStream(client, location, params) {
+    if (location instanceof FileLocation && ArrayBuffer.isView(location.location)) {
+        return bufferToStream(location.location);
+    }
+    const cancel = new AbortController();
+    if (params?.abortSignal) {
+        params?.abortSignal.addEventListener('abort', () => {
+            cancel.abort();
+        });
+    }
+    return new ReadableStream({
+        start(controller) {
+            (async () => {
+                for await (const chunk of downloadAsIterable(client, location, params)) {
+                    controller.enqueue(chunk);
+                }
+                controller.close();
+            })().catch((e) => controller.error(e));
+        },
+        cancel() {
+            cancel.abort();
+        },
+    });
+}
+//# sourceMappingURL=download-stream.js.map

package/esm/highlevel/methods/files/download-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-stream.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/download-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAgD,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC5B,MAAuB,EACvB,QAA8B,EAC9B,MAA+B;IAE/B,IAAI,QAAQ,YAAY,YAAY,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAC3E,OAAO,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;KAC3C;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IAEpC,IAAI,MAAM,EAAE,WAAW,EAAE;QACrB,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,KAAK,EAAE,CAAA;QAClB,CAAC,CAAC,CAAA;KACL;IAED,OAAO,IAAI,cAAc,CAAa;QAClC,KAAK,CAAC,UAAU;YACZ,CAAC,KAAK,IAAI,EAAE;gBACR,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACpE,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;iBAC5B;gBAED,UAAU,CAAC,KAAK,EAAE,CAAA;YACtB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,CAAC;QACD,MAAM;YACF,MAAM,CAAC,KAAK,EAAE,CAAA;QAClB,CAAC;KACJ,CAAC,CAAA;AACN,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { FileDownloadLocation, FileDownloadParameters, FileLocation } from '../../types/index.js'\nimport { bufferToStream } from '../../utils/stream-utils.js'\nimport { downloadAsIterable } from './download-iterable.js'\n\n/**\n * Download a file and return it as a readable stream,\n * streaming file contents.\n *\n * @param params  File download parameters\n */\nexport function downloadAsStream(\n    client: ITelegramClient,\n    location: FileDownloadLocation,\n    params?: FileDownloadParameters,\n): ReadableStream<Uint8Array> {\n    if (location instanceof FileLocation && ArrayBuffer.isView(location.location)) {\n        return bufferToStream(location.location)\n    }\n\n    const cancel = new AbortController()\n\n    if (params?.abortSignal) {\n        params?.abortSignal.addEventListener('abort', () => {\n            cancel.abort()\n        })\n    }\n\n    return new ReadableStream<Uint8Array>({\n        start(controller) {\n            (async () => {\n                for await (const chunk of downloadAsIterable(client, location, params)) {\n                    controller.enqueue(chunk)\n                }\n\n                controller.close()\n            })().catch((e) => controller.error(e))\n        },\n        cancel() {\n            cancel.abort()\n        },\n    })\n}\n"]}

package/esm/highlevel/methods/files/normalize-file-to-document.d.ts

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

package/esm/highlevel/methods/files/normalize-file-to-document.js

@@ -0,0 +1,19 @@
+import { tl } from '@mtcute/tl';
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { _normalizeInputMedia } from './normalize-input-media.js';
+/**
+ * @internal
+ */
+export async function _normalizeFileToDocument(client, file, params) {
+    if (typeof file === 'object' && tl.isAnyInputDocument(file)) {
+        return file;
+    }
+    const media = await _normalizeInputMedia(client, {
+        type: 'document',
+        file,
+    }, params, true);
+    assertTypeIs('_normalizeFileToDocument', media, 'inputMediaDocument');
+    assertTypeIs('_normalizeFileToDocument', media.id, 'inputDocument');
+    return media.id;
+}
+//# sourceMappingURL=normalize-file-to-document.js.map

package/esm/highlevel/methods/files/normalize-file-to-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-file-to-document.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/normalize-file-to-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAGhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEjE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,MAAuB,EACvB,IAA0C,EAC1C,MAEC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;QACzD,OAAO,IAAI,CAAA;KACd;IAED,MAAM,KAAK,GAAG,MAAM,oBAAoB,CACpC,MAAM,EACN;QACI,IAAI,EAAE,UAAU;QAChB,IAAI;KACP,EACD,MAAM,EACN,IAAI,CACP,CAAA;IAED,YAAY,CAAC,0BAA0B,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAA;IACrE,YAAY,CAAC,0BAA0B,EAAE,KAAK,CAAC,EAAE,EAAE,eAAe,CAAC,CAAA;IAEnE,OAAO,KAAK,CAAC,EAAE,CAAA;AACnB,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputFileLike } from '../../types/index.js'\nimport { _normalizeInputMedia } from './normalize-input-media.js'\n\n/**\n * @internal\n */\nexport async function _normalizeFileToDocument(\n    client: ITelegramClient,\n    file: InputFileLike | tl.TypeInputDocument,\n    params: {\n        progressCallback?: (uploaded: number, total: number) => void\n    },\n): Promise<tl.TypeInputDocument> {\n    if (typeof file === 'object' && tl.isAnyInputDocument(file)) {\n        return file\n    }\n\n    const media = await _normalizeInputMedia(\n        client,\n        {\n            type: 'document',\n            file,\n        },\n        params,\n        true,\n    )\n\n    assertTypeIs('_normalizeFileToDocument', media, 'inputMediaDocument')\n    assertTypeIs('_normalizeFileToDocument', media.id, 'inputDocument')\n\n    return media.id\n}\n"]}

package/esm/highlevel/methods/files/normalize-input-file.d.ts

@@ -0,0 +1,13 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputFileLike } from '../../types/files/index.js';
+/**
+ * Normalize a {@link InputFileLike} to `InputFile`,
+ * uploading it if needed.
+ */
+export declare function _normalizeInputFile(client: ITelegramClient, input: InputFileLike, params: {
+    progressCallback?: (uploaded: number, total: number) => void;
+    fileName?: string;
+    fileSize?: number;
+    fileMime?: string;
+}): Promise<tl.TypeInputFile>;

package/esm/highlevel/methods/files/normalize-input-file.js

@@ -0,0 +1,38 @@
+import { tdFileId } from '@mtcute/file-id';
+import { tl } from '@mtcute/tl';
+import { MtArgumentError } from '../../../types/errors.js';
+import { isUploadedFile } from '../../types/files/index.js';
+import { uploadFile } from './upload-file.js';
+/**
+ * Normalize a {@link InputFileLike} to `InputFile`,
+ * uploading it if needed.
+ */
+export async function _normalizeInputFile(client, input, params) {
+    if (typeof input === 'object' && tl.isAnyInputMedia(input)) {
+        throw new MtArgumentError("InputFile can't be created from an InputMedia");
+    }
+    else if (tdFileId.isFileIdLike(input)) {
+        if (typeof input === 'string' && input.match(/^file:/)) {
+            const uploaded = await uploadFile(client, {
+                file: input.substring(5),
+                ...params,
+            });
+            return uploaded.inputFile;
+        }
+        throw new MtArgumentError("InputFile can't be created from an URL or a File ID");
+    }
+    else if (isUploadedFile(input)) {
+        return input.inputFile;
+    }
+    else if (typeof input === 'object' && tl.isAnyInputFile(input)) {
+        return input;
+    }
+    else {
+        const uploaded = await uploadFile(client, {
+            file: input,
+            ...params,
+        });
+        return uploaded.inputFile;
+    }
+}
+//# sourceMappingURL=normalize-input-file.js.map

package/esm/highlevel/methods/files/normalize-input-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-input-file.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/files/normalize-input-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,OAAO,EAAiB,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,MAAuB,EACvB,KAAoB,EACpB,MAKC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE;QACxD,MAAM,IAAI,eAAe,CAAC,+CAA+C,CAAC,CAAA;KAC7E;SAAM,IAAI,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;QACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;YACpD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;gBACtC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;gBACxB,GAAG,MAAM;aACZ,CAAC,CAAA;YAEF,OAAO,QAAQ,CAAC,SAAS,CAAA;SAC5B;QACD,MAAM,IAAI,eAAe,CAAC,qDAAqD,CAAC,CAAA;KACnF;SAAM,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE;QAC9B,OAAO,KAAK,CAAC,SAAS,CAAA;KACzB;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE;QAC9D,OAAO,KAAK,CAAA;KACf;SAAM;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;YACtC,IAAI,EAAE,KAAK;YACX,GAAG,MAAM;SACZ,CAAC,CAAA;QAEF,OAAO,QAAQ,CAAC,SAAS,CAAA;KAC5B;AACL,CAAC","sourcesContent":["import { tdFileId } from '@mtcute/file-id'\nimport { tl } from '@mtcute/tl'\n\nimport { MtArgumentError } from '../../../types/errors.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputFileLike, isUploadedFile } from '../../types/files/index.js'\nimport { uploadFile } from './upload-file.js'\n\n/**\n * Normalize a {@link InputFileLike} to `InputFile`,\n * uploading it if needed.\n */\nexport async function _normalizeInputFile(\n    client: ITelegramClient,\n    input: InputFileLike,\n    params: {\n        progressCallback?: (uploaded: number, total: number) => void\n        fileName?: string\n        fileSize?: number\n        fileMime?: string\n    },\n): Promise<tl.TypeInputFile> {\n    if (typeof input === 'object' && tl.isAnyInputMedia(input)) {\n        throw new MtArgumentError(\"InputFile can't be created from an InputMedia\")\n    } else if (tdFileId.isFileIdLike(input)) {\n        if (typeof input === 'string' && input.match(/^file:/)) {\n            const uploaded = await uploadFile(client, {\n                file: input.substring(5),\n                ...params,\n            })\n\n            return uploaded.inputFile\n        }\n        throw new MtArgumentError(\"InputFile can't be created from an URL or a File ID\")\n    } else if (isUploadedFile(input)) {\n        return input.inputFile\n    } else if (typeof input === 'object' && tl.isAnyInputFile(input)) {\n        return input\n    } else {\n        const uploaded = await uploadFile(client, {\n            file: input,\n            ...params,\n        })\n\n        return uploaded.inputFile\n    }\n}\n"]}

package/esm/highlevel/methods/files/normalize-input-media.d.ts

@@ -0,0 +1,11 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputMediaLike } from '../../types/media/input-media.js';
+/**
+ * Normalize an {@link InputMediaLike} to `InputMedia`,
+ * uploading the file if needed.
+ */
+export declare function _normalizeInputMedia(client: ITelegramClient, media: InputMediaLike, params?: {
+    progressCallback?: (uploaded: number, total: number) => void;
+    uploadPeer?: tl.TypeInputPeer;
+}, uploadMedia?: boolean): Promise<tl.TypeInputMedia>;