@mtcute/core 0.14.0 → 0.15.1

package/cjs/highlevel/base.d.ts

@@ -4,7 +4,7 @@ import { ConnectionKind, RpcCallOptions } from '../network/network-manager.js';
 import { StorageManagerExtraOptions } from '../storage/storage.js';
 import { MustEqual } from '../types/utils.js';
 import { StringSessionData } from '../utils/index.js';
-import { ConnectionState, ITelegramClient } from './client.types.js';
+import { ConnectionState, ITelegramClient, ServerUpdateHandler } 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';
@@ -99,7 +99,8 @@ export declare class BaseTelegramClient implements ITelegramClient {
     onError(handler: (err: unknown) => void): void;
     emitError(err: unknown): void;
     handleClientUpdate(updates: tl.TypeUpdates, noDispatch?: boolean): void;
-    onServerUpdate(handler: (update: tl.TypeUpdates) => void): void;
+    onServerUpdate(handler: ServerUpdateHandler): void;
+    getServerUpdateHandler(): ServerUpdateHandler;
     onUpdate(handler: RawUpdateHandler): void;
     onConnectionState(handler: (state: ConnectionState) => void): void;
     getApiCrenetials(): Promise<{
@@ -111,4 +112,5 @@ export declare class BaseTelegramClient implements ITelegramClient {
     computeSrpParams(request: tl.account.RawPassword, password: string): Promise<tl.RawInputCheckPasswordSRP>;
     computeNewPasswordHash(algo: tl.TypePasswordKdfAlgo, password: string): Promise<Uint8Array>;
     get stopSignal(): AbortSignal;
+    changePrimaryDc(dcId: number): Promise<void>;
 }

package/cjs/highlevel/base.js

@@ -214,6 +214,9 @@ class BaseTelegramClient {
     onServerUpdate(handler) {
         this._serverUpdatesHandler = handler;
     }
+    getServerUpdateHandler() {
+        return this._serverUpdatesHandler;
+    }
     onUpdate(handler) {
         if (!this.updates) {
             throw new errors_js_1.MtArgumentError('Updates manager is disabled');
@@ -250,6 +253,9 @@ class BaseTelegramClient {
     get stopSignal() {
         return this.mt.stopSignal;
     }
+    changePrimaryDc(dcId) {
+        return this.mt.network.changePrimaryDc(dcId);
+    }
 }
 exports.BaseTelegramClient = BaseTelegramClient;
 //# sourceMappingURL=base.js.map

package/cjs/highlevel/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/highlevel/base.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/require-await */\nimport { tl } from '@mtcute/tl'\n\nimport { MtClient, MtClientOptions } from '../network/client.js'\nimport { ConnectionKind, RpcCallOptions } from '../network/network-manager.js'\nimport { StorageManagerExtraOptions } from '../storage/storage.js'\nimport { MtArgumentError } from '../types/errors.js'\nimport { MustEqual } from '../types/utils.js'\nimport {\n    asyncResettable,\n    computeNewPasswordHash,\n    computeSrpParams,\n    readStringSession,\n    StringSessionData,\n    writeStringSession,\n} from '../utils/index.js'\nimport { LogManager } from '../utils/logger.js'\nimport { ConnectionState, ITelegramClient } from './client.types.js'\nimport { AppConfigManager } from './managers/app-config-manager.js'\nimport { ITelegramStorageProvider } from './storage/provider.js'\nimport { TelegramStorageManager, TelegramStorageManagerExtraOptions } from './storage/storage.js'\nimport { UpdatesManager } from './updates/manager.js'\nimport { RawUpdateHandler, UpdatesManagerParams } from './updates/types.js'\n\nexport interface BaseTelegramClientOptions extends MtClientOptions {\n    storage: ITelegramStorageProvider\n    storageOptions?: StorageManagerExtraOptions & TelegramStorageManagerExtraOptions\n    updates?: UpdatesManagerParams | false\n}\n\nexport class BaseTelegramClient implements ITelegramClient {\n    readonly updates?: UpdatesManager\n    private _serverUpdatesHandler: (updates: tl.TypeUpdates) => void = () => {}\n    private _connectionStateHandler: (state: ConnectionState) => void = () => {}\n\n    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        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: (update: tl.TypeUpdates) => void): void {\n        this._serverUpdatesHandler = handler\n    }\n\n    onUpdate(handler: RawUpdateHandler): void {\n        if (!this.updates) {\n            throw new MtArgumentError('Updates manager is disabled')\n        }\n\n        this.updates.setHandler(handler)\n    }\n\n    onConnectionState(handler: (state: ConnectionState) => void): void {\n        this._connectionStateHandler = handler\n    }\n\n    async getApiCrenetials() {\n        return {\n            id: this.params.apiId,\n            hash: this.params.apiHash,\n        }\n    }\n\n    async getPoolSize(kind: ConnectionKind, dcId?: number): Promise<number> {\n        if (!this._connected) {\n            await this._connect.run()\n        }\n\n        return this.mt.network.getPoolSize(kind, dcId)\n    }\n\n    async getPrimaryDcId(): Promise<number> {\n        if (!this._connected) {\n            await this._connect.run()\n        }\n\n        return this.mt.network.getPrimaryDcId()\n    }\n\n    computeSrpParams(request: tl.account.RawPassword, password: string): Promise<tl.RawInputCheckPasswordSRP> {\n        return computeSrpParams(this.crypto, request, password)\n    }\n    computeNewPasswordHash(algo: tl.TypePasswordKdfAlgo, password: string): Promise<Uint8Array> {\n        return computeNewPasswordHash(this.crypto, algo, password)\n    }\n\n    get stopSignal(): AbortSignal {\n        return this.mt.stopSignal\n    }\n}\n"]}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/highlevel/base.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/require-await */\nimport { tl } from '@mtcute/tl'\n\nimport { MtClient, MtClientOptions } from '../network/client.js'\nimport { ConnectionKind, RpcCallOptions } from '../network/network-manager.js'\nimport { StorageManagerExtraOptions } from '../storage/storage.js'\nimport { MtArgumentError } from '../types/errors.js'\nimport { MustEqual } from '../types/utils.js'\nimport {\n    asyncResettable,\n    computeNewPasswordHash,\n    computeSrpParams,\n    readStringSession,\n    StringSessionData,\n    writeStringSession,\n} from '../utils/index.js'\nimport { LogManager } from '../utils/logger.js'\nimport { ConnectionState, ITelegramClient, 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\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        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/cjs/highlevel/client.d.ts

@@ -36,7 +36,7 @@ import { getProfileStories } from './methods/stories/get-profile-stories.js';
 import { getStoryViewers } from './methods/stories/get-story-viewers.js';
 import { getProfilePhotos } from './methods/users/get-profile-photos.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
-import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeersIndex, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, Sticker, StickerSet, StickerSourceType, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeersIndex, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, Sticker, StickerSet, StickerSourceType, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate } from './types/index.js';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { StringSessionData } from './utils/string-session.js';
 type TelegramClientOptions = ((PartialOnly<Omit<BaseTelegramClientOptions, 'storage'>, 'transport' | 'crypto'> & {
@@ -147,6 +147,13 @@ export interface TelegramClient extends ITelegramClient {
      * @param handler  Inline callback query handler
      */
     on(name: 'inline_callback_query', handler: (upd: InlineCallbackQuery) => void): this;
+    /**
+     * Register a business callback query handler
+     *
+     * @param name  Event name
+     * @param handler  Business callback query handler
+     */
+    on(name: 'business_callback_query', handler: (upd: BusinessCallbackQuery) => void): this;
     /**
      * Register a poll update handler
      *
@@ -335,6 +342,8 @@ export interface TelegramClient extends ITelegramClient {
         phone: string;
         /** Confirmation code identifier from {@link SentCode} */
         phoneCodeHash: string;
+        /** Abort signal */
+        abortSignal?: AbortSignal;
     }): Promise<SentCode>;
     /**
      * Simple wrapper that calls {@link start} and then
@@ -364,6 +373,8 @@ export interface TelegramClient extends ITelegramClient {
         futureAuthTokens?: Uint8Array[];
         /** Additional code settings to pass to the server */
         codeSettings?: Omit<tl.RawCodeSettings, '_' | 'logoutTokens'>;
+        /** Abort signal */
+        abortSignal?: AbortSignal;
     }): Promise<SentCode>;
     /**
      * Send a code to email needed to recover your password
@@ -383,6 +394,33 @@ export interface TelegramClient extends ITelegramClient {
      * @throws BadRequestError  In case the bot token is invalid
      */
     signInBot(token: string): Promise<User>;
+    /**
+     * Execute the [QR login flow](https://core.telegram.org/api/qr-login).
+     *
+     * This method will resolve once the authorization is complete,
+     * returning the authorized user.
+     * **Available**: 👤 users only
+     *
+     */
+    signInQr(params: {
+        /**
+         * Function that will be called whenever the login URL is changed.
+         *
+         * The app is expected to display `url` as a QR code to the user
+         */
+        onUrlUpdated: (url: string, expires: Date) => void;
+        /** Password for 2FA */
+        password?: MaybeDynamic<string>;
+        /**
+         * Function that will be called after the server has rejected the password.
+         *
+         * Note that in case {@link password} is not a function,
+         * this callback will never be called, and an error will be thrown instead.
+         */
+        invalidPasswordCallback?: () => MaybePromise<void>;
+        /** Abort signal */
+        abortSignal?: AbortSignal;
+    }): Promise<User>;
     /**
      * Authorize a user in Telegram with a valid confirmation code.
      *
@@ -399,6 +437,8 @@ export interface TelegramClient extends ITelegramClient {
         phoneCodeHash: string;
         /** The confirmation code that was received */
         phoneCode: string;
+        /** Abort signal */
+        abortSignal?: AbortSignal;
     }): Promise<User>;
     /**
      * Utility function to quickly authorize on test DC
@@ -459,6 +499,14 @@ export interface TelegramClient extends ITelegramClient {
          * Whether to overwrite existing session.
          */
         sessionForce?: boolean;
+        /**
+         * When passed, [QR login flow](https://core.telegram.org/api/qr-login)
+         * will be used instead of the regular login flow.
+         *
+         * This function will be called whenever the login URL is changed,
+         * and the app is expected to display it as a QR code to the user.
+         */
+        qrCodeHandler?: (url: string, expires: Date) => void;
         /**
          * Phone number of the account.
          * If account does not exist, it will be created
@@ -503,6 +551,8 @@ export interface TelegramClient extends ITelegramClient {
         futureAuthTokens?: Uint8Array[];
         /** Additional code settings to pass to the server */
         codeSettings?: Omit<tl.RawCodeSettings, '_' | 'logoutTokens'>;
+        /** Abort signal */
+        abortSignal?: AbortSignal;
     }): Promise<User>;
     /**
      * Check if the given peer/input peer is referring to the current user
@@ -1780,7 +1830,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get a preview of a chatlist by its invite link
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param link  Invite link
      */

package/cjs/highlevel/client.js

@@ -40,6 +40,7 @@ const send_code_js_1 = require("./methods/auth/send-code.js");
 const send_recovery_code_js_1 = require("./methods/auth/send-recovery-code.js");
 const sign_in_js_1 = require("./methods/auth/sign-in.js");
 const sign_in_bot_js_1 = require("./methods/auth/sign-in-bot.js");
+const sign_in_qr_js_1 = require("./methods/auth/sign-in-qr.js");
 const start_js_1 = require("./methods/auth/start.js");
 const start_test_js_1 = require("./methods/auth/start-test.js");
 const utils_js_1 = require("./methods/auth/utils.js");
@@ -289,6 +290,9 @@ class TelegramClient extends events_1.default {
         Object.defineProperty(this, 'stopSignal', {
             get: () => this._client.stopSignal,
         });
+        Object.defineProperty(this, 'appConfig', {
+            get: () => this._client.appConfig,
+        });
         if (!opts.disableUpdates) {
             const skipConversationUpdates = opts.skipConversationUpdates ?? true;
             const { messageGroupingInterval } = opts.updates ?? {};
@@ -338,6 +342,9 @@ TelegramClient.prototype.sendRecoveryCode = function (...args) {
 TelegramClient.prototype.signInBot = function (...args) {
     return (0, sign_in_bot_js_1.signInBot)(this._client, ...args);
 };
+TelegramClient.prototype.signInQr = function (...args) {
+    return (0, sign_in_qr_js_1.signInQr)(this._client, ...args);
+};
 TelegramClient.prototype.signIn = function (...args) {
     return (0, sign_in_js_1.signIn)(this._client, ...args);
 };
@@ -1153,6 +1160,12 @@ TelegramClient.prototype.computeNewPasswordHash = function (...args) {
 TelegramClient.prototype.onConnectionState = function (...args) {
     return this._client.onConnectionState(...args);
 };
+TelegramClient.prototype.getServerUpdateHandler = function (...args) {
+    return this._client.getServerUpdateHandler(...args);
+};
+TelegramClient.prototype.changePrimaryDc = function (...args) {
+    return this._client.changePrimaryDc(...args);
+};
 TelegramClient.prototype.onServerUpdate = function () {
     throw new Error('onServerUpdate is not available for TelegramClient, use .on() methods instead');
 };