@mtcute/core 0.16.7 → 0.16.9

package/cjs/network/client.d.ts

@@ -1,216 +0,0 @@
-import EventEmitter from 'node:events';
-import type { mtp } from '@mtcute/tl';
-import { tl } from '@mtcute/tl';
-import type { TlReaderMap, TlWriterMap } from '@mtcute/tl-runtime';
-import type { IMtStorageProvider } from '../storage/provider.js';
-import type { StorageManagerExtraOptions } from '../storage/storage.js';
-import { StorageManager } from '../storage/storage.js';
-import type { MustEqual } from '../types/index.js';
-import type { DcOptions, ICryptoProvider, Logger } from '../utils/index.js';
-import { ConfigManager } from './config-manager.js';
-import type { NetworkManagerExtraParams, RpcCallOptions } from './network-manager.js';
-import { NetworkManager } from './network-manager.js';
-import type { PersistentConnectionParams } from './persistent-connection.js';
-import type { ReconnectionStrategy } from './reconnection.js';
-import type { TransportFactory } from './transports/index.js';
-/** Options for {@link MtClient} */
-export interface MtClientOptions {
-    /**
-     * API ID from my.telegram.org
-     */
-    apiId: number;
-    /**
-     * API hash from my.telegram.org
-     */
-    apiHash: string;
-    /**
-     * Storage to use for this client.
-     */
-    storage: IMtStorageProvider;
-    /** Additional options for the storage manager */
-    storageOptions?: StorageManagerExtraOptions;
-    /**
-     * Cryptography provider to allow delegating
-     * crypto to native addon, worker, etc.
-     */
-    crypto: ICryptoProvider;
-    /**
-     * Whether to use IPv6 datacenters
-     * (IPv6 will be preferred when choosing a DC by id)
-     * (default: false)
-     */
-    useIpv6?: boolean;
-    /**
-     * Primary DC to use for initial connection.
-     * This does not mean this will be the only DC used,
-     * nor that this DC will actually be primary, this only
-     * determines the first DC the library will try to connect to.
-     * Can be used to connect to other networks (like test DCs).
-     *
-     * When session already contains primary DC, this parameter is ignored.
-     *
-     * @default  Production DC 2.
-     */
-    defaultDcs?: DcOptions;
-    /**
-     * Whether to connect to test servers.
-     *
-     * If passed, {@link defaultDc} defaults to Test DC 2.
-     *
-     * **Must** be passed if using test servers, even if
-     * you passed custom {@link defaultDc}
-     */
-    testMode?: boolean;
-    /**
-     * Additional options for initConnection call.
-     * `apiId` and `query` are not available and will be ignored.
-     * Omitted values will be filled with defaults
-     */
-    initConnectionOptions?: Partial<Omit<tl.RawInitConnectionRequest, 'apiId' | 'query'>>;
-    /**
-     * Transport factory to use in the client.
-     *
-     * @default  platform-specific transport: WebSocket on the web, TCP in node
-     */
-    transport: TransportFactory;
-    /**
-     * Reconnection strategy.
-     *
-     * @default  simple reconnection strategy: first 0ms, then up to 5s (increasing by 1s)
-     */
-    reconnectionStrategy?: ReconnectionStrategy<PersistentConnectionParams>;
-    /**
-     * If true, all API calls will be wrapped with `tl.invokeWithoutUpdates`,
-     * effectively disabling the server-sent events for the clients.
-     * May be useful in some cases.
-     *
-     * @default false
-     */
-    disableUpdates?: boolean;
-    /**
-     * mtcute can send all unknown RPC errors to [danog](https://github.com/danog)'s
-     * [error reporting service](https://rpc.pwrtelegram.xyz/).
-     *
-     * This is fully anonymous (except maybe IP) and is only used to improve the library
-     * and developer experience for everyone working with MTProto. This is fully opt-in,
-     * and if you're too paranoid, you can disable it by manually passing `enableErrorReporting: false` to the client.
-     *
-     * @default false
-     */
-    enableErrorReporting?: boolean;
-    /**
-     * Extra parameters for {@link NetworkManager}
-     */
-    network?: NetworkManagerExtraParams;
-    /**
-     * Logger instance for the client.
-     * If not passed, a new one will be created.
-     */
-    logger?: Logger;
-    /**
-     * Set logging level for the client.
-     * Shorthand for `client.log.level = level`.
-     *
-     * See static members of {@link LogManager} for possible values.
-     */
-    logLevel?: number;
-    /**
-     * **EXPERT USE ONLY!**
-     *
-     * Override TL layer used for the connection.
-     *
-     * **Does not** change the schema used.
-     */
-    overrideLayer?: number;
-    /**
-     * **EXPERT USE ONLY**
-     *
-     * Override reader map used for the connection.
-     */
-    readerMap?: TlReaderMap;
-    /**
-     * **EXPERT USE ONLY**
-     *
-     * Override writer map used for the connection.
-     */
-    writerMap?: TlWriterMap;
-}
-/**
- * Basic MTProto client implementation, only doing the bare minimum
- * to make RPC calls and receive low-level updates, as well as providing
- * some APIs to manage that.
- */
-export declare class MtClient extends EventEmitter {
-    readonly params: MtClientOptions;
-    /**
-     * Crypto provider taken from {@link MtClientOptions.crypto}
-     */
-    readonly crypto: ICryptoProvider;
-    /** Storage manager */
-    readonly storage: StorageManager;
-    /**
-     * "Test mode" taken from {@link MtClientOptions.testMode}
-     */
-    protected readonly _testMode: boolean;
-    /**
-     * Primary DCs taken from {@link MtClientOptions.defaultDcs},
-     * loaded from session or changed by other means (like redirecting).
-     */
-    _defaultDcs: DcOptions;
-    /** TL layer used by the client */
-    readonly _layer: number;
-    /** TL readers map used by the client */
-    readonly _readerMap: TlReaderMap;
-    /** TL writers map used by the client */
-    readonly _writerMap: TlWriterMap;
-    readonly _config: ConfigManager;
-    private _emitError?;
-    readonly log: Logger;
-    readonly network: NetworkManager;
-    private _abortController;
-    readonly stopSignal: AbortSignal;
-    constructor(params: MtClientOptions);
-    emitError(err: unknown): void;
-    private _prepare;
-    /**
-     * **ADVANCED**
-     *
-     * Do all the preparations, but don't connect just yet.
-     * Useful when you want to do some preparations before
-     * connecting, like setting up session.
-     *
-     * Call {@link connect} to actually connect.
-     */
-    prepare(): Promise<void>;
-    private _connect;
-    /**
-     * Initialize the connection to the primary DC.
-     *
-     * You shouldn't usually call this method directly as it is called
-     * implicitly the first time you call {@link call}.
-     */
-    connect(): Promise<void>;
-    /**
-     * Close all connections and finalize the client.
-     */
-    close(): Promise<void>;
-    /**
-     * Make an RPC call.
-     *
-     * The connection must have been {@link connect}-ed
-     * before calling this method.
-     *
-     * This method is still quite low-level and you shouldn't use this
-     * when using high-level API provided by `@mtcute/client`.
-     *
-     * @param message  RPC method to call
-     * @param params  Additional call parameters
-     */
-    call<T extends tl.RpcMethod>(message: MustEqual<T, tl.RpcMethod>, params?: RpcCallOptions): Promise<tl.RpcCallReturn[T['_']] | mtp.RawMt_rpc_error>;
-    /**
-     * Register an error handler for the client
-     *
-     * @param handler Error handler.
-     */
-    onError(handler: (err: unknown) => void): void;
-}

package/cjs/network/client.js

@@ -1,189 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MtClient = void 0;
-const node_events_1 = __importDefault(require("node:events"));
-const tl_1 = require("@mtcute/tl");
-const reader_js_1 = require("@mtcute/tl/binary/reader.js");
-const writer_js_1 = require("@mtcute/tl/binary/writer.js");
-const storage_js_1 = require("../storage/storage.js");
-const index_js_1 = require("../utils/index.js");
-const config_manager_js_1 = require("./config-manager.js");
-const network_manager_js_1 = require("./network-manager.js");
-/**
- * Basic MTProto client implementation, only doing the bare minimum
- * to make RPC calls and receive low-level updates, as well as providing
- * some APIs to manage that.
- */
-class MtClient extends node_events_1.default {
-    params;
-    /**
-     * Crypto provider taken from {@link MtClientOptions.crypto}
-     */
-    crypto;
-    /** Storage manager */
-    storage;
-    /**
-     * "Test mode" taken from {@link MtClientOptions.testMode}
-     */
-    _testMode;
-    /**
-     * Primary DCs taken from {@link MtClientOptions.defaultDcs},
-     * loaded from session or changed by other means (like redirecting).
-     */
-    _defaultDcs;
-    /** TL layer used by the client */
-    _layer;
-    /** TL readers map used by the client */
-    _readerMap;
-    /** TL writers map used by the client */
-    _writerMap;
-    _config = new config_manager_js_1.ConfigManager(async () => {
-        const res = await this.call({ _: 'help.getConfig' });
-        if ((0, index_js_1.isTlRpcError)(res))
-            throw new Error(`Failed to get config: ${res.errorMessage}`);
-        return res;
-    });
-    _emitError;
-    log;
-    network;
-    _abortController;
-    stopSignal;
-    constructor(params) {
-        super();
-        this.params = params;
-        this.log = params.logger ?? new index_js_1.LogManager();
-        if (params.logLevel !== undefined) {
-            this.log.mgr.level = params.logLevel;
-        }
-        this.crypto = params.crypto;
-        this._testMode = Boolean(params.testMode);
-        let dc = params.defaultDcs;
-        if (!dc) {
-            if (params.testMode) {
-                dc = params.useIpv6 ? index_js_1.defaultTestIpv6Dc : index_js_1.defaultTestDc;
-            }
-            else {
-                dc = params.useIpv6 ? index_js_1.defaultProductionIpv6Dc : index_js_1.defaultProductionDc;
-            }
-        }
-        this._defaultDcs = dc;
-        this._layer = params.overrideLayer ?? tl_1.tl.LAYER;
-        this._readerMap = params.readerMap ?? reader_js_1.__tlReaderMap;
-        this._writerMap = params.writerMap ?? writer_js_1.__tlWriterMap;
-        this._abortController = new AbortController();
-        this.stopSignal = this._abortController.signal;
-        this.storage = new storage_js_1.StorageManager({
-            provider: params.storage,
-            log: this.log,
-            readerMap: this._readerMap,
-            writerMap: this._writerMap,
-            ...params.storageOptions,
-        });
-        this.network = new network_manager_js_1.NetworkManager({
-            apiId: params.apiId,
-            crypto: this.crypto,
-            disableUpdates: params.disableUpdates ?? false,
-            initConnectionOptions: params.initConnectionOptions,
-            layer: this._layer,
-            log: this.log,
-            readerMap: this._readerMap,
-            writerMap: this._writerMap,
-            reconnectionStrategy: params.reconnectionStrategy,
-            storage: this.storage,
-            testMode: Boolean(params.testMode),
-            transport: params.transport,
-            emitError: this.emitError.bind(this),
-            isPremium: false,
-            useIpv6: Boolean(params.useIpv6),
-            enableErrorReporting: params.enableErrorReporting ?? false,
-            onUsable: () => this.emit('usable'),
-            onConnecting: () => this.emit('connecting'),
-            onNetworkChanged: connected => this.emit('networkChanged', connected),
-            onUpdate: upd => this.emit('update', upd),
-            stopSignal: this.stopSignal,
-            ...params.network,
-        }, this._config);
-    }
-    emitError(err) {
-        if (this._emitError) {
-            this._emitError(err);
-        }
-        else if (this._connect.finished()) {
-            this.log.error('unhandled error:', err);
-        }
-    }
-    _prepare = (0, index_js_1.asyncResettable)(async () => {
-        await this.crypto.initialize?.();
-        await this.storage.load();
-        const primaryDc = await this.storage.dcs.fetch();
-        if (primaryDc !== null)
-            this._defaultDcs = primaryDc;
-    });
-    /**
-     * **ADVANCED**
-     *
-     * Do all the preparations, but don't connect just yet.
-     * Useful when you want to do some preparations before
-     * connecting, like setting up session.
-     *
-     * Call {@link connect} to actually connect.
-     */
-    prepare() {
-        return this._prepare.run();
-    }
-    _connect = (0, index_js_1.asyncResettable)(async () => {
-        await this._prepare.run();
-        await this.network.connect(this._defaultDcs);
-    });
-    /**
-     * Initialize the connection to the primary DC.
-     *
-     * You shouldn't usually call this method directly as it is called
-     * implicitly the first time you call {@link call}.
-     */
-    async connect() {
-        return this._connect.run();
-    }
-    /**
-     * Close all connections and finalize the client.
-     */
-    async close() {
-        this.log.debug('closing client');
-        this._config.destroy();
-        await this.network.destroy();
-        await this.storage.save();
-        await this.storage.destroy?.();
-        this._prepare.reset();
-        this._connect.reset();
-        this._abortController.abort();
-        this.log.debug('client closed successfully');
-    }
-    /**
-     * Make an RPC call.
-     *
-     * The connection must have been {@link connect}-ed
-     * before calling this method.
-     *
-     * This method is still quite low-level and you shouldn't use this
-     * when using high-level API provided by `@mtcute/client`.
-     *
-     * @param message  RPC method to call
-     * @param params  Additional call parameters
-     */
-    async call(message, params) {
-        return this.network.call(message, params);
-    }
-    /**
-     * Register an error handler for the client
-     *
-     * @param handler Error handler.
-     */
-    onError(handler) {
-        this._emitError = handler;
-    }
-}
-exports.MtClient = MtClient;
-//# sourceMappingURL=client.js.map

package/cjs/network/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/network/client.ts"],"names":[],"mappings":"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","sourcesContent":["import EventEmitter from 'node:events'\n\nimport type { mtp } from '@mtcute/tl'\nimport { tl } from '@mtcute/tl'\nimport { __tlReaderMap as defaultReaderMap } from '@mtcute/tl/binary/reader.js'\nimport { __tlWriterMap as defaultWriterMap } from '@mtcute/tl/binary/writer.js'\nimport type { TlReaderMap, TlWriterMap } from '@mtcute/tl-runtime'\n\nimport type { IMtStorageProvider } from '../storage/provider.js'\nimport type { StorageManagerExtraOptions } from '../storage/storage.js'\nimport { StorageManager } from '../storage/storage.js'\nimport type { MustEqual } from '../types/index.js'\nimport type {\n    DcOptions,\n    ICryptoProvider,\n    Logger,\n} from '../utils/index.js'\nimport {\n    LogManager,\n    asyncResettable,\n    defaultProductionDc,\n    defaultProductionIpv6Dc,\n    defaultTestDc,\n    defaultTestIpv6Dc,\n    isTlRpcError,\n} from '../utils/index.js'\n\nimport { ConfigManager } from './config-manager.js'\nimport type { NetworkManagerExtraParams, RpcCallOptions } from './network-manager.js'\nimport { NetworkManager } from './network-manager.js'\nimport type { PersistentConnectionParams } from './persistent-connection.js'\nimport type { ReconnectionStrategy } from './reconnection.js'\nimport type { TransportFactory } from './transports/index.js'\n\n/** Options for {@link MtClient} */\nexport interface MtClientOptions {\n    /**\n     * API ID from my.telegram.org\n     */\n    apiId: number\n    /**\n     * API hash from my.telegram.org\n     */\n    apiHash: string\n\n    /**\n     * Storage to use for this client.\n     */\n    storage: IMtStorageProvider\n\n    /** Additional options for the storage manager */\n    storageOptions?: StorageManagerExtraOptions\n\n    /**\n     * Cryptography provider to allow delegating\n     * crypto to native addon, worker, etc.\n     */\n    crypto: ICryptoProvider\n\n    /**\n     * Whether to use IPv6 datacenters\n     * (IPv6 will be preferred when choosing a DC by id)\n     * (default: false)\n     */\n    useIpv6?: boolean\n\n    /**\n     * Primary DC to use for initial connection.\n     * This does not mean this will be the only DC used,\n     * nor that this DC will actually be primary, this only\n     * determines the first DC the library will try to connect to.\n     * Can be used to connect to other networks (like test DCs).\n     *\n     * When session already contains primary DC, this parameter is ignored.\n     *\n     * @default  Production DC 2.\n     */\n    defaultDcs?: DcOptions\n\n    /**\n     * Whether to connect to test servers.\n     *\n     * If passed, {@link defaultDc} defaults to Test DC 2.\n     *\n     * **Must** be passed if using test servers, even if\n     * you passed custom {@link defaultDc}\n     */\n    testMode?: boolean\n\n    /**\n     * Additional options for initConnection call.\n     * `apiId` and `query` are not available and will be ignored.\n     * Omitted values will be filled with defaults\n     */\n    initConnectionOptions?: Partial<Omit<tl.RawInitConnectionRequest, 'apiId' | 'query'>>\n\n    /**\n     * Transport factory to use in the client.\n     *\n     * @default  platform-specific transport: WebSocket on the web, TCP in node\n     */\n    transport: TransportFactory\n\n    /**\n     * Reconnection strategy.\n     *\n     * @default  simple reconnection strategy: first 0ms, then up to 5s (increasing by 1s)\n     */\n    reconnectionStrategy?: ReconnectionStrategy<PersistentConnectionParams>\n\n    /**\n     * If true, all API calls will be wrapped with `tl.invokeWithoutUpdates`,\n     * effectively disabling the server-sent events for the clients.\n     * May be useful in some cases.\n     *\n     * @default false\n     */\n    disableUpdates?: boolean\n\n    /**\n     * mtcute can send all unknown RPC errors to [danog](https://github.com/danog)'s\n     * [error reporting service](https://rpc.pwrtelegram.xyz/).\n     *\n     * This is fully anonymous (except maybe IP) and is only used to improve the library\n     * and developer experience for everyone working with MTProto. This is fully opt-in,\n     * and if you're too paranoid, you can disable it by manually passing `enableErrorReporting: false` to the client.\n     *\n     * @default false\n     */\n    enableErrorReporting?: boolean\n\n    /**\n     * Extra parameters for {@link NetworkManager}\n     */\n    network?: NetworkManagerExtraParams\n\n    /**\n     * Logger instance for the client.\n     * If not passed, a new one will be created.\n     */\n    logger?: Logger\n\n    /**\n     * Set logging level for the client.\n     * Shorthand for `client.log.level = level`.\n     *\n     * See static members of {@link LogManager} for possible values.\n     */\n    logLevel?: number\n\n    /**\n     * **EXPERT USE ONLY!**\n     *\n     * Override TL layer used for the connection.\n     *\n     * **Does not** change the schema used.\n     */\n    overrideLayer?: number\n\n    /**\n     * **EXPERT USE ONLY**\n     *\n     * Override reader map used for the connection.\n     */\n    readerMap?: TlReaderMap\n\n    /**\n     * **EXPERT USE ONLY**\n     *\n     * Override writer map used for the connection.\n     */\n    writerMap?: TlWriterMap\n}\n\n/**\n * Basic MTProto client implementation, only doing the bare minimum\n * to make RPC calls and receive low-level updates, as well as providing\n * some APIs to manage that.\n */\nexport class MtClient extends EventEmitter {\n    /**\n     * Crypto provider taken from {@link MtClientOptions.crypto}\n     */\n    readonly crypto: ICryptoProvider\n\n    /** Storage manager */\n    readonly storage: StorageManager\n\n    /**\n     * \"Test mode\" taken from {@link MtClientOptions.testMode}\n     */\n    protected readonly _testMode: boolean\n\n    /**\n     * Primary DCs taken from {@link MtClientOptions.defaultDcs},\n     * loaded from session or changed by other means (like redirecting).\n     */\n    _defaultDcs: DcOptions\n\n    /** TL layer used by the client */\n    readonly _layer: number\n    /** TL readers map used by the client */\n    readonly _readerMap: TlReaderMap\n    /** TL writers map used by the client */\n    readonly _writerMap: TlWriterMap\n\n    readonly _config: ConfigManager = new ConfigManager(async () => {\n        const res = await this.call({ _: 'help.getConfig' })\n\n        if (isTlRpcError(res)) throw new Error(`Failed to get config: ${res.errorMessage}`)\n\n        return res\n    })\n\n    private _emitError?: (err: unknown) => void\n\n    readonly log: Logger\n    readonly network: NetworkManager\n\n    private _abortController: AbortController\n    readonly stopSignal: AbortSignal\n\n    constructor(readonly params: MtClientOptions) {\n        super()\n\n        this.log = params.logger ?? new LogManager()\n\n        if (params.logLevel !== undefined) {\n            this.log.mgr.level = params.logLevel\n        }\n\n        this.crypto = params.crypto\n        this._testMode = Boolean(params.testMode)\n\n        let dc = params.defaultDcs\n\n        if (!dc) {\n            if (params.testMode) {\n                dc = params.useIpv6 ? defaultTestIpv6Dc : defaultTestDc\n            } else {\n                dc = params.useIpv6 ? defaultProductionIpv6Dc : defaultProductionDc\n            }\n        }\n\n        this._defaultDcs = dc\n\n        this._layer = params.overrideLayer ?? tl.LAYER\n        this._readerMap = params.readerMap ?? defaultReaderMap\n        this._writerMap = params.writerMap ?? defaultWriterMap\n\n        this._abortController = new AbortController()\n        this.stopSignal = this._abortController.signal\n\n        this.storage = new StorageManager({\n            provider: params.storage,\n            log: this.log,\n            readerMap: this._readerMap,\n            writerMap: this._writerMap,\n            ...params.storageOptions,\n        })\n\n        this.network = new NetworkManager(\n            {\n                apiId: params.apiId,\n                crypto: this.crypto,\n                disableUpdates: params.disableUpdates ?? false,\n                initConnectionOptions: params.initConnectionOptions,\n                layer: this._layer,\n                log: this.log,\n                readerMap: this._readerMap,\n                writerMap: this._writerMap,\n                reconnectionStrategy: params.reconnectionStrategy,\n                storage: this.storage,\n                testMode: Boolean(params.testMode),\n                transport: params.transport,\n                emitError: this.emitError.bind(this),\n                isPremium: false,\n                useIpv6: Boolean(params.useIpv6),\n                enableErrorReporting: params.enableErrorReporting ?? false,\n                onUsable: () => this.emit('usable'),\n                onConnecting: () => this.emit('connecting'),\n                onNetworkChanged: connected => this.emit('networkChanged', connected),\n                onUpdate: upd => this.emit('update', upd),\n                stopSignal: this.stopSignal,\n                ...params.network,\n            },\n            this._config,\n        )\n    }\n\n    emitError(err: unknown): void {\n        if (this._emitError) {\n            this._emitError(err)\n        } else if (this._connect.finished()) {\n            this.log.error('unhandled error:', err)\n        }\n    }\n\n    private _prepare = asyncResettable(async () => {\n        await this.crypto.initialize?.()\n        await this.storage.load()\n\n        const primaryDc = await this.storage.dcs.fetch()\n        if (primaryDc !== null) this._defaultDcs = primaryDc\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(): Promise<void> {\n        return this._prepare.run()\n    }\n\n    private _connect = asyncResettable(async () => {\n        await this._prepare.run()\n        await this.network.connect(this._defaultDcs)\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    /**\n     * Close all connections and finalize the client.\n     */\n    async close(): Promise<void> {\n        this.log.debug('closing client')\n\n        this._config.destroy()\n        await this.network.destroy()\n\n        await this.storage.save()\n        await this.storage.destroy?.()\n\n        this._prepare.reset()\n        this._connect.reset()\n        this._abortController.abort()\n\n        this.log.debug('client closed successfully')\n    }\n\n    /**\n     * Make an RPC call.\n     *\n     * The connection must have been {@link connect}-ed\n     * before calling this method.\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['_']] | mtp.RawMt_rpc_error> {\n        return this.network.call(message, params)\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._emitError = handler\n    }\n}\n"]}

package/cjs/network/config-manager.d.ts

@@ -1,19 +0,0 @@
-import type { tl } from '@mtcute/tl';
-import { Reloadable } from '../utils/reloadable.js';
-/**
- * Config manager is responsible for keeping
- * the current server configuration up-to-date
- * and providing methods to find the best DC
- * option for the current session.
- */
-export declare class ConfigManager extends Reloadable<tl.RawConfig> {
-    constructor(update: () => Promise<tl.RawConfig>);
-    findOption(params: {
-        dcId: number;
-        allowIpv6?: boolean;
-        preferIpv6?: boolean;
-        allowMedia?: boolean;
-        preferMedia?: boolean;
-        cdn?: boolean;
-    }): Promise<tl.RawDcOption | undefined>;
-}

package/cjs/network/config-manager.js

@@ -1,51 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigManager = void 0;
-const reloadable_js_1 = require("../utils/reloadable.js");
-/**
- * Config manager is responsible for keeping
- * the current server configuration up-to-date
- * and providing methods to find the best DC
- * option for the current session.
- */
-class ConfigManager extends reloadable_js_1.Reloadable {
-    constructor(update) {
-        super({
-            reload: update,
-            getExpiresAt: data => data.expires * 1000,
-        });
-    }
-    async findOption(params) {
-        if (this.isStale)
-            await this.update();
-        const options = this._data.dcOptions.filter((opt) => {
-            if (opt.tcpoOnly)
-                return false; // unsupported
-            if (opt.ipv6 && !params.allowIpv6)
-                return false;
-            if (opt.mediaOnly && !params.allowMedia)
-                return false;
-            if (opt.cdn && !params.cdn)
-                return false;
-            return opt.id === params.dcId;
-        });
-        if (params.preferMedia && params.preferIpv6) {
-            const r = options.find(opt => opt.mediaOnly && opt.ipv6);
-            if (r)
-                return r;
-        }
-        if (params.preferMedia) {
-            const r = options.find(opt => opt.mediaOnly);
-            if (r)
-                return r;
-        }
-        if (params.preferIpv6) {
-            const r = options.find(opt => opt.ipv6);
-            if (r)
-                return r;
-        }
-        return options[0];
-    }
-}
-exports.ConfigManager = ConfigManager;
-//# sourceMappingURL=config-manager.js.map

package/cjs/network/config-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../../src/network/config-manager.ts"],"names":[],"mappings":";;;AAEA,0DAAmD;AAEnD;;;;;GAKG;AACH,MAAa,aAAc,SAAQ,0BAAwB;IACvD,YAAY,MAAmC;QAC3C,KAAK,CAAC;YACF,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI;SAC5C,CAAC,CAAA;IACN,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAOhB;QACG,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAErC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;YACjD,IAAI,GAAG,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAA,CAAC,cAAc;YAC7C,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAA;YAC/C,IAAI,GAAG,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAA;YACrD,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG;gBAAE,OAAO,KAAK,CAAA;YAExC,OAAO,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,CAAA;QACjC,CAAC,CAAC,CAAA;QAEF,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,CAAA;YACxD,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAA;QACnB,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;YAC5C,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAA;QACnB,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACvC,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAA;QACnB,CAAC;QAED,OAAO,OAAO,CAAC,CAAC,CAAC,CAAA;IACrB,CAAC;CACJ;AA5CD,sCA4CC","sourcesContent":["import type { tl } from '@mtcute/tl'\n\nimport { Reloadable } from '../utils/reloadable.js'\n\n/**\n * Config manager is responsible for keeping\n * the current server configuration up-to-date\n * and providing methods to find the best DC\n * option for the current session.\n */\nexport class ConfigManager extends Reloadable<tl.RawConfig> {\n    constructor(update: () => Promise<tl.RawConfig>) {\n        super({\n            reload: update,\n            getExpiresAt: data => data.expires * 1000,\n        })\n    }\n\n    async findOption(params: {\n        dcId: number\n        allowIpv6?: boolean\n        preferIpv6?: boolean\n        allowMedia?: boolean\n        preferMedia?: boolean\n        cdn?: boolean\n    }): Promise<tl.RawDcOption | undefined> {\n        if (this.isStale) await this.update()\n\n        const options = this._data!.dcOptions.filter((opt) => {\n            if (opt.tcpoOnly) return false // unsupported\n            if (opt.ipv6 && !params.allowIpv6) return false\n            if (opt.mediaOnly && !params.allowMedia) return false\n            if (opt.cdn && !params.cdn) return false\n\n            return opt.id === params.dcId\n        })\n\n        if (params.preferMedia && params.preferIpv6) {\n            const r = options.find(opt => opt.mediaOnly && opt.ipv6)\n            if (r) return r\n        }\n\n        if (params.preferMedia) {\n            const r = options.find(opt => opt.mediaOnly)\n            if (r) return r\n        }\n\n        if (params.preferIpv6) {\n            const r = options.find(opt => opt.ipv6)\n            if (r) return r\n        }\n\n        return options[0]\n    }\n}\n"]}

package/cjs/network/index.js

@@ -1,22 +0,0 @@
-"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);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./client.js"), exports);
-__exportStar(require("./middlewares/index.js"), exports);
-__exportStar(require("./reconnection.js"), exports);
-__exportStar(require("./session-connection.js"), exports);
-__exportStar(require("./transports/index.js"), exports);
-//# sourceMappingURL=index.js.map

package/cjs/network/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/network/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,yDAAsC;AAQtC,oDAAiC;AACjC,0DAAuC;AACvC,wDAAqC","sourcesContent":["export * from './client.js'\nexport * from './middlewares/index.js'\nexport type {\n    ConnectionKind,\n    NetworkManagerExtraParams,\n    RpcCallMiddleware,\n    RpcCallMiddlewareContext,\n    RpcCallOptions,\n} from './network-manager.js'\nexport * from './reconnection.js'\nexport * from './session-connection.js'\nexport * from './transports/index.js'\n"]}

package/cjs/network/middlewares/bundle.js

@@ -1,20 +0,0 @@
-"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);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./default.js"), exports);
-__exportStar(require("./on-error.js"), exports);
-__exportStar(require("./on-method.js"), exports);
-//# sourceMappingURL=bundle.js.map

package/cjs/network/middlewares/bundle.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../../src/network/middlewares/bundle.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,gDAA6B;AAC7B,iDAA8B","sourcesContent":["export * from './default.js'\nexport * from './on-error.js'\nexport * from './on-method.js'\n"]}

package/cjs/network/middlewares/default.d.ts

@@ -1,8 +0,0 @@
-import type { RpcCallMiddleware } from '../network-manager.js';
-import type { FloodWaiterOptions } from './flood-waiter.js';
-import type { InternalErrorsHandlerOptions } from './internal-errors.js';
-export interface BasicMiddlewaresOptions {
-    floodWaiter?: FloodWaiterOptions;
-    internalErrors?: InternalErrorsHandlerOptions;
-}
-export declare function basic(options?: BasicMiddlewaresOptions): RpcCallMiddleware[];

package/cjs/network/middlewares/default.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.basic = basic;
-const flood_waiter_js_1 = require("./flood-waiter.js");
-const internal_errors_js_1 = require("./internal-errors.js");
-function basic(options) {
-    return [(0, flood_waiter_js_1.floodWaiter)(options?.floodWaiter ?? {}), (0, internal_errors_js_1.internalErrorsHandler)(options?.internalErrors ?? {})];
-}
-//# sourceMappingURL=default.js.map

package/cjs/network/middlewares/default.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../../src/network/middlewares/default.ts"],"names":[],"mappings":";;AAYA,sBAEC;AAXD,uDAA+C;AAE/C,6DAA4D;AAO5D,SAAgB,KAAK,CAAC,OAAiC;IACnD,OAAO,CAAC,IAAA,6BAAW,EAAC,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,IAAA,0CAAqB,EAAC,OAAO,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,CAAA;AAC1G,CAAC","sourcesContent":["import type { RpcCallMiddleware } from '../network-manager.js'\n\nimport type { FloodWaiterOptions } from './flood-waiter.js'\nimport { floodWaiter } from './flood-waiter.js'\nimport type { InternalErrorsHandlerOptions } from './internal-errors.js'\nimport { internalErrorsHandler } from './internal-errors.js'\n\nexport interface BasicMiddlewaresOptions {\n    floodWaiter?: FloodWaiterOptions\n    internalErrors?: InternalErrorsHandlerOptions\n}\n\nexport function basic(options?: BasicMiddlewaresOptions): RpcCallMiddleware[] {\n    return [floodWaiter(options?.floodWaiter ?? {}), internalErrorsHandler(options?.internalErrors ?? {})]\n}\n"]}

package/cjs/network/middlewares/flood-waiter.d.ts

@@ -1,37 +0,0 @@
-import type { RpcCallMiddleware } from '../network-manager.js';
-export interface FloodWaiterOptions {
-    /**
-     * Maximum number of ms to wait when a FLOOD_WAIT_X
-     * error is encountered. If the wait time is greater
-     * than this value, the request will throw an error instead
-     *
-     * This can be overwritten on a per-request basis by setting
-     * `floodSleepThreshold` in the request parameters
-     *
-     * @default  10_000
-     */
-    maxWait?: number;
-    /**
-     * Maximum number of retries to perform when a FLOOD_WAIT_X
-     * error is encountered. After this number of retries, the
-     * last error will be thrown
-     *
-     * @default  5
-     */
-    maxRetries?: number;
-    /**
-     * Whether to store the last flood wait time and delay
-     * the consecutive requests accordingly
-     *
-     * @default  true
-     */
-    store?: boolean;
-    /**
-     * If the stored wait time is less than this value,
-     * the request will not be delayed
-     *
-     * @default  3_000
-     */
-    minStoredWait?: number;
-}
-export declare function floodWaiter(options: FloodWaiterOptions): RpcCallMiddleware;