@mtkruto/node 0.0.988 → 0.0.990

package/esm/types/0_poll_option.d.ts

@@ -0,0 +1,8 @@
+import * as types from "../tl/2_types.js";
+export interface PollOption {
+    /** Option text, 1-100 characters */
+    text: string;
+    /** Number of users that voted for this option */
+    voterCount: number;
+}
+export declare function constructPollOption(option: types.PollAnswer, results: Array<types.TypePollAnswerVoters>): PollOption;

package/esm/types/0_poll_option.js

@@ -0,0 +1,6 @@
+export function constructPollOption(option, results) {
+    return {
+        text: option.text,
+        voterCount: results.find((v) => v.option.every((v, i) => option.option[i] == v))?.voters ?? 0,
+    };
+}

package/esm/types/1_chat.js

@@ -1,7 +1,6 @@
 import { ZERO_CHANNEL_ID } from "../constants.js";
 import { UNREACHABLE } from "../utilities/0_control.js";
 import { cleanObject } from "../utilities/0_object.js";
-import { as } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
 import { getIdColor } from "./!0_id_color.js";
 import { constructChatPhoto } from "./0_chat_photo.js";
@@ -29,7 +28,7 @@ export function constructChat(chat) {
         };
         if (chat_.isBot) {
             chat_.isRestricted = chat.restricted || false;
-            chat_.restrictionReason = chat.restrictionReason?.map((v) => v[as](types.RestrictionReason));
+            chat_.restrictionReason = chat.restrictionReason;
         }
         if (chat.photo instanceof types.UserProfilePhoto) {
             chat_.photo = constructChatPhoto(chat.photo, chat_.id, chat.accessHash ?? 0n);
@@ -81,9 +80,9 @@ export function constructChat(chat) {
             };
         }
         chat_.username = chat.username;
-        chat_.also = chat.usernames?.map((v) => v[as](types.Username)).map((v) => v.username);
+        chat_.also = chat.usernames?.map((v) => v.username);
         if (chat_.isRestricted) {
-            chat_.restrictionReason = chat.restrictionReason?.map((v) => v[as](types.RestrictionReason));
+            chat_.restrictionReason = chat.restrictionReason;
         }
         if (chat.photo instanceof types.ChatPhoto) {
             chat_.photo = constructChatPhoto(chat.photo, chat_.id, chat.accessHash ?? 0n);

package/esm/types/1_keyboard_button.js

@@ -1,5 +1,4 @@
 import { UNREACHABLE } from "../utilities/0_control.js";
-import { as } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
 import { chatAdministratorRightsToTlObject, constructChatAdministratorRights } from "./0_chat_administrator_rights.js";
 export function constructKeyboardButton(button_) {
@@ -30,10 +29,10 @@ export function constructKeyboardButton(button_) {
                 },
             };
             if (button_.peerType.botAdminRights) {
-                button.requestChat.botAdministratorRights = constructChatAdministratorRights(button_.peerType.botAdminRights[as](types.ChatAdminRights));
+                button.requestChat.botAdministratorRights = constructChatAdministratorRights(button_.peerType.botAdminRights);
             }
             if (button_.peerType.userAdminRights) {
-                button.requestChat.userAdministratorRights = constructChatAdministratorRights(button_.peerType.userAdminRights[as](types.ChatAdminRights));
+                button.requestChat.userAdministratorRights = constructChatAdministratorRights(button_.peerType.userAdminRights);
             }
             return button;
         }
@@ -48,10 +47,10 @@ export function constructKeyboardButton(button_) {
                 },
             };
             if (button_.peerType.botAdminRights) {
-                button.requestChat.botAdministratorRights = constructChatAdministratorRights(button_.peerType.botAdminRights[as](types.ChatAdminRights));
+                button.requestChat.botAdministratorRights = constructChatAdministratorRights(button_.peerType.botAdminRights);
             }
             if (button_.peerType.userAdminRights) {
-                button.requestChat.userAdministratorRights = constructChatAdministratorRights(button_.peerType.userAdminRights[as](types.ChatAdminRights));
+                button.requestChat.userAdministratorRights = constructChatAdministratorRights(button_.peerType.userAdminRights);
             }
             return button;
         }

package/esm/types/1_photo.js

@@ -1,4 +1,3 @@
-import { as } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
 import { FileID, FileType, FileUniqueID, FileUniqueType, ThumbnailSource } from "./!0_file_id.js";
 import { constructThumbnail } from "./0_thumbnail.js";
@@ -13,7 +12,6 @@ export function constructPhoto(photo) {
         }
     })
         .filter((v) => v instanceof types.PhotoSize)
-        .map((v) => v[as](types.PhotoSize))
         .sort((a, b) => a.size - b.size);
     const largest = sizes.slice(-1)[0];
     const { dcId, id: mediaId, accessHash, fileReference } = photo;

package/esm/types/1_poll.d.ts

@@ -0,0 +1,32 @@
+import * as types from "../tl/2_types.js";
+import { MessageEntity } from "./0_message_entity.js";
+import { PollOption } from "./0_poll_option.js";
+export interface Poll {
+    /** Unique poll identifier */
+    id: string;
+    /** Poll question, 1-300 characters  */
+    question: string;
+    /** List of poll options */
+    options: PollOption[];
+    /** Total number of users that voted in the poll */
+    totalVoterCount: number;
+    /** True, if the poll is closed */
+    isClosed: boolean;
+    /** True, if the poll is anonymous */
+    isAnonymous: boolean;
+    /** Poll type, currently can be “regular” or “quiz” */
+    type: "regular" | "quiz";
+    /** True, if the poll allows multiple answers */
+    allowMultipleAnswers?: boolean;
+    /** Optional. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot. */
+    correctOptionId?: number;
+    /** Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters */
+    explanation?: string;
+    /** Optional. Special entities like usernames, URLs, bot commands, etc. that appear in the explanation */
+    explanationEntities?: MessageEntity[];
+    /** Optional. Amount of time in seconds the poll will be active after creation */
+    openPeriod?: number;
+    /** Optional. Point in time (Unix timestamp) when the poll will be automatically closed */
+    closeDate?: Date;
+}
+export declare function constructPoll(media_: types.MessageMediaPoll): Poll;

package/esm/types/1_poll.js

@@ -0,0 +1,23 @@
+import { cleanObject } from "../utilities/0_object.js";
+import { constructMessageEntity } from "./0_message_entity.js";
+import { constructPollOption } from "./0_poll_option.js";
+export function constructPoll(media_) {
+    const poll = media_.poll;
+    const correctOption = media_.results.results?.find((v) => v.correct)?.option;
+    const correctOptionId = correctOption !== undefined ? poll.answers.findIndex((v) => v.option.every((v, i) => correctOption[i] == v)) : undefined;
+    return cleanObject({
+        id: String(poll.id),
+        question: poll.question,
+        options: poll.answers.map((v) => constructPollOption(v, media_.results.results ?? [])),
+        totalVoterCount: media_.results.totalVoters ?? 0,
+        isClosed: poll.closed || false,
+        isAnonymous: !poll.publicVoters,
+        type: poll.quiz ? "quiz" : "regular",
+        allowMultipleAnswers: poll.quiz ? undefined : poll.multipleChoice || false,
+        correctOptionId,
+        explanation: media_.results.solution,
+        explanationEntities: media_.results.solutionEntities?.map(constructMessageEntity).filter((v) => v != null),
+        openPeriod: poll.closePeriod,
+        closeDate: poll.closeDate ? new Date(poll.closeDate * 1000) : undefined,
+    });
+}

package/esm/types/1_sticker.js

@@ -20,7 +20,7 @@ export async function constructSticker(document, fileId, fileUniqueId, getSticke
         emoji: stickerAttribute.alt || undefined,
         setName,
         premiumAnimation: undefined,
-        maskPosition: stickerAttribute.maskCoords ? constructMaskPosition(stickerAttribute.maskCoords[as](types.MaskCoords)) : undefined,
+        maskPosition: stickerAttribute.maskCoords ? constructMaskPosition(stickerAttribute.maskCoords) : undefined,
         customEmojiId: undefined,
         needsRepainting: undefined,
         fileSize: Number(document.size),

package/esm/types/1_user.js

@@ -1,5 +1,4 @@
 import { cleanObject } from "../utilities/0_object.js";
-import { as } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
 import { getIdColor } from "./!0_id_color.js";
 import { constructChatPhoto } from "./0_chat_photo.js";
@@ -12,7 +11,7 @@ export function constructUser(user_) {
         firstName: user_.firstName || "",
         lastName: user_.lastName,
         username: user_.username,
-        also: user_.usernames?.map((v) => v[as](types.Username)).map((v) => v.username),
+        also: user_.usernames?.map((v) => v.username),
         languageCode: user_.langCode,
         isScam: user_.scam || false,
         isFake: user_.fake || false,

package/esm/types/2_game.js

@@ -5,11 +5,11 @@ import { FileID, FileType, FileUniqueID, FileUniqueType } from "./!0_file_id.js"
 import { constructAnimation } from "./1_animation.js";
 import { constructPhoto } from "./1_photo.js";
 export function constructGame(media_) {
-    const game_ = media_.game[as](types.Game);
+    const game_ = media_.game;
     const document_ = game_.document ? game_.document[as](types.Document) : undefined;
     return cleanObject({
         title: game_.title,
-        description: game_.description,
+        description: media_.game.description,
         photo: constructPhoto(game_.photo[as](types.Photo)),
         animation: document_
             ? constructAnimation(document_, document_.attributes.find((v) => v instanceof types.DocumentAttributeVideo), document_.attributes.find((v) => v instanceof types.DocumentAttributeFilename), new FileID(null, null, FileType.Animation, document_.dcId, {

package/esm/types/2_inline_keyboard_markup.js

@@ -1,9 +1,8 @@
-import { as } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
 import { constructInlineKeyboardButton, inlineKeyboardButtonToTlObject } from "./1_inline_keyboard_button.js";
 export function constructInlineKeyboardMarkup(keyboard_) {
     const rows = new Array();
-    for (const row_ of keyboard_.rows.map((v) => v[as](types.KeyboardButtonRow))) {
+    for (const row_ of keyboard_.rows) {
         const row = new Array();
         for (const button_ of row_.buttons) {
             row.push(constructInlineKeyboardButton(button_));

package/esm/types/2_reply_keyboard_markup.js

@@ -1,9 +1,8 @@
-import { as } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
 import { constructKeyboardButton, keyboardButtonToTlObject } from "./1_keyboard_button.js";
 export function constructReplyKeyboardMarkup(keyboard_) {
     const rows = new Array();
-    for (const row_ of keyboard_.rows.map((v) => v[as](types.KeyboardButtonRow))) {
+    for (const row_ of keyboard_.rows) {
         const row = new Array();
         for (const button_ of row_.buttons) {
             row.push(constructKeyboardButton(button_));

package/esm/types/3_message.d.ts

@@ -18,6 +18,7 @@ import { Voice } from "./0_voice.js";
 import { Dice } from "./0_dice.js";
 import { Contact } from "./0_contact.js";
 import { Game } from "./2_game.js";
+import { Poll } from "./1_poll.js";
 import { Venue } from "./0_venue.js";
 import { Location } from "./0_location.js";
 /** This object represents a message. */
@@ -100,6 +101,7 @@ export interface Message {
     contact?: Contact;
     /** Message is a game, information about the game. */
     game?: Game;
+    poll?: Poll;
     /** Message is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set */
     venue?: Venue;
     /** Message is a shared location, information about the location */

package/esm/types/3_message.js

@@ -22,6 +22,7 @@ import { constructDice } from "./0_dice.js";
 import { FileID, FileType, FileUniqueID, FileUniqueType } from "./!0_file_id.js";
 import { constructContact } from "./0_contact.js";
 import { constructGame } from "./2_game.js";
+import { constructPoll } from "./1_poll.js";
 import { constructVenue } from "./0_venue.js";
 import { constructLocation } from "./0_location.js";
 import { ZERO_CHANNEL_ID } from "../constants.js";
@@ -376,6 +377,9 @@ export async function constructMessage(message_, getEntity, getMessage, getStick
         else if (message_.media instanceof types.MessageMediaGame) {
             message.game = constructGame(message_.media);
         }
+        else if (message_.media instanceof types.MessageMediaPoll) {
+            message.poll = constructPoll(message_.media);
+        }
         else if (message_.media instanceof types.MessageMediaVenue) {
             message.venue = constructVenue(message_.media);
         }

package/esm/utilities/0_queue.d.ts

@@ -1,5 +1,7 @@
 export declare class Queue {
+    private d;
     private functions;
+    constructor(name: string);
     add(fn: () => Promise<void>): void;
     private busy;
     private check;

package/esm/utilities/0_queue.js

@@ -1,5 +1,12 @@
+import { debug } from "../deps.js";
 export class Queue {
-    constructor() {
+    constructor(name) {
+        Object.defineProperty(this, "d", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "functions", {
             enumerable: true,
             configurable: true,
@@ -12,6 +19,7 @@ export class Queue {
             writable: true,
             value: false
         });
+        this.d = debug(`q/${name}`);
     }
     add(fn) {
         this.functions.push(fn);
@@ -26,7 +34,11 @@ export class Queue {
         }
         const fn = this.functions.shift();
         if (fn !== undefined) {
-            fn().finally(() => {
+            fn()
+                .catch((err) => {
+                this.d("%o", err);
+            })
+                .finally(() => {
                 this.busy = false;
                 this.check();
             });

package/esm/utilities/1_misc.js

@@ -1,6 +1,6 @@
 import { UNREACHABLE } from "./0_control.js";
 export function drop(promise) {
-    promise.then().catch();
+    promise.catch(() => { });
 }
 export function mustPrompt(message) {
     const result = prompt(message);

package/package.json

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

package/script/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/script/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/script/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>;