@mtcute/core 0.16.6 → 0.16.9

package/esm/highlevel/methods/auth/sign-in-qr.js

@@ -1,122 +0,0 @@
-import { tl } from '@mtcute/tl';
-import { getPlatform } from '../../../platform.js';
-import { createControllablePromise } from '../../../utils/controllable-promise.js';
-import { sleepWithAbort } from '../../../utils/misc-utils.js';
-import { assertTypeIs } from '../../../utils/type-assertions.js';
-import { User } from '../../types/index.js';
-import { resolveMaybeDynamic } from '../../utils/misc-utils.js';
-import { checkPassword } from './check-password.js';
-// @available=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.
- */
-export async function signInQr(client, params) {
-    const { onUrlUpdated, abortSignal, onQrScanned } = params;
-    let waiter;
-    // crutch – we need to wait for the updateLoginToken update.
-    // we replace the server update handler temporarily because:
-    //   - updates manager may be disabled, in which case `onUpdate` will never be called
-    //   - even if the updates manager is enabled, it won't start until we're logged in
-    //
-    // todo: how can we make this more clean?
-    const originalHandler = client.getServerUpdateHandler();
-    const onUpdate = (upd) => {
-        if (upd._ === 'updateShort' && upd.update._ === 'updateLoginToken') {
-            onQrScanned?.();
-            waiter?.resolve();
-            client.onServerUpdate(originalHandler);
-        }
-    };
-    client.onServerUpdate(onUpdate);
-    abortSignal?.addEventListener('abort', () => {
-        client.onServerUpdate(originalHandler);
-        waiter?.reject(abortSignal.reason);
-    });
-    async function handle2fa(input) {
-        const isDynamic = typeof input === 'function';
-        while (true) {
-            const password = await resolveMaybeDynamic(input);
-            try {
-                return await checkPassword(client, password);
-            }
-            catch (e) {
-                if (tl.RpcError.is(e, 'PASSWORD_HASH_INVALID')) {
-                    if (!isDynamic) {
-                        throw e;
-                    }
-                    if (params.invalidPasswordCallback) {
-                        await params.invalidPasswordCallback?.();
-                    }
-                    else {
-                        // eslint-disable-next-line no-console
-                        console.log('Invalid password. Please try again');
-                    }
-                    continue;
-                }
-                throw e;
-            }
-        }
-    }
-    try {
-        const { id, hash } = await client.getApiCrenetials();
-        const platform = getPlatform();
-        loop: while (true) {
-            let res;
-            try {
-                res = await client.call({
-                    _: 'auth.exportLoginToken',
-                    apiId: id,
-                    apiHash: hash,
-                    exceptIds: [],
-                }, { abortSignal });
-            }
-            catch (e) {
-                if (tl.RpcError.is(e, 'SESSION_PASSWORD_NEEDED') && params.password) {
-                    return handle2fa(params.password);
-                }
-                throw e;
-            }
-            switch (res._) {
-                case 'auth.loginToken':
-                    onUrlUpdated(`tg://login?token=${platform.base64Encode(res.token, true)}`, new Date(res.expires * 1000));
-                    waiter = createControllablePromise();
-                    await Promise.race([waiter, sleepWithAbort(res.expires * 1000 - Date.now(), client.stopSignal)]);
-                    break;
-                case 'auth.loginTokenMigrateTo': {
-                    await client.changePrimaryDc(res.dcId);
-                    let res2;
-                    try {
-                        res2 = await client.call({
-                            _: 'auth.importLoginToken',
-                            token: res.token,
-                        }, { abortSignal });
-                    }
-                    catch (e) {
-                        if (tl.RpcError.is(e, 'SESSION_PASSWORD_NEEDED') && params.password) {
-                            return handle2fa(params.password);
-                        }
-                        throw e;
-                    }
-                    assertTypeIs('auth.importLoginToken', res2, 'auth.loginTokenSuccess');
-                    break loop;
-                }
-                case 'auth.loginTokenSuccess':
-                    break loop;
-            }
-        }
-        const [self] = await client.call({
-            _: 'users.getUsers',
-            id: [{ _: 'inputUserSelf' }],
-        }, { abortSignal });
-        assertTypeIs('users.getUsers', self, 'user');
-        await client.notifyLoggedIn(self);
-        return new User(self);
-    }
-    finally {
-        client.onServerUpdate(originalHandler);
-    }
-}
-//# sourceMappingURL=sign-in-qr.js.map

package/esm/highlevel/methods/auth/sign-in-qr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sign-in-qr.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/auth/sign-in-qr.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { getPlatform } from '../../../platform.js'\nimport { MaybePromise } from '../../../types/utils.js'\nimport { ControllablePromise, createControllablePromise } from '../../../utils/controllable-promise.js'\nimport { sleepWithAbort } from '../../../utils/misc-utils.js'\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient, ServerUpdateHandler } from '../../client.types.js'\nimport { MaybeDynamic, User } from '../../types/index.js'\nimport { resolveMaybeDynamic } from '../../utils/misc-utils.js'\nimport { checkPassword } from './check-password.js'\n\n// @available=user\n/**\n * Execute the [QR login flow](https://core.telegram.org/api/qr-login).\n *\n * This method will resolve once the authorization is complete,\n * returning the authorized user.\n */\nexport async function signInQr(\n    client: ITelegramClient,\n    params: {\n        /**\n         * Function that will be called whenever the login URL is changed.\n         *\n         * The app is expected to display `url` as a QR code to the user\n         */\n        onUrlUpdated: (url: string, expires: Date) => void\n\n        /**\n         * Function that will be called when the user has scanned the QR code\n         * (i.e. when `updateLoginToken` is received), and the library is finalizing the auth\n         */\n        onQrScanned?: () => void\n\n        /** Password for 2FA */\n        password?: MaybeDynamic<string>\n\n        /**\n         * Function that will be called after the server has rejected the password.\n         *\n         * Note that in case {@link password} is not a function,\n         * this callback will never be called, and an error will be thrown instead.\n         */\n        invalidPasswordCallback?: () => MaybePromise<void>\n\n        /** Abort signal */\n        abortSignal?: AbortSignal\n    },\n): Promise<User> {\n    const { onUrlUpdated, abortSignal, onQrScanned } = params\n\n    let waiter: ControllablePromise<void> | undefined\n\n    // crutch – we need to wait for the updateLoginToken update.\n    // we replace the server update handler temporarily because:\n    //   - updates manager may be disabled, in which case `onUpdate` will never be called\n    //   - even if the updates manager is enabled, it won't start until we're logged in\n    //\n    // todo: how can we make this more clean?\n    const originalHandler = client.getServerUpdateHandler()\n\n    const onUpdate: ServerUpdateHandler = (upd) => {\n        if (upd._ === 'updateShort' && upd.update._ === 'updateLoginToken') {\n            onQrScanned?.()\n            waiter?.resolve()\n            client.onServerUpdate(originalHandler)\n        }\n    }\n\n    client.onServerUpdate(onUpdate)\n\n    abortSignal?.addEventListener('abort', () => {\n        client.onServerUpdate(originalHandler)\n        waiter?.reject(abortSignal.reason)\n    })\n\n    async function handle2fa(input: MaybeDynamic<string>) {\n        const isDynamic = typeof input === 'function'\n\n        while (true) {\n            const password = await resolveMaybeDynamic(input)\n\n            try {\n                return await checkPassword(client, password)\n            } catch (e) {\n                if (tl.RpcError.is(e, 'PASSWORD_HASH_INVALID')) {\n                    if (!isDynamic) {\n                        throw e\n                    }\n\n                    if (params.invalidPasswordCallback) {\n                        await params.invalidPasswordCallback?.()\n                    } else {\n                        // eslint-disable-next-line no-console\n                        console.log('Invalid password. Please try again')\n                    }\n                    continue\n                }\n\n                throw e\n            }\n        }\n    }\n\n    try {\n        const { id, hash } = await client.getApiCrenetials()\n        const platform = getPlatform()\n\n        loop: while (true) {\n            let res: tl.auth.TypeLoginToken\n\n            try {\n                res = await client.call(\n                    {\n                        _: 'auth.exportLoginToken',\n                        apiId: id,\n                        apiHash: hash,\n                        exceptIds: [],\n                    },\n                    { abortSignal },\n                )\n            } catch (e) {\n                if (tl.RpcError.is(e, 'SESSION_PASSWORD_NEEDED') && params.password) {\n                    return handle2fa(params.password)\n                }\n\n                throw e\n            }\n\n            switch (res._) {\n                case 'auth.loginToken':\n                    onUrlUpdated(\n                        `tg://login?token=${platform.base64Encode(res.token, true)}`,\n                        new Date(res.expires * 1000),\n                    )\n\n                    waiter = createControllablePromise()\n                    await Promise.race([waiter, sleepWithAbort(res.expires * 1000 - Date.now(), client.stopSignal)])\n                    break\n                case 'auth.loginTokenMigrateTo': {\n                    await client.changePrimaryDc(res.dcId)\n\n                    let res2: tl.auth.TypeLoginToken\n\n                    try {\n                        res2 = await client.call(\n                            {\n                                _: 'auth.importLoginToken',\n                                token: res.token,\n                            },\n                            { abortSignal },\n                        )\n                    } catch (e) {\n                        if (tl.RpcError.is(e, 'SESSION_PASSWORD_NEEDED') && params.password) {\n                            return handle2fa(params.password)\n                        }\n\n                        throw e\n                    }\n\n                    assertTypeIs('auth.importLoginToken', res2, 'auth.loginTokenSuccess')\n                    break loop\n                }\n                case 'auth.loginTokenSuccess':\n                    break loop\n            }\n        }\n\n        const [self] = await client.call(\n            {\n                _: 'users.getUsers',\n                id: [{ _: 'inputUserSelf' }],\n            },\n            { abortSignal },\n        )\n        assertTypeIs('users.getUsers', self, 'user')\n\n        await client.notifyLoggedIn(self)\n\n        return new User(self)\n    } finally {\n        client.onServerUpdate(originalHandler)\n    }\n}\n"]}

package/esm/highlevel/methods/auth/sign-in.d.ts

@@ -1,19 +0,0 @@
-import { ITelegramClient } from '../../client.types.js';
-import { User } from '../../types/peers/user.js';
-/**
- * Authorize a user in Telegram with a valid confirmation code.
- *
- * @returns  If the code was valid and authorization succeeded, the {@link User} is returned.
- * @throws  BadRequestError  In case the arguments are invalid
- * @throws  SessionPasswordNeededError  In case a password is needed to sign in
- */
-export declare function signIn(client: ITelegramClient, params: {
-    /** Phone number in international format */
-    phone: string;
-    /** Code identifier from {@link sendCode} */
-    phoneCodeHash: string;
-    /** The confirmation code that was received */
-    phoneCode: string;
-    /** Abort signal */
-    abortSignal?: AbortSignal;
-}): Promise<User>;

package/esm/highlevel/methods/auth/sign-in.js

@@ -1,20 +0,0 @@
-import { normalizePhoneNumber } from '../../utils/misc-utils.js';
-import { _onAuthorization } from './utils.js';
-/**
- * Authorize a user in Telegram with a valid confirmation code.
- *
- * @returns  If the code was valid and authorization succeeded, the {@link User} is returned.
- * @throws  BadRequestError  In case the arguments are invalid
- * @throws  SessionPasswordNeededError  In case a password is needed to sign in
- */
-export async function signIn(client, params) {
-    const { phone, phoneCodeHash, phoneCode, abortSignal } = params;
-    const res = await client.call({
-        _: 'auth.signIn',
-        phoneNumber: normalizePhoneNumber(phone),
-        phoneCodeHash,
-        phoneCode,
-    }, { abortSignal });
-    return _onAuthorization(client, res);
-}
-//# sourceMappingURL=sign-in.js.map

package/esm/highlevel/methods/auth/sign-in.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sign-in.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/auth/sign-in.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CACxB,MAAuB,EACvB,MASC;IAED,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CAAA;IAE/D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CACzB;QACI,CAAC,EAAE,aAAa;QAChB,WAAW,EAAE,oBAAoB,CAAC,KAAK,CAAC;QACxC,aAAa;QACb,SAAS;KACZ,EACD,EAAE,WAAW,EAAE,CAClB,CAAA;IAED,OAAO,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACxC,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { User } from '../../types/peers/user.js'\nimport { normalizePhoneNumber } from '../../utils/misc-utils.js'\nimport { _onAuthorization } from './utils.js'\n\n/**\n * Authorize a user in Telegram with a valid confirmation code.\n *\n * @returns  If the code was valid and authorization succeeded, the {@link User} is returned.\n * @throws  BadRequestError  In case the arguments are invalid\n * @throws  SessionPasswordNeededError  In case a password is needed to sign in\n */\nexport async function signIn(\n    client: ITelegramClient,\n    params: {\n        /** Phone number in international format */\n        phone: string\n        /** Code identifier from {@link sendCode} */\n        phoneCodeHash: string\n        /** The confirmation code that was received */\n        phoneCode: string\n        /** Abort signal */\n        abortSignal?: AbortSignal\n    },\n): Promise<User> {\n    const { phone, phoneCodeHash, phoneCode, abortSignal } = params\n\n    const res = await client.call(\n        {\n            _: 'auth.signIn',\n            phoneNumber: normalizePhoneNumber(phone),\n            phoneCodeHash,\n            phoneCode,\n        },\n        { abortSignal },\n    )\n\n    return _onAuthorization(client, res)\n}\n"]}

package/esm/highlevel/methods/auth/start-test.d.ts

@@ -1,30 +0,0 @@
-import { ITelegramClient } from '../../client.types.js';
-import { User } from '../../types/index.js';
-/**
- * Utility function to quickly authorize on test DC
- * using a [Test phone number](https://core.telegram.org/api/auth#test-phone-numbers),
- * which is randomly generated by default.
- *
- * > **Note**: Using this method assumes that you
- * > are using a test DC in `primaryDc` parameter.
- *
- * @param params  Additional parameters
- */
-export declare function startTest(client: ITelegramClient, params?: {
-    /**
-     * Whether to log out if current session is logged in.
-     *
-     * @default  false.
-     */
-    logout?: boolean;
-    /**
-     * Override phone number. Must be a valid Test phone number.
-     *
-     * By default is randomly generated.
-     */
-    phone?: string;
-    /**
-     * Override user's DC. Must be a valid test DC.
-     */
-    dcId?: number;
-}): Promise<User>;

package/esm/highlevel/methods/auth/start-test.js

@@ -1,62 +0,0 @@
-import { MtArgumentError } from '../../../types/errors.js';
-import { logOut } from './log-out.js';
-import { start } from './start.js';
-/**
- * Utility function to quickly authorize on test DC
- * using a [Test phone number](https://core.telegram.org/api/auth#test-phone-numbers),
- * which is randomly generated by default.
- *
- * > **Note**: Using this method assumes that you
- * > are using a test DC in `primaryDc` parameter.
- *
- * @param params  Additional parameters
- */
-export async function startTest(client, params) {
-    if (!params)
-        params = {};
-    if (params.logout) {
-        try {
-            await logOut(client);
-        }
-        catch (e) { }
-    }
-    const availableDcs = await client
-        .call({
-        _: 'help.getConfig',
-    })
-        .then((res) => res.dcOptions);
-    let phone = params.phone;
-    if (phone) {
-        if (!phone.match(/^99966\d{5}/)) {
-            throw new MtArgumentError(`${phone} is an invalid test phone number`);
-        }
-        const id = parseInt(phone[5]);
-        if (!availableDcs.find((dc) => dc.id === id)) {
-            throw new MtArgumentError(`${phone} has invalid DC ID (${id})`);
-        }
-    }
-    else {
-        let dcId = await client.getPrimaryDcId();
-        if (params.dcId) {
-            if (!availableDcs.find((dc) => dc.id === params.dcId)) {
-                throw new MtArgumentError(`DC ID is invalid (${dcId})`);
-            }
-            dcId = params.dcId;
-        }
-        let numbers = Math.floor(Math.random() * 9999).toString();
-        while (numbers.length !== 4)
-            numbers += '0';
-        phone = `99966${dcId}${numbers}`;
-    }
-    let code = '';
-    return start(client, {
-        phone,
-        code: () => code,
-        codeSentCallback: (sent) => {
-            for (let i = 0; i < sent.length; i++) {
-                code += phone[5];
-            }
-        },
-    });
-}
-//# sourceMappingURL=start-test.js.map

package/esm/highlevel/methods/auth/start-test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"start-test.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/auth/start-test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAG1D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,MAAuB,EACvB,MAmBC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,EAAE,CAAA;IAExB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CAAC;IAClB,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,MAAM;SAC5B,IAAI,CAAC;QACF,CAAC,EAAE,gBAAgB;KACtB,CAAC;SACD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAEjC,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAExB,IAAI,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,kCAAkC,CAAC,CAAA;QACzE,CAAC;QACD,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAE7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,uBAAuB,EAAE,GAAG,CAAC,CAAA;QACnE,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,IAAI,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAA;QAExC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,eAAe,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAA;YAC3D,CAAC;YACD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QACtB,CAAC;QAED,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAA;QACzD,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,GAAG,CAAA;QAE3C,KAAK,GAAG,QAAQ,IAAI,GAAG,OAAO,EAAE,CAAA;IACpC,CAAC;IAED,IAAI,IAAI,GAAG,EAAE,CAAA;IAEb,OAAO,KAAK,CAAC,MAAM,EAAE;QACjB,KAAK;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI;QAChB,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAA;YACpB,CAAC;QACL,CAAC;KACJ,CAAC,CAAA;AACN,CAAC","sourcesContent":["import { MtArgumentError } from '../../../types/errors.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { User } from '../../types/index.js'\nimport { logOut } from './log-out.js'\nimport { start } from './start.js'\n\n/**\n * Utility function to quickly authorize on test DC\n * using a [Test phone number](https://core.telegram.org/api/auth#test-phone-numbers),\n * which is randomly generated by default.\n *\n * > **Note**: Using this method assumes that you\n * > are using a test DC in `primaryDc` parameter.\n *\n * @param params  Additional parameters\n */\nexport async function startTest(\n    client: ITelegramClient,\n    params?: {\n        /**\n         * Whether to log out if current session is logged in.\n         *\n         * @default  false.\n         */\n        logout?: boolean\n\n        /**\n         * Override phone number. Must be a valid Test phone number.\n         *\n         * By default is randomly generated.\n         */\n        phone?: string\n\n        /**\n         * Override user's DC. Must be a valid test DC.\n         */\n        dcId?: number\n    },\n): Promise<User> {\n    if (!params) params = {}\n\n    if (params.logout) {\n        try {\n            await logOut(client)\n        } catch (e) {}\n    }\n\n    const availableDcs = await client\n        .call({\n            _: 'help.getConfig',\n        })\n        .then((res) => res.dcOptions)\n\n    let phone = params.phone\n\n    if (phone) {\n        if (!phone.match(/^99966\\d{5}/)) {\n            throw new MtArgumentError(`${phone} is an invalid test phone number`)\n        }\n        const id = parseInt(phone[5])\n\n        if (!availableDcs.find((dc) => dc.id === id)) {\n            throw new MtArgumentError(`${phone} has invalid DC ID (${id})`)\n        }\n    } else {\n        let dcId = await client.getPrimaryDcId()\n\n        if (params.dcId) {\n            if (!availableDcs.find((dc) => dc.id === params.dcId)) {\n                throw new MtArgumentError(`DC ID is invalid (${dcId})`)\n            }\n            dcId = params.dcId\n        }\n\n        let numbers = Math.floor(Math.random() * 9999).toString()\n        while (numbers.length !== 4) numbers += '0'\n\n        phone = `99966${dcId}${numbers}`\n    }\n\n    let code = ''\n\n    return start(client, {\n        phone,\n        code: () => code,\n        codeSentCallback: (sent) => {\n            for (let i = 0; i < sent.length; i++) {\n                code += phone[5]\n            }\n        },\n    })\n}\n"]}

package/esm/highlevel/methods/auth/start.d.ts

@@ -1,89 +0,0 @@
-import { tl } from '@mtcute/tl';
-import { MaybePromise } from '../../../types/utils.js';
-import { ITelegramClient } from '../../client.types.js';
-import { SentCode } from '../../types/auth/sent-code.js';
-import { User } from '../../types/peers/user.js';
-import { MaybeDynamic } from '../../types/utils.js';
-import { StringSessionData } from '../../utils/string-session.js';
-/**
- * Start the client in an interactive and declarative manner,
- * by providing callbacks for authorization details.
- *
- * This method handles both login and sign up, and also handles 2FV
- *
- * All parameters are `MaybeDynamic<T>`, meaning you
- * can either supply `T`, or a function that returns `MaybePromise<T>`
- *
- * This method is intended for simple and fast use in automated
- * scripts and bots. If you are developing a custom client,
- * you'll probably need to use other auth methods.
- */
-export declare function start(client: ITelegramClient, params: {
-    /**
-     * String session exported using {@link TelegramClient.exportSession}.
-     *
-     * This simply calls {@link TelegramClient.importSession} before anything else.
-     *
-     * Note that passed session will be ignored in case storage already
-     * contains authorization.
-     */
-    session?: string | StringSessionData;
-    /**
-     * 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
-     */
-    phone?: MaybeDynamic<string>;
-    /**
-     * Bot token to use. Ignored if `phone` is supplied.
-     */
-    botToken?: MaybeDynamic<string>;
-    /**
-     * 2FA password. Ignored if `botToken` is supplied
-     */
-    password?: MaybeDynamic<string>;
-    /**
-     * Code sent to the phone (either sms, call, flash call or other).
-     * Ignored if `botToken` is supplied, must be present if `phone` is supplied.
-     */
-    code?: MaybeDynamic<string>;
-    /**
-     * If passed, this function will be called if provided code or 2FA password
-     * was invalid. New code/password will be requested later.
-     *
-     * If provided `code`/`password` is a constant string, providing an
-     * invalid one will interrupt authorization flow.
-     */
-    invalidCodeCallback?: (type: 'code' | 'password') => MaybePromise<void>;
-    /**
-     * Whether to force code delivery through SMS
-     */
-    forceSms?: boolean;
-    /**
-     * Custom method that is called when a code is sent. Can be used
-     * to show a GUI alert of some kind.
-     *
-     * This method is called *before* {@link start.params.code}.
-     *
-     * @param code
-     * @default  `console.log`.
-     */
-    codeSentCallback?: (code: SentCode) => MaybePromise<void>;
-    /** Saved future auth tokens, if any */
-    futureAuthTokens?: Uint8Array[];
-    /** Additional code settings to pass to the server */
-    codeSettings?: Omit<tl.RawCodeSettings, '_' | 'logoutTokens'>;
-    /** Abort signal */
-    abortSignal?: AbortSignal;
-}): Promise<User>;

package/esm/highlevel/methods/auth/start.js

@@ -1,182 +0,0 @@
-/* eslint-disable no-console */
-import { tl } from '@mtcute/tl';
-import { MtArgumentError, MtcuteError } from '../../../types/errors.js';
-import { normalizePhoneNumber, resolveMaybeDynamic } from '../../utils/misc-utils.js';
-import { getMe } from '../users/get-me.js';
-import { checkPassword } from './check-password.js';
-import { resendCode } from './resend-code.js';
-import { sendCode } from './send-code.js';
-import { signIn } from './sign-in.js';
-import { signInBot } from './sign-in-bot.js';
-import { signInQr } from './sign-in-qr.js';
-// @available=both
-/**
- * Start the client in an interactive and declarative manner,
- * by providing callbacks for authorization details.
- *
- * This method handles both login and sign up, and also handles 2FV
- *
- * All parameters are `MaybeDynamic<T>`, meaning you
- * can either supply `T`, or a function that returns `MaybePromise<T>`
- *
- * This method is intended for simple and fast use in automated
- * scripts and bots. If you are developing a custom client,
- * you'll probably need to use other auth methods.
- */
-export async function start(client, params) {
-    if (params.session) {
-        await client.importSession(params.session, params.sessionForce);
-    }
-    const { abortSignal } = params;
-    let has2fa = false;
-    let sentCode;
-    let phone = null;
-    try {
-        const me = await getMe(client);
-        // user is already authorized
-        client.log.info('Logged in as %s (ID: %s, username: %s, bot: %s)', me.displayName, me.id, me.username, me.isBot);
-        await client.notifyLoggedIn(me.raw);
-        return me;
-    }
-    catch (e) {
-        if (tl.RpcError.is(e)) {
-            if (e.text === 'SESSION_PASSWORD_NEEDED')
-                has2fa = true;
-            else if (e.text !== 'AUTH_KEY_UNREGISTERED')
-                throw e;
-        }
-    }
-    // if has2fa == true, then we are half-logged in, but need to enter password
-    if (!has2fa && !params.qrCodeHandler) {
-        if (!params.phone && !params.botToken) {
-            throw new MtArgumentError('Neither phone nor bot token were provided');
-        }
-        phone = params.phone ? await resolveMaybeDynamic(params.phone) : null;
-        if (phone) {
-            phone = normalizePhoneNumber(phone);
-            if (!params.code) {
-                throw new MtArgumentError('You must pass `code` to use `phone`');
-            }
-        }
-        else {
-            const botToken = params.botToken ? await resolveMaybeDynamic(params.botToken) : null;
-            if (!botToken) {
-                throw new MtArgumentError('Either bot token or phone number must be provided');
-            }
-            return await signInBot(client, botToken);
-        }
-        try {
-            sentCode = await sendCode(client, {
-                phone,
-                futureAuthTokens: params.futureAuthTokens,
-                codeSettings: params.codeSettings,
-                abortSignal,
-            });
-        }
-        catch (e) {
-            if (tl.RpcError.is(e, 'SESSION_PASSWORD_NEEDED')) {
-                has2fa = true;
-            }
-            else {
-                throw e;
-            }
-        }
-    }
-    if (sentCode) {
-        if (params.forceSms && (sentCode.type === 'app' || sentCode.type === 'email')) {
-            sentCode = await resendCode(client, {
-                phone: phone,
-                phoneCodeHash: sentCode.phoneCodeHash,
-                abortSignal,
-            });
-        }
-        if (params.codeSentCallback) {
-            await params.codeSentCallback(sentCode);
-        }
-        else {
-            if (sentCode.type === 'email_required') {
-                throw new MtcuteError('Email login setup is required to sign in');
-            }
-            console.log(`The confirmation code has been sent via ${sentCode.type}.`);
-        }
-        for (;;) {
-            const code = await resolveMaybeDynamic(params.code);
-            if (!code)
-                throw new tl.RpcError(400, 'PHONE_CODE_EMPTY');
-            try {
-                return await signIn(client, {
-                    phone: phone,
-                    phoneCodeHash: sentCode.phoneCodeHash,
-                    phoneCode: code,
-                    abortSignal,
-                });
-            }
-            catch (e) {
-                if (!tl.RpcError.is(e))
-                    throw e;
-                if (e.is('SESSION_PASSWORD_NEEDED')) {
-                    has2fa = true;
-                    break;
-                }
-                else if (e.is('PHONE_CODE_EMPTY') ||
-                    e.is('PHONE_CODE_EXPIRED') ||
-                    e.is('PHONE_CODE_INVALID') ||
-                    e.is('PHONE_CODE_HASH_EMPTY')) {
-                    if (typeof params.code !== 'function') {
-                        throw new MtArgumentError('Provided code was invalid');
-                    }
-                    if (params.invalidCodeCallback) {
-                        await params.invalidCodeCallback('code');
-                    }
-                    else {
-                        console.log('Invalid code. Please try again');
-                    }
-                    continue;
-                }
-                else
-                    throw e;
-            }
-            // if there was no error, code was valid, so it's either 2fa or signup
-            break;
-        }
-    }
-    if (has2fa) {
-        if (!params.password) {
-            throw new MtArgumentError('2FA is enabled, but `password` was not provided.');
-        }
-        for (;;) {
-            const password = await resolveMaybeDynamic(params.password);
-            try {
-                return await checkPassword(client, password);
-            }
-            catch (e) {
-                if (typeof params.password !== 'function') {
-                    throw new MtArgumentError('Provided password was invalid');
-                }
-                if (tl.RpcError.is(e, 'PASSWORD_HASH_INVALID')) {
-                    if (params.invalidCodeCallback) {
-                        await params.invalidCodeCallback('password');
-                    }
-                    else {
-                        console.log('Invalid password. Please try again');
-                    }
-                    continue;
-                }
-                else
-                    throw e;
-            }
-        }
-    }
-    if (params.qrCodeHandler) {
-        return await signInQr(client, {
-            onUrlUpdated: params.qrCodeHandler,
-            password: params.password,
-            invalidPasswordCallback: params.invalidCodeCallback ?
-                () => params.invalidCodeCallback('password') :
-                undefined,
-            abortSignal,
-        });
-    }
-    throw new MtArgumentError('Failed to log in with provided credentials');
-}
-//# sourceMappingURL=start.js.map

package/esm/highlevel/methods/auth/start.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/auth/start.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAE/B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAMvE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAErF,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,kBAAkB;AAClB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACvB,MAAuB,EACvB,MAgFC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAA;IAE9B,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,IAAI,QAA8B,CAAA;IAClC,IAAI,KAAK,GAAkB,IAAI,CAAA;IAE/B,IAAI,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAA;QAE9B,6BAA6B;QAE7B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,iDAAiD,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,CAAA;QAEhH,MAAM,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;QAEnC,OAAO,EAAE,CAAA;IACb,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,CAAC,IAAI,KAAK,yBAAyB;gBAAE,MAAM,GAAG,IAAI,CAAA;iBAClD,IAAI,CAAC,CAAC,IAAI,KAAK,uBAAuB;gBAAE,MAAM,CAAC,CAAA;QACxD,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,eAAe,CAAC,2CAA2C,CAAC,CAAA;QAC1E,CAAC;QAED,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAErE,IAAI,KAAK,EAAE,CAAC;YACR,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;YAEnC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,IAAI,eAAe,CAAC,qCAAqC,CAAC,CAAA;YACpE,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAEpF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,MAAM,IAAI,eAAe,CAAC,mDAAmD,CAAC,CAAA;YAClF,CAAC;YAED,OAAO,MAAM,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC5C,CAAC;QAED,IAAI,CAAC;YACD,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE;gBAC9B,KAAK;gBACL,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,WAAW;aACd,CAAC,CAAA;QACN,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,yBAAyB,CAAC,EAAE,CAAC;gBAC/C,MAAM,GAAG,IAAI,CAAA;YACjB,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,CAAA;YACX,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;YAC5E,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;gBAChC,KAAK,EAAE,KAAM;gBACb,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,WAAW;aACd,CAAC,CAAA;QACN,CAAC;QAED,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC3C,CAAC;aAAM,CAAC;YACJ,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACrC,MAAM,IAAI,WAAW,CAAC,0CAA0C,CAAC,CAAA;YACrE,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,2CAA2C,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAA;QAC5E,CAAC;QAED,SAAS,CAAC;YACN,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACnD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;YAEzD,IAAI,CAAC;gBACD,OAAO,MAAM,MAAM,CAAC,MAAM,EAAE;oBACxB,KAAK,EAAE,KAAM;oBACb,aAAa,EAAE,QAAQ,CAAC,aAAa;oBACrC,SAAS,EAAE,IAAI;oBACf,WAAW;iBACd,CAAC,CAAA;YACN,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;oBAAE,MAAM,CAAC,CAAA;gBAE/B,IAAI,CAAC,CAAC,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC;oBAClC,MAAM,GAAG,IAAI,CAAA;oBACb,MAAK;gBACT,CAAC;qBAAM,IACH,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC;oBACxB,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC;oBAC1B,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC;oBAC1B,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC,EAC/B,CAAC;oBACC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;wBACpC,MAAM,IAAI,eAAe,CAAC,2BAA2B,CAAC,CAAA;oBAC1D,CAAC;oBAED,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;wBAC7B,MAAM,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;oBAC5C,CAAC;yBAAM,CAAC;wBACJ,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;oBACjD,CAAC;oBAED,SAAQ;gBACZ,CAAC;;oBAAM,MAAM,CAAC,CAAA;YAClB,CAAC;YAED,sEAAsE;YACtE,MAAK;QACT,CAAC;IACL,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACT,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,eAAe,CAAC,kDAAkD,CAAC,CAAA;QACjF,CAAC;QAED,SAAS,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAE3D,IAAI,CAAC;gBACD,OAAO,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;YAChD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACxC,MAAM,IAAI,eAAe,CAAC,+BAA+B,CAAC,CAAA;gBAC9D,CAAC;gBAED,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,uBAAuB,CAAC,EAAE,CAAC;oBAC7C,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;wBAC7B,MAAM,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAA;oBAChD,CAAC;yBAAM,CAAC;wBACJ,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;oBACrD,CAAC;oBACD,SAAQ;gBACZ,CAAC;;oBAAM,MAAM,CAAC,CAAA;YAClB,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACvB,OAAO,MAAM,QAAQ,CAAC,MAAM,EAAE;YAC1B,YAAY,EAAE,MAAM,CAAC,aAAa;YAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,uBAAuB,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC;gBACjD,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC/C,SAAS;YACb,WAAW;SACd,CAAC,CAAA;IACN,CAAC;IAED,MAAM,IAAI,eAAe,CAAC,4CAA4C,CAAC,CAAA;AAC3E,CAAC","sourcesContent":["/* eslint-disable no-console */\nimport { tl } from '@mtcute/tl'\n\nimport { MtArgumentError, MtcuteError } from '../../../types/errors.js'\nimport { MaybePromise } from '../../../types/utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { SentCode } from '../../types/auth/sent-code.js'\nimport { User } from '../../types/peers/user.js'\nimport { MaybeDynamic } from '../../types/utils.js'\nimport { normalizePhoneNumber, resolveMaybeDynamic } from '../../utils/misc-utils.js'\nimport { StringSessionData } from '../../utils/string-session.js'\nimport { getMe } from '../users/get-me.js'\nimport { checkPassword } from './check-password.js'\nimport { resendCode } from './resend-code.js'\nimport { sendCode } from './send-code.js'\nimport { signIn } from './sign-in.js'\nimport { signInBot } from './sign-in-bot.js'\nimport { signInQr } from './sign-in-qr.js'\n\n// @available=both\n/**\n * Start the client in an interactive and declarative manner,\n * by providing callbacks for authorization details.\n *\n * This method handles both login and sign up, and also handles 2FV\n *\n * All parameters are `MaybeDynamic<T>`, meaning you\n * can either supply `T`, or a function that returns `MaybePromise<T>`\n *\n * This method is intended for simple and fast use in automated\n * scripts and bots. If you are developing a custom client,\n * you'll probably need to use other auth methods.\n */\nexport async function start(\n    client: ITelegramClient,\n    params: {\n        /**\n         * String session exported using {@link TelegramClient.exportSession}.\n         *\n         * This simply calls {@link TelegramClient.importSession} before anything else.\n         *\n         * Note that passed session will be ignored in case storage already\n         * contains authorization.\n         */\n        session?: string | StringSessionData\n\n        /**\n         * Whether to overwrite existing session.\n         */\n        sessionForce?: boolean\n\n        /**\n         * When passed, [QR login flow](https://core.telegram.org/api/qr-login)\n         * will be used instead of the regular login flow.\n         *\n         * This function will be called whenever the login URL is changed,\n         * and the app is expected to display it as a QR code to the user.\n         */\n        qrCodeHandler?: (url: string, expires: Date) => void\n\n        /**\n         * Phone number of the account.\n         * If account does not exist, it will be created\n         */\n        phone?: MaybeDynamic<string>\n\n        /**\n         * Bot token to use. Ignored if `phone` is supplied.\n         */\n        botToken?: MaybeDynamic<string>\n\n        /**\n         * 2FA password. Ignored if `botToken` is supplied\n         */\n        password?: MaybeDynamic<string>\n\n        /**\n         * Code sent to the phone (either sms, call, flash call or other).\n         * Ignored if `botToken` is supplied, must be present if `phone` is supplied.\n         */\n        code?: MaybeDynamic<string>\n\n        /**\n         * If passed, this function will be called if provided code or 2FA password\n         * was invalid. New code/password will be requested later.\n         *\n         * If provided `code`/`password` is a constant string, providing an\n         * invalid one will interrupt authorization flow.\n         */\n        invalidCodeCallback?: (type: 'code' | 'password') => MaybePromise<void>\n\n        /**\n         * Whether to force code delivery through SMS\n         */\n        forceSms?: boolean\n\n        /**\n         * Custom method that is called when a code is sent. Can be used\n         * to show a GUI alert of some kind.\n         *\n         * This method is called *before* {@link start.params.code}.\n         *\n         * @param code\n         * @default  `console.log`.\n         */\n        codeSentCallback?: (code: SentCode) => MaybePromise<void>\n\n        /** Saved future auth tokens, if any */\n        futureAuthTokens?: Uint8Array[]\n\n        /** Additional code settings to pass to the server */\n        codeSettings?: Omit<tl.RawCodeSettings, '_' | 'logoutTokens'>\n\n        /** Abort signal */\n        abortSignal?: AbortSignal\n    },\n): Promise<User> {\n    if (params.session) {\n        await client.importSession(params.session, params.sessionForce)\n    }\n\n    const { abortSignal } = params\n\n    let has2fa = false\n    let sentCode: SentCode | undefined\n    let phone: string | null = null\n\n    try {\n        const me = await getMe(client)\n\n        // user is already authorized\n\n        client.log.info('Logged in as %s (ID: %s, username: %s, bot: %s)', me.displayName, me.id, me.username, me.isBot)\n\n        await client.notifyLoggedIn(me.raw)\n\n        return me\n    } catch (e) {\n        if (tl.RpcError.is(e)) {\n            if (e.text === 'SESSION_PASSWORD_NEEDED') has2fa = true\n            else if (e.text !== 'AUTH_KEY_UNREGISTERED') throw e\n        }\n    }\n\n    // if has2fa == true, then we are half-logged in, but need to enter password\n    if (!has2fa && !params.qrCodeHandler) {\n        if (!params.phone && !params.botToken) {\n            throw new MtArgumentError('Neither phone nor bot token were provided')\n        }\n\n        phone = params.phone ? await resolveMaybeDynamic(params.phone) : null\n\n        if (phone) {\n            phone = normalizePhoneNumber(phone)\n\n            if (!params.code) {\n                throw new MtArgumentError('You must pass `code` to use `phone`')\n            }\n        } else {\n            const botToken = params.botToken ? await resolveMaybeDynamic(params.botToken) : null\n\n            if (!botToken) {\n                throw new MtArgumentError('Either bot token or phone number must be provided')\n            }\n\n            return await signInBot(client, botToken)\n        }\n\n        try {\n            sentCode = await sendCode(client, {\n                phone,\n                futureAuthTokens: params.futureAuthTokens,\n                codeSettings: params.codeSettings,\n                abortSignal,\n            })\n        } catch (e) {\n            if (tl.RpcError.is(e, 'SESSION_PASSWORD_NEEDED')) {\n                has2fa = true\n            } else {\n                throw e\n            }\n        }\n    }\n\n    if (sentCode) {\n        if (params.forceSms && (sentCode.type === 'app' || sentCode.type === 'email')) {\n            sentCode = await resendCode(client, {\n                phone: phone!,\n                phoneCodeHash: sentCode.phoneCodeHash,\n                abortSignal,\n            })\n        }\n\n        if (params.codeSentCallback) {\n            await params.codeSentCallback(sentCode)\n        } else {\n            if (sentCode.type === 'email_required') {\n                throw new MtcuteError('Email login setup is required to sign in')\n            }\n\n            console.log(`The confirmation code has been sent via ${sentCode.type}.`)\n        }\n\n        for (;;) {\n            const code = await resolveMaybeDynamic(params.code)\n            if (!code) throw new tl.RpcError(400, 'PHONE_CODE_EMPTY')\n\n            try {\n                return await signIn(client, {\n                    phone: phone!,\n                    phoneCodeHash: sentCode.phoneCodeHash,\n                    phoneCode: code,\n                    abortSignal,\n                })\n            } catch (e) {\n                if (!tl.RpcError.is(e)) throw e\n\n                if (e.is('SESSION_PASSWORD_NEEDED')) {\n                    has2fa = true\n                    break\n                } else if (\n                    e.is('PHONE_CODE_EMPTY') ||\n                    e.is('PHONE_CODE_EXPIRED') ||\n                    e.is('PHONE_CODE_INVALID') ||\n                    e.is('PHONE_CODE_HASH_EMPTY')\n                ) {\n                    if (typeof params.code !== 'function') {\n                        throw new MtArgumentError('Provided code was invalid')\n                    }\n\n                    if (params.invalidCodeCallback) {\n                        await params.invalidCodeCallback('code')\n                    } else {\n                        console.log('Invalid code. Please try again')\n                    }\n\n                    continue\n                } else throw e\n            }\n\n            // if there was no error, code was valid, so it's either 2fa or signup\n            break\n        }\n    }\n\n    if (has2fa) {\n        if (!params.password) {\n            throw new MtArgumentError('2FA is enabled, but `password` was not provided.')\n        }\n\n        for (;;) {\n            const password = await resolveMaybeDynamic(params.password)\n\n            try {\n                return await checkPassword(client, password)\n            } catch (e) {\n                if (typeof params.password !== 'function') {\n                    throw new MtArgumentError('Provided password was invalid')\n                }\n\n                if (tl.RpcError.is(e, 'PASSWORD_HASH_INVALID')) {\n                    if (params.invalidCodeCallback) {\n                        await params.invalidCodeCallback('password')\n                    } else {\n                        console.log('Invalid password. Please try again')\n                    }\n                    continue\n                } else throw e\n            }\n        }\n    }\n\n    if (params.qrCodeHandler) {\n        return await signInQr(client, {\n            onUrlUpdated: params.qrCodeHandler,\n            password: params.password,\n            invalidPasswordCallback: params.invalidCodeCallback ?\n                () => params.invalidCodeCallback!('password') :\n                undefined,\n            abortSignal,\n        })\n    }\n\n    throw new MtArgumentError('Failed to log in with provided credentials')\n}\n"]}

package/esm/highlevel/methods/auth/utils.d.ts

@@ -1,9 +0,0 @@
-import { tl } from '@mtcute/tl';
-import { ITelegramClient } from '../../client.types.js';
-import { User } from '../../types/peers/user.js';
-/** @internal */
-export declare function _onAuthorization(client: ITelegramClient, auth: tl.auth.TypeAuthorization): Promise<User>;
-/**
- * Check if the given peer/input peer is referring to the current user
- */
-export declare function isSelfPeer(client: ITelegramClient, peer: tl.TypeInputPeer | tl.TypePeer | tl.TypeInputUser): boolean;

package/esm/highlevel/methods/auth/utils.js

@@ -1,28 +0,0 @@
-import { User } from '../../types/peers/user.js';
-/** @internal */
-export async function _onAuthorization(client, auth) {
-    const user = await client.notifyLoggedIn(auth);
-    return new User(user);
-}
-/**
- * Check if the given peer/input peer is referring to the current user
- */
-export function isSelfPeer(client, peer) {
-    const state = client.storage.self.getCached();
-    if (!state)
-        return false;
-    switch (peer._) {
-        case 'inputPeerSelf':
-        case 'inputUserSelf':
-            return true;
-        case 'inputPeerUser':
-        case 'inputPeerUserFromMessage':
-        case 'inputUser':
-        case 'inputUserFromMessage':
-        case 'peerUser':
-            return peer.userId === state.userId;
-        default:
-            return false;
-    }
-}
-//# sourceMappingURL=utils.js.map

package/esm/highlevel/methods/auth/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/auth/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAA;AAEhD,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,MAAuB,EACvB,IAA+B;IAE/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;IAE9C,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACtB,MAAuB,EACvB,IAAuD;IAEvD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAExB,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;QACb,KAAK,eAAe,CAAC;QACrB,KAAK,eAAe;YAChB,OAAO,IAAI,CAAA;QACf,KAAK,eAAe,CAAC;QACrB,KAAK,0BAA0B,CAAC;QAChC,KAAK,WAAW,CAAC;QACjB,KAAK,sBAAsB,CAAC;QAC5B,KAAK,UAAU;YACX,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAA;QACvC;YACI,OAAO,KAAK,CAAA;IACpB,CAAC;AACL,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport { User } from '../../types/peers/user.js'\n\n/** @internal */\nexport async function _onAuthorization(\n    client: ITelegramClient,\n    auth: tl.auth.TypeAuthorization,\n): Promise<User> {\n    const user = await client.notifyLoggedIn(auth)\n\n    return new User(user)\n}\n\n/**\n * Check if the given peer/input peer is referring to the current user\n */\nexport function isSelfPeer(\n    client: ITelegramClient,\n    peer: tl.TypeInputPeer | tl.TypePeer | tl.TypeInputUser,\n): boolean {\n    const state = client.storage.self.getCached()\n    if (!state) return false\n\n    switch (peer._) {\n        case 'inputPeerSelf':\n        case 'inputUserSelf':\n            return true\n        case 'inputPeerUser':\n        case 'inputPeerUserFromMessage':\n        case 'inputUser':\n        case 'inputUserFromMessage':\n        case 'peerUser':\n            return peer.userId === state.userId\n        default:\n            return false\n    }\n}\n"]}