@mtcute/core 0.15.3 → 0.16.1

package/cjs/storage/driver.js

@@ -10,7 +10,7 @@ class BaseStorageDriver {
     _destroyed = false;
     _log;
     setup(log) {
-        this._log = log;
+        this._log = log.create('sqlite');
     }
     get loaded() {
         return this._loadedTimes > 0;

package/cjs/storage/driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/storage/driver.ts"],"names":[],"mappings":";;;AA0CA;;;GAGG;AACH,MAAsB,iBAAiB;IAK3B,YAAY,GAAG,CAAC,CAAA;IAChB,UAAU,GAAG,KAAK,CAAA;IAEhB,IAAI,CAAS;IAEvB,KAAK,CAAC,GAAW;QACb,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACnB,CAAC;IAED,IAAc,MAAM;QAChB,OAAO,IAAI,CAAC,YAAY,GAAG,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,IAAI;QACN,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;YAClB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;QAC3B,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACT,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAM;QACV,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAA;QAEnB,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;YACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QAC1B,CAAC;IACL,CAAC;IAED,IAAI;QACA,OAAO,IAAI,CAAC,KAAK,EAAE,EAAE,CAAA;IACzB,CAAC;CACJ;AA3CD,8CA2CC","sourcesContent":["import { MaybePromise } from '../types/utils.js'\nimport { Logger } from '../utils/logger.js'\n\n/**\n * Basic storage driver interface,\n * describing the lifecycle of a storage driver\n */\nexport interface IStorageDriver {\n    /**\n     * Load session from some external storage.\n     * Should be used either to load data from file/network/etc\n     * to memory, or to open required connections to fetch data on demand\n     *\n     * May be called more than once, handle this with care\n     * (or use {@link BaseStorageDriver} that handles this for you)\n     */\n    load?(): MaybePromise<void>\n    /**\n     * Save session to some external storage.\n     * Should be used to commit pending changes in the session.\n     * For example, saving session content to file/network/etc,\n     * or committing a database transaction\n     *\n     * It is safe to batch all changes and only commit them here,\n     * unless stated otherwise in the method description\n     */\n    save?(): MaybePromise<void>\n    /**\n     * Cleanup session and release all used resources.\n     *\n     * May be called more than once, handle this with care\n     * (or use {@link BaseStorageDriver} that handles this for you)\n     */\n    destroy?(): MaybePromise<void>\n\n    /**\n     * Setup the driver, passing the logger instance,\n     * in case your driver needs it\n     */\n    setup?(log: Logger): void\n}\n\n/**\n * Base storage driver class, implementing {@link IStorageDriver}\n * and handling the lifecycle for you\n */\nexport abstract class BaseStorageDriver implements IStorageDriver {\n    abstract _load(): MaybePromise<void>\n    abstract _destroy(): MaybePromise<void>\n    abstract _save?(): MaybePromise<void>\n\n    private _loadedTimes = 0\n    private _destroyed = false\n\n    protected _log!: Logger\n\n    setup(log: Logger): void {\n        this._log = log\n    }\n\n    protected get loaded(): boolean {\n        return this._loadedTimes > 0\n    }\n\n    async load(): Promise<void> {\n        if (this._loadedTimes === 0) {\n            await this._load()\n            this._destroyed = false\n        }\n\n        this._loadedTimes++\n    }\n\n    async destroy(): Promise<void> {\n        if (this._destroyed) {\n            return\n        }\n\n        this._loadedTimes--\n\n        if (this._loadedTimes === 0) {\n            await this._destroy()\n            this._destroyed = true\n        }\n    }\n\n    save(): MaybePromise<void> {\n        return this._save?.()\n    }\n}\n"]}
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/storage/driver.ts"],"names":[],"mappings":";;;AA0CA;;;GAGG;AACH,MAAsB,iBAAiB;IAK3B,YAAY,GAAG,CAAC,CAAA;IAChB,UAAU,GAAG,KAAK,CAAA;IAEhB,IAAI,CAAS;IAEvB,KAAK,CAAC,GAAW;QACb,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,IAAc,MAAM;QAChB,OAAO,IAAI,CAAC,YAAY,GAAG,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,IAAI;QACN,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;YAClB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;QAC3B,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACT,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAM;QACV,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAA;QAEnB,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;YACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QAC1B,CAAC;IACL,CAAC;IAED,IAAI;QACA,OAAO,IAAI,CAAC,KAAK,EAAE,EAAE,CAAA;IACzB,CAAC;CACJ;AA3CD,8CA2CC","sourcesContent":["import { MaybePromise } from '../types/utils.js'\nimport { Logger } from '../utils/logger.js'\n\n/**\n * Basic storage driver interface,\n * describing the lifecycle of a storage driver\n */\nexport interface IStorageDriver {\n    /**\n     * Load session from some external storage.\n     * Should be used either to load data from file/network/etc\n     * to memory, or to open required connections to fetch data on demand\n     *\n     * May be called more than once, handle this with care\n     * (or use {@link BaseStorageDriver} that handles this for you)\n     */\n    load?(): MaybePromise<void>\n    /**\n     * Save session to some external storage.\n     * Should be used to commit pending changes in the session.\n     * For example, saving session content to file/network/etc,\n     * or committing a database transaction\n     *\n     * It is safe to batch all changes and only commit them here,\n     * unless stated otherwise in the method description\n     */\n    save?(): MaybePromise<void>\n    /**\n     * Cleanup session and release all used resources.\n     *\n     * May be called more than once, handle this with care\n     * (or use {@link BaseStorageDriver} that handles this for you)\n     */\n    destroy?(): MaybePromise<void>\n\n    /**\n     * Setup the driver, passing the logger instance,\n     * in case your driver needs it\n     */\n    setup?(log: Logger): void\n}\n\n/**\n * Base storage driver class, implementing {@link IStorageDriver}\n * and handling the lifecycle for you\n */\nexport abstract class BaseStorageDriver implements IStorageDriver {\n    abstract _load(): MaybePromise<void>\n    abstract _destroy(): MaybePromise<void>\n    abstract _save?(): MaybePromise<void>\n\n    private _loadedTimes = 0\n    private _destroyed = false\n\n    protected _log!: Logger\n\n    setup(log: Logger): void {\n        this._log = log.create('sqlite')\n    }\n\n    protected get loaded(): boolean {\n        return this._loadedTimes > 0\n    }\n\n    async load(): Promise<void> {\n        if (this._loadedTimes === 0) {\n            await this._load()\n            this._destroyed = false\n        }\n\n        this._loadedTimes++\n    }\n\n    async destroy(): Promise<void> {\n        if (this._destroyed) {\n            return\n        }\n\n        this._loadedTimes--\n\n        if (this._loadedTimes === 0) {\n            await this._destroy()\n            this._destroyed = true\n        }\n    }\n\n    save(): MaybePromise<void> {\n        return this._save?.()\n    }\n}\n"]}

package/cjs/storage/storage.js

@@ -34,7 +34,7 @@ class StorageManager {
         this.driver.setup?.(this.log);
         if (this.options.cleanup ?? true) {
             this._cleanupRestore = (0, platform_js_1.getPlatform)().beforeExit(() => {
-                this._destroy().catch((err) => this.log.error('cleanup error: %s', err));
+                this._destroy().catch((err) => this.log.error('cleanup error: %e', err));
             });
         }
         await this.driver.load?.();

package/cjs/storage/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":"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","sourcesContent":["import { TlReaderMap, TlWriterMap } from '@mtcute/tl-runtime'\n\nimport { getPlatform } from '../platform.js'\nimport { asyncResettable } from '../utils/index.js'\nimport { Logger } from '../utils/logger.js'\nimport { IMtStorageProvider } from './provider.js'\nimport { AuthKeysService } from './service/auth-keys.js'\nimport { ServiceOptions } from './service/base.js'\nimport { DefaultDcsService } from './service/default-dcs.js'\nimport { FutureSaltsService } from './service/future-salts.js'\n\ninterface StorageManagerOptions {\n    provider: IMtStorageProvider\n    log: Logger\n    readerMap: TlReaderMap\n    writerMap: TlWriterMap\n}\n\n/**\n * Additional options for {@link StorageManager}, that\n * can be customized by the user.\n *\n * @internal\n */\nexport interface StorageManagerExtraOptions {\n    /**\n     * Interval in milliseconds for saving the storage.\n     *\n     * When saving, the storage is expected to persist\n     * all changes to disk, so that they are not lost.\n     */\n    saveInterval?: number\n\n    /**\n     * Whether to finalize database before exiting.\n     *\n     * @default  `true`\n     */\n    cleanup?: boolean\n}\n\nexport class StorageManager {\n    readonly provider\n    readonly driver\n    readonly log\n    readonly dcs\n    readonly salts\n    readonly keys\n\n    constructor(readonly options: StorageManagerOptions & StorageManagerExtraOptions) {\n        this.provider = this.options.provider\n        this.driver = this.provider.driver\n        this.log = this.options.log.create('storage')\n\n        const serviceOptions: ServiceOptions = {\n            driver: this.driver,\n            readerMap: this.options.readerMap,\n            writerMap: this.options.writerMap,\n            log: this.log,\n        }\n\n        this.dcs = new DefaultDcsService(this.provider.kv, serviceOptions)\n        this.salts = new FutureSaltsService(this.provider.kv, serviceOptions)\n        this.keys = new AuthKeysService(this.provider.authKeys, this.salts, serviceOptions)\n    }\n\n    private _cleanupRestore?: () => void\n\n    private _load = asyncResettable(async () => {\n        this.driver.setup?.(this.log)\n\n        if (this.options.cleanup ?? true) {\n            this._cleanupRestore = getPlatform().beforeExit(() => {\n                this._destroy().catch((err) => this.log.error('cleanup error: %s', err))\n            })\n        }\n\n        await this.driver.load?.()\n    })\n    load(): Promise<void> {\n        return this._load.run()\n    }\n\n    async save(): Promise<void> {\n        await this.driver.save?.()\n    }\n\n    async clear(withAuthKeys = false) {\n        if (withAuthKeys) {\n            await this.provider.authKeys.deleteAll()\n        }\n        await this.provider.kv.deleteAll()\n        await this.save()\n    }\n\n    private async _destroy(): Promise<void> {\n        if (!this._load.finished()) return\n        await this._load.wait()\n\n        await this.driver.destroy?.()\n        this._load.reset()\n    }\n\n    async destroy(): Promise<void> {\n        if (this._cleanupRestore) {\n            this._cleanupRestore()\n            this._cleanupRestore = undefined\n        }\n\n        await this._destroy()\n    }\n}\n"]}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":";;;AAEA,gDAA4C;AAC5C,gDAAmD;AAGnD,yDAAwD;AAExD,6DAA4D;AAC5D,+DAA8D;AAgC9D,MAAa,cAAc;IAQF;IAPZ,QAAQ,CAAA;IACR,MAAM,CAAA;IACN,GAAG,CAAA;IACH,GAAG,CAAA;IACH,KAAK,CAAA;IACL,IAAI,CAAA;IAEb,YAAqB,OAA2D;QAA3D,YAAO,GAAP,OAAO,CAAoD;QAC5E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAA;QAClC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAE7C,MAAM,cAAc,GAAmB;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;SAChB,CAAA;QAED,IAAI,CAAC,GAAG,GAAG,IAAI,kCAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC,CAAA;QAClE,IAAI,CAAC,KAAK,GAAG,IAAI,oCAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC,CAAA;QACrE,IAAI,CAAC,IAAI,GAAG,IAAI,8BAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IACvF,CAAC;IAEO,eAAe,CAAa;IAE5B,KAAK,GAAG,IAAA,0BAAe,EAAC,KAAK,IAAI,EAAE;QACvC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAE7B,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,GAAG,IAAA,yBAAW,GAAE,CAAC,UAAU,CAAC,GAAG,EAAE;gBACjD,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,CAAA;YAC5E,CAAC,CAAC,CAAA;QACN,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAA;IAC9B,CAAC,CAAC,CAAA;IACF,IAAI;QACA,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK;QAC5B,IAAI,YAAY,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAA;QAC5C,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,CAAA;QAClC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;IAEO,KAAK,CAAC,QAAQ;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;YAAE,OAAM;QAClC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QAEvB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAA;QAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,OAAO;QACT,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,EAAE,CAAA;YACtB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAA;QACpC,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;IACzB,CAAC;CACJ;AAtED,wCAsEC","sourcesContent":["import { TlReaderMap, TlWriterMap } from '@mtcute/tl-runtime'\n\nimport { getPlatform } from '../platform.js'\nimport { asyncResettable } from '../utils/index.js'\nimport { Logger } from '../utils/logger.js'\nimport { IMtStorageProvider } from './provider.js'\nimport { AuthKeysService } from './service/auth-keys.js'\nimport { ServiceOptions } from './service/base.js'\nimport { DefaultDcsService } from './service/default-dcs.js'\nimport { FutureSaltsService } from './service/future-salts.js'\n\ninterface StorageManagerOptions {\n    provider: IMtStorageProvider\n    log: Logger\n    readerMap: TlReaderMap\n    writerMap: TlWriterMap\n}\n\n/**\n * Additional options for {@link StorageManager}, that\n * can be customized by the user.\n *\n * @internal\n */\nexport interface StorageManagerExtraOptions {\n    /**\n     * Interval in milliseconds for saving the storage.\n     *\n     * When saving, the storage is expected to persist\n     * all changes to disk, so that they are not lost.\n     */\n    saveInterval?: number\n\n    /**\n     * Whether to finalize database before exiting.\n     *\n     * @default  `true`\n     */\n    cleanup?: boolean\n}\n\nexport class StorageManager {\n    readonly provider\n    readonly driver\n    readonly log\n    readonly dcs\n    readonly salts\n    readonly keys\n\n    constructor(readonly options: StorageManagerOptions & StorageManagerExtraOptions) {\n        this.provider = this.options.provider\n        this.driver = this.provider.driver\n        this.log = this.options.log.create('storage')\n\n        const serviceOptions: ServiceOptions = {\n            driver: this.driver,\n            readerMap: this.options.readerMap,\n            writerMap: this.options.writerMap,\n            log: this.log,\n        }\n\n        this.dcs = new DefaultDcsService(this.provider.kv, serviceOptions)\n        this.salts = new FutureSaltsService(this.provider.kv, serviceOptions)\n        this.keys = new AuthKeysService(this.provider.authKeys, this.salts, serviceOptions)\n    }\n\n    private _cleanupRestore?: () => void\n\n    private _load = asyncResettable(async () => {\n        this.driver.setup?.(this.log)\n\n        if (this.options.cleanup ?? true) {\n            this._cleanupRestore = getPlatform().beforeExit(() => {\n                this._destroy().catch((err) => this.log.error('cleanup error: %e', err))\n            })\n        }\n\n        await this.driver.load?.()\n    })\n    load(): Promise<void> {\n        return this._load.run()\n    }\n\n    async save(): Promise<void> {\n        await this.driver.save?.()\n    }\n\n    async clear(withAuthKeys = false) {\n        if (withAuthKeys) {\n            await this.provider.authKeys.deleteAll()\n        }\n        await this.provider.kv.deleteAll()\n        await this.save()\n    }\n\n    private async _destroy(): Promise<void> {\n        if (!this._load.finished()) return\n        await this._load.wait()\n\n        await this.driver.destroy?.()\n        this._load.reset()\n    }\n\n    async destroy(): Promise<void> {\n        if (this._cleanupRestore) {\n            this._cleanupRestore()\n            this._cleanupRestore = undefined\n        }\n\n        await this._destroy()\n    }\n}\n"]}

package/cjs/utils/abort-signal.d.ts

@@ -0,0 +1 @@
+export declare function combineAbortSignals(signal1: AbortSignal, signal2?: AbortSignal): AbortSignal;

package/cjs/utils/abort-signal.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.combineAbortSignals = void 0;
+function combineAbortSignals(signal1, signal2) {
+    if (!signal2)
+        return signal1;
+    const controller = new AbortController();
+    signal1.addEventListener('abort', () => controller.abort());
+    signal2.addEventListener('abort', () => controller.abort());
+    return controller.signal;
+}
+exports.combineAbortSignals = combineAbortSignals;
+//# sourceMappingURL=abort-signal.js.map

package/cjs/utils/abort-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-signal.js","sourceRoot":"","sources":["../../../src/utils/abort-signal.ts"],"names":[],"mappings":";;;AAAA,SAAgB,mBAAmB,CAAC,OAAoB,EAAE,OAAqB;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAA;IAE5B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IAExC,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAA;IAC3D,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAA;IAE3D,OAAO,UAAU,CAAC,MAAM,CAAA;AAC5B,CAAC;AATD,kDASC","sourcesContent":["export function combineAbortSignals(signal1: AbortSignal, signal2?: AbortSignal): AbortSignal {\n    if (!signal2) return signal1\n\n    const controller = new AbortController()\n\n    signal1.addEventListener('abort', () => controller.abort())\n    signal2.addEventListener('abort', () => controller.abort())\n\n    return controller.signal\n}\n"]}

package/cjs/utils/composer.d.ts

@@ -0,0 +1,3 @@
+export type Middleware<Context, Result = void> = (ctx: Context, next: (ctx: Context) => Promise<Result>) => Promise<Result>;
+export type ComposedMiddleware<Context, Result = void> = (ctx: Context) => Promise<Result>;
+export declare function composeMiddlewares<Context, Result = void>(middlewares: Middleware<Context, Result>[], final: ComposedMiddleware<Context, Result>): ComposedMiddleware<Context, Result>;

package/cjs/utils/composer.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeMiddlewares = void 0;
+function composeMiddlewares(middlewares, final) {
+    middlewares = middlewares.slice();
+    middlewares.push(final);
+    function dispatch(i, ctx) {
+        const fn = middlewares[i];
+        if (!fn)
+            return final(ctx);
+        return fn(ctx, boundDispatches[i + 1]);
+    }
+    const boundDispatches = [];
+    for (let i = 0; i < middlewares.length; i++) {
+        boundDispatches.push(dispatch.bind(null, i));
+    }
+    return function (context) {
+        return boundDispatches[0](context);
+    };
+}
+exports.composeMiddlewares = composeMiddlewares;
+//# sourceMappingURL=composer.js.map

package/cjs/utils/composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer.js","sourceRoot":"","sources":["../../../src/utils/composer.ts"],"names":[],"mappings":";;;AAMA,SAAgB,kBAAkB,CAC9B,WAA0C,EAC1C,KAA0C;IAE1C,WAAW,GAAG,WAAW,CAAC,KAAK,EAAE,CAAA;IACjC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAEvB,SAAS,QAAQ,CAAC,CAAS,EAAE,GAAY;QACrC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;QACzB,IAAI,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAA;QAE1B,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,eAAe,GAA6C,EAAE,CAAA;IAEpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,OAAO,UAAU,OAAgB;QAC7B,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC,CAAA;AACL,CAAC;AAvBD,gDAuBC","sourcesContent":["export type Middleware<Context, Result = void> = (\n    ctx: Context,\n    next: (ctx: Context) => Promise<Result>,\n) => Promise<Result>\nexport type ComposedMiddleware<Context, Result = void> = (ctx: Context) => Promise<Result>\n\nexport function composeMiddlewares<Context, Result = void>(\n    middlewares: Middleware<Context, Result>[],\n    final: ComposedMiddleware<Context, Result>,\n): ComposedMiddleware<Context, Result> {\n    middlewares = middlewares.slice()\n    middlewares.push(final)\n\n    function dispatch(i: number, ctx: Context): Promise<Result> {\n        const fn = middlewares[i]\n        if (!fn) return final(ctx)\n\n        return fn(ctx, boundDispatches[i + 1])\n    }\n\n    const boundDispatches: Array<(ctx: Context) => Promise<Result>> = []\n\n    for (let i = 0; i < middlewares.length; i++) {\n        boundDispatches.push(dispatch.bind(null, i))\n    }\n\n    return function (context: Context): Promise<Result> {\n        return boundDispatches[0](context)\n    }\n}\n"]}

package/cjs/utils/error-reporting.js

@@ -15,7 +15,7 @@ function reportUnknownError(log, error, method) {
         }
     })
         .catch((e) => {
-        log.debug('failed to report error %s to telerpc: %s', error.text, e);
+        log.debug('failed to report error %s to telerpc: %e', error.text, e);
     });
 }
 exports.reportUnknownError = reportUnknownError;

package/cjs/utils/error-reporting.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-reporting.js","sourceRoot":"","sources":["../../../src/utils/error-reporting.ts"],"names":[],"mappings":";;;AAIA,SAAgB,kBAAkB,CAAC,GAAW,EAAE,KAAkB,EAAE,MAAc;IAC9E,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAM;IAEvC,KAAK,CAAC,qCAAqC,KAAK,CAAC,IAAI,WAAW,MAAM,UAAU,KAAK,CAAC,IAAI,EAAE,CAAC;SACxF,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACrB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACR,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;QAClF,CAAC;aAAM,CAAC;YACJ,GAAG,CAAC,IAAI,CACJ,wFAAwF,EACxF,KAAK,CAAC,IAAI,CACb,CAAA;QACL,CAAC;IACL,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,GAAG,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;AACV,CAAC;AAlBD,gDAkBC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { Logger } from './logger.js'\n\nexport function reportUnknownError(log: Logger, error: tl.RpcError, method: string): void {\n    if (typeof fetch !== 'function') return\n\n    fetch(`https://rpc.pwrtelegram.xyz/?code=${error.code}&method=${method}&error=${error.text}`)\n        .then((r) => r.json())\n        .then((r) => {\n            if (r.ok) {\n                log.info('telerpc responded with error info for %s: %s', error.text, r.result)\n            } else {\n                log.info(\n                    'Reported error %s to telerpc. You can disable this using `enableErrorReporting: false`',\n                    error.text,\n                )\n            }\n        })\n        .catch((e) => {\n            log.debug('failed to report error %s to telerpc: %s', error.text, e)\n        })\n}\n"]}
+{"version":3,"file":"error-reporting.js","sourceRoot":"","sources":["../../../src/utils/error-reporting.ts"],"names":[],"mappings":";;;AAIA,SAAgB,kBAAkB,CAAC,GAAW,EAAE,KAAkB,EAAE,MAAc;IAC9E,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAM;IAEvC,KAAK,CAAC,qCAAqC,KAAK,CAAC,IAAI,WAAW,MAAM,UAAU,KAAK,CAAC,IAAI,EAAE,CAAC;SACxF,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACrB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACR,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;QAClF,CAAC;aAAM,CAAC;YACJ,GAAG,CAAC,IAAI,CACJ,wFAAwF,EACxF,KAAK,CAAC,IAAI,CACb,CAAA;QACL,CAAC;IACL,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,GAAG,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;AACV,CAAC;AAlBD,gDAkBC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { Logger } from './logger.js'\n\nexport function reportUnknownError(log: Logger, error: tl.RpcError, method: string): void {\n    if (typeof fetch !== 'function') return\n\n    fetch(`https://rpc.pwrtelegram.xyz/?code=${error.code}&method=${method}&error=${error.text}`)\n        .then((r) => r.json())\n        .then((r) => {\n            if (r.ok) {\n                log.info('telerpc responded with error info for %s: %s', error.text, r.result)\n            } else {\n                log.info(\n                    'Reported error %s to telerpc. You can disable this using `enableErrorReporting: false`',\n                    error.text,\n                )\n            }\n        })\n        .catch((e) => {\n            log.debug('failed to report error %s to telerpc: %e', error.text, e)\n        })\n}\n"]}

package/cjs/utils/index.d.ts

@@ -6,6 +6,7 @@ export * from '../storage/service/default-dcs.js';
 export * from './async-lock.js';
 export * from './bigint-utils.js';
 export * from './buffer-utils.js';
+export * from './composer.js';
 export * from './condition-variable.js';
 export * from './controllable-promise.js';
 export * from './crypto/index.js';

package/cjs/utils/index.js

@@ -30,6 +30,7 @@ __exportStar(require("../storage/service/default-dcs.js"), exports);
 __exportStar(require("./async-lock.js"), exports);
 __exportStar(require("./bigint-utils.js"), exports);
 __exportStar(require("./buffer-utils.js"), exports);
+__exportStar(require("./composer.js"), exports);
 __exportStar(require("./condition-variable.js"), exports);
 __exportStar(require("./controllable-promise.js"), exports);
 __exportStar(require("./crypto/index.js"), exports);

package/cjs/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA2C;AAC3C,2BAA2B;AAC3B,+EAA4D;AAC5D,0EAAuD;AACvD,6DAA0C;AAC1C,oEAAiD;AACjD,WAAW;AACX,kDAA+B;AAC/B,oDAAiC;AACjC,oDAAiC;AACjC,0DAAuC;AACvC,4DAAyC;AACzC,oDAAiC;AACjC,2CAAwB;AACxB,6CAA0B;AAC1B,mDAAgC;AAChC,sDAAmC;AACnC,mDAAgC;AAChC,mDAAgC;AAChC,8CAA2B;AAC3B,kDAA+B;AAC/B,+CAA4B;AAC5B,+CAA4B;AAC5B,kDAA+B;AAC/B,kDAA+B;AAC/B,oDAAiC;AACjC,+CAA4B;AAC5B,uDAAoC;AACpC,qDAAkC","sourcesContent":["export * from '../highlevel/utils/index.js'\n// todo: remove after 1.0.0\nexport * from '../highlevel/storage/service/current-user.js'\nexport * from '../highlevel/storage/service/updates.js'\nexport * from '../storage/service/base.js'\nexport * from '../storage/service/default-dcs.js'\n// end todo\nexport * from './async-lock.js'\nexport * from './bigint-utils.js'\nexport * from './buffer-utils.js'\nexport * from './condition-variable.js'\nexport * from './controllable-promise.js'\nexport * from './crypto/index.js'\nexport * from './dcs.js'\nexport * from './deque.js'\nexport * from './early-timer.js'\nexport * from './function-utils.js'\nexport * from './linked-list.js'\nexport * from './links/index.js'\nexport * from './logger.js'\nexport * from './long-utils.js'\nexport * from './lru-map.js'\nexport * from './lru-set.js'\nexport * from './misc-utils.js'\nexport * from './peer-utils.js'\nexport * from './sorted-array.js'\nexport * from './tl-json.js'\nexport * from './type-assertions.js'\nexport * from '@mtcute/tl-runtime'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA2C;AAC3C,2BAA2B;AAC3B,+EAA4D;AAC5D,0EAAuD;AACvD,6DAA0C;AAC1C,oEAAiD;AACjD,WAAW;AACX,kDAA+B;AAC/B,oDAAiC;AACjC,oDAAiC;AACjC,gDAA6B;AAC7B,0DAAuC;AACvC,4DAAyC;AACzC,oDAAiC;AACjC,2CAAwB;AACxB,6CAA0B;AAC1B,mDAAgC;AAChC,sDAAmC;AACnC,mDAAgC;AAChC,mDAAgC;AAChC,8CAA2B;AAC3B,kDAA+B;AAC/B,+CAA4B;AAC5B,+CAA4B;AAC5B,kDAA+B;AAC/B,kDAA+B;AAC/B,oDAAiC;AACjC,+CAA4B;AAC5B,uDAAoC;AACpC,qDAAkC","sourcesContent":["export * from '../highlevel/utils/index.js'\n// todo: remove after 1.0.0\nexport * from '../highlevel/storage/service/current-user.js'\nexport * from '../highlevel/storage/service/updates.js'\nexport * from '../storage/service/base.js'\nexport * from '../storage/service/default-dcs.js'\n// end todo\nexport * from './async-lock.js'\nexport * from './bigint-utils.js'\nexport * from './buffer-utils.js'\nexport * from './composer.js'\nexport * from './condition-variable.js'\nexport * from './controllable-promise.js'\nexport * from './crypto/index.js'\nexport * from './dcs.js'\nexport * from './deque.js'\nexport * from './early-timer.js'\nexport * from './function-utils.js'\nexport * from './linked-list.js'\nexport * from './links/index.js'\nexport * from './logger.js'\nexport * from './long-utils.js'\nexport * from './lru-map.js'\nexport * from './lru-set.js'\nexport * from './misc-utils.js'\nexport * from './peer-utils.js'\nexport * from './sorted-array.js'\nexport * from './tl-json.js'\nexport * from './type-assertions.js'\nexport * from '@mtcute/tl-runtime'\n"]}

package/cjs/utils/logger.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LogManager = exports.Logger = void 0;
+const tl_1 = require("@mtcute/tl");
 const platform_js_1 = require("../platform.js");
-const DEFAULT_LOG_LEVEL = 3;
+const type_assertions_js_1 = require("./type-assertions.js");
+const DEFAULT_LOG_LEVEL = 2;
 const FORMATTER_RE = /%[a-zA-Z]/g;
 /**
  * Logger created by {@link LogManager}
@@ -47,10 +49,11 @@ class Logger {
             fmt.includes('%j') ||
             fmt.includes('%J') ||
             fmt.includes('%l') ||
-            fmt.includes('%L')) {
+            fmt.includes('%L') ||
+            fmt.includes('%e')) {
             let idx = 0;
             fmt = fmt.replace(FORMATTER_RE, (m) => {
-                if (m === '%h' || m === '%b' || m === '%j' || m === '%J' || m === '%l' || m === '%L') {
+                if (m === '%h' || m === '%b' || m === '%j' || m === '%J' || m === '%l' || m === '%L' || m === '%e') {
                     let val = args[idx];
                     args.splice(idx, 1);
                     if (m === '%h') {
@@ -88,6 +91,15 @@ class Logger {
                             return 'n/a';
                         return `[${val.map(String).join(', ')}]`;
                     }
+                    if (m === '%e') {
+                        if ((0, type_assertions_js_1.isTlRpcError)(val)) {
+                            return `${val.errorCode} ${val.errorMessage}`;
+                        }
+                        if (tl_1.tl.RpcError.is(val)) {
+                            return `${val.code} ${val.text}`;
+                        }
+                        return val && typeof val === 'object' ? val.stack || val.message : String(val);
+                    }
                 }
                 idx++;
                 return m;

package/cjs/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { getPlatform } from '../platform.js'\n\nconst DEFAULT_LOG_LEVEL = 3\nconst FORMATTER_RE = /%[a-zA-Z]/g\n\n/**\n * Logger created by {@link LogManager}\n */\nexport class Logger {\n    private color: number\n\n    prefix = ''\n\n    constructor(\n        readonly mgr: LogManager,\n        readonly tag: string,\n        readonly parent: Logger = mgr,\n    ) {\n        let hash = 0\n\n        for (let i = 0; i < tag.length; i++) {\n            hash = (hash << 5) - hash + tag.charCodeAt(i)\n            hash |= 0 // convert to 32bit int\n        }\n\n        this.color = Math.abs(hash) % 6\n    }\n\n    getPrefix(): string {\n        let s = ''\n\n        // eslint-disable-next-line @typescript-eslint/no-this-alias\n        let obj: Logger | undefined = this\n\n        while (obj) {\n            if (obj.prefix) s = obj.prefix + s\n            obj = obj.parent\n        }\n\n        return s\n    }\n\n    log(level: number, fmt: string, ...args: unknown[]): void {\n        if (level > this.mgr.level) return\n        // eslint-disable-next-line dot-notation\n        if (!this.mgr['_filter'](this.tag)) return\n\n        // custom formatters\n        if (\n            fmt.includes('%h') ||\n            fmt.includes('%b') ||\n            fmt.includes('%j') ||\n            fmt.includes('%J') ||\n            fmt.includes('%l') ||\n            fmt.includes('%L')\n        ) {\n            let idx = 0\n            fmt = fmt.replace(FORMATTER_RE, (m) => {\n                if (m === '%h' || m === '%b' || m === '%j' || m === '%J' || m === '%l' || m === '%L') {\n                    let val = args[idx]\n\n                    args.splice(idx, 1)\n\n                    if (m === '%h') {\n                        if (ArrayBuffer.isView(val)) return this.mgr.platform.hexEncode(val as Uint8Array)\n                        if (typeof val === 'number' || typeof val === 'bigint') return val.toString(16)\n\n                        return String(val)\n                    }\n                    if (m === '%b') return String(Boolean(val))\n\n                    if (m === '%j' || m === '%J') {\n                        if (m === '%J') {\n                            val = [...(val as IterableIterator<unknown>)]\n                        }\n\n                        return JSON.stringify(val, (k, v) => {\n                            if (\n                                ArrayBuffer.isView(v) ||\n                                (typeof v === 'object' && v.type === 'Buffer' && Array.isArray(v.data)) // todo: how can we do this better?\n                            ) {\n                                // eslint-disable-next-line\n                                let str = v.data ? Buffer.from(v.data as number[]).toString('hex') : this.mgr.platform.hexEncode(v)\n\n                                if (str.length > 300) {\n                                    str = str.slice(0, 300) + '...'\n                                }\n\n                                return str\n                            }\n\n                            // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n                            return v\n                        })\n                    }\n                    if (m === '%l') return String(val)\n\n                    if (m === '%L') {\n                        if (!Array.isArray(val)) return 'n/a'\n\n                        return `[${(val as unknown[]).map(String).join(', ')}]`\n                    }\n                }\n\n                idx++\n\n                return m\n            })\n        }\n\n        this.mgr.handler(this.color, level, this.tag, this.getPrefix() + fmt, args)\n    }\n\n    readonly error = this.log.bind(this, LogManager.ERROR)\n    readonly warn = this.log.bind(this, LogManager.WARN)\n    readonly info = this.log.bind(this, LogManager.INFO)\n    readonly debug = this.log.bind(this, LogManager.DEBUG)\n    readonly verbose = this.log.bind(this, LogManager.VERBOSE)\n\n    /**\n     * Create a {@link Logger} with the given tag\n     * from the same {@link LogManager} as the current\n     * Logger.\n     *\n     * @param tag  Logger tag\n     */\n    create(tag: string): Logger {\n        return new Logger(this.mgr, tag, this)\n    }\n}\n\nconst defaultFilter = () => true\n\n/**\n * Log manager. A logger that allows managing child loggers\n */\nexport class LogManager extends Logger {\n    static OFF = 0\n    static ERROR = 1\n    static WARN = 2\n    static INFO = 3\n    static DEBUG = 4\n    static VERBOSE = 5\n\n    readonly platform\n    level: number\n    handler\n\n    constructor(tag = 'base') {\n        // workaround because we cant pass this to super\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any,@typescript-eslint/no-unsafe-argument\n        super(null as any, tag)\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        ;(this as any).mgr = this\n\n        this.platform = getPlatform()\n        this.level = this.platform.getDefaultLogLevel() ?? DEFAULT_LOG_LEVEL\n        this.handler = this.platform.log.bind(this.platform)\n    }\n\n    private _filter: (tag: string) => boolean = defaultFilter\n\n    /**\n     * Create a {@link Logger} with the given tag\n     *\n     * @param tag  Logger tag\n     */\n    create(tag: string): Logger {\n        return new Logger(this, tag)\n    }\n\n    /**\n     * Filter logging by tags.\n     *\n     * @param cb\n     */\n    filter(cb: ((tag: string) => boolean) | null): void {\n        this._filter = cb ?? defaultFilter\n    }\n}\n"]}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { getPlatform } from '../platform.js'\nimport { isTlRpcError } from './type-assertions.js'\n\nconst DEFAULT_LOG_LEVEL = 2\nconst FORMATTER_RE = /%[a-zA-Z]/g\n\n/**\n * Logger created by {@link LogManager}\n */\nexport class Logger {\n    private color: number\n\n    prefix = ''\n\n    constructor(\n        readonly mgr: LogManager,\n        readonly tag: string,\n        readonly parent: Logger = mgr,\n    ) {\n        let hash = 0\n\n        for (let i = 0; i < tag.length; i++) {\n            hash = (hash << 5) - hash + tag.charCodeAt(i)\n            hash |= 0 // convert to 32bit int\n        }\n\n        this.color = Math.abs(hash) % 6\n    }\n\n    getPrefix(): string {\n        let s = ''\n\n        // eslint-disable-next-line @typescript-eslint/no-this-alias\n        let obj: Logger | undefined = this\n\n        while (obj) {\n            if (obj.prefix) s = obj.prefix + s\n            obj = obj.parent\n        }\n\n        return s\n    }\n\n    log(level: number, fmt: string, ...args: unknown[]): void {\n        if (level > this.mgr.level) return\n        // eslint-disable-next-line dot-notation\n        if (!this.mgr['_filter'](this.tag)) return\n\n        // custom formatters\n        if (\n            fmt.includes('%h') ||\n            fmt.includes('%b') ||\n            fmt.includes('%j') ||\n            fmt.includes('%J') ||\n            fmt.includes('%l') ||\n            fmt.includes('%L') ||\n            fmt.includes('%e')\n        ) {\n            let idx = 0\n            fmt = fmt.replace(FORMATTER_RE, (m) => {\n                if (m === '%h' || m === '%b' || m === '%j' || m === '%J' || m === '%l' || m === '%L' || m === '%e') {\n                    let val = args[idx]\n\n                    args.splice(idx, 1)\n\n                    if (m === '%h') {\n                        if (ArrayBuffer.isView(val)) return this.mgr.platform.hexEncode(val as Uint8Array)\n                        if (typeof val === 'number' || typeof val === 'bigint') return val.toString(16)\n\n                        return String(val)\n                    }\n                    if (m === '%b') return String(Boolean(val))\n\n                    if (m === '%j' || m === '%J') {\n                        if (m === '%J') {\n                            val = [...(val as IterableIterator<unknown>)]\n                        }\n\n                        return JSON.stringify(val, (k, v) => {\n                            if (\n                                ArrayBuffer.isView(v) ||\n                                (typeof v === 'object' && v.type === 'Buffer' && Array.isArray(v.data)) // todo: how can we do this better?\n                            ) {\n                                // eslint-disable-next-line\n                                let str = v.data ? Buffer.from(v.data as number[]).toString('hex') : this.mgr.platform.hexEncode(v)\n\n                                if (str.length > 300) {\n                                    str = str.slice(0, 300) + '...'\n                                }\n\n                                return str\n                            }\n\n                            // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n                            return v\n                        })\n                    }\n                    if (m === '%l') return String(val)\n\n                    if (m === '%L') {\n                        if (!Array.isArray(val)) return 'n/a'\n\n                        return `[${(val as unknown[]).map(String).join(', ')}]`\n                    }\n\n                    if (m === '%e') {\n                        if (isTlRpcError(val)) {\n                            return `${val.errorCode} ${val.errorMessage}`\n                        }\n\n                        if (tl.RpcError.is(val)) {\n                            return `${val.code} ${val.text}`\n                        }\n\n                        return val && typeof val === 'object' ? (val as Error).stack || (val as Error).message : String(val)\n                    }\n                }\n\n                idx++\n\n                return m\n            })\n        }\n\n        this.mgr.handler(this.color, level, this.tag, this.getPrefix() + fmt, args)\n    }\n\n    readonly error = this.log.bind(this, LogManager.ERROR)\n    readonly warn = this.log.bind(this, LogManager.WARN)\n    readonly info = this.log.bind(this, LogManager.INFO)\n    readonly debug = this.log.bind(this, LogManager.DEBUG)\n    readonly verbose = this.log.bind(this, LogManager.VERBOSE)\n\n    /**\n     * Create a {@link Logger} with the given tag\n     * from the same {@link LogManager} as the current\n     * Logger.\n     *\n     * @param tag  Logger tag\n     */\n    create(tag: string): Logger {\n        return new Logger(this.mgr, tag, this)\n    }\n}\n\nconst defaultFilter = () => true\n\n/**\n * Log manager. A logger that allows managing child loggers\n */\nexport class LogManager extends Logger {\n    static OFF = 0\n    static ERROR = 1\n    static WARN = 2\n    static INFO = 3\n    static DEBUG = 4\n    static VERBOSE = 5\n\n    readonly platform\n    level: number\n    handler\n\n    constructor(tag = 'base') {\n        // workaround because we cant pass this to super\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any,@typescript-eslint/no-unsafe-argument\n        super(null as any, tag)\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        ;(this as any).mgr = this\n\n        this.platform = getPlatform()\n        this.level = this.platform.getDefaultLogLevel() ?? DEFAULT_LOG_LEVEL\n        this.handler = this.platform.log.bind(this.platform)\n    }\n\n    private _filter: (tag: string) => boolean = defaultFilter\n\n    /**\n     * Create a {@link Logger} with the given tag\n     *\n     * @param tag  Logger tag\n     */\n    create(tag: string): Logger {\n        return new Logger(this, tag)\n    }\n\n    /**\n     * Filter logging by tags.\n     *\n     * @param cb\n     */\n    filter(cb: ((tag: string) => boolean) | null): void {\n        this._filter = cb ?? defaultFilter\n    }\n}\n"]}

package/esm/highlevel/base.d.ts

@@ -3,7 +3,7 @@ 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 { ICryptoProvider, Logger, StringSessionData } from '../utils/index.js';
 import { ConnectionState, ITelegramClient, ServerUpdateHandler } from './client.types.js';
 import { AppConfigManager } from './managers/app-config-manager.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
@@ -20,9 +20,9 @@ export declare class BaseTelegramClient implements ITelegramClient {
     readonly updates?: UpdatesManager;
     private _serverUpdatesHandler;
     private _connectionStateHandler;
-    readonly log: import("../utils/logger.js").Logger;
+    readonly log: Logger;
     readonly mt: MtClient;
-    readonly crypto: import("../utils/index.js").ICryptoProvider;
+    readonly crypto: ICryptoProvider;
     readonly storage: TelegramStorageManager;
     constructor(params: BaseTelegramClientOptions);
     readonly appConfig: AppConfigManager;

package/esm/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 { mtp, 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 { reportUnknownError } from '../utils/error-reporting.js'\nimport {\n    asyncResettable,\n    computeNewPasswordHash,\n    computeSrpParams,\n    isTlRpcError,\n    readStringSession,\n    StringSessionData,\n    writeStringSession,\n} from '../utils/index.js'\nimport { LogManager } from '../utils/logger.js'\nimport { ConnectionState, ITelegramClient, ServerUpdateHandler } 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\nfunction makeRpcError(raw: mtp.RawMt_rpc_error, stack: string, method?: string) {\n    const error = tl.RpcError.fromTl(raw)\n    error.stack = `RpcError (${error.code} ${error.text}): ${error.message}\\n    at ${method}\\n${stack\n        .split('\\n')\n        .slice(2)\n        .join('\\n')}`\n\n    return error\n}\n\nexport class BaseTelegramClient implements ITelegramClient {\n    readonly updates?: UpdatesManager\n    private _serverUpdatesHandler: ServerUpdateHandler = () => {}\n    private _connectionStateHandler: (state: ConnectionState) => void = () => {}\n\n    readonly log\n    readonly mt\n    readonly crypto\n    readonly storage\n\n    constructor(readonly params: BaseTelegramClientOptions) {\n        this.log = this.params.logger ?? new LogManager('client')\n        this.mt = new MtClient({\n            ...this.params,\n            logger: this.log.create('mtproto'),\n        })\n\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        this.crypto = this.mt.crypto\n        this.storage = new TelegramStorageManager(this.mt.storage, {\n            provider: this.params.storage,\n            ...this.params.storageOptions,\n        })\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        this._connected = false\n        await this.mt.close()\n        this.updates?.stopLoop()\n        this._prepare.reset()\n        this._connect.reset()\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        if (isTlRpcError(res)) {\n            const error = makeRpcError(res, new Error().stack ?? '', message._)\n\n            if (error.unknown && this.params.enableErrorReporting) {\n                reportUnknownError(this.log, error, message._)\n            }\n\n            throw error\n        }\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(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: ServerUpdateHandler): void {\n        this._serverUpdatesHandler = handler\n    }\n\n    getServerUpdateHandler(): ServerUpdateHandler {\n        return this._serverUpdatesHandler\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    get stopSignal(): AbortSignal {\n        return this.mt.stopSignal\n    }\n\n    changePrimaryDc(dcId: number): Promise<void> {\n        return this.mt.network.changePrimaryDc(dcId)\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 { mtp, 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 { reportUnknownError } from '../utils/error-reporting.js'\nimport {\n    asyncResettable,\n    computeNewPasswordHash,\n    computeSrpParams,\n    ICryptoProvider,\n    isTlRpcError,\n    Logger,\n    readStringSession,\n    StringSessionData,\n    writeStringSession,\n} from '../utils/index.js'\nimport { LogManager } from '../utils/logger.js'\nimport { ConnectionState, ITelegramClient, ServerUpdateHandler } 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\nfunction makeRpcError(raw: mtp.RawMt_rpc_error, stack: string, method?: string) {\n    const error = tl.RpcError.fromTl(raw)\n    error.stack = `RpcError (${error.code} ${error.text}): ${error.message}\\n    at ${method}\\n${stack\n        .split('\\n')\n        .slice(2)\n        .join('\\n')}`\n\n    return error\n}\n\nexport class BaseTelegramClient implements ITelegramClient {\n    readonly updates?: UpdatesManager\n    private _serverUpdatesHandler: ServerUpdateHandler = () => {}\n    private _connectionStateHandler: (state: ConnectionState) => void = () => {}\n\n    readonly log: Logger\n    readonly mt: MtClient\n    readonly crypto: ICryptoProvider\n    readonly storage: TelegramStorageManager\n\n    constructor(readonly params: BaseTelegramClientOptions) {\n        this.log = this.params.logger ?? new LogManager('client')\n        this.mt = new MtClient({\n            ...this.params,\n            logger: this.log.create('mtproto'),\n        })\n\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        this.crypto = this.mt.crypto\n        this.storage = new TelegramStorageManager(this.mt.storage, {\n            provider: this.params.storage,\n            ...this.params.storageOptions,\n        })\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        this._connected = false\n        await this.mt.close()\n        this.updates?.stopLoop()\n        this._prepare.reset()\n        this._connect.reset()\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        if (isTlRpcError(res)) {\n            const error = makeRpcError(res, new Error().stack ?? '', message._)\n\n            if (error.unknown && this.params.enableErrorReporting) {\n                reportUnknownError(this.log, error, message._)\n            }\n\n            throw error\n        }\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(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: ServerUpdateHandler): void {\n        this._serverUpdatesHandler = handler\n    }\n\n    getServerUpdateHandler(): ServerUpdateHandler {\n        return this._serverUpdatesHandler\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    get stopSignal(): AbortSignal {\n        return this.mt.stopSignal\n    }\n\n    changePrimaryDc(dcId: number): Promise<void> {\n        return this.mt.network.changePrimaryDc(dcId)\n    }\n}\n"]}

package/esm/highlevel/client.d.ts

@@ -1128,6 +1128,11 @@ export interface TelegramClient extends ITelegramClient {
         chatId: InputPeerLike;
         /** User/channel ID whose messages to delete */
         participantId: InputPeerLike;
+        /**
+         * Whether to dispatch the updates that will be generated by this call.
+         * Doesn't follow `disableNoDispatch`
+         */
+        shouldDispatch?: true;
     }): Promise<void>;
     /**
      * Edit supergroup/channel admin rights of a user.
@@ -2172,7 +2177,13 @@ export interface TelegramClient extends ITelegramClient {
      * @param chat  Chat or user ID, username, phone number, `"me"` or `"self"`
      * @param topicId  ID of the topic (i.e. its top message ID)
      */
-    deleteForumTopicHistory(chat: InputPeerLike, topicId: number | ForumTopic): Promise<void>;
+    deleteForumTopicHistory(chat: InputPeerLike, topicId: number | ForumTopic, params?: {
+        /**
+         * Whether to dispatch updates that will be generated by this call.
+         * Doesn't follow `disableNoDispatch`
+         */
+        shouldDispatch?: true;
+    }): Promise<void>;
     /**
      * Modify a topic in a forum
      *
@@ -3149,6 +3160,11 @@ export interface TelegramClient extends ITelegramClient {
          * Whether to also clear all mentions in the chat
          */
         clearMentions?: boolean;
+        /**
+         * Whether to dispatch updates that will be generated by this call.
+         * Doesn't follow `disableNoDispatch`
+         */
+        shouldDispatch?: true;
     }): Promise<void>;
     /**
      * Mark all reactions in chat as read.
@@ -3157,7 +3173,13 @@ export interface TelegramClient extends ITelegramClient {
      *
      * @param chatId  Chat ID
      */
-    readReactions(chatId: InputPeerLike): Promise<void>;
+    readReactions(chatId: InputPeerLike, params?: {
+        /**
+         * Whether to dispatch updates that will be generated by this call.
+         * Doesn't follow `disableNoDispatch`
+         */
+        shouldDispatch?: true;
+    }): Promise<void>;
     /**
      * Search for messages globally from all of your chats
      *
@@ -3641,6 +3663,11 @@ export interface TelegramClient extends ITelegramClient {
          * For forums - unpin only messages from the given topic
          */
         topicId?: number;
+        /**
+         * Whether to dispatch updates that will be generated by this call.
+         * Doesn't follow `disableNoDispatch`
+         */
+        shouldDispatch?: true;
     }): Promise<void>;
     /**
      * Unpin a message in a group, supergroup, channel or PM.