@mtkruto/node 0.0.821 → 0.0.822

package/esm/tl/3_functions.d.ts

@@ -496,7 +496,7 @@ export declare class AccountUpdateProfile extends Function<types.TypeUser> {
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         firstName?: string;
         lastName?: string;
         about?: string;
@@ -847,7 +847,7 @@ export declare class AccountInitTakeoutSession extends Function<types.AccountTak
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         contacts?: true;
         messageUsers?: true;
         messageChats?: true;
@@ -862,7 +862,7 @@ export declare class AccountFinishTakeoutSession extends Function<boolean> {
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         success?: true;
     });
 }
@@ -908,7 +908,7 @@ export declare class AccountGetNotifyExceptions extends Function<types.TypeUpdat
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         compareSound?: true;
         peer?: types.TypeInputNotifyPeer;
     });
@@ -1054,7 +1054,7 @@ export declare class AccountInstallTheme extends Function<boolean> {
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         dark?: true;
         theme?: types.TypeInputTheme;
         format?: string;
@@ -1088,7 +1088,7 @@ export declare class AccountSetContentSettings extends Function<boolean> {
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         sensitiveEnabled?: true;
     });
 }
@@ -2550,7 +2550,7 @@ export declare class MessagesClearRecentStickers extends Function<boolean> {
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         attached?: true;
     });
 }
@@ -3041,7 +3041,7 @@ export declare class MessagesRequestURLAuth extends Function<types.TypeURLAuthRe
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         peer?: types.TypeInputPeer;
         msgId?: number;
         buttonId?: number;
@@ -3057,7 +3057,7 @@ export declare class MessagesAcceptURLAuth extends Function<types.TypeURLAuthRes
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         writeAllowed?: true;
         peer?: types.TypeInputPeer;
         msgId?: number;
@@ -3269,7 +3269,7 @@ export declare class MessagesDeletePhoneCallHistory extends Function<types.Messa
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         revoke?: true;
     });
 }
@@ -4092,7 +4092,7 @@ export declare class PhotosUploadProfilePhoto extends Function<types.PhotosPhoto
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         fallback?: true;
         bot?: types.TypeInputUser;
         file?: types.TypeInputFile;
@@ -4686,7 +4686,7 @@ export declare class ChannelsGetAdminedPublicChannels extends Function<types.Typ
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         byLocation?: true;
         checkLimit?: true;
     });
@@ -5306,7 +5306,7 @@ export declare class PaymentsClearSavedInfo extends Function<boolean> {
     protected get [id](): number;
     static get [paramDesc](): ParamDesc;
     protected get [params](): Params;
-    constructor(params: {
+    constructor(params?: {
         credentials?: true;
         info?: true;
     });

package/esm/tl/3_functions.js

@@ -1594,9 +1594,9 @@ export class AccountUpdateProfile extends Function {
             writable: true,
             value: void 0
         });
-        this.firstName = params.firstName;
-        this.lastName = params.lastName;
-        this.about = params.about;
+        this.firstName = params?.firstName;
+        this.lastName = params?.lastName;
+        this.about = params?.about;
     }
 }
 export class AccountUpdateStatus extends Function {
@@ -2664,13 +2664,13 @@ export class AccountInitTakeoutSession extends Function {
             writable: true,
             value: void 0
         });
-        this.contacts = params.contacts;
-        this.messageUsers = params.messageUsers;
-        this.messageChats = params.messageChats;
-        this.messageMegagroups = params.messageMegagroups;
-        this.messageChannels = params.messageChannels;
-        this.files = params.files;
-        this.fileMaxSize = params.fileMaxSize;
+        this.contacts = params?.contacts;
+        this.messageUsers = params?.messageUsers;
+        this.messageChats = params?.messageChats;
+        this.messageMegagroups = params?.messageMegagroups;
+        this.messageChannels = params?.messageChannels;
+        this.files = params?.files;
+        this.fileMaxSize = params?.fileMaxSize;
     }
 }
 export class AccountFinishTakeoutSession extends Function {
@@ -2697,7 +2697,7 @@ export class AccountFinishTakeoutSession extends Function {
             writable: true,
             value: void 0
         });
-        this.success = params.success;
+        this.success = params?.success;
     }
 }
 export class AccountConfirmPasswordEmail extends Function {
@@ -2824,8 +2824,8 @@ export class AccountGetNotifyExceptions extends Function {
             writable: true,
             value: void 0
         });
-        this.compareSound = params.compareSound;
-        this.peer = params.peer;
+        this.compareSound = params?.compareSound;
+        this.peer = params?.peer;
     }
 }
 export class AccountGetWallPaper extends Function {
@@ -3319,10 +3319,10 @@ export class AccountInstallTheme extends Function {
             writable: true,
             value: void 0
         });
-        this.dark = params.dark;
-        this.theme = params.theme;
-        this.format = params.format;
-        this.baseTheme = params.baseTheme;
+        this.dark = params?.dark;
+        this.theme = params?.theme;
+        this.format = params?.format;
+        this.baseTheme = params?.baseTheme;
     }
 }
 export class AccountGetTheme extends Function {
@@ -3417,7 +3417,7 @@ export class AccountSetContentSettings extends Function {
             writable: true,
             value: void 0
         });
-        this.sensitiveEnabled = params.sensitiveEnabled;
+        this.sensitiveEnabled = params?.sensitiveEnabled;
     }
 }
 export class AccountGetContentSettings extends Function {
@@ -8265,7 +8265,7 @@ export class MessagesClearRecentStickers extends Function {
             writable: true,
             value: void 0
         });
-        this.attached = params.attached;
+        this.attached = params?.attached;
     }
 }
 export class MessagesGetArchivedStickers extends Function {
@@ -9887,10 +9887,10 @@ export class MessagesRequestURLAuth extends Function {
             writable: true,
             value: void 0
         });
-        this.peer = params.peer;
-        this.msgId = params.msgId;
-        this.buttonId = params.buttonId;
-        this.url = params.url;
+        this.peer = params?.peer;
+        this.msgId = params?.msgId;
+        this.buttonId = params?.buttonId;
+        this.url = params?.url;
     }
 }
 export class MessagesAcceptURLAuth extends Function {
@@ -9949,11 +9949,11 @@ export class MessagesAcceptURLAuth extends Function {
             writable: true,
             value: void 0
         });
-        this.writeAllowed = params.writeAllowed;
-        this.peer = params.peer;
-        this.msgId = params.msgId;
-        this.buttonId = params.buttonId;
-        this.url = params.url;
+        this.writeAllowed = params?.writeAllowed;
+        this.peer = params?.peer;
+        this.msgId = params?.msgId;
+        this.buttonId = params?.buttonId;
+        this.url = params?.url;
     }
 }
 export class MessagesHidePeerSettingsBar extends Function {
@@ -10625,7 +10625,7 @@ export class MessagesDeletePhoneCallHistory extends Function {
             writable: true,
             value: void 0
         });
-        this.revoke = params.revoke;
+        this.revoke = params?.revoke;
     }
 }
 export class MessagesCheckHistoryImport extends Function {
@@ -13388,12 +13388,12 @@ export class PhotosUploadProfilePhoto extends Function {
             writable: true,
             value: void 0
         });
-        this.fallback = params.fallback;
-        this.bot = params.bot;
-        this.file = params.file;
-        this.video = params.video;
-        this.videoStartTs = params.videoStartTs;
-        this.videoEmojiMarkup = params.videoEmojiMarkup;
+        this.fallback = params?.fallback;
+        this.bot = params?.bot;
+        this.file = params?.file;
+        this.video = params?.video;
+        this.videoStartTs = params?.videoStartTs;
+        this.videoEmojiMarkup = params?.videoEmojiMarkup;
     }
 }
 export class PhotosDeletePhotos extends Function {
@@ -15227,8 +15227,8 @@ export class ChannelsGetAdminedPublicChannels extends Function {
             writable: true,
             value: void 0
         });
-        this.byLocation = params.byLocation;
-        this.checkLimit = params.checkLimit;
+        this.byLocation = params?.byLocation;
+        this.checkLimit = params?.checkLimit;
     }
 }
 export class ChannelsEditBanned extends Function {
@@ -17227,8 +17227,8 @@ export class PaymentsClearSavedInfo extends Function {
             writable: true,
             value: void 0
         });
-        this.credentials = params.credentials;
-        this.info = params.info;
+        this.credentials = params?.credentials;
+        this.info = params?.info;
     }
 }
 export class PaymentsGetBankCardData extends Function {

package/esm/utilities/1_password.d.ts

@@ -8,4 +8,4 @@ export declare function pbkdf2(password: Uint8Array, salt: Uint8Array, iteration
 export declare const ph2: (password: Uint8Array, salt1: Uint8Array, salt2: Uint8Array) => Promise<Uint8Array>;
 export declare function isGoodModExpFirst(modexp: bigint, prime: bigint): boolean;
 export declare function pad(bigint: number | bigint | Uint8Array): Uint8Array;
-export declare function checkPassword(password: Uint8Array, ap: types.AccountPassword): Promise<types.InputCheckPasswordSRP>;
+export declare function checkPassword(password_: string, ap: types.AccountPassword): Promise<types.InputCheckPasswordSRP>;

package/esm/utilities/1_password.js

@@ -69,7 +69,8 @@ export function pad(bigint) {
         return concat(new Uint8Array(256 - bigint.length), bigint);
     }
 }
-export async function checkPassword(password, ap) {
+export async function checkPassword(password_, ap) {
+    const password = new TextEncoder().encode(password_);
     const algo = ap.currentAlgo;
     if (!(algo instanceof
         types.PasswordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow)) {

package/package.json

@@ -2,7 +2,7 @@
   "module": "./esm/mod.js",
   "main": "./script/mod.js",
   "name": "@mtkruto/node",
-  "version": "0.0.821",
+  "version": "0.0.822",
   "description": "MTKruto for Node.js",
   "author": "Roj <rojvv@icloud.com>",
   "license": "LGPL-3.0-or-later",

package/script/client/client.d.ts

@@ -4,16 +4,43 @@ import * as functions from "../tl/3_functions.js";
 import { ClientAbstract } from "./client_abstract.js";
 import { Session } from "../session/session.js";
 import { DC, TransportProvider } from "../transport/transport_provider.js";
-export interface AuthorizeUserParams<S = string, N = {
-    first: S;
-    last: S;
-}> {
+export declare const restartAuth: unique symbol;
+export interface AuthorizeUserParams<S = string> {
     phone: S | (() => MaybePromise<S>);
     code: S | (() => MaybePromise<S>);
     password: S | (() => MaybePromise<S>);
-    names: N | (() => MaybePromise<N>);
 }
 export type UpdatesHandler = null | ((client: Client, update: types.Updates) => MaybePromise<void>);
+export interface ClientParams {
+    /**
+     * The transport provider to use. Defaults to `defaultTransportProvider`.
+     */
+    transportProvider?: TransportProvider;
+    /**
+     * The app_version parameter to be passed to initConnection when calling `authorize`.
+     */
+    appVersion?: string;
+    /**
+     * The device_version parameter to be passed to initConnection when calling `authorize`.
+     */
+    deviceModel?: string;
+    /**
+     * The lang_code parameter to be passed to initConnection when calling `authorize`.
+     */
+    langCode?: string;
+    /**
+     * The lang_pack parameter to be passed to initConnection when calling `authorize`.
+     */
+    langPack?: string;
+    /**
+     * The system_lang_cde parameter to be passed to initConnection when calling `authorize`.
+     */
+    systemLangCode?: string;
+    /**
+     * The system_version parameter to be passed to initConnection when calling `authorize`.
+     */
+    systemVersion?: string;
+}
 export declare class Client extends ClientAbstract {
     readonly session: Session;
     readonly apiId: number;
@@ -29,22 +56,59 @@ export declare class Client extends ClientAbstract {
     readonly langPack: string;
     readonly systemLangCode: string;
     readonly systemVersion: string;
-    constructor(session?: Session, apiId?: number, apiHash?: string, params?: {
-        transportProvider?: TransportProvider;
-        appVersion?: string;
-        deviceModel?: string;
-        langCode?: string;
-        langPack?: string;
-        systemLangCode?: string;
-        systemVersion?: string;
-    });
+    /**
+     * Constructs the client.
+     *
+     * @param session The session provider to use. Defaults to in-memory session.
+     * @param apiId App's API ID from [my.telegram.org](https://my.telegram.org/apps). Defaults to 0 (unset).
+     * @param apiHash App's API hash from [my.telegram.org/apps](https://my.telegram.org/apps). Default to empty string (unset).
+     * @param params Other parameters.
+     */
+    constructor(session?: Session, apiId?: number, apiHash?: string, params?: ClientParams);
     private shouldLoadSession;
+    /**
+     * Sets the DC and resets the auth key stored in the session provider
+     * if the stored DC was not the same as the `dc` parameter.
+     *
+     * @param dc The DC to change to.
+     */
     setDc(dc: DC): void;
+    /**
+     * Loads the session if `setDc` was not called, initializes and connnects
+     * a `ClientPlain` to generate auth key if there was none, and connects the client.
+     * Before establishing the connection, the session is saved.
+     */
     connect(): Promise<void>;
+    /**
+     * Calls [initConnection](1) and authorizes the client with one of the following:
+     *
+     * - Bot token (`string`)
+     * - Exported authorization (`types.AuthExportedAuthorization`)
+     * - User authorization handlers (`AuthorizeUserParams`)
+     *
+     * if the current auth key doesn't throw AUTH_KEY_UNREGISTERED when calling [updates.getState](2).
+     *
+     * Notes:
+     * 1. Requires the `apiId` and `apiHash` paramters to be passed when constructing the client.
+     * 2. Reconnects the client to the appropriate DC in case of MIGRATE_X errors.
+     * 3. The parameters passed to the [initConnection][1] call can be configured with the last parameter of the constructor.
+     *
+     * [1]: https://core.telegram.org/method/initConnection
+     * [2]: https://core.telegram.org/method/updates.getState
+     */
     authorize(params: string | types.AuthExportedAuthorization | AuthorizeUserParams): Promise<void>;
     private receiveLoop;
     private pingLoop;
+    /**
+     * Invokes a function waiting and returning its reply if the second parameter is not `true`. Requires the client
+     * to be connected.
+     *
+     * @param function_ The function to invoke.
+     */
     invoke<T extends (functions.Function<unknown> | types.Type) = functions.Function<unknown>>(function_: T): Promise<T extends functions.Function<unknown> ? T["__R"] : void>;
     invoke<T extends (functions.Function<unknown> | types.Type) = functions.Function<unknown>>(function_: T, noWait: true): Promise<void>;
+    /**
+     * Alias for `invoke` with its second parameter being `true`.
+     */
     send<T extends (functions.Function<unknown> | types.Type) = functions.Function<unknown>>(function_: T): Promise<void>;
 }

package/script/client/client.js

@@ -23,11 +23,12 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = void 0;
+exports.Client = exports.restartAuth = void 0;
 const deps_js_1 = require("../deps.js");
 const constants_js_1 = require("../constants.js");
 const _0_bigint_js_1 = require("../utilities/0_bigint.js");
 const _1_message_js_1 = require("../utilities/1_message.js");
+const _1_password_js_1 = require("../utilities/1_password.js");
 const types = __importStar(require("../tl/2_types.js"));
 const functions = __importStar(require("../tl/3_functions.js"));
 const _3_tl_reader_js_1 = require("../tl/3_tl_reader.js");
@@ -37,7 +38,16 @@ const _6_message_container_js_1 = require("../tl/6_message_container.js");
 const client_abstract_js_1 = require("./client_abstract.js");
 const client_plain_js_1 = require("./client_plain.js");
 const session_memory_js_1 = require("../session/session_memory.js");
+exports.restartAuth = Symbol();
 class Client extends client_abstract_js_1.ClientAbstract {
+    /**
+     * Constructs the client.
+     *
+     * @param session The session provider to use. Defaults to in-memory session.
+     * @param apiId App's API ID from [my.telegram.org](https://my.telegram.org/apps). Defaults to 0 (unset).
+     * @param apiHash App's API hash from [my.telegram.org/apps](https://my.telegram.org/apps). Default to empty string (unset).
+     * @param params Other parameters.
+     */
     constructor(session = new session_memory_js_1.SessionMemory(), apiId = 0, apiHash = "", params) {
         super(params?.transportProvider);
         Object.defineProperty(this, "session", {
@@ -137,6 +147,12 @@ class Client extends client_abstract_js_1.ClientAbstract {
         this.systemLangCode = params?.systemLangCode ?? constants_js_1.DEFAULT_SYSTEM_LANG_CODE;
         this.systemVersion = params?.systemVersion ?? constants_js_1.DEFAULT_SYSTEM_VERSION;
     }
+    /**
+     * Sets the DC and resets the auth key stored in the session provider
+     * if the stored DC was not the same as the `dc` parameter.
+     *
+     * @param dc The DC to change to.
+     */
     setDc(dc) {
         if (this.session.dc != dc) {
             this.session.dc = dc;
@@ -147,6 +163,11 @@ class Client extends client_abstract_js_1.ClientAbstract {
         }
         super.setDc(dc);
     }
+    /**
+     * Loads the session if `setDc` was not called, initializes and connnects
+     * a `ClientPlain` to generate auth key if there was none, and connects the client.
+     * Before establishing the connection, the session is saved.
+     */
     async connect() {
         if (this.shouldLoadSession) {
             await this.session.load();
@@ -172,6 +193,23 @@ class Client extends client_abstract_js_1.ClientAbstract {
         this.receiveLoop();
         this.pingLoop();
     }
+    /**
+     * Calls [initConnection](1) and authorizes the client with one of the following:
+     *
+     * - Bot token (`string`)
+     * - Exported authorization (`types.AuthExportedAuthorization`)
+     * - User authorization handlers (`AuthorizeUserParams`)
+     *
+     * if the current auth key doesn't throw AUTH_KEY_UNREGISTERED when calling [updates.getState](2).
+     *
+     * Notes:
+     * 1. Requires the `apiId` and `apiHash` paramters to be passed when constructing the client.
+     * 2. Reconnects the client to the appropriate DC in case of MIGRATE_X errors.
+     * 3. The parameters passed to the [initConnection][1] call can be configured with the last parameter of the constructor.
+     *
+     * [1]: https://core.telegram.org/method/initConnection
+     * [2]: https://core.telegram.org/method/updates.getState
+     */
     async authorize(params) {
         if (!this.apiId) {
             throw new Error("apiId not set");
@@ -201,12 +239,92 @@ class Client extends client_abstract_js_1.ClientAbstract {
                 throw err;
             }
         }
+        let signedIn = false;
+        let phoneNumber = null;
         try {
             if (params instanceof types.AuthExportedAuthorization) {
                 await this.invoke(new functions.AuthImportAuthorization({ id: params.id, bytes: params.bytes }));
             }
             else if (typeof params == "object") {
-                throw new Error("Not implemented");
+                while (true) {
+                    if (signedIn) {
+                        break;
+                    }
+                    try {
+                        try {
+                            phoneNumber = typeof params.phone === "string" ? params.phone : await params.phone();
+                            const sentCode = await this.invoke(new functions.AuthSendCode({
+                                apiId: this.apiId,
+                                apiHash: this.apiHash,
+                                phoneNumber,
+                                settings: new types.CodeSettings(),
+                            }));
+                            if (sentCode instanceof types.AuthSentCode) {
+                                while (true) {
+                                    const phoneCode = typeof params.code === "string" ? params.code : await params.code();
+                                    try {
+                                        const auth = await this.invoke(new functions.AuthSignIn({ phoneNumber, phoneCode, phoneCodeHash: sentCode.phoneCodeHash }));
+                                        if (auth instanceof types.AuthAuthorizationSignUpRequired) {
+                                            throw new Error("Sign up not supported");
+                                        }
+                                        else {
+                                            signedIn = true;
+                                            break;
+                                        }
+                                    }
+                                    catch (err) {
+                                        if (err instanceof types.RPCError && err.errorMessage == "PHONE_CODE_INVALID") {
+                                            continue;
+                                        }
+                                        else {
+                                            throw err;
+                                        }
+                                    }
+                                }
+                            }
+                            else {
+                                throw new Error(`Handling ${sentCode.constructor.name} not implemented`);
+                            }
+                        }
+                        catch (err) {
+                            if (err instanceof types.RPCError && err.errorMessage == "SESSION_PASSWORD_NEEDED") {
+                                while (true) {
+                                    const ap = await this.invoke(new functions.AccountGetPassword());
+                                    if (ap.currentAlgo instanceof types.PasswordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow) {
+                                        try {
+                                            const password = typeof params.password === "string" ? params.password : await params.password();
+                                            const input = await (0, _1_password_js_1.checkPassword)(password, ap);
+                                            await this.invoke(new functions.AuthCheckPassword({ password: input }));
+                                            break;
+                                        }
+                                        catch (err) {
+                                            if (err instanceof types.RPCError && err.errorMessage == "PASSWORD_HASH_INVALID") {
+                                                continue;
+                                            }
+                                            else {
+                                                throw err;
+                                            }
+                                        }
+                                    }
+                                    else {
+                                        throw new Error(`Handling ${ap.currentAlgo?.constructor.name} not implemented`);
+                                    }
+                                }
+                            }
+                            else {
+                                throw err;
+                            }
+                        }
+                    }
+                    catch (err) {
+                        if (err == exports.restartAuth) {
+                            continue;
+                        }
+                        else {
+                            throw err;
+                        }
+                    }
+                }
             }
             else {
                 await this.invoke(new functions.AuthImportBotAuthorization({ apiId: this.apiId, apiHash: this.apiHash, botAuthToken: params, flags: 0 }));
@@ -221,6 +339,10 @@ class Client extends client_abstract_js_1.ClientAbstract {
                         newDc += "-test";
                     }
                     await this.reconnect(newDc);
+                    if (typeof params === "object" && phoneNumber != null) {
+                        params = Object.assign({}, params);
+                        params.phone = phoneNumber;
+                    }
                     await this.authorize(params);
                 }
                 else {
@@ -344,6 +466,9 @@ class Client extends client_abstract_js_1.ClientAbstract {
             return result;
         }
     }
+    /**
+     * Alias for `invoke` with its second parameter being `true`.
+     */
     send(function_) {
         return this.invoke(function_, true);
     }