@mtcute/core 0.7.3 → 0.8.0

package/README.md

@@ -2,25 +2,48 @@
 
 📖 [API Reference](https://ref.mtcute.dev/modules/_mtcute_core.html)
 
-Basic low-level MTProto implementation and auxiliary utilities.
+Platform-agnostic MTProto implementation and auxiliary utilities.
 
 ## Features
 - **MTProto 2.0**: Implements the full MTProto protocol, including all the encryption and serialization
 - **2FA support**: Provides utilities for 2-step verification
 - **Hackable**: Bring your own storage, transport, and other components to customize the library to your needs
 - **Magical**: Handles reconnections, connection pooling, DC redirections and other stuff for you
-- **Web support**: Works in the browser with no additional configuration
+- **Updates handling**: Implements proper updates handling, including ordering and gap recovery (learn more)
+- **High-level**: Includes a high-level API that wrap the MTProto APIs and provide a clean interface
+- **Tree-shaking**: You can import just the methods you need, and the rest will not be included into the bundle
 
 ## Usage
 
 ```ts
-import { BaseTelegramClient } from '@mtcute/core'
+import { BaseTelegramClient } from '@mtcute/core/client.js'
 
 const tg = new BaseTelegramClient({
     apiId: 12345,
     apiHash: '0123456789abcdef0123456789abcdef',
+    crypto: new MyCryptoProvider(),
+    storage: new MyStorage(),
+    transport: () => new MyTransport(),
 })
 
 tg.call({ _: 'help.getConfig' })
     .then(console.log)
 ```
+
+## Usage with high-level API
+
+```ts
+import { TelegramClient } from '@mtcute/core/client.js'
+
+const tg = new TelegramClient({
+    // ... same options as above
+})
+
+tg.run({
+    phone: '+1234567890',
+    code: () => prompt('Enter the code:'),
+    password: 'my-password',
+}, async (user) => {
+    console.log(`✨ logged in as ${user.displayName}`)
+})
+```

package/cjs/highlevel/base.d.ts

@@ -4,7 +4,7 @@ import { ConnectionKind, RpcCallOptions } from '../network/network-manager.js';
 import { StorageManagerExtraOptions } from '../storage/storage.js';
 import { MustEqual } from '../types/utils.js';
 import { StringSessionData } from '../utils/index.js';
-import { ITelegramClient } from './client.types.js';
+import { ConnectionState, ITelegramClient } from './client.types.js';
 import { AppConfigManager } from './managers/app-config-manager.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
 import { TelegramStorageManager, TelegramStorageManagerExtraOptions } from './storage/storage.js';
@@ -19,6 +19,7 @@ export declare class BaseTelegramClient implements ITelegramClient {
     readonly params: BaseTelegramClientOptions;
     readonly updates?: UpdatesManager;
     private _serverUpdatesHandler;
+    private _connectionStateHandler;
     constructor(params: BaseTelegramClientOptions);
     readonly log: import("../utils/logger.js").Logger;
     readonly mt: MtClient;
@@ -100,6 +101,7 @@ export declare class BaseTelegramClient implements ITelegramClient {
     handleClientUpdate(updates: tl.TypeUpdates, noDispatch?: boolean): void;
     onServerUpdate(handler: (update: tl.TypeUpdates) => void): void;
     onUpdate(handler: RawUpdateHandler): void;
+    onConnectionState(handler: (state: ConnectionState) => void): void;
     getApiCrenetials(): Promise<{
         id: number;
         hash: string;

package/cjs/highlevel/base.js

@@ -12,6 +12,7 @@ class BaseTelegramClient {
     constructor(params) {
         this.params = params;
         this._serverUpdatesHandler = () => { };
+        this._connectionStateHandler = () => { };
         this.log = this.params.logger ?? new logger_js_1.LogManager('client');
         this.mt = new client_js_1.MtClient({
             ...this.params,
@@ -40,10 +41,24 @@ class BaseTelegramClient {
         if (!params.disableUpdates && params.updates !== false) {
             this.updates = new manager_js_1.UpdatesManager(this, params.updates);
             this._serverUpdatesHandler = this.updates.handleUpdate.bind(this.updates);
+            this.updates.onCatchingUp((catchingUp) => {
+                this._connectionStateHandler(catchingUp ? 'updating' : 'connected');
+            });
         }
         this.mt.on('update', (update) => {
             this._serverUpdatesHandler(update);
         });
+        this.mt.on('usable', () => {
+            this._connectionStateHandler('connected');
+        });
+        this.mt.on('wait', () => {
+            this._connectionStateHandler('connecting');
+        });
+        this.mt.on('networkChanged', (connected) => {
+            if (!connected) {
+                this._connectionStateHandler('offline');
+            }
+        });
     }
     /**
      * **ADVANCED**
@@ -199,6 +214,9 @@ class BaseTelegramClient {
         }
         this.updates.setHandler(handler);
     }
+    onConnectionState(handler) {
+        this._connectionStateHandler = handler;
+    }
     async getApiCrenetials() {
         return {
             id: this.params.apiId,

package/cjs/highlevel/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/highlevel/base.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/require-await */\nimport { tl } from '@mtcute/tl'\n\nimport { MtClient, MtClientOptions } from '../network/client.js'\nimport { ConnectionKind, RpcCallOptions } from '../network/network-manager.js'\nimport { StorageManagerExtraOptions } from '../storage/storage.js'\nimport { MtArgumentError } from '../types/errors.js'\nimport { MustEqual } from '../types/utils.js'\nimport {\n    asyncResettable,\n    computeNewPasswordHash,\n    computeSrpParams,\n    readStringSession,\n    StringSessionData,\n    writeStringSession,\n} from '../utils/index.js'\nimport { LogManager } from '../utils/logger.js'\nimport { ITelegramClient } from './client.types.js'\nimport { AppConfigManager } from './managers/app-config-manager.js'\nimport { ITelegramStorageProvider } from './storage/provider.js'\nimport { TelegramStorageManager, TelegramStorageManagerExtraOptions } from './storage/storage.js'\nimport { UpdatesManager } from './updates/manager.js'\nimport { RawUpdateHandler, UpdatesManagerParams } from './updates/types.js'\n\nexport interface BaseTelegramClientOptions extends MtClientOptions {\n    storage: ITelegramStorageProvider\n    storageOptions?: StorageManagerExtraOptions & TelegramStorageManagerExtraOptions\n    updates?: UpdatesManagerParams | false\n}\n\nexport class BaseTelegramClient implements ITelegramClient {\n    readonly updates?: UpdatesManager\n    private _serverUpdatesHandler: (updates: tl.TypeUpdates) => void = () => {}\n\n    constructor(readonly params: BaseTelegramClientOptions) {\n        if (!params.disableUpdates && params.updates !== false) {\n            this.updates = new UpdatesManager(this, params.updates)\n            this._serverUpdatesHandler = this.updates.handleUpdate.bind(this.updates)\n        }\n\n        this.mt.on('update', (update: tl.TypeUpdates) => {\n            this._serverUpdatesHandler(update)\n        })\n    }\n\n    readonly log = this.params.logger ?? new LogManager('client')\n    readonly mt = new MtClient({\n        ...this.params,\n        logger: this.log.create('mtproto'),\n    })\n    readonly crypto = this.mt.crypto\n    readonly storage = new TelegramStorageManager(this.mt.storage, {\n        provider: this.params.storage,\n        ...this.params.storageOptions,\n    })\n    readonly appConfig = new AppConfigManager(this)\n\n    private _prepare = asyncResettable(async () => {\n        await this.mt.prepare()\n\n        const self = await this.storage.self.fetch()\n        this.log.prefix = `[USER ${self?.userId ?? 'n/a'}] `\n        this.mt.network.setIsPremium(self?.isPremium ?? false)\n\n        await this.updates?.prepare()\n    })\n\n    /**\n     * **ADVANCED**\n     *\n     * Do all the preparations, but don't connect just yet.\n     * Useful when you want to do some preparations before\n     * connecting, like setting up session.\n     *\n     * Call {@link connect} to actually connect.\n     */\n    prepare() {\n        return this._prepare.run()\n    }\n\n    // used in a hot path, avoid extra function calls\n    private _connected = false\n    private _connect = asyncResettable(async () => {\n        await this._prepare.run()\n        await this.mt.connect()\n        this._connected = true\n    })\n\n    /**\n     * Initialize the connection to the primary DC.\n     *\n     * You shouldn't usually call this method directly as it is called\n     * implicitly the first time you call {@link call}.\n     */\n    async connect(): Promise<void> {\n        return this._connect.run()\n    }\n\n    get isConnected(): boolean {\n        return this._connected\n    }\n\n    async close(): Promise<void> {\n        await this.mt.close()\n        this.updates?.stopLoop()\n        this._prepare.reset()\n        this._connect.reset()\n        this._connected = false\n    }\n\n    async notifyLoggedIn(auth: tl.auth.TypeAuthorization | tl.RawUser): Promise<tl.RawUser> {\n        const user = this.mt.network.notifyLoggedIn(auth)\n\n        this.log.prefix = `[USER ${user.id}] `\n        const self = await this.storage.self.storeFrom(user)\n\n        this.updates?.notifyLoggedIn(self)\n\n        return user\n    }\n\n    async notifyLoggedOut(): Promise<void> {\n        this.mt.network.notifyLoggedOut()\n\n        this.log.prefix = '[USER n/a] '\n        await this.storage.self.store(null)\n    }\n\n    async notifyChannelOpened(channelId: number, pts?: number): Promise<boolean> {\n        return this.updates?.notifyChannelOpened(channelId, pts) ?? false\n    }\n\n    async notifyChannelClosed(channelId: number): Promise<boolean> {\n        return this.updates?.notifyChannelClosed(channelId) ?? false\n    }\n\n    async startUpdatesLoop(): Promise<void> {\n        await this.updates?.startLoop()\n    }\n\n    async stopUpdatesLoop(): Promise<void> {\n        this.updates?.stopLoop()\n    }\n\n    /**\n     * Make an RPC call\n     *\n     * This method is still quite low-level and you shouldn't use this\n     * when using high-level API provided by `@mtcute/client`.\n     *\n     * @param message  RPC method to call\n     * @param params  Additional call parameters\n     */\n    async call<T extends tl.RpcMethod>(\n        message: MustEqual<T, tl.RpcMethod>,\n        params?: RpcCallOptions,\n    ): Promise<tl.RpcCallReturn[T['_']]> {\n        if (!this._connected) {\n            await this._connect.run()\n        }\n\n        const res = await this.mt.call(message, params)\n\n        await this.storage.peers.updatePeersFrom(res)\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return res\n    }\n\n    /**\n     * Import the session from the given session string.\n     *\n     * Note that the session will only be imported in case\n     * the storage is missing authorization (i.e. does not contain\n     * auth key for the primary DC), otherwise it will be ignored (unless `force`).\n     *\n     * @param session  Session string to import\n     * @param force  Whether to overwrite existing session\n     */\n    async importSession(session: string | StringSessionData, force = false): Promise<void> {\n        await this.prepare()\n\n        const defaultDcAuthKey = await this.mt.storage.provider.authKeys.get(this.mt._defaultDcs.main.id)\n\n        if (defaultDcAuthKey && !force) return\n\n        const data = typeof session === 'string' ? readStringSession(this.mt._readerMap, session) : session\n\n        if (data.testMode && !this.params.testMode) {\n            throw new Error(\n                'This session string is not for the current backend. ' +\n                    `Session is ${data.testMode ? 'test' : 'prod'}, ` +\n                    `but the client is ${this.params.testMode ? 'test' : 'prod'}`,\n            )\n        }\n\n        this.mt._defaultDcs = data.primaryDcs\n        await this.mt.storage.dcs.store(data.primaryDcs)\n\n        if (data.self) {\n            await this.storage.self.store(data.self)\n        }\n\n        await this.mt.storage.provider.authKeys.set(data.primaryDcs.main.id, data.authKey)\n\n        await this.mt.storage.save()\n    }\n\n    /**\n     * Export current session to a single *LONG* string, containing\n     * all the needed information.\n     *\n     * > **Warning!** Anyone with this string will be able\n     * > to authorize as you and do anything. Treat this\n     * > as your password, and never give it away!\n     * >\n     * > In case you have accidentally leaked this string,\n     * > make sure to revoke this session in account settings:\n     * > \"Privacy & Security\" > \"Active sessions\" >\n     * > find the one containing `mtcute` > Revoke,\n     * > or, in case this is a bot, revoke bot token\n     * > with [@BotFather](//t.me/botfather)\n     */\n    async exportSession(): Promise<string> {\n        await this._prepare.run()\n\n        const primaryDcs = (await this.mt.storage.dcs.fetch()) ?? this.mt._defaultDcs\n\n        const authKey = await this.mt.storage.provider.authKeys.get(primaryDcs.main.id)\n        if (!authKey) throw new Error('Auth key is not ready yet')\n\n        return writeStringSession({\n            version: 3,\n            self: await this.storage.self.fetch(),\n            testMode: Boolean(this.params.testMode),\n            primaryDcs,\n            authKey,\n        })\n    }\n\n    /**\n     * Register an error handler for the client\n     *\n     * @param handler  Error handler.\n     */\n    onError(handler: (err: unknown) => void): void {\n        this.mt.onError(handler)\n    }\n\n    emitError(err: unknown): void {\n        this.mt.emitError(err)\n    }\n\n    handleClientUpdate(updates: tl.TypeUpdates, noDispatch?: boolean): void {\n        this.updates?.handleClientUpdate(updates, noDispatch)\n    }\n\n    onServerUpdate(handler: (update: tl.TypeUpdates) => void): void {\n        this._serverUpdatesHandler = handler\n    }\n\n    onUpdate(handler: RawUpdateHandler): void {\n        if (!this.updates) {\n            throw new MtArgumentError('Updates manager is disabled')\n        }\n\n        this.updates.setHandler(handler)\n    }\n\n    async getApiCrenetials() {\n        return {\n            id: this.params.apiId,\n            hash: this.params.apiHash,\n        }\n    }\n\n    async getPoolSize(kind: ConnectionKind, dcId?: number): Promise<number> {\n        if (!this._connected) {\n            await this._connect.run()\n        }\n\n        return this.mt.network.getPoolSize(kind, dcId)\n    }\n\n    async getPrimaryDcId(): Promise<number> {\n        if (!this._connected) {\n            await this._connect.run()\n        }\n\n        return this.mt.network.getPrimaryDcId()\n    }\n\n    computeSrpParams(request: tl.account.RawPassword, password: string): Promise<tl.RawInputCheckPasswordSRP> {\n        return computeSrpParams(this.crypto, request, password)\n    }\n    computeNewPasswordHash(algo: tl.TypePasswordKdfAlgo, password: string): Promise<Uint8Array> {\n        return computeNewPasswordHash(this.crypto, algo, password)\n    }\n}\n"]}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/highlevel/base.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/require-await */\nimport { tl } from '@mtcute/tl'\n\nimport { MtClient, MtClientOptions } from '../network/client.js'\nimport { ConnectionKind, RpcCallOptions } from '../network/network-manager.js'\nimport { StorageManagerExtraOptions } from '../storage/storage.js'\nimport { MtArgumentError } from '../types/errors.js'\nimport { MustEqual } from '../types/utils.js'\nimport {\n    asyncResettable,\n    computeNewPasswordHash,\n    computeSrpParams,\n    readStringSession,\n    StringSessionData,\n    writeStringSession,\n} from '../utils/index.js'\nimport { LogManager } from '../utils/logger.js'\nimport { ConnectionState, ITelegramClient } from './client.types.js'\nimport { AppConfigManager } from './managers/app-config-manager.js'\nimport { ITelegramStorageProvider } from './storage/provider.js'\nimport { TelegramStorageManager, TelegramStorageManagerExtraOptions } from './storage/storage.js'\nimport { UpdatesManager } from './updates/manager.js'\nimport { RawUpdateHandler, UpdatesManagerParams } from './updates/types.js'\n\nexport interface BaseTelegramClientOptions extends MtClientOptions {\n    storage: ITelegramStorageProvider\n    storageOptions?: StorageManagerExtraOptions & TelegramStorageManagerExtraOptions\n    updates?: UpdatesManagerParams | false\n}\n\nexport class BaseTelegramClient implements ITelegramClient {\n    readonly updates?: UpdatesManager\n    private _serverUpdatesHandler: (updates: tl.TypeUpdates) => void = () => {}\n    private _connectionStateHandler: (state: ConnectionState) => void = () => {}\n\n    constructor(readonly params: BaseTelegramClientOptions) {\n        if (!params.disableUpdates && params.updates !== false) {\n            this.updates = new UpdatesManager(this, params.updates)\n            this._serverUpdatesHandler = this.updates.handleUpdate.bind(this.updates)\n            this.updates.onCatchingUp((catchingUp) => {\n                this._connectionStateHandler(catchingUp ? 'updating' : 'connected')\n            })\n        }\n\n        this.mt.on('update', (update: tl.TypeUpdates) => {\n            this._serverUpdatesHandler(update)\n        })\n        this.mt.on('usable', () => {\n            this._connectionStateHandler('connected')\n        })\n        this.mt.on('wait', () => {\n            this._connectionStateHandler('connecting')\n        })\n        this.mt.on('networkChanged', (connected: boolean) => {\n            if (!connected) {\n                this._connectionStateHandler('offline')\n            }\n        })\n    }\n\n    readonly log = this.params.logger ?? new LogManager('client')\n    readonly mt = new MtClient({\n        ...this.params,\n        logger: this.log.create('mtproto'),\n    })\n    readonly crypto = this.mt.crypto\n    readonly storage = new TelegramStorageManager(this.mt.storage, {\n        provider: this.params.storage,\n        ...this.params.storageOptions,\n    })\n    readonly appConfig = new AppConfigManager(this)\n\n    private _prepare = asyncResettable(async () => {\n        await this.mt.prepare()\n\n        const self = await this.storage.self.fetch()\n        this.log.prefix = `[USER ${self?.userId ?? 'n/a'}] `\n        this.mt.network.setIsPremium(self?.isPremium ?? false)\n\n        await this.updates?.prepare()\n    })\n\n    /**\n     * **ADVANCED**\n     *\n     * Do all the preparations, but don't connect just yet.\n     * Useful when you want to do some preparations before\n     * connecting, like setting up session.\n     *\n     * Call {@link connect} to actually connect.\n     */\n    prepare() {\n        return this._prepare.run()\n    }\n\n    // used in a hot path, avoid extra function calls\n    private _connected = false\n    private _connect = asyncResettable(async () => {\n        await this._prepare.run()\n        await this.mt.connect()\n        this._connected = true\n    })\n\n    /**\n     * Initialize the connection to the primary DC.\n     *\n     * You shouldn't usually call this method directly as it is called\n     * implicitly the first time you call {@link call}.\n     */\n    async connect(): Promise<void> {\n        return this._connect.run()\n    }\n\n    get isConnected(): boolean {\n        return this._connected\n    }\n\n    async close(): Promise<void> {\n        await this.mt.close()\n        this.updates?.stopLoop()\n        this._prepare.reset()\n        this._connect.reset()\n        this._connected = false\n    }\n\n    async notifyLoggedIn(auth: tl.auth.TypeAuthorization | tl.RawUser): Promise<tl.RawUser> {\n        const user = this.mt.network.notifyLoggedIn(auth)\n\n        this.log.prefix = `[USER ${user.id}] `\n        const self = await this.storage.self.storeFrom(user)\n\n        this.updates?.notifyLoggedIn(self)\n\n        return user\n    }\n\n    async notifyLoggedOut(): Promise<void> {\n        this.mt.network.notifyLoggedOut()\n\n        this.log.prefix = '[USER n/a] '\n        await this.storage.self.store(null)\n    }\n\n    async notifyChannelOpened(channelId: number, pts?: number): Promise<boolean> {\n        return this.updates?.notifyChannelOpened(channelId, pts) ?? false\n    }\n\n    async notifyChannelClosed(channelId: number): Promise<boolean> {\n        return this.updates?.notifyChannelClosed(channelId) ?? false\n    }\n\n    async startUpdatesLoop(): Promise<void> {\n        await this.updates?.startLoop()\n    }\n\n    async stopUpdatesLoop(): Promise<void> {\n        this.updates?.stopLoop()\n    }\n\n    /**\n     * Make an RPC call\n     *\n     * This method is still quite low-level and you shouldn't use this\n     * when using high-level API provided by `@mtcute/client`.\n     *\n     * @param message  RPC method to call\n     * @param params  Additional call parameters\n     */\n    async call<T extends tl.RpcMethod>(\n        message: MustEqual<T, tl.RpcMethod>,\n        params?: RpcCallOptions,\n    ): Promise<tl.RpcCallReturn[T['_']]> {\n        if (!this._connected) {\n            await this._connect.run()\n        }\n\n        const res = await this.mt.call(message, params)\n\n        await this.storage.peers.updatePeersFrom(res)\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return res\n    }\n\n    /**\n     * Import the session from the given session string.\n     *\n     * Note that the session will only be imported in case\n     * the storage is missing authorization (i.e. does not contain\n     * auth key for the primary DC), otherwise it will be ignored (unless `force`).\n     *\n     * @param session  Session string to import\n     * @param force  Whether to overwrite existing session\n     */\n    async importSession(session: string | StringSessionData, force = false): Promise<void> {\n        await this.prepare()\n\n        const defaultDcAuthKey = await this.mt.storage.provider.authKeys.get(this.mt._defaultDcs.main.id)\n\n        if (defaultDcAuthKey && !force) return\n\n        const data = typeof session === 'string' ? readStringSession(this.mt._readerMap, session) : session\n\n        if (data.testMode && !this.params.testMode) {\n            throw new Error(\n                'This session string is not for the current backend. ' +\n                    `Session is ${data.testMode ? 'test' : 'prod'}, ` +\n                    `but the client is ${this.params.testMode ? 'test' : 'prod'}`,\n            )\n        }\n\n        this.mt._defaultDcs = data.primaryDcs\n        await this.mt.storage.dcs.store(data.primaryDcs)\n\n        if (data.self) {\n            await this.storage.self.store(data.self)\n        }\n\n        await this.mt.storage.provider.authKeys.set(data.primaryDcs.main.id, data.authKey)\n\n        await this.mt.storage.save()\n    }\n\n    /**\n     * Export current session to a single *LONG* string, containing\n     * all the needed information.\n     *\n     * > **Warning!** Anyone with this string will be able\n     * > to authorize as you and do anything. Treat this\n     * > as your password, and never give it away!\n     * >\n     * > In case you have accidentally leaked this string,\n     * > make sure to revoke this session in account settings:\n     * > \"Privacy & Security\" > \"Active sessions\" >\n     * > find the one containing `mtcute` > Revoke,\n     * > or, in case this is a bot, revoke bot token\n     * > with [@BotFather](//t.me/botfather)\n     */\n    async exportSession(): Promise<string> {\n        await this._prepare.run()\n\n        const primaryDcs = (await this.mt.storage.dcs.fetch()) ?? this.mt._defaultDcs\n\n        const authKey = await this.mt.storage.provider.authKeys.get(primaryDcs.main.id)\n        if (!authKey) throw new Error('Auth key is not ready yet')\n\n        return writeStringSession({\n            version: 3,\n            self: await this.storage.self.fetch(),\n            testMode: Boolean(this.params.testMode),\n            primaryDcs,\n            authKey,\n        })\n    }\n\n    /**\n     * Register an error handler for the client\n     *\n     * @param handler  Error handler.\n     */\n    onError(handler: (err: unknown) => void): void {\n        this.mt.onError(handler)\n    }\n\n    emitError(err: unknown): void {\n        this.mt.emitError(err)\n    }\n\n    handleClientUpdate(updates: tl.TypeUpdates, noDispatch?: boolean): void {\n        this.updates?.handleClientUpdate(updates, noDispatch)\n    }\n\n    onServerUpdate(handler: (update: tl.TypeUpdates) => void): void {\n        this._serverUpdatesHandler = handler\n    }\n\n    onUpdate(handler: RawUpdateHandler): void {\n        if (!this.updates) {\n            throw new MtArgumentError('Updates manager is disabled')\n        }\n\n        this.updates.setHandler(handler)\n    }\n\n    onConnectionState(handler: (state: ConnectionState) => void): void {\n        this._connectionStateHandler = handler\n    }\n\n    async getApiCrenetials() {\n        return {\n            id: this.params.apiId,\n            hash: this.params.apiHash,\n        }\n    }\n\n    async getPoolSize(kind: ConnectionKind, dcId?: number): Promise<number> {\n        if (!this._connected) {\n            await this._connect.run()\n        }\n\n        return this.mt.network.getPoolSize(kind, dcId)\n    }\n\n    async getPrimaryDcId(): Promise<number> {\n        if (!this._connected) {\n            await this._connect.run()\n        }\n\n        return this.mt.network.getPrimaryDcId()\n    }\n\n    computeSrpParams(request: tl.account.RawPassword, password: string): Promise<tl.RawInputCheckPasswordSRP> {\n        return computeSrpParams(this.crypto, request, password)\n    }\n    computeNewPasswordHash(algo: tl.TypePasswordKdfAlgo, password: string): Promise<Uint8Array> {\n        return computeNewPasswordHash(this.crypto, algo, password)\n    }\n}\n"]}

package/cjs/highlevel/client.d.ts

@@ -3,6 +3,7 @@ import EventEmitter from 'events';
 import Long from 'long';
 import { tdFileId } from '@mtcute/file-id';
 import { tl } from '@mtcute/tl';
+import { RpcCallOptions } from '../network/index.js';
 import { MaybeArray, MaybePromise, PartialExcept, PartialOnly } from '../types/index.js';
 import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
@@ -36,15 +37,14 @@ import { ITelegramStorageProvider } from './storage/provider.js';
 import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FileDownloadLocation, FileDownloadParameters, ForumTopic, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, MaybeDynamic, Message, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeersIndex, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, Sticker, StickerSet, StickerSourceType, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate } from './types/index.js';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { StringSessionData } from './utils/string-session.js';
-type TelegramClientOptions = ((Omit<BaseTelegramClientOptions, 'storage'> & {
+type TelegramClientOptions = ((PartialOnly<Omit<BaseTelegramClientOptions, 'storage'>, 'transport' | 'crypto'> & {
     /**
      * Storage to use for this client.
      *
-     * If a string is passed, it will be used as:
-     *   - a path to a JSON file for Node.js
-     *   - IndexedDB database name for browsers
+     * If a string is passed, it will be used as
+     * a name for the default platform-specific storage provider to use.
      *
-     * If omitted, {@link MemoryStorage} is used
+     * @default `"client.session"`
      */
     storage?: string | ITelegramStorageProvider;
 }) | {
@@ -229,6 +229,13 @@ export interface TelegramClient extends ITelegramClient {
      */
     on(name: 'bot_reaction_count', handler: (upd: BotReactionCountUpdate) => void): this;
     on(name: string, handler: (...args: any[]) => void): this;
+    /**
+     * Wrap this client so that all RPC calls will use the specified parameters.
+     *
+     * @param params  Parameters to use
+     * @returns  Wrapped client
+     */
+    withParams(params: RpcCallOptions): this;
     /**
      * Check your Two-Step verification password and log in
      *
@@ -1696,7 +1703,7 @@ export interface TelegramClient extends ITelegramClient {
      * **Available**: 👤 users only
      *
      */
-    getFolders(): Promise<tl.TypeDialogFilter[]>;
+    getFolders(): Promise<tl.messages.RawDialogFilters>;
     /**
      * Get dialogs with certain peers.
      *
@@ -1827,7 +1834,7 @@ export interface TelegramClient extends ITelegramClient {
      */
     downloadAsBuffer(location: FileDownloadLocation, params?: FileDownloadParameters): Promise<Uint8Array>;
     /**
-     * Download a remote file to a local file (only for NodeJS).
+     * Download a remote file to a local file (only for Node.js).
      * Promise will resolve once the download is complete.
      *
      * **Available**: ✅ both users and bots
@@ -1846,6 +1853,14 @@ export interface TelegramClient extends ITelegramClient {
      * @param params  Download parameters
      */
     downloadAsIterable(input: FileDownloadLocation, params?: FileDownloadParameters): AsyncIterableIterator<Uint8Array>;
+    /**
+     * Download a remote file as a Node.js Readable stream.
+     *
+     * **Available**: ✅ both users and bots
+     *
+     * @param params  File download parameters
+     */
+    downloadAsNodeStream(location: FileDownloadLocation, params?: FileDownloadParameters): import('stream').Readable;
     /**
      * Download a file and return it as a readable stream,
      * streaming file contents.
@@ -1891,9 +1906,6 @@ export interface TelegramClient extends ITelegramClient {
     uploadFile(params: {
         /**
          * Upload file source.
-         *
-         * > **Note**: `fs.ReadStream` is a subclass of `stream.Readable` and contains
-         * > info about file name, thus you don't need to pass them explicitly.
          */
         file: UploadFileLike;
         /**
@@ -4406,6 +4418,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<User>;
 }
 export type { TelegramClientOptions };
+export * from './base.js';
 export declare class TelegramClient extends EventEmitter implements ITelegramClient {
     _client: ITelegramClient;
     constructor(opts: TelegramClientOptions);

package/cjs/highlevel/client.js

@@ -1,4 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -8,7 +22,7 @@ exports.TelegramClient = void 0;
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
 /* THIS FILE WAS AUTO-GENERATED */
 const events_1 = __importDefault(require("events"));
-const index_js_1 = require("../storage/providers/memory/index.js");
+const index_js_1 = require("../types/index.js");
 const base_js_1 = require("./base.js");
 const check_password_js_1 = require("./methods/auth/check-password.js");
 const get_password_hint_js_1 = require("./methods/auth/get-password-hint.js");
@@ -94,7 +108,6 @@ const get_peer_dialogs_js_1 = require("./methods/dialogs/get-peer-dialogs.js");
 const iter_dialogs_js_1 = require("./methods/dialogs/iter-dialogs.js");
 const set_folders_order_js_1 = require("./methods/dialogs/set-folders-order.js");
 const download_buffer_js_1 = require("./methods/files/download-buffer.js");
-const download_file_js_1 = require("./methods/files/download-file.js");
 const download_iterable_js_1 = require("./methods/files/download-iterable.js");
 const download_stream_js_1 = require("./methods/files/download-stream.js");
 const normalize_input_file_js_1 = require("./methods/files/normalize-input-file.js");
@@ -169,6 +182,7 @@ const unpin_all_messages_js_1 = require("./methods/messages/unpin-all-messages.j
 const unpin_message_js_1 = require("./methods/messages/unpin-message.js");
 const init_takeout_session_js_1 = require("./methods/misc/init-takeout-session.js");
 const normalize_privacy_rules_js_1 = require("./methods/misc/normalize-privacy-rules.js");
+const with_params_js_1 = require("./methods/misc/with-params.js");
 const change_cloud_password_js_1 = require("./methods/password/change-cloud-password.js");
 const enable_cloud_password_js_1 = require("./methods/password/enable-cloud-password.js");
 const password_email_js_1 = require("./methods/password/password-email.js");
@@ -231,7 +245,7 @@ const unblock_user_js_1 = require("./methods/users/unblock-user.js");
 const update_profile_js_1 = require("./methods/users/update-profile.js");
 const conversation_js_1 = require("./types/conversation.js");
 const parsed_js_1 = require("./updates/parsed.js");
-const storage_js_1 = require("./utils/platform/storage.js");
+__exportStar(require("./base.js"), exports);
 class TelegramClient extends events_1.default {
     constructor(opts) {
         super();
@@ -239,20 +253,10 @@ class TelegramClient extends events_1.default {
             this._client = opts.client;
         }
         else {
-            let storage;
-            if (typeof opts.storage === 'string') {
-                storage = (0, storage_js_1._defaultStorageFactory)(opts.storage);
-            }
-            else if (!opts.storage) {
-                storage = new index_js_1.MemoryStorage();
-            }
-            else {
-                storage = opts.storage;
+            if (!opts.storage || typeof opts.storage === 'string' || !opts.transport || !opts.crypto) {
+                throw new index_js_1.MtUnsupportedError('You need to explicitly provide storage, transport and crypto for @mtcute/core');
             }
-            this._client = new base_js_1.BaseTelegramClient({
-                ...opts,
-                storage,
-            });
+            this._client = new base_js_1.BaseTelegramClient(opts);
         }
         // @ts-expect-error codegen
         this.log = this._client.log;
@@ -273,6 +277,9 @@ class TelegramClient extends events_1.default {
             },
         }));
     }
+    withParams(params) {
+        return (0, with_params_js_1.withParams)(this, params);
+    }
 }
 exports.TelegramClient = TelegramClient;
 TelegramClient.prototype.checkPassword = function (...args) {
@@ -542,9 +549,6 @@ TelegramClient.prototype.setFoldersOrder = function (...args) {
 TelegramClient.prototype.downloadAsBuffer = function (...args) {
     return (0, download_buffer_js_1.downloadAsBuffer)(this._client, ...args);
 };
-TelegramClient.prototype.downloadToFile = function (...args) {
-    return (0, download_file_js_1.downloadToFile)(this._client, ...args);
-};
 TelegramClient.prototype.downloadAsIterable = function (...args) {
     return (0, download_iterable_js_1.downloadAsIterable)(this._client, ...args);
 };
@@ -1060,6 +1064,9 @@ TelegramClient.prototype.computeSrpParams = function (...args) {
 TelegramClient.prototype.computeNewPasswordHash = function (...args) {
     return this._client.computeNewPasswordHash(...args);
 };
+TelegramClient.prototype.onConnectionState = function (...args) {
+    return this._client.onConnectionState(...args);
+};
 TelegramClient.prototype.onServerUpdate = function () {
     throw new Error('onServerUpdate is not available for TelegramClient, use .on() methods instead');
 };