@mtkruto/node 0.0.988 → 0.0.990

package/esm/client/1_client_abstract.d.ts

@@ -1,11 +1,17 @@
 import { MaybePromise } from "../utilities/0_types.js";
 import { DC, TransportProvider } from "../transport/2_transport_provider.js";
 export interface ClientAbstractParams {
+    /**
+     * The first DC to connect to. This is commonly used to decide whether to connect to test or production servers. It is not necessarily the DC that the client will directly connect to or is currently connected to. Defaults to the default initial DC.
+     */
     initialDc?: DC;
     /**
      * The transport provider to use. Defaults to `webSocketTransportProvider` with its default options.
      */
     transportProvider?: TransportProvider;
+    /**
+     * Whether the connection is with a CDN server. Defaults to false.
+     */
     cdn?: boolean;
 }
 export declare abstract class ClientAbstract {

package/esm/client/2_client_plain.d.ts

@@ -3,7 +3,7 @@ import { Function } from "../tl/3_functions.js";
 import { ClientAbstract, ClientAbstractParams } from "./1_client_abstract.js";
 export interface ClientPlainParams extends ClientAbstractParams {
     /**
-     * MTProto public keys to use in the `[keyId, [key, exponent]][]` format. Don't set this unless you know what you are doing.
+     * MTProto public keys to use in the `[keyId, [key, exponent]][]` format. Don't set this unless you know what you are doing. Defaults to Telegram servers' public keys.
      */
     publicKeys?: PublicKeys;
 }

package/esm/client/3_client.d.ts

@@ -1,17 +1,17 @@
 import { MaybePromise } from "../utilities/0_types.js";
+import { DC } from "../transport/2_transport_provider.js";
 import * as types from "../tl/2_types.js";
-import * as functions from "../tl/3_functions.js";
 import { ReadObject } from "../tl/3_tl_reader.js";
-import { Storage } from "../storage/0_storage.js";
-import { DC } from "../transport/2_transport_provider.js";
-import { MessageEntity } from "../types/0_message_entity.js";
+import * as functions from "../tl/3_functions.js";
 import { ReplyKeyboardRemove } from "../types/0_reply_keyboard_remove.js";
+import { MessageEntity } from "../types/0_message_entity.js";
 import { ForceReply } from "../types/0_force_reply.js";
-import { ReplyKeyboardMarkup } from "../types/2_reply_keyboard_markup.js";
 import { InlineKeyboardMarkup } from "../types/2_inline_keyboard_markup.js";
+import { ReplyKeyboardMarkup } from "../types/2_reply_keyboard_markup.js";
 import { Message } from "../types/3_message.js";
-import { ClientAbstract } from "./1_client_abstract.js";
+import { Storage } from "../storage/0_storage.js";
 import { ClientPlainParams } from "./2_client_plain.js";
+import { ClientAbstract } from "./1_client_abstract.js";
 export declare const getEntity: unique symbol;
 export declare const getStickerSetName: unique symbol;
 export declare const handleMigrationError: unique symbol;
@@ -27,35 +27,35 @@ export interface AuthorizeUserParams<S = string> {
 }
 export interface ClientParams extends ClientPlainParams {
     /**
-     * Default parse mode. Defauls to `ParseMode.None`.
+     * A parse mode to use when the `parseMode` parameter is not specified when sending or editing messages. Defauls to `ParseMode.None`.
      */
     parseMode?: ParseMode;
     /**
-     * The app_version parameter to be passed to initConnection when calling `authorize`.
+     * The app_version parameter to be passed to initConnection when calling `authorize`. It is recommended that this parameter is changed if users are authorized. Defaults to "MTKruto" followed by this version of MTKruto.
      */
     appVersion?: string;
     /**
-     * The device_version parameter to be passed to initConnection when calling `authorize`.
+     * The device_version parameter to be passed to initConnection when calling `authorize`. The default varies by the current runtime.
      */
     deviceModel?: string;
     /**
-     * The lang_code parameter to be passed to initConnection when calling `authorize`.
+     * The lang_code parameter to be passed to initConnection when calling `authorize`. Defaults to the runtime's language or `"en"`.
      */
     langCode?: string;
     /**
-     * The lang_pack parameter to be passed to initConnection when calling `authorize`.
+     * The lang_pack parameter to be passed to initConnection when calling `authorize`. Defaults to an empty string.
      */
     langPack?: string;
     /**
-     * The system_lang_cde parameter to be passed to initConnection when calling `authorize`.
+     * The system_lang_cde parameter to be passed to initConnection when calling `authorize`. Defaults to the runtime's language or `"en"`.
      */
     systemLangCode?: string;
     /**
-     * The system_version parameter to be passed to initConnection when calling `authorize`.
+     * The system_version parameter to be passed to initConnection when calling `authorize`. The default varies by the current runtime.
      */
     systemVersion?: string;
     /**
-     * Whether to automatically call `start` with no parameters in the first `invoke` call.
+     * Whether to automatically call `start` with no parameters in the first `invoke` call. Defaults to `true`.
      */
     autoStart?: boolean;
 }
@@ -171,6 +171,7 @@ export declare class Client extends ClientAbstract {
      */
     constructor(storage?: Storage, apiId?: number | null, apiHash?: string | null, params?: ClientParams);
     private propagateConnectionState;
+    private lastPropagatedConnectionState;
     protected stateChangeHandler: (connected: boolean) => void;
     private storageInited;
     /**
@@ -308,7 +309,7 @@ export declare class Client extends ClientAbstract {
     private handleUpdate;
     handler: Handler;
     use(middleware: Handler): void;
-    on<U extends keyof Update, K extends keyof Update[U]>(filter: Update[U] extends string ? U : U | [U, ...K[]], handler: Handler<Pick<{
+    on<U extends keyof Update, K extends keyof Update[U]>(filter: Update[U] extends string ? U : Update[U] extends Array<any> ? U : U | [U, ...K[]], handler: Handler<Pick<{
         [P in U]: With<Update[U], K>;
     }, U>>): void;
 }
@@ -318,6 +319,7 @@ export interface Update {
     message: Message;
     editedMessage: Message;
     connectionState: ConnectionState;
+    deletedMessages: [Message, ...Message[]];
 }
 export interface Handler<U extends Partial<Update> = Partial<Update>> {
     (update: U, next: () => Promise<void>): MaybePromise<void>;

package/esm/client/3_client.js

@@ -1,33 +1,33 @@
 import { debug, gunzip, Mutex } from "../deps.js";
 import { ACK_THRESHOLD, APP_VERSION, CHANNEL_DIFFERENCE_LIMIT_BOT, CHANNEL_DIFFERENCE_LIMIT_USER, DEVICE_MODEL, LANG_CODE, LANG_PACK, LAYER, MAX_CHANNEL_ID, MAX_CHAT_ID, STICKER_SET_NAME_TTL, SYSTEM_LANG_CODE, SYSTEM_VERSION, USERNAME_TTL, ZERO_CHANNEL_ID } from "../constants.js";
+import { drop, mustPrompt, mustPromptOneOf } from "../utilities/1_misc.js";
 import { bigIntFromBuffer, getRandomBigInt, getRandomId } from "../utilities/0_bigint.js";
+import { getChannelChatId, hasChannelPts, hasPts, peerToChatId } from "./0_utilities.js";
 import { UNREACHABLE } from "../utilities/0_control.js";
+import { Queue } from "../utilities/0_queue.js";
 import { sha1 } from "../utilities/0_hash.js";
+import { TLError } from "../tl/0_tl_raw_reader.js";
 import { as } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
-import * as functions from "../tl/3_functions.js";
 import { TLReader } from "../tl/3_tl_reader.js";
+import * as functions from "../tl/3_functions.js";
 import { RPCResult } from "../tl/5_rpc_result.js";
 import { Message as Message_ } from "../tl/6_message.js"; // MTProto API message
 import { MessageContainer } from "../tl/7_message_container.js";
-import { StorageMemory } from "../storage/1_storage_memory.js";
 import { FileID, FileType, ThumbnailSource } from "../types/!0_file_id.js";
-import { messageEntityToTlObject } from "../types/0_message_entity.js";
 import { replyKeyboardRemoveToTlObject } from "../types/0_reply_keyboard_remove.js";
+import { messageEntityToTlObject } from "../types/0_message_entity.js";
 import { forceReplyToTlObject } from "../types/0_force_reply.js";
-import { replyKeyboardMarkupToTlObject } from "../types/2_reply_keyboard_markup.js";
+import { constructUser } from "../types/1_user.js";
 import { inlineKeyboardMarkupToTlObject } from "../types/2_inline_keyboard_markup.js";
+import { replyKeyboardMarkupToTlObject } from "../types/2_reply_keyboard_markup.js";
 import { constructMessage } from "../types/3_message.js"; // high-level wrapper for Telegram API's message
+import { StorageMemory } from "../storage/1_storage_memory.js";
 import { decryptMessage, encryptMessage, getMessageId } from "./0_message.js";
-import { parseHtml } from "./0_html.js";
 import { checkPassword } from "./0_password.js";
-import { ClientAbstract } from "./1_client_abstract.js";
+import { parseHtml } from "./0_html.js";
 import { ClientPlain } from "./2_client_plain.js";
-import { drop, mustPrompt, mustPromptOneOf } from "../utilities/1_misc.js";
-import { getChannelChatId, hasChannelPts, hasPts, peerToChatId } from "./0_utilities.js";
-import { constructUser } from "../types/1_user.js";
-import { TLError } from "../tl/0_tl_raw_reader.js";
-import { Queue } from "../utilities/0_queue.js";
+import { ClientAbstract } from "./1_client_abstract.js";
 const d = debug("Client");
 const dGap = debug("Client/recoverUpdateGap");
 const dGapC = debug("Client/recoverChannelUpdateGap");
@@ -161,12 +161,29 @@ export class Client extends ClientAbstract {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "lastPropagatedConnectionState", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
         Object.defineProperty(this, "stateChangeHandler", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: ((connected) => {
-                this.propagateConnectionState(connected ? "ready" : "not-connected");
+                this.connectMutex.acquire().then(async (release) => {
+                    try {
+                        const connectionState = connected ? "ready" : "not-connected";
+                        if (this.connected == connected && this.lastPropagatedConnectionState != connectionState) {
+                            await this.propagateConnectionState(connectionState);
+                            this.lastPropagatedConnectionState = connectionState;
+                        }
+                    }
+                    finally {
+                        release();
+                    }
+                });
             }).bind(this)
         });
         Object.defineProperty(this, "storageInited", {
@@ -203,13 +220,13 @@ export class Client extends ClientAbstract {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: new Queue()
+            value: new Queue("handleUpdate")
         });
         Object.defineProperty(this, "processUpdatesQueue", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: new Queue()
+            value: new Queue("processUpdates")
         });
         Object.defineProperty(this, "handler", {
             enumerable: true,
@@ -561,7 +578,7 @@ export class Client extends ClientAbstract {
                         body = new TLReader(gunzip(body.packedData)).readObject();
                     }
                     dRecv("received %s", body.constructor.name);
-                    if (body instanceof types.TypeUpdates || body instanceof types.TypeUpdate) {
+                    if (body instanceof types._TypeUpdates || body instanceof types._TypeUpdate) {
                         this.processUpdatesQueue.add(() => this.processUpdates(body));
                     }
                     else if (message.body instanceof RPCResult) {
@@ -588,7 +605,7 @@ export class Client extends ClientAbstract {
                                 this.promises.delete(messageId);
                             }
                         };
-                        if (result instanceof types.TypeUpdates || result instanceof types.TypeUpdate) {
+                        if (result instanceof types._TypeUpdates || result instanceof types._TypeUpdate) {
                             this.processUpdatesQueue.add(async () => {
                                 await this.processUpdates(result);
                                 resolvePromise();
@@ -692,7 +709,7 @@ export class Client extends ClientAbstract {
                     await this.storage.updateUsernames("channel", chat.id, [chat.username]);
                 }
                 if (chat.usernames) {
-                    await this.storage.updateUsernames("channel", chat.id, chat.usernames.map((v) => v[as](types.Username)).map((v) => v.username));
+                    await this.storage.updateUsernames("channel", chat.id, chat.usernames.map((v) => v.username));
                 }
             }
             else if (chat instanceof types.Chat) {
@@ -709,7 +726,7 @@ export class Client extends ClientAbstract {
                     await this.storage.updateUsernames("user", user.id, [user.username]);
                 }
                 if (user.usernames) {
-                    await this.storage.updateUsernames("user", user.id, user.usernames.map((v) => v[as](types.Username)).map((v) => v.username));
+                    await this.storage.updateUsernames("user", user.id, user.usernames.map((v) => v.username));
                 }
             }
         }
@@ -763,7 +780,7 @@ export class Client extends ClientAbstract {
             await this.recoverUpdateGap("updatesTooLong");
             return;
         }
-        else if (updates_ instanceof types.TypeUpdate) {
+        else if (updates_ instanceof types._TypeUpdate) {
             updates = [updates_];
         }
         else {
@@ -842,7 +859,7 @@ export class Client extends ClientAbstract {
                 await this.recoverChannelUpdateGap(update.channelId, "updateChannelTooLong");
             }
             else if (update instanceof types.UpdateUserName) {
-                await this.storage.updateUsernames("user", update.userId, update.usernames.map((v) => v[as](types.Username)).map((v) => v.username));
+                await this.storage.updateUsernames("user", update.userId, update.usernames.map((v) => v.username));
             }
             else if (update instanceof types.UpdatePtsChanged) {
                 await this.fetchState("updatePtsChanged");
@@ -854,7 +871,7 @@ export class Client extends ClientAbstract {
                 }
             }
             /// If there were any Update, they will be passed to the update handling queue.
-            if (update instanceof types.TypeUpdate) {
+            if (update instanceof types._TypeUpdate) {
                 updatesToHandle.push(update);
             }
         }
@@ -906,12 +923,12 @@ export class Client extends ClientAbstract {
                         await this.processUpdates(update, true);
                     }
                     if (difference instanceof types.UpdatesDifference) {
-                        await this.storage.setState(difference.state[as](types.UpdatesState));
+                        await this.storage.setState(difference.state);
                         dGap("recovered from update gap");
                         break;
                     }
                     else if (difference instanceof types.UpdatesDifferenceSlice) {
-                        state = difference.intermediateState[as](types.UpdatesState);
+                        state = difference.intermediateState;
                     }
                     else {
                         UNREACHABLE();
@@ -1364,7 +1381,7 @@ export class Client extends ClientAbstract {
         }
         else {
             const stickerSet = await this.invoke(new functions.MessagesGetStickerSet({ stickerset: inputStickerSet, hash }));
-            const name = stickerSet[as](types.MessagesStickerSet).set[as](types.StickerSet).shortName;
+            const name = stickerSet[as](types.MessagesStickerSet).set.shortName;
             await this.storage.updateStickerSetName(inputStickerSet.id, inputStickerSet.accessHash, name);
             return name;
         }
@@ -1411,25 +1428,13 @@ export class Client extends ClientAbstract {
         }
         return constructUser(users[0][as](types.User));
     }
+    // TODO: log errors
     async handleUpdate(update) {
         if (update instanceof types.UpdateNewMessage || update instanceof types.UpdateNewMessage || update instanceof types.UpdateNewChannelMessage || update instanceof types.UpdateNewChannelMessage) {
             if (update.message instanceof types.Message || update.message instanceof types.MessageService) {
                 await this.storage.setMessage(peerToChatId(update.message.peerId), update.message.id, update.message);
             }
         }
-        else if (update instanceof types.UpdateDeleteChannelMessages) {
-            for (const message of update.messages) {
-                await this.storage.setMessage(getChannelChatId(update.channelId), message, null);
-            }
-        }
-        else if (update instanceof types.UpdateDeleteMessages) {
-            for (const message of update.messages) {
-                const chatId = await this.storage.getMessageChat(message);
-                if (chatId) {
-                    await this.storage.setMessage(chatId, message, null);
-                }
-            }
-        }
         if (update instanceof types.UpdateNewMessage ||
             update instanceof types.UpdateNewChannelMessage ||
             update instanceof types.UpdateEditMessage ||
@@ -1438,6 +1443,36 @@ export class Client extends ClientAbstract {
             const message = await constructMessage(update.message, this[getEntity].bind(this), this.getMessage.bind(this), this[getStickerSetName].bind(this));
             await this.handler({ [key]: message }, resolve);
         }
+        if (update instanceof types.UpdateDeleteMessages) {
+            const deletedMessages = new Array();
+            for (const messageId of update.messages) {
+                const chatId = await this.storage.getMessageChat(messageId);
+                if (chatId) {
+                    const message = await this.storage.getMessage(chatId, messageId);
+                    if (message != null) {
+                        deletedMessages.push(await constructMessage(message, this[getEntity].bind(this), this.getMessage.bind(this), this[getStickerSetName].bind(this)));
+                    }
+                    await this.storage.setMessage(chatId, messageId, null);
+                }
+            }
+            if (deletedMessages.length > 0) {
+                await this.handler({ deletedMessages: deletedMessages }, resolve);
+            }
+        }
+        else if (update instanceof types.UpdateDeleteChannelMessages) {
+            const chatId = getChannelChatId(update.channelId);
+            const deletedMessages = new Array();
+            for (const messageId of update.messages) {
+                const message = await this.storage.getMessage(chatId, messageId);
+                if (message) {
+                    deletedMessages.push(await constructMessage(message, this[getEntity].bind(this), this.getMessage.bind(this), this[getStickerSetName].bind(this)));
+                }
+                await this.storage.setMessage(chatId, messageId, null);
+            }
+            if (deletedMessages.length > 0) {
+                await this.handler({ deletedMessages: deletedMessages }, resolve);
+            }
+        }
     }
     use(middleware) {
         const handler = this.handler;
@@ -1451,7 +1486,9 @@ export class Client extends ClientAbstract {
             });
         };
     }
-    on(filter, handler) {
+    on(
+    // deno-lint-ignore no-explicit-any
+    filter, handler) {
         const type = typeof filter === "string" ? filter : filter[0];
         const keys = Array.isArray(filter) ? filter.slice(1) : [];
         this.use((update, next) => {

package/esm/constants.d.ts

@@ -5,7 +5,7 @@ export declare const PUBLIC_KEYS: PublicKeys;
 export declare const VECTOR_CONSTRUCTOR = 481674261;
 export declare const INITIAL_DC: DC;
 export declare const LAYER = 161;
-export declare const APP_VERSION = "MTKruto 0.0.988";
+export declare const APP_VERSION = "MTKruto 0.0.990";
 export declare const DEVICE_MODEL: string;
 export declare const LANG_CODE: string;
 export declare const LANG_PACK = "";

package/esm/constants.js

@@ -54,7 +54,7 @@ export const PUBLIC_KEYS = Object.freeze([
 export const VECTOR_CONSTRUCTOR = 0x1CB5C415;
 export const INITIAL_DC = "2-test";
 export const LAYER = 161;
-export const APP_VERSION = "MTKruto 0.0.988";
+export const APP_VERSION = "MTKruto 0.0.990";
 // @ts-ignore: lib
 export const DEVICE_MODEL = typeof dntShim.Deno === "undefined" ? typeof navigator === "undefined" ? typeof process === "undefined" ? "Unknown" : process.platform + "-" + process.arch : navigator.userAgent.split(" ")[0] : dntShim.Deno.build.os + "-" + dntShim.Deno.build.arch;
 export const LANG_CODE = typeof navigator === "undefined" ? "en" : navigator.language.split("-")[0];