@mtkruto/node 0.0.958 → 0.0.960

package/esm/client/0_utilities.d.ts

@@ -0,0 +1,3 @@
+import * as types from "../tl/2_types.js";
+export declare function getChannelChatId(channelId: bigint): number;
+export declare function peerToChatId(peer: types.TypePeer | types.TypeInputPeer): number;

package/esm/client/0_utilities.js

@@ -0,0 +1,20 @@
+import { ZERO_CHANNEL_ID } from "../constants.js";
+import * as types from "../tl/2_types.js";
+import { UNREACHABLE } from "../utilities/0_control.js";
+export function getChannelChatId(channelId) {
+    return ZERO_CHANNEL_ID + -Number(channelId);
+}
+export function peerToChatId(peer) {
+    if (peer instanceof types.PeerUser || peer instanceof types.InputPeerUser) {
+        return Number(peer.userId);
+    }
+    else if (peer instanceof types.PeerChat || peer instanceof types.InputPeerChat) {
+        return -Number(peer.chatId);
+    }
+    else if (peer instanceof types.PeerChannel || peer instanceof types.InputPeerChannel) {
+        return getChannelChatId(peer.channelId);
+    }
+    else {
+        UNREACHABLE();
+    }
+}

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

@@ -172,7 +172,7 @@ export declare class Client extends ClientAbstract {
         sendAs?: number | string;
         replyMarkup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
     }): Promise<Message>;
-    getMessages(chatId: number | string, messageIds: number[]): Promise<Omit<Message, "replyToMessage">[]>;
+    getMessages(chatId_: number | string, messageIds: number[]): Promise<Omit<Message, "replyToMessage">[]>;
     getMessage(chatId: number | string, messageId: number): Promise<Omit<Message, "replyToMessage"> | null>;
     private downloadInner;
     download(fileId_: string): Promise<AsyncGenerator<Uint8Array, void, unknown>>;

package/esm/client/3_client.js

@@ -23,6 +23,7 @@ import { parseHtml } from "./0_html.js";
 import { checkPassword } from "./0_password.js";
 import { ClientAbstract } from "./1_client_abstract.js";
 import { ClientPlain } from "./2_client_plain.js";
+import { getChannelChatId, peerToChatId } from "./0_utilities.js";
 const d = debug("Client");
 const dGap = debug("Client/recoverUpdateGap");
 const dGapC = debug("Client/recoverChannelUpdateGap");
@@ -507,7 +508,7 @@ export class Client extends ClientAbstract {
                             this.promises.delete(messageId);
                         }
                     };
-                    if (result instanceof types.Updates || result instanceof types.TypeUpdate) {
+                    if (result instanceof types.TypeUpdates || result instanceof types.TypeUpdate) {
                         this.processUpdates(result).then(resolvePromise);
                     }
                     else {
@@ -663,6 +664,24 @@ export class Client extends ClientAbstract {
                 d("applied update with pts %d", update.pts);
                 await this.storage.setChannelPts(channelId, update.pts);
             }
+            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);
+                    }
+                }
+            }
             // apply update (call listeners)
             this.updateHandler?.(this, update);
         }
@@ -1040,6 +1059,13 @@ export class Client extends ClientAbstract {
             await this.processChats(result.chats);
             await this.processUsers(result.users);
         }
+        if (result instanceof types.MessagesMessages) {
+            for (const message of result.messages) {
+                if (message instanceof types.Message || message instanceof types.MessageService) {
+                    await this.storage.setMessage(peerToChatId(message.peerId), message.id, message);
+                }
+            }
+        }
     }
     async updatesToMessages(chatId, updates) {
         const messages = new Array();
@@ -1121,22 +1147,37 @@ export class Client extends ClientAbstract {
         }));
         return await this.updatesToMessages(chatId, result).then((v) => v[0]);
     }
-    async getMessages(chatId, messageIds) {
-        const peer = await this.getInputPeer(chatId);
-        let messages_;
-        if (peer instanceof types.InputPeerChannel) {
-            messages_ = await this.invoke(new functions.ChannelsGetMessages({
-                channel: new types.InputChannel({ channelId: peer.channelId, accessHash: peer.accessHash }),
-                id: messageIds.map((v) => new types.InputMessageID({ id: v })),
-            })).then((v) => v[as](types.MessagesChannelMessages));
+    async getMessages(chatId_, messageIds) {
+        const peer = await this.getInputPeer(chatId_);
+        let messages_ = new Array();
+        const chatId = peerToChatId(peer);
+        let shouldFetch = false;
+        for (const messageId of messageIds) {
+            const message = await this.storage.getMessage(chatId, messageId);
+            if (message == null) {
+                messages_ = [];
+                shouldFetch = true;
+                break;
+            }
+            else {
+                messages_.push(message);
+            }
         }
-        else {
-            messages_ = await this.invoke(new functions.MessagesGetMessages({
-                id: messageIds.map((v) => new types.InputMessageID({ id: v })),
-            })).then((v) => v[as](types.MessagesMessages));
+        if (shouldFetch) {
+            if (peer instanceof types.InputPeerChannel) {
+                messages_ = await this.invoke(new functions.ChannelsGetMessages({
+                    channel: new types.InputChannel({ channelId: peer.channelId, accessHash: peer.accessHash }),
+                    id: messageIds.map((v) => new types.InputMessageID({ id: v })),
+                })).then((v) => v[as](types.MessagesChannelMessages).messages);
+            }
+            else {
+                messages_ = await this.invoke(new functions.MessagesGetMessages({
+                    id: messageIds.map((v) => new types.InputMessageID({ id: v })),
+                })).then((v) => v[as](types.MessagesMessages).messages);
+            }
         }
         const messages = new Array();
-        for (const message_ of messages_.messages) {
+        for (const message_ of messages_) {
             messages.push(await constructMessage(message_, this[getEntity].bind(this), null, this[getStickerSetName].bind(this)));
         }
         return messages;

package/esm/constants.d.ts

@@ -4,7 +4,7 @@ export declare const publicKeys: Map<bigint, [bigint, bigint]>;
 export declare const VECTOR_CONSTRUCTOR = 481674261;
 export declare const DEFAULT_INITIAL_DC: DC;
 export declare const LAYER = 158;
-export declare const DEFAULT_APP_VERSION = "MTKruto 0.0.958";
+export declare const DEFAULT_APP_VERSION = "MTKruto 0.0.960";
 export declare const DEFAULT_DEVICE_MODEL: string;
 export declare const DEFAULT_LANG_CODE: string;
 export declare const DEFAULT_LANG_PACK = "";

package/esm/constants.js

@@ -62,7 +62,7 @@ export const publicKeys = new Map([
 export const VECTOR_CONSTRUCTOR = 0x1CB5C415;
 export const DEFAULT_INITIAL_DC = "2-test";
 export const LAYER = 158;
-export const DEFAULT_APP_VERSION = "MTKruto 0.0.958";
+export const DEFAULT_APP_VERSION = "MTKruto 0.0.960";
 // @ts-ignore: lib
 export const DEFAULT_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 DEFAULT_LANG_CODE = typeof navigator === "undefined" ? "en" : navigator.language.split("-")[0];

package/esm/storage/0_storage.d.ts

@@ -1,5 +1,6 @@
 import { MaybePromise } from "../utilities/0_types.js";
 import { DC } from "../transport/2_transport_provider.js";
+import { TLObject } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
 export type StorageKeyPart = string | number | bigint | Uint8Array;
 export declare abstract class Storage {
@@ -19,8 +20,13 @@ export declare abstract class Storage {
     getUserAccessHash(id: bigint): MaybePromise<bigint | null>;
     updateUsernames(type: "user" | "channel", id: bigint, usernames: string[]): Promise<void>;
     getUsername(username: string): MaybePromise<["channel" | "user", bigint, Date] | null>;
+    setTlObject(key: readonly StorageKeyPart[], value: TLObject | null): Promise<void>;
+    getTLObject(key: readonly StorageKeyPart[]): Promise<import("../tl/3_tl_reader.js").ReadObject | null>;
     setState(state: types.UpdatesState): Promise<void>;
     getState(): Promise<types.UpdatesState | null>;
+    setMessage(chatId: number, messageId: number, message: types.TypeMessage | null): Promise<void>;
+    getMessageChat(messageId: number): MaybePromise<number | null>;
+    getMessage(chatId: number, messageId: number): Promise<types.TypeMessage | null>;
     setChannelPts(channelId: bigint, pts: number): Promise<void>;
     getChannelPts(channelId: bigint): MaybePromise<number | null>;
     setEntity(peer: types.Channel): Promise<void>;

package/esm/storage/0_storage.js

@@ -4,6 +4,8 @@ import { bigIntFromBuffer } from "../utilities/0_bigint.js";
 import { serialize } from "../tl/1_tl_object.js";
 import * as types from "../tl/2_types.js";
 import { TLReader } from "../tl/3_tl_reader.js";
+import { rleDecode, rleEncode } from "../utilities/0_rle.js";
+import { ZERO_CHANNEL_ID } from "../constants.js";
 const KPARTS__DC = ["dc"];
 const KPARTS__AUTH_KEY = ["authKey"];
 const KPARTS__CHANNEL_ACCESS_HASH = (v) => ["channelAccessHash", v];
@@ -14,6 +16,8 @@ const KPARTS__CHANNEL_PTS = (v) => ["channelPts", v];
 const KPARTS__PEER = (type, id) => ["peer", type, id];
 const KPARTS__ACCOUNT_TYPE = ["accountType"];
 const KPARTS__STICKER_SET_NAME = (id, accessHash) => ["stickerSetName", id, accessHash];
+const KPARTS_MESSAGE = (chatId, messageId) => ["messages", chatId, messageId];
+const KPARTS_MESSAGE_REF = (messageId) => ["messageRefs", messageId];
 export class Storage {
     constructor() {
         Object.defineProperty(this, "_authKeyId", {
@@ -71,18 +75,41 @@ export class Storage {
         username = username.toLowerCase();
         return this.get(KPARTS__USERNAME(username));
     }
-    async setState(state) {
-        await this.set(KPARTS__STATE, state[serialize]());
+    async setTlObject(key, value) {
+        if (value == null) {
+            await this.set(key, null);
+        }
+        else {
+            await this.set(key, rleEncode(value[serialize]()));
+        }
     }
-    async getState() {
-        const state = await this.get(KPARTS__STATE);
-        if (state != null) {
-            return new TLReader(state).readObject();
+    async getTLObject(key) {
+        const buffer = await this.get(key);
+        if (buffer != null) {
+            return new TLReader(rleDecode(buffer)).readObject();
         }
         else {
             return null;
         }
     }
+    async setState(state) {
+        await this.setTlObject(KPARTS__STATE, state);
+    }
+    async getState() {
+        return await this.getTLObject(KPARTS__STATE);
+    }
+    async setMessage(chatId, messageId, message) {
+        if (chatId > ZERO_CHANNEL_ID) {
+            await this.set(KPARTS_MESSAGE_REF(messageId), message == null ? null : chatId);
+        }
+        await this.setTlObject(KPARTS_MESSAGE(chatId, messageId), message);
+    }
+    getMessageChat(messageId) {
+        return this.get(KPARTS_MESSAGE_REF(messageId));
+    }
+    async getMessage(chatId, messageId) {
+        return await this.getTLObject(KPARTS_MESSAGE(chatId, messageId));
+    }
     async setChannelPts(channelId, pts) {
         await this.set(KPARTS__CHANNEL_PTS(channelId), pts);
     }

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

@@ -1,13 +1,22 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents an audio file to be treated as music by the Telegram clients. */
 export interface Audio {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Duration of the audio in seconds as defined by sender */
     duration: number;
+    /** Performer of the audio as defined by sender or by audio tags */
     performer?: string;
+    /** Title of the audio as defined by sender or by audio tags */
     title?: string;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */
     fileSize: number;
+    /** Thumbnail of the album cover to which the music file belongs */
     thumbnails: Thumbnail[];
 }
 export declare function constructAudio(document: types.Document, audioAttribute: types.DocumentAttributeAudio | undefined, fileId: string, fileUniqueId: string): Audio;

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

@@ -17,13 +17,13 @@ export interface ChatAdministratorRights {
     canChangeInfo: boolean;
     /** True, if the user is allowed to invite new users to the chat */
     canInviteUsers: boolean;
-    /** Optional. True, if the administrator can post in the channel; channels only */
+    /** True, if the administrator can post in the channel; channels only */
     canPostMessages?: boolean;
-    /** Optional. True, if the administrator can edit messages of other users and can pin messages; channels only */
+    /** True, if the administrator can edit messages of other users and can pin messages; channels only */
     canEditMessages?: boolean;
-    /** Optional. True, if the user is allowed to pin messages; groups and supergroups only */
+    /** True, if the user is allowed to pin messages; groups and supergroups only */
     canPinMessages?: boolean;
-    /** Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
+    /** True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
     canManageTopics?: boolean;
 }
 export declare function constructChatAdministratorRights(rights_: types.ChatAdminRights): ChatAdministratorRights;

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

@@ -1,9 +1,15 @@
 import * as types from "../tl/2_types.js";
+/** This object represents a phone contact. */
 export interface Contact {
+    /** Contact's phone number */
     phoneNumber: string;
+    /** Contact's first name */
     firstName: string;
+    /** Contact's last name */
     lastName?: string;
+    /** Contact's user identifier in Telegram. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier. */
     userId?: number;
+    /** Additional data about the contact in the form of a [vCard](https://en.wikipedia.org/wiki/VCard) */
     vcard?: string;
 }
 export declare function constructContact(contact: types.MessageMediaContact): Contact;

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

@@ -1,6 +1,9 @@
 import * as types from "../tl/2_types.js";
+/** This object represents an animated emoji that displays a random value. */
 export interface Dice {
+    /** Emoji on which the dice throw animation is based */
     emoji: string;
+    /** Value of the dice, 1-6 for "🎲", "🎯" and "🎳" base emoji, 1-5 for "🏀" and "⚽" base emoji, 1-64 for "🎰" base emoji */
     value: number;
 }
 export declare function constructDice(dice_: types.MessageMediaDice): Dice;

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

@@ -5,7 +5,7 @@ export interface ForceReply {
     forceReply: true;
     /** Shows reply interface to the user, as if they manually selected the bot's message and tapped 'Reply' */
     inputFieldPlaceholder?: string;
-    /** Optional. Use this parameter if you want to force reply from specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message. */
+    /** Use this parameter if you want to force reply from specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message. */
     selective?: boolean;
 }
 export declare function constructForceReply(replyMarkup_: types.ReplyKeyboardForceReply): ForceReply;

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

@@ -1,5 +1,5 @@
 /** This object represents type of a poll, which is allowed to be created and sent when the corresponding button is pressed. */
 export interface KeyboardButtonPollType {
-    /** Optional. If quiz is passed, the user will be allowed to create only polls in the quiz mode. If regular is passed, only regular polls will be allowed. Otherwise, the user will be allowed to create a poll of any type. */
+    /** If quiz is passed, the user will be allowed to create only polls in the quiz mode. If regular is passed, only regular polls will be allowed. Otherwise, the user will be allowed to create a poll of any type. */
     type?: string;
 }

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

@@ -1,10 +1,17 @@
 import * as types from "../tl/2_types.js";
+/** This object represents a point on the map. */
 export interface Location {
+    /** Latitude as defined by sender */
     latitude: number;
+    /** Longitude as defined by sender */
     longitude: number;
+    /** The radius of uncertainty for the location, measured in meters; 0-1500 */
     horizontalAccuracy?: number;
+    /** Time relative to the message sending date, during which the location can be updated; in seconds. For active live locations only. */
     livePeriod?: number;
+    /** The direction in which user is moving, in degrees; 1-360. For active live locations only. */
     heading?: number;
+    /** The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only. */
     proximityAlertRadius?: number;
 }
 export declare function constructLocation(geo_: types.MessageMediaGeo | types.MessageMediaGeoLive | types.GeoPoint): Location;

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

@@ -2,10 +2,10 @@
 export interface LoginUrl {
     /** An HTTPS URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in [Receiving authorization data](https://core.telegram.org/widgets/login#receiving-authorization-data). */
     url: string;
-    /** Optional. New text of the button in forwarded messages. */
+    /** New text of the button in forwarded messages. */
     forwardText?: string;
-    /** Optional. Username of a bot, which will be used for user authorization. See [Setting up a bot](https://core.telegram.org/widgets/login#setting-up-a-bot) for more details. If not specified, the current bot's username will be assumed. The url's domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details. */
+    /** Username of a bot, which will be used for user authorization. See [Setting up a bot](https://core.telegram.org/widgets/login#setting-up-a-bot) for more details. If not specified, the current bot's username will be assumed. The url's domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details. */
     botUsername?: string;
-    /** Optional. Pass True to request the permission for your bot to send messages to the user. */
+    /** Pass True to request the permission for your bot to send messages to the user. */
     requestWriteAccess?: boolean;
 }

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

@@ -1,8 +1,13 @@
 import * as types from "../tl/2_types.js";
+/** This object describes the position on faces where a mask should be placed by default. */
 export interface MaskPosition {
+    /** The part of the face relative to which the mask should be placed. One of "forehead", "eyes", "mouth", or "chin". */
     point: "forehead" | "eyes" | "mouth" | "chin";
+    /** Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position. */
     xShift: number;
+    /** Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position. */
     yShift: number;
+    /** Mask scaling coefficient. For example, 2.0 means double size. */
     scale: number;
 }
 export declare function constructMaskPosition({ n, x, y, zoom }: types.MaskCoords): MaskPosition;

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

@@ -50,7 +50,7 @@ export declare namespace MessageEntity {
     }
     interface Pre extends Base {
         type: MessageEntityType.Pre;
-        /** Optional. For “pre” only, the programming language of the entity text */
+        /** For “pre” only, the programming language of the entity text */
         language: string;
     }
     interface Code extends Base {
@@ -58,12 +58,12 @@ export declare namespace MessageEntity {
     }
     interface TextURL extends Base {
         type: MessageEntityType.TextURL;
-        /** Optional. For “text_link” only, URL that will be opened after user taps on the text */
+        /** For “text_link” only, URL that will be opened after user taps on the text */
         url: string;
     }
     interface MentionName extends Base {
         type: MessageEntityType.MentionName;
-        /** Optional. For “text_mention” only, the ID of the mentioned user */
+        /** For “text_mention” only, the ID of the mentioned user */
         userId: number;
     }
     interface Cashtag extends Base {
@@ -89,7 +89,7 @@ export declare namespace MessageEntity {
     }
     interface CustomEmoji extends Base {
         type: MessageEntityType.CustomEmoji;
-        /** Optional. For “custom_emoji” only, unique identifier of the custom emoji */
+        /** For “custom_emoji” only, unique identifier of the custom emoji */
         customEmojiId: string;
     }
 }

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

@@ -3,7 +3,7 @@ import * as types from "../tl/2_types.js";
 export interface ReplyKeyboardRemove {
     /** Requests clients to remove the custom keyboard (user will not be able to summon this keyboard; if you want to hide the keyboard from sight but keep it accessible, use _one_time_keyboard_ in `ReplyKeyboardMarkup`) */
     removeKeyboard: true;
-    /** Optional. Use this parameter if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the text of the `Message` object; 2) if the bot's message is a reply (has _reply_to_message_id_), sender of the original message. */
+    /** Use this parameter if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the text of the `Message` object; 2) if the bot's message is a reply (has _reply_to_message_id_), sender of the original message. */
     selective?: boolean;
 }
 export declare function constructReplyKeyboardRemove(replyMarkup_: types.ReplyKeyboardHide): ReplyKeyboardRemove;

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

@@ -1,4 +1,5 @@
 import * as types from "../tl/2_types.js";
+/** This object represents thumbnail of a file or a sticker. */
 export interface Thumbnail {
     /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
@@ -8,7 +9,7 @@ export interface Thumbnail {
     width: number;
     /** Photo height */
     height: number;
-    /** Optional. File size in bytes */
+    /** File size in bytes */
     fileSize: number;
 }
 export declare function constructThumbnail(size: types.PhotoSize, file: types.Document | types.Photo): Thumbnail;

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

@@ -1,10 +1,16 @@
 import * as types from "../tl/2_types.js";
 import { Location } from "./0_location.js";
+/**  */
 export interface Venue {
+    /** Venue location. Can't be a live location */
     location: Location;
+    /** Name of the venue */
     title: string;
+    /** Address of the venue */
     address: string;
+    /** Foursquare identifier of the venue */
     foursquareId?: string;
+    /** Foursquare type of the venue. (For example, "arts_entertainment/default", "arts_entertainment/aquarium" or "food/icecream".) */
     foursquareType?: string;
 }
 export declare function constructVenue(media_: types.MessageMediaVenue): Venue;

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

@@ -1,9 +1,15 @@
 import * as types from "../tl/2_types.js";
+/** This object represents a voice note. */
 export interface Voice {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Duration of the audio in seconds as defined by sender */
     duration: number;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */
     fileSize: number;
 }
 export declare function constructVoice(document: types.Document, audioAttributes: types.DocumentAttributeAudio, fileId: string, fileUniqueId: string): Voice;

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

@@ -1,14 +1,24 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound). */
 export interface Animation {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Video width as defined by sender */
     width: number;
+    /** Video height as defined by sender */
     height: number;
+    /** Duration of the video in seconds as defined by sender */
     duration: number;
+    /** Animation thumbnail as defined by sender */
     thumbnails: Thumbnail[];
+    /** Original animation filename as defined by sender */
     fileName?: string;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */
     fileSize: number;
 }
 export declare function constructAnimation(document: types.Document, videoAttribute: types.DocumentAttributeVideo | undefined, fileAttribute: types.DocumentAttributeFilename | undefined, fileId: string, fileUniqueId: string): Animation;

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

@@ -13,22 +13,22 @@ export declare namespace Chat {
         /** Unique identifier for this chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier. */
         id: number;
         idColor: string;
-        /** Optional. Chat photo. */
+        /** Chat photo. */
         photo?: ChatPhoto;
     }
     interface Private extends Base {
         type: ChatType.Private;
         /** True, if this user is a bot */
         isBot?: boolean;
-        /** Optional. First name of the other party in a private chat */
+        /** First name of the other party in a private chat */
         firstName: string;
-        /** Optional. Last name of the other party in a private chat */
+        /** Last name of the other party in a private chat */
         lastName?: string;
-        /** Optional. Username, for private chats, supergroups and channels if available */
+        /** Username, for private chats, supergroups and channels if available */
         username?: string;
-        /** Optional. Additional usernames */
+        /** Additional usernames */
         also?: string[];
-        /** Optional. Chat photo. */
+        /** Chat photo. */
         photo?: ChatPhoto.User;
         /** True, if the user is a scam user */
         isScam: boolean;
@@ -40,26 +40,26 @@ export declare namespace Chat {
         isVerified: boolean;
         /** True, if the access to the user must be restricted for the reason specified in `restriction_reason` */
         isRestricted?: boolean;
-        /** Optional. Contains the reason why access to the user must be restricted. */
+        /** Contains the reason why access to the user must be restricted. */
         restrictionReason?: types.RestrictionReason[];
     }
     interface Group extends Base {
         type: ChatType.Group;
-        /** Optional. Title, for supergroups, channels and group chats */
+        /** Title, for supergroups, channels and group chats */
         title: string;
-        /** Optional. Chat photo. */
+        /** Chat photo. */
         photo?: ChatPhoto.Chat;
         /** True, if the user is creator of the chat */
         isCreator: boolean;
     }
     interface ChannelBase extends Base {
-        /** Optional. Title, for supergroups, channels and group chats */
+        /** Title, for supergroups, channels and group chats */
         title: string;
-        /** Optional. Username, for private chats, supergroups and channels if available */
+        /** Username, for private chats, supergroups and channels if available */
         username?: string;
-        /** Optional. Additional usernames */
+        /** Additional usernames */
         also?: string[];
-        /** Optional. Chat photo. */
+        /** Chat photo. */
         photo?: ChatPhoto.Chat;
         /** True, if the user is a scam user */
         isScam: boolean;
@@ -69,21 +69,21 @@ export declare namespace Chat {
         isVerified: boolean;
         /** True, if the access to the user must be restricted for the reason specified in `restriction_reason` */
         isRestricted: boolean;
-        /** Optional. Contains the reason why access to the user must be restricted. */
+        /** Contains the reason why access to the user must be restricted. */
         restrictionReason?: types.RestrictionReason[];
     }
     interface Channel extends ChannelBase {
         type: ChatType.Channel;
-        /** Optional. Title, for supergroups, channels and group chats */
+        /** Title, for supergroups, channels and group chats */
         title: string;
-        /** Optional. Username, for private chats, supergroups and channels if available */
+        /** Username, for private chats, supergroups and channels if available */
         username?: string;
-        /** Optional. Additional usernames */
+        /** Additional usernames */
         also?: string[];
     }
     interface Supergroup extends ChannelBase {
         type: ChatType.Supergroup;
-        /** Optional. True, if the supergroup chat is a forum (has [topics](https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups) enabled) */
+        /** True, if the supergroup chat is a forum (has [topics](https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups) enabled) */
         isForum: boolean;
     }
 }

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

@@ -1,11 +1,18 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a general file (as opposed to [photos](https://corefork.telegram.org/bots/api#photosize), [voice messages](https://corefork.telegram.org/bots/api#voice) and [audio files](https://corefork.telegram.org/bots/api#audio)). */
 export interface Document {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Document thumbnail as defined by sender */
     thumbnails: Thumbnail[];
+    /** Original filename as defined by sender */
     fileName: string;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */
     fileSize: number;
 }
 export declare function constructDocument(document: types.Document, fileNameAttribute: types.DocumentAttributeFilename, fileId: string, fileUniqueId: string): Document;