@mtcute/core 0.6.0 → 0.7.1

package/cjs/highlevel/base.d.ts

@@ -0,0 +1,111 @@
+import { tl } from '@mtcute/tl';
+import { MtClient, MtClientOptions } from '../network/client.js';
+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 { AppConfigManager } from './managers/app-config-manager.js';
+import { ITelegramStorageProvider } from './storage/provider.js';
+import { TelegramStorageManager, TelegramStorageManagerExtraOptions } from './storage/storage.js';
+import { UpdatesManager } from './updates/manager.js';
+import { RawUpdateHandler, UpdatesManagerParams } from './updates/types.js';
+export interface BaseTelegramClientOptions extends MtClientOptions {
+    storage: ITelegramStorageProvider;
+    storageOptions?: StorageManagerExtraOptions & TelegramStorageManagerExtraOptions;
+    updates?: UpdatesManagerParams | false;
+}
+export declare class BaseTelegramClient implements ITelegramClient {
+    readonly params: BaseTelegramClientOptions;
+    readonly updates?: UpdatesManager;
+    private _serverUpdatesHandler;
+    constructor(params: BaseTelegramClientOptions);
+    readonly log: import("../utils/logger.js").Logger;
+    readonly mt: MtClient;
+    readonly crypto: import("../utils/index.js").ICryptoProvider;
+    readonly storage: TelegramStorageManager;
+    readonly appConfig: AppConfigManager;
+    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 _connected;
+    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>;
+    get isConnected(): boolean;
+    close(): Promise<void>;
+    notifyLoggedIn(auth: tl.auth.TypeAuthorization | tl.RawUser): Promise<tl.RawUser>;
+    notifyLoggedOut(): Promise<void>;
+    notifyChannelOpened(channelId: number, pts?: number): Promise<boolean>;
+    notifyChannelClosed(channelId: number): Promise<boolean>;
+    startUpdatesLoop(): Promise<void>;
+    stopUpdatesLoop(): Promise<void>;
+    /**
+     * Make an RPC call
+     *
+     * 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['_']]>;
+    /**
+     * Import the session from the given session string.
+     *
+     * Note that the session will only be imported in case
+     * the storage is missing authorization (i.e. does not contain
+     * auth key for the primary DC), otherwise it will be ignored (unless `force`).
+     *
+     * @param session  Session string to import
+     * @param force  Whether to overwrite existing session
+     */
+    importSession(session: string | StringSessionData, force?: boolean): Promise<void>;
+    /**
+     * Export current session to a single *LONG* string, containing
+     * all the needed information.
+     *
+     * > **Warning!** Anyone with this string will be able
+     * > to authorize as you and do anything. Treat this
+     * > as your password, and never give it away!
+     * >
+     * > In case you have accidentally leaked this string,
+     * > make sure to revoke this session in account settings:
+     * > "Privacy & Security" > "Active sessions" >
+     * > find the one containing `mtcute` > Revoke,
+     * > or, in case this is a bot, revoke bot token
+     * > with [@BotFather](//t.me/botfather)
+     */
+    exportSession(): Promise<string>;
+    /**
+     * Register an error handler for the client
+     *
+     * @param handler  Error handler.
+     */
+    onError(handler: (err: unknown) => void): void;
+    emitError(err: unknown): void;
+    handleClientUpdate(updates: tl.TypeUpdates, noDispatch?: boolean): void;
+    onServerUpdate(handler: (update: tl.TypeUpdates) => void): void;
+    onUpdate(handler: RawUpdateHandler): void;
+    getApiCrenetials(): Promise<{
+        id: number;
+        hash: string;
+    }>;
+    getPoolSize(kind: ConnectionKind, dcId?: number): Promise<number>;
+    getPrimaryDcId(): Promise<number>;
+    computeSrpParams(request: tl.account.RawPassword, password: string): Promise<tl.RawInputCheckPasswordSRP>;
+    computeNewPasswordHash(algo: tl.TypePasswordKdfAlgo, password: string): Promise<Uint8Array>;
+}

package/cjs/highlevel/base.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseTelegramClient = void 0;
+const client_js_1 = require("../network/client.js");
+const errors_js_1 = require("../types/errors.js");
+const index_js_1 = require("../utils/index.js");
+const logger_js_1 = require("../utils/logger.js");
+const app_config_manager_js_1 = require("./managers/app-config-manager.js");
+const storage_js_1 = require("./storage/storage.js");
+const manager_js_1 = require("./updates/manager.js");
+class BaseTelegramClient {
+    constructor(params) {
+        this.params = params;
+        this._serverUpdatesHandler = () => { };
+        this.log = this.params.logger ?? new logger_js_1.LogManager('client');
+        this.mt = new client_js_1.MtClient({
+            ...this.params,
+            logger: this.log.create('mtproto'),
+        });
+        this.crypto = this.mt.crypto;
+        this.storage = new storage_js_1.TelegramStorageManager(this.mt.storage, {
+            provider: this.params.storage,
+            ...this.params.storageOptions,
+        });
+        this.appConfig = new app_config_manager_js_1.AppConfigManager(this);
+        this._prepare = (0, index_js_1.asyncResettable)(async () => {
+            await this.mt.prepare();
+            const self = await this.storage.self.fetch();
+            this.log.prefix = `[USER ${self?.userId ?? 'n/a'}] `;
+            this.mt.network.setIsPremium(self?.isPremium ?? false);
+            await this.updates?.prepare();
+        });
+        // used in a hot path, avoid extra function calls
+        this._connected = false;
+        this._connect = (0, index_js_1.asyncResettable)(async () => {
+            await this._prepare.run();
+            await this.mt.connect();
+            this._connected = true;
+        });
+        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.mt.on('update', (update) => {
+            this._serverUpdatesHandler(update);
+        });
+    }
+    /**
+     * **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();
+    }
+    /**
+     * 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();
+    }
+    get isConnected() {
+        return this._connected;
+    }
+    async close() {
+        await this.mt.close();
+        this.updates?.stopLoop();
+        this._prepare.reset();
+        this._connect.reset();
+        this._connected = false;
+    }
+    async notifyLoggedIn(auth) {
+        const user = this.mt.network.notifyLoggedIn(auth);
+        this.log.prefix = `[USER ${user.id}] `;
+        const self = await this.storage.self.storeFrom(user);
+        this.updates?.notifyLoggedIn(self);
+        return user;
+    }
+    async notifyLoggedOut() {
+        this.mt.network.notifyLoggedOut();
+        this.log.prefix = '[USER n/a] ';
+        await this.storage.self.store(null);
+    }
+    async notifyChannelOpened(channelId, pts) {
+        return this.updates?.notifyChannelOpened(channelId, pts) ?? false;
+    }
+    async notifyChannelClosed(channelId) {
+        return this.updates?.notifyChannelClosed(channelId) ?? false;
+    }
+    async startUpdatesLoop() {
+        await this.updates?.startLoop();
+    }
+    async stopUpdatesLoop() {
+        this.updates?.stopLoop();
+    }
+    /**
+     * Make an RPC call
+     *
+     * 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) {
+        if (!this._connected) {
+            await this._connect.run();
+        }
+        const res = await this.mt.call(message, params);
+        await this.storage.peers.updatePeersFrom(res);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return res;
+    }
+    /**
+     * Import the session from the given session string.
+     *
+     * Note that the session will only be imported in case
+     * the storage is missing authorization (i.e. does not contain
+     * auth key for the primary DC), otherwise it will be ignored (unless `force`).
+     *
+     * @param session  Session string to import
+     * @param force  Whether to overwrite existing session
+     */
+    async importSession(session, force = false) {
+        await this.prepare();
+        const defaultDcAuthKey = await this.mt.storage.provider.authKeys.get(this.mt._defaultDcs.main.id);
+        if (defaultDcAuthKey && !force)
+            return;
+        const data = typeof session === 'string' ? (0, index_js_1.readStringSession)(this.mt._readerMap, session) : session;
+        if (data.testMode && !this.params.testMode) {
+            throw new Error('This session string is not for the current backend. ' +
+                `Session is ${data.testMode ? 'test' : 'prod'}, ` +
+                `but the client is ${this.params.testMode ? 'test' : 'prod'}`);
+        }
+        this.mt._defaultDcs = data.primaryDcs;
+        await this.mt.storage.dcs.store(data.primaryDcs);
+        if (data.self) {
+            await this.storage.self.store(data.self);
+        }
+        await this.mt.storage.provider.authKeys.set(data.primaryDcs.main.id, data.authKey);
+        await this.mt.storage.save();
+    }
+    /**
+     * Export current session to a single *LONG* string, containing
+     * all the needed information.
+     *
+     * > **Warning!** Anyone with this string will be able
+     * > to authorize as you and do anything. Treat this
+     * > as your password, and never give it away!
+     * >
+     * > In case you have accidentally leaked this string,
+     * > make sure to revoke this session in account settings:
+     * > "Privacy & Security" > "Active sessions" >
+     * > find the one containing `mtcute` > Revoke,
+     * > or, in case this is a bot, revoke bot token
+     * > with [@BotFather](//t.me/botfather)
+     */
+    async exportSession() {
+        await this._prepare.run();
+        const primaryDcs = (await this.mt.storage.dcs.fetch()) ?? this.mt._defaultDcs;
+        const authKey = await this.mt.storage.provider.authKeys.get(primaryDcs.main.id);
+        if (!authKey)
+            throw new Error('Auth key is not ready yet');
+        return (0, index_js_1.writeStringSession)({
+            version: 2,
+            self: await this.storage.self.fetch(),
+            testMode: Boolean(this.params.testMode),
+            primaryDcs,
+            authKey,
+        });
+    }
+    /**
+     * Register an error handler for the client
+     *
+     * @param handler  Error handler.
+     */
+    onError(handler) {
+        this.mt.onError(handler);
+    }
+    emitError(err) {
+        this.mt.emitError(err);
+    }
+    handleClientUpdate(updates, noDispatch) {
+        this.updates?.handleClientUpdate(updates, noDispatch);
+    }
+    onServerUpdate(handler) {
+        this._serverUpdatesHandler = handler;
+    }
+    onUpdate(handler) {
+        if (!this.updates) {
+            throw new errors_js_1.MtArgumentError('Updates manager is disabled');
+        }
+        this.updates.setHandler(handler);
+    }
+    async getApiCrenetials() {
+        return {
+            id: this.params.apiId,
+            hash: this.params.apiHash,
+        };
+    }
+    async getPoolSize(kind, dcId) {
+        if (!this._connected) {
+            await this._connect.run();
+        }
+        return this.mt.network.getPoolSize(kind, dcId);
+    }
+    async getPrimaryDcId() {
+        if (!this._connected) {
+            await this._connect.run();
+        }
+        return this.mt.network.getPrimaryDcId();
+    }
+    computeSrpParams(request, password) {
+        return (0, index_js_1.computeSrpParams)(this.crypto, request, password);
+    }
+    computeNewPasswordHash(algo, password) {
+        return (0, index_js_1.computeNewPasswordHash)(this.crypto, algo, password);
+    }
+}
+exports.BaseTelegramClient = BaseTelegramClient;
+//# sourceMappingURL=base.js.map

package/cjs/highlevel/base.js.map

@@ -0,0 +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: 2,\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"]}