@mtcute/core 0.5.0 → 0.7.0

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

@@ -0,0 +1,30 @@
+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

@@ -0,0 +1,62 @@
+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

@@ -0,0 +1 @@
+{"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;QACf,IAAI;YACA,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;SACvB;QAAC,OAAO,CAAC,EAAE,GAAE;KACjB;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;QACP,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE;YAC7B,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,kCAAkC,CAAC,CAAA;SACxE;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;YAC1C,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,uBAAuB,EAAE,GAAG,CAAC,CAAA;SAClE;KACJ;SAAM;QACH,IAAI,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAA;QAExC,IAAI,MAAM,CAAC,IAAI,EAAE;YACb,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,MAAO,CAAC,IAAI,CAAC,EAAE;gBACpD,MAAM,IAAI,eAAe,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAA;aAC1D;YACD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;SACrB;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;KACnC;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;gBAClC,IAAI,IAAI,KAAM,CAAC,CAAC,CAAC,CAAA;aACpB;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

@@ -0,0 +1,74 @@
+import { MaybePromise } from '../../../types/utils.js';
+import { StringSessionData } from '../../../utils/string-session.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';
+/**
+ * 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;
+    /**
+     * 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>;
+}): Promise<User>;

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

@@ -0,0 +1,132 @@
+/* eslint-disable no-console */
+import { tl } from '@mtcute/tl';
+import { MtArgumentError } 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';
+// @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);
+    }
+    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, 'AUTH_KEY_UNREGISTERED'))
+            throw e;
+    }
+    if (!params.phone && !params.botToken) {
+        throw new MtArgumentError('Neither phone nor bot token were provided');
+    }
+    let 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);
+    }
+    let sentCode = await sendCode(client, { phone });
+    if (params.forceSms && sentCode.type === 'app') {
+        sentCode = await resendCode(client, { phone, phoneCodeHash: sentCode.phoneCodeHash });
+    }
+    if (params.codeSentCallback) {
+        await params.codeSentCallback(sentCode);
+    }
+    else {
+        console.log(`The confirmation code has been sent via ${sentCode.type}.`);
+    }
+    let has2fa = false;
+    for (;;) {
+        const code = await resolveMaybeDynamic(params.code);
+        if (!code)
+            throw new tl.RpcError(400, 'PHONE_CODE_EMPTY');
+        try {
+            return await signIn(client, { phone, phoneCodeHash: sentCode.phoneCodeHash, phoneCode: code });
+        }
+        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;
+            }
+        }
+    }
+    throw new MtArgumentError('Failed to log in with provided credentials');
+}
+//# sourceMappingURL=start.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/auth/start.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-console */\nimport { tl } from '@mtcute/tl'\n\nimport { MtArgumentError } from '../../../types/errors.js'\nimport { MaybePromise } from '../../../types/utils.js'\nimport { StringSessionData } from '../../../utils/string-session.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 { 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'\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         * 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): Promise<User> {\n    if (params.session) {\n        await client.importSession(params.session, params.sessionForce)\n    }\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, 'AUTH_KEY_UNREGISTERED')) throw e\n    }\n\n    if (!params.phone && !params.botToken) {\n        throw new MtArgumentError('Neither phone nor bot token were provided')\n    }\n\n    let 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    let sentCode = await sendCode(client, { phone })\n\n    if (params.forceSms && sentCode.type === 'app') {\n        sentCode = await resendCode(client, { phone, phoneCodeHash: sentCode.phoneCodeHash })\n    }\n\n    if (params.codeSentCallback) {\n        await params.codeSentCallback(sentCode)\n    } else {\n        console.log(`The confirmation code has been sent via ${sentCode.type}.`)\n    }\n\n    let has2fa = false\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, { phone, phoneCodeHash: sentCode.phoneCodeHash, phoneCode: code })\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    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    throw new MtArgumentError('Failed to log in with provided credentials')\n}\n"]}

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

@@ -0,0 +1,6 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * 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

@@ -0,0 +1,28 @@
+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

@@ -0,0 +1 @@
+{"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;QACZ,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;KACnB;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"]}

package/esm/highlevel/methods/bots/answer-callback-query.d.ts

@@ -0,0 +1,41 @@
+import Long from 'long';
+import { ITelegramClient } from '../../client.types.js';
+import { CallbackQuery } from '../../types/updates/callback-query.js';
+/**
+ * Send an answer to a callback query.
+ *
+ * @param queryId  ID of the callback query, or the query itself
+ * @param params  Parameters of the answer
+ */
+export declare function answerCallbackQuery(client: ITelegramClient, queryId: Long | CallbackQuery, params?: {
+    /**
+     * Maximum amount of time in seconds for which
+     * this result can be cached by the client (not server!).
+     *
+     * @default  0
+     */
+    cacheTime?: number;
+    /**
+     * Text of the notification (0-200 chars).
+     *
+     * If not set, nothing will be displayed
+     */
+    text?: string;
+    /**
+     * Whether to show an alert in the middle of the screen
+     * instead of a notification at the top of the screen.
+     *
+     * @default  false
+     */
+    alert?: boolean;
+    /**
+     * URL that the client should open.
+     *
+     * If this was a button containing a game,
+     * you can provide arbitrary link to your game.
+     * Otherwise, you can only use links in the format
+     * `t.me/your_bot?start=...` that open your bot
+     * with a deep-link parameter.
+     */
+    url?: string;
+}): Promise<void>;

package/esm/highlevel/methods/bots/answer-callback-query.js

@@ -0,0 +1,21 @@
+import Long from 'long';
+import { assertTrue } from '../../../utils/type-assertions.js';
+/**
+ * Send an answer to a callback query.
+ *
+ * @param queryId  ID of the callback query, or the query itself
+ * @param params  Parameters of the answer
+ */
+export async function answerCallbackQuery(client, queryId, params) {
+    const { cacheTime = 0, text, alert, url } = params ?? {};
+    const r = await client.call({
+        _: 'messages.setBotCallbackAnswer',
+        queryId: Long.isLong(queryId) ? queryId : queryId.id,
+        cacheTime,
+        alert,
+        message: text,
+        url,
+    });
+    assertTrue('messages.setBotCallbackAnswer', r);
+}
+//# sourceMappingURL=answer-callback-query.js.map

package/esm/highlevel/methods/bots/answer-callback-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-callback-query.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/bots/answer-callback-query.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAI9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,MAAuB,EACvB,OAA6B,EAC7B,MAkCC;IAED,MAAM,EAAE,SAAS,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;IAExD,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QACxB,CAAC,EAAE,+BAA+B;QAClC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;QACpD,SAAS;QACT,KAAK;QACL,OAAO,EAAE,IAAI;QACb,GAAG;KACN,CAAC,CAAA;IAEF,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAA;AAClD,CAAC","sourcesContent":["import Long from 'long'\n\nimport { assertTrue } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { CallbackQuery } from '../../types/updates/callback-query.js'\n\n/**\n * Send an answer to a callback query.\n *\n * @param queryId  ID of the callback query, or the query itself\n * @param params  Parameters of the answer\n */\nexport async function answerCallbackQuery(\n    client: ITelegramClient,\n    queryId: Long | CallbackQuery,\n    params?: {\n        /**\n         * Maximum amount of time in seconds for which\n         * this result can be cached by the client (not server!).\n         *\n         * @default  0\n         */\n        cacheTime?: number\n\n        /**\n         * Text of the notification (0-200 chars).\n         *\n         * If not set, nothing will be displayed\n         */\n        text?: string\n\n        /**\n         * Whether to show an alert in the middle of the screen\n         * instead of a notification at the top of the screen.\n         *\n         * @default  false\n         */\n        alert?: boolean\n\n        /**\n         * URL that the client should open.\n         *\n         * If this was a button containing a game,\n         * you can provide arbitrary link to your game.\n         * Otherwise, you can only use links in the format\n         * `t.me/your_bot?start=...` that open your bot\n         * with a deep-link parameter.\n         */\n        url?: string\n    },\n): Promise<void> {\n    const { cacheTime = 0, text, alert, url } = params ?? {}\n\n    const r = await client.call({\n        _: 'messages.setBotCallbackAnswer',\n        queryId: Long.isLong(queryId) ? queryId : queryId.id,\n        cacheTime,\n        alert,\n        message: text,\n        url,\n    })\n\n    assertTrue('messages.setBotCallbackAnswer', r)\n}\n"]}

package/esm/highlevel/methods/bots/answer-inline-query.d.ts

@@ -0,0 +1,88 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputInlineResult } from '../../types/bots/index.js';
+import { InlineQuery } from '../../types/updates/inline-query.js';
+/**
+ * Answer an inline query.
+ *
+ * @param queryId  Inline query ID
+ * @param results  Results of the query
+ * @param params  Additional parameters
+ */
+export declare function answerInlineQuery(client: ITelegramClient, queryId: tl.Long | InlineQuery, results: InputInlineResult[], params?: {
+    /**
+     * Maximum number of time in seconds that the results of the
+     * query may be cached on the server for.
+     *
+     * @default  300
+     */
+    cacheTime?: number;
+    /**
+     * Whether the results should be displayed as a gallery instead
+     * of a vertical list. Only applicable to some media types.
+     *
+     * In some cases changing this may lead to the results not being
+     * displayed by the client.
+     *
+     * Default is derived automatically based on result types
+     */
+    gallery?: boolean;
+    /**
+     * Whether the results should only be cached on the server
+     * for the user who sent the query.
+     *
+     * @default  false
+     */
+    private?: boolean;
+    /**
+     * Next pagination offset (up to 64 bytes).
+     *
+     * When user has reached the end of the current results,
+     * the client will re-send the inline query with the same text, but
+     * with `offset` set to this value.
+     *
+     * If omitted or empty string is provided, it is assumed that
+     * there are no more results.
+     */
+    nextOffset?: string;
+    /**
+     * If passed, clients will display a button before any other results,
+     * that when clicked switches the user to a private chat with the bot
+     * and sends the bot `/start ${parameter}`.
+     *
+     * An example from the Bot API docs:
+     *
+     * An inline bot that sends YouTube videos can ask the user to connect
+     * the bot to their YouTube account to adapt search results accordingly.
+     * To do this, it displays a "Connect your YouTube account" button above
+     * the results, or even before showing any. The user presses the button,
+     * switches to a private chat with the bot and, in doing so, passes a start
+     * parameter that instructs the bot to return an oauth link. Once done, the
+     * bot can offer a switch_inline button so that the user can easily return to
+     * the chat where they wanted to use the bot's inline capabilities
+     */
+    switchPm?: {
+        /**
+         * Text of the button
+         */
+        text: string;
+        /**
+         * Parameter for `/start` command
+         */
+        parameter: string;
+    };
+    /**
+     * If passed, clients will display a button on top of the remaining inline result
+     * list with the specified text, that switches the user to the specified bot web app.
+     */
+    switchWebview?: {
+        /**
+         * Text of the button
+         */
+        text: string;
+        /**
+         * URL to open
+         */
+        url: string;
+    };
+}): Promise<void>;

package/esm/highlevel/methods/bots/answer-inline-query.js

@@ -0,0 +1,37 @@
+import Long from 'long';
+import { BotInline } from '../../types/bots/index.js';
+/**
+ * Answer an inline query.
+ *
+ * @param queryId  Inline query ID
+ * @param results  Results of the query
+ * @param params  Additional parameters
+ */
+export async function answerInlineQuery(client, queryId, results, params) {
+    const { cacheTime = 300, gallery, private: priv, nextOffset, switchPm, switchWebview } = params ?? {};
+    const [defaultGallery, tlResults] = await BotInline._convertToTl(client, results);
+    await client.call({
+        _: 'messages.setInlineBotResults',
+        queryId: Long.isLong(queryId) ? queryId : queryId.id,
+        results: tlResults,
+        cacheTime,
+        gallery: gallery ?? defaultGallery,
+        private: priv,
+        nextOffset,
+        switchPm: switchPm ?
+            {
+                _: 'inlineBotSwitchPM',
+                text: switchPm.text,
+                startParam: switchPm.parameter,
+            } :
+            undefined,
+        switchWebview: switchWebview ?
+            {
+                _: 'inlineBotWebView',
+                text: switchWebview.text,
+                url: switchWebview.url,
+            } :
+            undefined,
+    });
+}
+//# sourceMappingURL=answer-inline-query.js.map

package/esm/highlevel/methods/bots/answer-inline-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-inline-query.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/bots/answer-inline-query.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAKvB,OAAO,EAAE,SAAS,EAAqB,MAAM,2BAA2B,CAAA;AAGxE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,MAAuB,EACvB,OAA8B,EAC9B,OAA4B,EAC5B,MAmFC;IAED,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;IAErG,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEjF,MAAM,MAAM,CAAC,IAAI,CAAC;QACd,CAAC,EAAE,8BAA8B;QACjC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;QACpD,OAAO,EAAE,SAAS;QAClB,SAAS;QACT,OAAO,EAAE,OAAO,IAAI,cAAc;QAClC,OAAO,EAAE,IAAI;QACb,UAAU;QACV,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAChB;gBACI,CAAC,EAAE,mBAAmB;gBACtB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,UAAU,EAAE,QAAQ,CAAC,SAAS;aACjC,CAAC,CAAC;YACH,SAAS;QACb,aAAa,EAAE,aAAa,CAAC,CAAC;YAC1B;gBACI,CAAC,EAAE,kBAAkB;gBACrB,IAAI,EAAE,aAAa,CAAC,IAAI;gBACxB,GAAG,EAAE,aAAa,CAAC,GAAG;aACzB,CAAC,CAAC;YACH,SAAS;KAChB,CAAC,CAAA;AACN,CAAC","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport { BotInline, InputInlineResult } from '../../types/bots/index.js'\nimport { InlineQuery } from '../../types/updates/inline-query.js'\n\n/**\n * Answer an inline query.\n *\n * @param queryId  Inline query ID\n * @param results  Results of the query\n * @param params  Additional parameters\n */\nexport async function answerInlineQuery(\n    client: ITelegramClient,\n    queryId: tl.Long | InlineQuery,\n    results: InputInlineResult[],\n    params?: {\n        /**\n         * Maximum number of time in seconds that the results of the\n         * query may be cached on the server for.\n         *\n         * @default  300\n         */\n        cacheTime?: number\n\n        /**\n         * Whether the results should be displayed as a gallery instead\n         * of a vertical list. Only applicable to some media types.\n         *\n         * In some cases changing this may lead to the results not being\n         * displayed by the client.\n         *\n         * Default is derived automatically based on result types\n         */\n        gallery?: boolean\n\n        /**\n         * Whether the results should only be cached on the server\n         * for the user who sent the query.\n         *\n         * @default  false\n         */\n        private?: boolean\n\n        /**\n         * Next pagination offset (up to 64 bytes).\n         *\n         * When user has reached the end of the current results,\n         * the client will re-send the inline query with the same text, but\n         * with `offset` set to this value.\n         *\n         * If omitted or empty string is provided, it is assumed that\n         * there are no more results.\n         */\n        nextOffset?: string\n\n        /**\n         * If passed, clients will display a button before any other results,\n         * that when clicked switches the user to a private chat with the bot\n         * and sends the bot `/start ${parameter}`.\n         *\n         * An example from the Bot API docs:\n         *\n         * An inline bot that sends YouTube videos can ask the user to connect\n         * the bot to their YouTube account to adapt search results accordingly.\n         * To do this, it displays a \"Connect your YouTube account\" button above\n         * the results, or even before showing any. The user presses the button,\n         * switches to a private chat with the bot and, in doing so, passes a start\n         * parameter that instructs the bot to return an oauth link. Once done, the\n         * bot can offer a switch_inline button so that the user can easily return to\n         * the chat where they wanted to use the bot's inline capabilities\n         */\n        switchPm?: {\n            /**\n             * Text of the button\n             */\n            text: string\n\n            /**\n             * Parameter for `/start` command\n             */\n            parameter: string\n        }\n\n        /**\n         * If passed, clients will display a button on top of the remaining inline result\n         * list with the specified text, that switches the user to the specified bot web app.\n         */\n        switchWebview?: {\n            /**\n             * Text of the button\n             */\n            text: string\n\n            /**\n             * URL to open\n             */\n            url: string\n        }\n    },\n): Promise<void> {\n    const { cacheTime = 300, gallery, private: priv, nextOffset, switchPm, switchWebview } = params ?? {}\n\n    const [defaultGallery, tlResults] = await BotInline._convertToTl(client, results)\n\n    await client.call({\n        _: 'messages.setInlineBotResults',\n        queryId: Long.isLong(queryId) ? queryId : queryId.id,\n        results: tlResults,\n        cacheTime,\n        gallery: gallery ?? defaultGallery,\n        private: priv,\n        nextOffset,\n        switchPm: switchPm ?\n            {\n                _: 'inlineBotSwitchPM',\n                text: switchPm.text,\n                startParam: switchPm.parameter,\n            } :\n            undefined,\n        switchWebview: switchWebview ?\n            {\n                _: 'inlineBotWebView',\n                text: switchWebview.text,\n                url: switchWebview.url,\n            } :\n            undefined,\n    })\n}\n"]}

package/esm/highlevel/methods/bots/answer-pre-checkout-query.d.ts

@@ -0,0 +1,12 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import type { PreCheckoutQuery } from '../../types/updates/pre-checkout-query.js';
+/**
+ * Answer a pre-checkout query.
+ *
+ * @param queryId  Pre-checkout query ID
+ */
+export declare function answerPreCheckoutQuery(client: ITelegramClient, queryId: tl.Long | PreCheckoutQuery, params?: {
+    /** If pre-checkout is rejected, error message to show to the user */
+    error?: string;
+}): Promise<void>;

package/esm/highlevel/methods/bots/answer-pre-checkout-query.js

@@ -0,0 +1,18 @@
+import Long from 'long';
+import { assertTrue } from '../../../utils/type-assertions.js';
+/**
+ * Answer a pre-checkout query.
+ *
+ * @param queryId  Pre-checkout query ID
+ */
+export async function answerPreCheckoutQuery(client, queryId, params) {
+    const { error } = params ?? {};
+    const r = await client.call({
+        _: 'messages.setBotPrecheckoutResults',
+        queryId: Long.isLong(queryId) ? queryId : queryId.queryId,
+        success: !error,
+        error,
+    });
+    assertTrue('messages.setBotPrecheckoutResults', r);
+}
+//# sourceMappingURL=answer-pre-checkout-query.js.map

package/esm/highlevel/methods/bots/answer-pre-checkout-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-pre-checkout-query.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/bots/answer-pre-checkout-query.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAIvB,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAI9D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,MAAuB,EACvB,OAAmC,EACnC,MAGC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;IAE9B,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QACxB,CAAC,EAAE,mCAAmC;QACtC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;QACzD,OAAO,EAAE,CAAC,KAAK;QACf,KAAK;KACR,CAAC,CAAA;IAEF,UAAU,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAA;AACtD,CAAC","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { assertTrue } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport type { PreCheckoutQuery } from '../../types/updates/pre-checkout-query.js'\n\n/**\n * Answer a pre-checkout query.\n *\n * @param queryId  Pre-checkout query ID\n */\nexport async function answerPreCheckoutQuery(\n    client: ITelegramClient,\n    queryId: tl.Long | PreCheckoutQuery,\n    params?: {\n        /** If pre-checkout is rejected, error message to show to the user */\n        error?: string\n    },\n): Promise<void> {\n    const { error } = params ?? {}\n\n    const r = await client.call({\n        _: 'messages.setBotPrecheckoutResults',\n        queryId: Long.isLong(queryId) ? queryId : queryId.queryId,\n        success: !error,\n        error,\n    })\n\n    assertTrue('messages.setBotPrecheckoutResults', r)\n}\n"]}