@mtcute/node 0.7.0 → 0.9.0

package/cjs/worker.d.ts

@@ -0,0 +1,10 @@
+import { ClientMessageHandler, RespondFn, SendFn, SomeWorker, TelegramWorker as TelegramWorkerBase, TelegramWorkerOptions, TelegramWorkerPort as TelegramWorkerPortBase, TelegramWorkerPortOptions, WorkerCustomMethods, WorkerMessageHandler } from '@mtcute/core/worker.js';
+export type { TelegramWorkerOptions, TelegramWorkerPortOptions, WorkerCustomMethods };
+export declare class TelegramWorker<T extends WorkerCustomMethods> extends TelegramWorkerBase<T> {
+    registerWorker(handler: WorkerMessageHandler): RespondFn;
+}
+export declare class TelegramWorkerPort<T extends WorkerCustomMethods> extends TelegramWorkerPortBase<T> {
+    readonly options: TelegramWorkerPortOptions;
+    constructor(options: TelegramWorkerPortOptions);
+    connectToWorker(worker: SomeWorker, handler: ClientMessageHandler): [SendFn, () => void];
+}

package/cjs/worker.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramWorkerPort = exports.TelegramWorker = void 0;
+const worker_threads_1 = require("worker_threads");
+const platform_js_1 = require("@mtcute/core/platform.js");
+const worker_js_1 = require("@mtcute/core/worker.js");
+const platform_js_2 = require("./common-internals-node/platform.js");
+let _registered = false;
+class TelegramWorker extends worker_js_1.TelegramWorker {
+    registerWorker(handler) {
+        if (!worker_threads_1.parentPort) {
+            throw new Error('TelegramWorker must be created from a worker thread');
+        }
+        if (_registered) {
+            throw new Error('TelegramWorker must be created only once');
+        }
+        _registered = true;
+        const port = worker_threads_1.parentPort;
+        const respond = port.postMessage.bind(port);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        worker_threads_1.parentPort.on('message', (message) => handler(message, respond));
+        return respond;
+    }
+}
+exports.TelegramWorker = TelegramWorker;
+class TelegramWorkerPort extends worker_js_1.TelegramWorkerPort {
+    constructor(options) {
+        (0, platform_js_1.setPlatform)(new platform_js_2.NodePlatform());
+        super(options);
+        this.options = options;
+    }
+    connectToWorker(worker, handler) {
+        if (!(worker instanceof worker_threads_1.Worker)) {
+            throw new Error('Only worker_threads are supported');
+        }
+        const send = worker.postMessage.bind(worker);
+        worker.on('message', handler);
+        return [
+            send,
+            () => {
+                worker.off('message', handler);
+            },
+        ];
+    }
+}
+exports.TelegramWorkerPort = TelegramWorkerPort;
+//# sourceMappingURL=worker.js.map

package/cjs/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/worker.ts"],"names":[],"mappings":";;;AAAA,mDAAmD;AAEnD,0DAAsD;AACtD,sDAW+B;AAE/B,qEAAkE;AAIlE,IAAI,WAAW,GAAG,KAAK,CAAA;AAEvB,MAAa,cAA8C,SAAQ,0BAAqB;IACpF,cAAc,CAAC,OAA6B;QACxC,IAAI,CAAC,2BAAU,EAAE;YACb,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;SACzE;QACD,IAAI,WAAW,EAAE;YACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;SAC9D;QAED,WAAW,GAAG,IAAI,CAAA;QAElB,MAAM,IAAI,GAAG,2BAAU,CAAA;QAEvB,MAAM,OAAO,GAAc,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEtD,iEAAiE;QACjE,2BAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QAEhE,OAAO,OAAO,CAAA;IAClB,CAAC;CACJ;AApBD,wCAoBC;AAED,MAAa,kBAAkD,SAAQ,8BAAyB;IAC5F,YAAqB,OAAkC;QACnD,IAAA,yBAAW,EAAC,IAAI,0BAAY,EAAE,CAAC,CAAA;QAC/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFG,YAAO,GAAP,OAAO,CAA2B;IAGvD,CAAC;IAED,eAAe,CAAC,MAAkB,EAAE,OAA6B;QAC7D,IAAI,CAAC,CAAC,MAAM,YAAY,uBAAM,CAAC,EAAE;YAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;SACvD;QAED,MAAM,IAAI,GAAW,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAEpD,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAE7B,OAAO;YACH,IAAI;YACJ,GAAG,EAAE;gBACD,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAClC,CAAC;SACJ,CAAA;IACL,CAAC;CACJ;AAtBD,gDAsBC","sourcesContent":["import { parentPort, Worker } from 'worker_threads'\n\nimport { setPlatform } from '@mtcute/core/platform.js'\nimport {\n    ClientMessageHandler,\n    RespondFn,\n    SendFn,\n    SomeWorker,\n    TelegramWorker as TelegramWorkerBase,\n    TelegramWorkerOptions,\n    TelegramWorkerPort as TelegramWorkerPortBase,\n    TelegramWorkerPortOptions,\n    WorkerCustomMethods,\n    WorkerMessageHandler,\n} from '@mtcute/core/worker.js'\n\nimport { NodePlatform } from './common-internals-node/platform.js'\n\nexport type { TelegramWorkerOptions, TelegramWorkerPortOptions, WorkerCustomMethods }\n\nlet _registered = false\n\nexport class TelegramWorker<T extends WorkerCustomMethods> extends TelegramWorkerBase<T> {\n    registerWorker(handler: WorkerMessageHandler): RespondFn {\n        if (!parentPort) {\n            throw new Error('TelegramWorker must be created from a worker thread')\n        }\n        if (_registered) {\n            throw new Error('TelegramWorker must be created only once')\n        }\n\n        _registered = true\n\n        const port = parentPort\n\n        const respond: RespondFn = port.postMessage.bind(port)\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n        parentPort.on('message', (message) => handler(message, respond))\n\n        return respond\n    }\n}\n\nexport class TelegramWorkerPort<T extends WorkerCustomMethods> extends TelegramWorkerPortBase<T> {\n    constructor(readonly options: TelegramWorkerPortOptions) {\n        setPlatform(new NodePlatform())\n        super(options)\n    }\n\n    connectToWorker(worker: SomeWorker, handler: ClientMessageHandler): [SendFn, () => void] {\n        if (!(worker instanceof Worker)) {\n            throw new Error('Only worker_threads are supported')\n        }\n\n        const send: SendFn = worker.postMessage.bind(worker)\n\n        worker.on('message', handler)\n\n        return [\n            send,\n            () => {\n                worker.off('message', handler)\n            },\n        ]\n    }\n}\n"]}

package/esm/client.d.ts

@@ -0,0 +1,47 @@
+/// <reference types="node" resolution-mode="require"/>
+import { FileDownloadLocation, FileDownloadParameters, ITelegramStorageProvider, PartialOnly, User } from '@mtcute/core';
+import { BaseTelegramClient as BaseTelegramClientBase, BaseTelegramClientOptions as BaseTelegramClientOptionsBase, TelegramClient as TelegramClientBase, TelegramClientOptions } from '@mtcute/core/client.js';
+export type { TelegramClientOptions };
+export interface BaseTelegramClientOptions extends PartialOnly<Omit<BaseTelegramClientOptionsBase, 'storage'>, 'transport' | 'crypto'> {
+    /**
+     * Storage to use for this client.
+     *
+     * If a string is passed, it will be used as
+     * a name for an SQLite database file.
+     *
+     * @default `"client.session"`
+     */
+    storage?: string | ITelegramStorageProvider;
+    /**
+     * **ADVANCED USE ONLY**
+     *
+     * Whether to not set up the platform.
+     * This is useful if you call `setPlatform` yourself.
+     */
+    platformless?: boolean;
+}
+export declare class BaseTelegramClient extends BaseTelegramClientBase {
+    constructor(opts: BaseTelegramClientOptions);
+}
+/**
+ * Telegram client for use in Node.js
+ */
+export declare class TelegramClient extends TelegramClientBase {
+    constructor(opts: TelegramClientOptions);
+    private _rl?;
+    /**
+     * Tiny wrapper over Node `readline` package
+     * for simpler user input for `.run()` method.
+     *
+     * Associated `readline` interface is closed
+     * after `run()` returns, or with the client.
+     *
+     * @param text  Text of the question
+     */
+    input(text: string): Promise<string>;
+    close(): Promise<void>;
+    start(params?: Parameters<TelegramClientBase['start']>[0]): Promise<User>;
+    run(params: Parameters<TelegramClient['start']>[0] | ((user: User) => void | Promise<void>), then?: (user: User) => void | Promise<void>): void;
+    downloadToFile(filename: string, location: FileDownloadLocation, params?: FileDownloadParameters | undefined): Promise<void>;
+    downloadAsNodeStream(location: FileDownloadLocation, params?: FileDownloadParameters | undefined): import("stream").Readable;
+}

package/esm/client.js

@@ -0,0 +1,105 @@
+import { createRequire } from 'module';
+import { createInterface } from 'readline';
+import { BaseTelegramClient as BaseTelegramClientBase, TelegramClient as TelegramClientBase, } from '@mtcute/core/client.js';
+import { setPlatform } from '@mtcute/core/platform.js';
+import { NodePlatform } from './common-internals-node/platform.js';
+import { downloadToFile } from './methods/download-file.js';
+import { downloadAsNodeStream } from './methods/download-node-stream.js';
+import { SqliteStorage } from './sqlite/index.js';
+import { NodeCryptoProvider } from './utils/crypto.js';
+import { TcpTransport } from './utils/tcp.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let nativeCrypto;
+try {
+    // @only-if-esm
+    const require = createRequire(import.meta.url);
+    // @/only-if-esm
+    // eslint-disable-next-line
+    nativeCrypto = require('@mtcute/crypto-node').NodeNativeCryptoProvider;
+}
+catch (e) { }
+export class BaseTelegramClient extends BaseTelegramClientBase {
+    constructor(opts) {
+        if (!opts.platformless)
+            setPlatform(new NodePlatform());
+        super({
+            // eslint-disable-next-line
+            crypto: nativeCrypto ? new nativeCrypto() : new NodeCryptoProvider(),
+            transport: () => new TcpTransport(),
+            ...opts,
+            storage: typeof opts.storage === 'string' ?
+                new SqliteStorage(opts.storage) :
+                opts.storage ?? new SqliteStorage('client.session'),
+        });
+    }
+}
+/**
+ * Telegram client for use in Node.js
+ */
+export class TelegramClient extends TelegramClientBase {
+    constructor(opts) {
+        if ('client' in opts) {
+            super(opts);
+            return;
+        }
+        super({
+            client: new BaseTelegramClient(opts),
+        });
+    }
+    /**
+     * Tiny wrapper over Node `readline` package
+     * for simpler user input for `.run()` method.
+     *
+     * Associated `readline` interface is closed
+     * after `run()` returns, or with the client.
+     *
+     * @param text  Text of the question
+     */
+    input(text) {
+        if (!this._rl) {
+            this._rl = createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+        }
+        return new Promise((res) => this._rl?.question(text, res));
+    }
+    close() {
+        this._rl?.close();
+        return super.close();
+    }
+    start(params = {}) {
+        if (!params.botToken) {
+            if (!params.phone)
+                params.phone = () => this.input('phone > ');
+            if (!params.code)
+                params.code = () => this.input('code > ');
+            if (!params.password) {
+                params.password = () => this.input('2fa password > ');
+            }
+        }
+        return super.start(params).then((user) => {
+            if (this._rl) {
+                this._rl.close();
+                delete this._rl;
+            }
+            return user;
+        });
+    }
+    run(params, then) {
+        if (typeof params === 'function') {
+            then = params;
+            params = {};
+        }
+        this.start(params)
+            .then(then)
+            .catch((err) => this.emitError(err));
+    }
+    downloadToFile(filename, location, params) {
+        return downloadToFile(this, filename, location, params);
+    }
+    downloadAsNodeStream(location, params) {
+        return downloadAsNodeStream(this, location, params);
+    }
+}
+//# sourceMappingURL=client.js.map

package/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from 'module'\nimport { createInterface, Interface as RlInterface } from 'readline'\n\nimport { FileDownloadLocation, FileDownloadParameters, ITelegramStorageProvider, PartialOnly, User } from '@mtcute/core'\nimport {\n    BaseTelegramClient as BaseTelegramClientBase,\n    BaseTelegramClientOptions as BaseTelegramClientOptionsBase,\n    TelegramClient as TelegramClientBase,\n    TelegramClientOptions,\n} from '@mtcute/core/client.js'\nimport { setPlatform } from '@mtcute/core/platform.js'\n\nimport { NodePlatform } from './common-internals-node/platform.js'\nimport { downloadToFile } from './methods/download-file.js'\nimport { downloadAsNodeStream } from './methods/download-node-stream.js'\nimport { SqliteStorage } from './sqlite/index.js'\nimport { NodeCryptoProvider } from './utils/crypto.js'\nimport { TcpTransport } from './utils/tcp.js'\n\nexport type { TelegramClientOptions }\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet nativeCrypto: any\n\ntry {\n    // @only-if-esm\n    const require = createRequire(import.meta.url)\n    // @/only-if-esm\n    // eslint-disable-next-line\n    nativeCrypto = require('@mtcute/crypto-node').NodeNativeCryptoProvider\n} catch (e) {}\n\nexport interface BaseTelegramClientOptions\n    extends PartialOnly<Omit<BaseTelegramClientOptionsBase, 'storage'>, 'transport' | 'crypto'> {\n    /**\n     * Storage to use for this client.\n     *\n     * If a string is passed, it will be used as\n     * a name for an SQLite database file.\n     *\n     * @default `\"client.session\"`\n     */\n    storage?: string | ITelegramStorageProvider\n\n    /**\n     * **ADVANCED USE ONLY**\n     *\n     * Whether to not set up the platform.\n     * This is useful if you call `setPlatform` yourself.\n     */\n    platformless?: boolean\n}\n\nexport class BaseTelegramClient extends BaseTelegramClientBase {\n    constructor(opts: BaseTelegramClientOptions) {\n        if (!opts.platformless) setPlatform(new NodePlatform())\n\n        super({\n            // eslint-disable-next-line\n            crypto: nativeCrypto ? new nativeCrypto() : new NodeCryptoProvider(),\n            transport: () => new TcpTransport(),\n            ...opts,\n            storage:\n                typeof opts.storage === 'string' ?\n                    new SqliteStorage(opts.storage) :\n                    opts.storage ?? new SqliteStorage('client.session'),\n        })\n    }\n}\n\n/**\n * Telegram client for use in Node.js\n */\nexport class TelegramClient extends TelegramClientBase {\n    constructor(opts: TelegramClientOptions) {\n        if ('client' in opts) {\n            super(opts)\n\n            return\n        }\n\n        super({\n            client: new BaseTelegramClient(opts),\n        })\n    }\n\n    private _rl?: RlInterface\n\n    /**\n     * Tiny wrapper over Node `readline` package\n     * for simpler user input for `.run()` method.\n     *\n     * Associated `readline` interface is closed\n     * after `run()` returns, or with the client.\n     *\n     * @param text  Text of the question\n     */\n    input(text: string): Promise<string> {\n        if (!this._rl) {\n            this._rl = createInterface({\n                input: process.stdin,\n                output: process.stdout,\n            })\n        }\n\n        return new Promise((res) => this._rl?.question(text, res))\n    }\n\n    close(): Promise<void> {\n        this._rl?.close()\n\n        return super.close()\n    }\n\n    start(params: Parameters<TelegramClientBase['start']>[0] = {}): Promise<User> {\n        if (!params.botToken) {\n            if (!params.phone) params.phone = () => this.input('phone > ')\n            if (!params.code) params.code = () => this.input('code > ')\n\n            if (!params.password) {\n                params.password = () => this.input('2fa password > ')\n            }\n        }\n\n        return super.start(params).then((user) => {\n            if (this._rl) {\n                this._rl.close()\n                delete this._rl\n            }\n\n            return user\n        })\n    }\n\n    run(\n        params: Parameters<TelegramClient['start']>[0] | ((user: User) => void | Promise<void>),\n        then?: (user: User) => void | Promise<void>,\n    ): void {\n        if (typeof params === 'function') {\n            then = params\n            params = {}\n        }\n\n        this.start(params)\n            .then(then)\n            .catch((err) => this.emitError(err))\n    }\n\n    downloadToFile(\n        filename: string,\n        location: FileDownloadLocation,\n        params?: FileDownloadParameters | undefined,\n    ): Promise<void> {\n        return downloadToFile(this, filename, location, params)\n    }\n\n    downloadAsNodeStream(location: FileDownloadLocation, params?: FileDownloadParameters | undefined) {\n        return downloadAsNodeStream(this, location, params)\n    }\n}\n"]}

package/esm/common-internals-node/exit-hook.d.ts

@@ -0,0 +1 @@
+export declare function beforeExit(fn: () => void): () => void;

package/esm/common-internals-node/exit-hook.js

@@ -0,0 +1,41 @@
+// roughly based on https://github.com/sindresorhus/exit-hook/blob/main/index.js, MIT license
+let installed = false;
+let handled = false;
+const callbacks = new Set();
+function exit(shouldManuallyExit, signal, event) {
+    return function eventHandler() {
+        if (handled) {
+            return;
+        }
+        handled = true;
+        const exitCode = 128 + signal;
+        for (const callback of callbacks) {
+            callback();
+        }
+        if (shouldManuallyExit) {
+            // if the user has some custom handlers after us, we don't want to exit the process
+            const listeners = process.rawListeners(event);
+            const idx = listeners.indexOf(eventHandler);
+            if (idx === listeners.length - 1) {
+                process.exit(exitCode);
+            }
+        }
+    };
+}
+export function beforeExit(fn) {
+    // unsupported platform
+    if (typeof process === 'undefined')
+        return () => { };
+    if (!installed) {
+        installed = true;
+        process.on('beforeExit', exit(true, -128, 'beforeExit'));
+        process.on('SIGINT', exit(true, 2, 'SIGINT'));
+        process.on('SIGTERM', exit(true, 15, 'SIGINT'));
+        process.on('exit', exit(false, 15, 'exit'));
+    }
+    callbacks.add(fn);
+    return () => {
+        callbacks.delete(fn);
+    };
+}
+//# sourceMappingURL=exit-hook.js.map

package/esm/common-internals-node/exit-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-hook.js","sourceRoot":"","sources":["../../../src/common-internals-node/exit-hook.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,IAAI,SAAS,GAAG,KAAK,CAAA;AACrB,IAAI,OAAO,GAAG,KAAK,CAAA;AAEnB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;AAEvC,SAAS,IAAI,CAAC,kBAA2B,EAAE,MAAc,EAAE,KAAa;IACpE,OAAO,SAAS,YAAY;QACxB,IAAI,OAAO,EAAE;YACT,OAAM;SACT;QAED,OAAO,GAAG,IAAI,CAAA;QAEd,MAAM,QAAQ,GAAG,GAAG,GAAG,MAAM,CAAA;QAE7B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;YAC9B,QAAQ,EAAE,CAAA;SACb;QAED,IAAI,kBAAkB,EAAE;YACpB,mFAAmF;YAEnF,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;YAC7C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;YAE3C,IAAI,GAAG,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC9B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;aACzB;SACJ;IACL,CAAC,CAAA;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAc;IACrC,uBAAuB;IACvB,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAEnD,IAAI,CAAC,SAAS,EAAE;QACZ,SAAS,GAAG,IAAI,CAAA;QAEhB,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAA;QACxD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAA;QAC7C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAA;QAC/C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAA;KAC9C;IAED,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAEjB,OAAO,GAAG,EAAE;QACR,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACxB,CAAC,CAAA;AACL,CAAC","sourcesContent":["// roughly based on https://github.com/sindresorhus/exit-hook/blob/main/index.js, MIT license\n\nlet installed = false\nlet handled = false\n\nconst callbacks = new Set<() => void>()\n\nfunction exit(shouldManuallyExit: boolean, signal: number, event: string) {\n    return function eventHandler() {\n        if (handled) {\n            return\n        }\n\n        handled = true\n\n        const exitCode = 128 + signal\n\n        for (const callback of callbacks) {\n            callback()\n        }\n\n        if (shouldManuallyExit) {\n            // if the user has some custom handlers after us, we don't want to exit the process\n\n            const listeners = process.rawListeners(event)\n            const idx = listeners.indexOf(eventHandler)\n\n            if (idx === listeners.length - 1) {\n                process.exit(exitCode)\n            }\n        }\n    }\n}\n\nexport function beforeExit(fn: () => void): () => void {\n    // unsupported platform\n    if (typeof process === 'undefined') return () => {}\n\n    if (!installed) {\n        installed = true\n\n        process.on('beforeExit', exit(true, -128, 'beforeExit'))\n        process.on('SIGINT', exit(true, 2, 'SIGINT'))\n        process.on('SIGTERM', exit(true, 15, 'SIGINT'))\n        process.on('exit', exit(false, 15, 'exit'))\n    }\n\n    callbacks.add(fn)\n\n    return () => {\n        callbacks.delete(fn)\n    }\n}\n"]}

package/esm/common-internals-node/logging.d.ts

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

package/esm/common-internals-node/logging.js

@@ -0,0 +1,31 @@
+const isTty = typeof process === 'object' && Boolean(process.stdout?.isTTY);
+const BASE_FORMAT = isTty ? '%s [%s] [%s%s\x1b[0m] ' : '%s [%s] [%s] ';
+const LEVEL_NAMES = isTty ?
+    [
+        '',
+        '\x1b[31mERR\x1b[0m',
+        '\x1b[33mWRN\x1b[0m',
+        '\x1b[34mINF\x1b[0m',
+        '\x1b[36mDBG\x1b[0m',
+        '\x1b[35mVRB\x1b[0m',
+    ] :
+    [
+        '',
+        'ERR',
+        'WRN',
+        'INF',
+        'DBG',
+        'VRB',
+    ];
+const TAG_COLORS = [6, 2, 3, 4, 5, 1].map((i) => `\x1b[3${i};1m`);
+/** @internal */
+export const defaultLoggingHandler = isTty ?
+    (color, level, tag, fmt, args) => {
+        // eslint-disable-next-line no-console
+        console.log(BASE_FORMAT + fmt, new Date().toISOString(), LEVEL_NAMES[level], TAG_COLORS[color], tag, ...args);
+    } :
+    (color, level, tag, fmt, args) => {
+        // eslint-disable-next-line no-console
+        console.log(BASE_FORMAT + fmt, new Date().toISOString(), LEVEL_NAMES[level], tag, ...args);
+    };
+//# sourceMappingURL=logging.js.map

package/esm/common-internals-node/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../src/common-internals-node/logging.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAE3E,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,eAAe,CAAA;AACtE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC;IACvB;QACI,EAAE;QACF,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;KACvB,CAAC,CAAC;IACH;QACI,EAAE;QACF,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACR,CAAA;AACL,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AAEjE,gBAAgB;AAChB,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,CAAC;IACxC,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW,EAAE,IAAe,EAAQ,EAAE;QAC9E,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACjH,CAAC,CAAC,CAAC;IACH,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW,EAAE,IAAe,EAAQ,EAAE;QAC9E,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IAC9F,CAAC,CAAA","sourcesContent":["const isTty = typeof process === 'object' && Boolean(process.stdout?.isTTY)\n\nconst BASE_FORMAT = isTty ? '%s [%s] [%s%s\\x1b[0m] ' : '%s [%s] [%s] '\nconst LEVEL_NAMES = isTty ?\n    [\n        '', // OFF\n        '\\x1b[31mERR\\x1b[0m',\n        '\\x1b[33mWRN\\x1b[0m',\n        '\\x1b[34mINF\\x1b[0m',\n        '\\x1b[36mDBG\\x1b[0m',\n        '\\x1b[35mVRB\\x1b[0m',\n    ] :\n    [\n        '', // OFF\n        'ERR',\n        'WRN',\n        'INF',\n        'DBG',\n        'VRB',\n    ]\nconst TAG_COLORS = [6, 2, 3, 4, 5, 1].map((i) => `\\x1b[3${i};1m`)\n\n/** @internal */\nexport const defaultLoggingHandler = isTty ?\n    (color: number, level: number, tag: string, fmt: string, args: unknown[]): void => {\n        // eslint-disable-next-line no-console\n        console.log(BASE_FORMAT + fmt, new Date().toISOString(), LEVEL_NAMES[level], TAG_COLORS[color], tag, ...args)\n    } :\n    (color: number, level: number, tag: string, fmt: string, args: unknown[]): void => {\n        // eslint-disable-next-line no-console\n        console.log(BASE_FORMAT + fmt, new Date().toISOString(), LEVEL_NAMES[level], tag, ...args)\n    }\n"]}

package/esm/common-internals-node/platform.d.ts

@@ -0,0 +1,18 @@
+import { ICorePlatform } from '@mtcute/core/platform.js';
+import { normalizeFile } from '../utils/normalize-file.js';
+import { beforeExit } from './exit-hook.js';
+import { defaultLoggingHandler } from './logging.js';
+export declare class NodePlatform implements ICorePlatform {
+    log: typeof defaultLoggingHandler;
+    beforeExit: typeof beforeExit;
+    normalizeFile: typeof normalizeFile;
+    getDeviceModel(): string;
+    getDefaultLogLevel(): number | null;
+    utf8ByteLength(str: string): number;
+    utf8Encode(str: string): Uint8Array;
+    utf8Decode(buf: Uint8Array): string;
+    hexEncode(buf: Uint8Array): string;
+    hexDecode(str: string): Uint8Array;
+    base64Encode(buf: Uint8Array, url?: boolean): string;
+    base64Decode(string: string, url?: boolean): Uint8Array;
+}

package/esm/common-internals-node/platform.js

@@ -0,0 +1,58 @@
+import * as os from 'os';
+import { normalizeFile } from '../utils/normalize-file.js';
+import { beforeExit } from './exit-hook.js';
+import { defaultLoggingHandler } from './logging.js';
+const BUFFER_BASE64_URL_AVAILABLE = typeof Buffer.isEncoding === 'function' && Buffer.isEncoding('base64url');
+const toBuffer = (buf) => Buffer.from(buf.buffer, buf.byteOffset, buf.byteLength);
+export class NodePlatform {
+    getDeviceModel() {
+        return `${os.type()} ${os.arch()} ${os.release()}`;
+    }
+    getDefaultLogLevel() {
+        const envLogLevel = parseInt(process.env.MTCUTE_LOG_LEVEL ?? '');
+        if (!isNaN(envLogLevel)) {
+            return envLogLevel;
+        }
+        return null;
+    }
+    // ITlPlatform
+    utf8ByteLength(str) {
+        return Buffer.byteLength(str, 'utf8');
+    }
+    utf8Encode(str) {
+        return Buffer.from(str, 'utf8');
+    }
+    utf8Decode(buf) {
+        return toBuffer(buf).toString('utf8');
+    }
+    hexEncode(buf) {
+        return toBuffer(buf).toString('hex');
+    }
+    hexDecode(str) {
+        return Buffer.from(str, 'hex');
+    }
+    base64Encode(buf, url = false) {
+        const nodeBuffer = toBuffer(buf);
+        if (url && BUFFER_BASE64_URL_AVAILABLE)
+            return nodeBuffer.toString('base64url');
+        const str = nodeBuffer.toString('base64');
+        if (url)
+            return str.replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '');
+        return str;
+    }
+    base64Decode(string, url = false) {
+        if (url && BUFFER_BASE64_URL_AVAILABLE) {
+            return Buffer.from(string, 'base64url');
+        }
+        if (url) {
+            string = string.replace(/-/g, '+').replace(/_/g, '/');
+            while (string.length % 4)
+                string += '=';
+        }
+        return Buffer.from(string, 'base64');
+    }
+}
+NodePlatform.prototype.log = defaultLoggingHandler;
+NodePlatform.prototype.beforeExit = beforeExit;
+NodePlatform.prototype.normalizeFile = normalizeFile;
+//# sourceMappingURL=platform.js.map

package/esm/common-internals-node/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../../src/common-internals-node/platform.ts"],"names":[],"mappings":"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","sourcesContent":["import * as os from 'os'\n\nimport { ICorePlatform } from '@mtcute/core/platform.js'\n\nimport { normalizeFile } from '../utils/normalize-file.js'\nimport { beforeExit } from './exit-hook.js'\nimport { defaultLoggingHandler } from './logging.js'\n\nconst BUFFER_BASE64_URL_AVAILABLE = typeof Buffer.isEncoding === 'function' && Buffer.isEncoding('base64url')\n\nconst toBuffer = (buf: Uint8Array): Buffer => Buffer.from(buf.buffer, buf.byteOffset, buf.byteLength)\n\nexport class NodePlatform implements ICorePlatform {\n    // ICorePlatform\n    log!: typeof defaultLoggingHandler\n    beforeExit!: typeof beforeExit\n    normalizeFile!: typeof normalizeFile\n\n    getDeviceModel(): string {\n        return `${os.type()} ${os.arch()} ${os.release()}`\n    }\n\n    getDefaultLogLevel(): number | null {\n        const envLogLevel = parseInt(process.env.MTCUTE_LOG_LEVEL ?? '')\n\n        if (!isNaN(envLogLevel)) {\n            return envLogLevel\n        }\n\n        return null\n    }\n\n    // ITlPlatform\n    utf8ByteLength(str: string): number {\n        return Buffer.byteLength(str, 'utf8')\n    }\n    utf8Encode(str: string): Uint8Array {\n        return Buffer.from(str, 'utf8')\n    }\n    utf8Decode(buf: Uint8Array): string {\n        return toBuffer(buf).toString('utf8')\n    }\n\n    hexEncode(buf: Uint8Array): string {\n        return toBuffer(buf).toString('hex')\n    }\n    hexDecode(str: string): Uint8Array {\n        return Buffer.from(str, 'hex')\n    }\n\n    base64Encode(buf: Uint8Array, url = false): string {\n        const nodeBuffer = toBuffer(buf)\n\n        if (url && BUFFER_BASE64_URL_AVAILABLE) return nodeBuffer.toString('base64url')\n\n        const str = nodeBuffer.toString('base64')\n        if (url) return str.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '')\n\n        return str\n    }\n    base64Decode(string: string, url = false): Uint8Array {\n        if (url && BUFFER_BASE64_URL_AVAILABLE) {\n            return Buffer.from(string, 'base64url')\n        }\n\n        if (url) {\n            string = string.replace(/-/g, '+').replace(/_/g, '/')\n            while (string.length % 4) string += '='\n        }\n\n        return Buffer.from(string, 'base64')\n    }\n}\n\nNodePlatform.prototype.log = defaultLoggingHandler\nNodePlatform.prototype.beforeExit = beforeExit\nNodePlatform.prototype.normalizeFile = normalizeFile\n"]}

package/esm/index.d.ts

@@ -1,30 +1,9 @@
-import { TelegramClient, TelegramClientOptions, User } from '@mtcute/core';
-import { SqliteStorage } from '@mtcute/sqlite';
+export * from './client.js';
+export * from './common-internals-node/platform.js';
+export * from './sqlite/index.js';
+export * from './utils/crypto.js';
+export * from './utils/tcp.js';
+export * from './worker.js';
 export * from '@mtcute/core';
 export * from '@mtcute/html-parser';
 export * from '@mtcute/markdown-parser';
-export { SqliteStorage };
-/**
- * Tiny wrapper over {@link TelegramClient} for usage inside Node JS.
- *
- * This class automatically manages native
- * crypto addon and defaults to SQLite session (unlike `TelegarmClient`,
- * which defaults to a JSON file on Node).
- */
-export declare class NodeTelegramClient extends TelegramClient {
-    constructor(opts: TelegramClientOptions);
-    private _rl?;
-    /**
-     * Tiny wrapper over Node `readline` package
-     * for simpler user input for `.run()` method.
-     *
-     * Associated `readline` interface is closed
-     * after `run()` returns, or with the client.
-     *
-     * @param text  Text of the question
-     */
-    input(text: string): Promise<string>;
-    close(): Promise<void>;
-    start(params?: Parameters<TelegramClient['start']>[0]): Promise<User>;
-    run(params: Parameters<TelegramClient['start']>[0] | ((user: User) => void | Promise<void>), then?: (user: User) => void | Promise<void>): void;
-}

package/esm/index.js

@@ -1,91 +1,10 @@
-import { createRequire } from 'module';
-import { createInterface } from 'readline';
-import { TelegramClient } from '@mtcute/core';
-import { SqliteStorage } from '@mtcute/sqlite';
+export * from './client.js';
+export * from './common-internals-node/platform.js';
+export * from './sqlite/index.js';
+export * from './utils/crypto.js';
+export * from './utils/tcp.js';
+export * from './worker.js';
 export * from '@mtcute/core';
 export * from '@mtcute/html-parser';
 export * from '@mtcute/markdown-parser';
-export { SqliteStorage };
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-let nativeCrypto;
-try {
-    // @only-if-esm
-    const require = createRequire(import.meta.url);
-    // @/only-if-esm
-    // eslint-disable-next-line
-    nativeCrypto = require('@mtcute/crypto-node').NodeNativeCryptoProvider;
-}
-catch (e) { }
-/**
- * Tiny wrapper over {@link TelegramClient} for usage inside Node JS.
- *
- * This class automatically manages native
- * crypto addon and defaults to SQLite session (unlike `TelegarmClient`,
- * which defaults to a JSON file on Node).
- */
-export class NodeTelegramClient extends TelegramClient {
-    constructor(opts) {
-        if ('client' in opts) {
-            super(opts);
-            return;
-        }
-        super({
-            // eslint-disable-next-line
-            crypto: nativeCrypto ? () => new nativeCrypto() : undefined,
-            ...opts,
-            storage: typeof opts.storage === 'string' ?
-                new SqliteStorage(opts.storage) :
-                opts.storage ?? new SqliteStorage('client.session'),
-        });
-    }
-    /**
-     * Tiny wrapper over Node `readline` package
-     * for simpler user input for `.run()` method.
-     *
-     * Associated `readline` interface is closed
-     * after `run()` returns, or with the client.
-     *
-     * @param text  Text of the question
-     */
-    input(text) {
-        if (!this._rl) {
-            this._rl = createInterface({
-                input: process.stdin,
-                output: process.stdout,
-            });
-        }
-        return new Promise((res) => this._rl?.question(text, res));
-    }
-    close() {
-        this._rl?.close();
-        return super.close();
-    }
-    start(params = {}) {
-        if (!params.botToken) {
-            if (!params.phone)
-                params.phone = () => this.input('phone > ');
-            if (!params.code)
-                params.code = () => this.input('code > ');
-            if (!params.password) {
-                params.password = () => this.input('2fa password > ');
-            }
-        }
-        return super.start(params).then((user) => {
-            if (this._rl) {
-                this._rl.close();
-                delete this._rl;
-            }
-            return user;
-        });
-    }
-    run(params, then) {
-        if (typeof params === 'function') {
-            then = params;
-            params = {};
-        }
-        this.start(params)
-            .then(then)
-            .catch((err) => this.emitError(err));
-    }
-}
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from 'module'\nimport { createInterface, Interface as RlInterface } from 'readline'\n\nimport { TelegramClient, TelegramClientOptions, User } from '@mtcute/core'\nimport { SqliteStorage } from '@mtcute/sqlite'\n\nexport * from '@mtcute/core'\nexport * from '@mtcute/html-parser'\nexport * from '@mtcute/markdown-parser'\nexport { SqliteStorage }\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet nativeCrypto: any\n\ntry {\n    // @only-if-esm\n    const require = createRequire(import.meta.url)\n    // @/only-if-esm\n    // eslint-disable-next-line\n    nativeCrypto = require('@mtcute/crypto-node').NodeNativeCryptoProvider\n} catch (e) {}\n\n/**\n * Tiny wrapper over {@link TelegramClient} for usage inside Node JS.\n *\n * This class automatically manages native\n * crypto addon and defaults to SQLite session (unlike `TelegarmClient`,\n * which defaults to a JSON file on Node).\n */\nexport class NodeTelegramClient extends TelegramClient {\n    constructor(opts: TelegramClientOptions) {\n        if ('client' in opts) {\n            super(opts)\n\n            return\n        }\n\n        super({\n            // eslint-disable-next-line\n            crypto: nativeCrypto ? () => new nativeCrypto() : undefined,\n            ...opts,\n            storage:\n                typeof opts.storage === 'string' ?\n                    new SqliteStorage(opts.storage) :\n                    opts.storage ?? new SqliteStorage('client.session'),\n        })\n    }\n\n    private _rl?: RlInterface\n\n    /**\n     * Tiny wrapper over Node `readline` package\n     * for simpler user input for `.run()` method.\n     *\n     * Associated `readline` interface is closed\n     * after `run()` returns, or with the client.\n     *\n     * @param text  Text of the question\n     */\n    input(text: string): Promise<string> {\n        if (!this._rl) {\n            this._rl = createInterface({\n                input: process.stdin,\n                output: process.stdout,\n            })\n        }\n\n        return new Promise((res) => this._rl?.question(text, res))\n    }\n\n    close(): Promise<void> {\n        this._rl?.close()\n\n        return super.close()\n    }\n\n    start(params: Parameters<TelegramClient['start']>[0] = {}): Promise<User> {\n        if (!params.botToken) {\n            if (!params.phone) params.phone = () => this.input('phone > ')\n            if (!params.code) params.code = () => this.input('code > ')\n\n            if (!params.password) {\n                params.password = () => this.input('2fa password > ')\n            }\n        }\n\n        return super.start(params).then((user) => {\n            if (this._rl) {\n                this._rl.close()\n                delete this._rl\n            }\n\n            return user\n        })\n    }\n\n    run(\n        params: Parameters<TelegramClient['start']>[0] | ((user: User) => void | Promise<void>),\n        then?: (user: User) => void | Promise<void>,\n    ): void {\n        if (typeof params === 'function') {\n            then = params\n            params = {}\n        }\n\n        this.start(params)\n            .then(then)\n            .catch((err) => this.emitError(err))\n    }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,qCAAqC,CAAA;AACnD,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA","sourcesContent":["export * from './client.js'\nexport * from './common-internals-node/platform.js'\nexport * from './sqlite/index.js'\nexport * from './utils/crypto.js'\nexport * from './utils/tcp.js'\nexport * from './worker.js'\nexport * from '@mtcute/core'\nexport * from '@mtcute/html-parser'\nexport * from '@mtcute/markdown-parser'\n"]}

package/esm/methods/download-file.d.ts

@@ -0,0 +1,9 @@
+import { FileDownloadLocation, FileDownloadParameters, ITelegramClient } from '@mtcute/core';
+/**
+ * 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/esm/methods/download-file.js

@@ -0,0 +1,30 @@
+import { createWriteStream, rmSync } from 'fs';
+import { writeFile } from 'fs/promises';
+import { FileLocation } from '@mtcute/core';
+import { downloadAsIterable } from '@mtcute/core/methods.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 async function downloadToFile(client, filename, location, params) {
+    if (location instanceof FileLocation && ArrayBuffer.isView(location.location)) {
+        // early return for inline files
+        await writeFile(filename, location.location);
+    }
+    const output = createWriteStream(filename);
+    if (params?.abortSignal) {
+        params.abortSignal.addEventListener('abort', () => {
+            client.log.debug('aborting file download %s - cleaning up', filename);
+            output.destroy();
+            rmSync(filename);
+        });
+    }
+    for await (const chunk of downloadAsIterable(client, location, params)) {
+        output.write(chunk);
+    }
+    output.end();
+}
+//# sourceMappingURL=download-file.js.map

package/esm/methods/download-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-file.js","sourceRoot":"","sources":["../../../src/methods/download-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,IAAI,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAgD,YAAY,EAAmB,MAAM,cAAc,CAAA;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE5D;;;;;;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":["import { createWriteStream, rmSync } from 'fs'\nimport { writeFile } from 'fs/promises'\n\nimport { FileDownloadLocation, FileDownloadParameters, FileLocation, ITelegramClient } from '@mtcute/core'\nimport { downloadAsIterable } from '@mtcute/core/methods.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/methods/download-node-stream.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" resolution-mode="require"/>
+import { Readable } from 'stream';
+import { FileDownloadLocation, FileDownloadParameters, ITelegramClient } from '@mtcute/core';
+/**
+ * Download a remote file as a Node.js Readable stream.
+ *
+ * @param params  File download parameters
+ */
+export declare function downloadAsNodeStream(client: ITelegramClient, location: FileDownloadLocation, params?: FileDownloadParameters): Readable;