@mtkruto/node 0.1.105 → 0.1.107

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

@@ -1,22 +1,22 @@
 import { types } from "../2_tl.js";
 import { Thumbnail } from "./0_thumbnail.js";
-/** This object represents an audio file to be treated as music by the Telegram clients. */
+/** An audio file. */
 export interface Audio {
-    /** Identifier for this file, which can be used to download or reuse the file */
+    /** A file identifier that can be used to download or reuse this file. */
     fileId: string;
-    /** Unique identifier for this file, which is supposed to be the same over time and for different users and bots. Can't be used to download or reuse the file. */
+    /** A file identifier that can be used to identify this file. */
     fileUniqueId: string;
-    /** Duration of the audio in seconds as defined by sender */
+    /** Duration of the audio in seconds. */
     duration: number;
-    /** Performer of the audio as defined by sender or by audio tags */
+    /** Authors of the audio. */
     performer?: string;
-    /** Title of the audio as defined by sender or by audio tags */
+    /** Title of the audio. */
     title?: string;
-    /** MIME type of the file as defined by sender */
+    /** MIME type of the file. */
     mimeType: string;
-    /** File size in bytes */
+    /** Size of the file in bytes. */
     fileSize: number;
-    /** Thumbnail of the album cover to which the music file belongs */
+    /** Thumbnails 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_bot_command.d.ts

@@ -1,4 +1,6 @@
 export interface BotCommand {
+    /** The command's name. */
     command: string;
+    /** The command's description. */
     description: string;
 }

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

@@ -1 +1,2 @@
+/** A sign of a possible action by a member of a conversation. */
 export type ChatAction = "type" | "uploadPhoto" | "recordVideo" | "uploadVideo" | "recordVoice" | "uploadAudio" | "uploadDocument" | "chooseSticker" | "findLocation" | "recordVideoNote" | "uploadVideoNote";

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

@@ -1,29 +1,29 @@
 import { types } from "../2_tl.js";
-/** Represents the rights of an administrator in a chat. */
+/** The rights of a chat administrator. */
 export interface ChatAdministratorRights {
-    /** True, if the user's presence in the chat is hidden */
+    /** Whether the admininistrator's presence in the chat is hidden. */
     isAnonymous: boolean;
-    /** True, if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege */
+    /** Whether the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and surpass slow mode. */
     canManageChat: boolean;
-    /** True, if the administrator can delete messages of other users */
+    /** Whether the administrator can delete messages of other users. */
     canDeleteMessages: boolean;
-    /** True, if the administrator can manage video chats */
+    /** Whether the administrator can manage video chats. */
     canManageVideoChats: boolean;
-    /** True, if the administrator can restrict, ban or unban chat members */
+    /** Whether the administrator can restrict, ban or unban chat members. */
     canRestrictMembers: boolean;
-    /** True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by the user) */
+    /** Whether the administrator can promote regular members to admininistrators. */
     canPromoteMembers: boolean;
-    /** True, if the user is allowed to change the chat title, photo and other settings */
+    /** Whether the administrator can change the name of the chat, its photo, description and some other settings. */
     canChangeInfo: boolean;
-    /** True, if the user is allowed to invite new users to the chat */
+    /** Whether the administrator can invite users to the chat. */
     canInviteUsers: boolean;
-    /** True, if the administrator can post in the channel; channels only */
+    /** Whether the administrator can make posts in the channel. Only available for channels. */
     canPostMessages?: boolean;
-    /** True, if the administrator can edit messages of other users and can pin messages; channels only */
+    /** Whether the administrator can pin posts and edit posts they didn't send. Only available for channels. */
     canEditMessages?: boolean;
-    /** True, if the user is allowed to pin messages; groups and supergroups only */
+    /** Whether the administrator can pin messages. Only available for groups and supergroups. */
     canPinMessages?: boolean;
-    /** True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
+    /** Whether the administrator can manage topics. Only available for supergroups. */
     canManageTopics?: boolean;
 }
 export declare function constructChatAdministratorRights(rights_: types.ChatAdminRights): ChatAdministratorRights;

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

@@ -1,19 +1,20 @@
 import { types } from "../2_tl.js";
 export declare namespace ChatPhoto {
     interface Base {
-        /** File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed. */
+        /** A file identifier that can be used to download or reuse the small version of the chat photo (160x160). */
         smallFileId: string;
-        /** Unique file identifier of small (160x160) chat photo, which is supposed to be the same over time and for different users and bots. Can't be used to download or reuse the file. */
+        /** A file identifier that can be used to identify the small version of the chat photo (160x160). */
         smallFileUniqueId: string;
-        /** File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed. */
+        /** A file identifier that can be used to download or reuse the big version of the chat photo (640x640). */
         bigFileId: string;
-        /** Unique file identifier of big (640x640) chat photo, which is supposed to be the same over time and for different users and bots. Can't be used to download or reuse the file. */
+        /** A file identifier that can be used to identify the big version of the chat photo (640x640). */
         bigFileUniqueId: string;
-        /** True, if an [animated profile picture](https://core.telegram.org/api/files#animated-profile-pictures) is available for the user */
+        /** Whether the chat photo is animated. */
         hasVideo: boolean;
     }
     interface User extends Base {
-        personal: boolean;
+        /** Differentiates between user profile photos. */
+        personal: true;
     }
     type Chat = Base;
 }

package/esm/types/0_chat_photo.js

@@ -32,7 +32,7 @@ export function constructChatPhoto(photo, chatId, chatAccessHash) {
     }
     else {
         return {
-            personal: photo.personal || false,
+            personal: photo.personal ? true : undefined,
             smallFileId,
             smallFileUniqueId,
             bigFileId,

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

@@ -1,15 +1,15 @@
 import { types } from "../2_tl.js";
-/** This object represents a phone contact. */
+/** A shared contact. */
 export interface Contact {
-    /** Contact's phone number */
+    /** The contact's phone number. */
     phoneNumber: string;
-    /** Contact's first name */
+    /** The contact's first name. */
     firstName: string;
-    /** Contact's last name */
+    /** The contact's last name. */
     lastName?: string;
-    /** Contact's user identifier in Telegram */
+    /** The contact's Telegram identifier. */
     userId?: number;
-    /** Additional data about the contact in the form of a [vCard](https://en.wikipedia.org/wiki/VCard) */
+    /** Additional information in the vCard format. */
     vcard?: string;
 }
 export declare function constructContact(contact: types.MessageMediaContact): Contact;

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

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

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

@@ -1,11 +1,11 @@
 import { types } from "../2_tl.js";
-/** Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply'). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode. */
+/** Forces the user's client to select the message as the one that is to be replied. */
 export interface ForceReply {
-    /** Shows reply interface to the user, as if they manually selected the bot's message and tapped 'Reply' */
+    /** Differentiate from other reply markup types. */
     forceReply: true;
-    /** Shows reply interface to the user, as if they manually selected the bot's message and tapped 'Reply' */
+    /** A placeholder to be shown in the client's message box. */
     inputFieldPlaceholder?: string;
-    /** 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. */
+    /** Whether to only affect specific users. If true, only users that were mentioned will be affected along with the author of the replied message if any. */
     selective?: boolean;
 }
 export declare function constructForceReply(replyMarkup_: types.ReplyKeyboardForceReply): ForceReply;

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

@@ -1,6 +1,11 @@
+/** A message content that shares a contact. */
 export interface InputContactMessageContent {
+    /** The contact's phone number. */
     phoneNumber: string;
+    /** The contact's first name. */
     firstName: string;
+    /** The contact's last name. */
     lastName?: string;
+    /** Additional information in the vCard format. */
     vcard?: string;
 }

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

@@ -1,8 +1,15 @@
+/** A message content that shares a location. */
 export interface InputLocationMessageContent {
+    /** The latitude of the location. */
     latitude: number;
+    /** The longitude of the location. */
     longitude: number;
+    /** The accuracy radius of the location in meters. Must be in the range of 0-1500. */
     horizontalAccuracy?: number;
+    /** The duration in which the location can be updated in seconds. Must be in the range of 80-864,000. */
     livePeriod?: number;
+    /** The direction which the user is moving towards. Must be in the range of 1-350. */
     heading?: number;
+    /** The maximum distance for proximity alerts on approaching another chat member in meters. Must be in the range 1-100,000. */
     proximityAlertRadius?: number;
 }

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

@@ -1,10 +1,19 @@
+/** A message content that shares a venue. */
 export interface InputVenuMessageContent {
+    /** The latitude of the venue. */
     latitude: number;
-    loingitude: number;
+    /** The longitude of the venue. */
+    longitude: number;
+    /** The name of the venue. */
     title: string;
+    /** The address of the venue. */
     address: string;
+    /** The Foursquare identifier of the venue. */
     foursquareId?: string;
+    /** The Foursquare type of the venue. */
     foursquareType?: string;
+    /** The Google Places identifier of the venue. */
     googlePlaceId?: string;
+    /** The Google Places type of the venue. */
     googlePlaceType?: string;
 }

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. */
+/** A keyboard button representing the type of the poll that is requested to be created. */
 export interface KeyboardButtonPollType {
-    /** 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;
+    /** If a type is not specified, the user will be allowed to choose either type. */
+    type?: "regular" | "quiz";
 }

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

@@ -1,17 +1,17 @@
 import { types } from "../2_tl.js";
-/** This object represents a point on the map. */
+/** A shared location. */
 export interface Location {
-    /** Latitude as defined by sender */
+    /** The latitude of the location. */
     latitude: number;
-    /** Longitude as defined by sender */
+    /** The longitude of the location. */
     longitude: number;
-    /** The radius of uncertainty for the location, measured in meters; 0-1500 */
+    /** The accuracy radius of the location in meters. Must be in the range of 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. */
+    /** The duration in which the location can be updated in seconds. Must be in the range of 80-864,000. */
     livePeriod?: number;
-    /** The direction in which user is moving, in degrees; 1-360. For active live locations only. */
+    /** The direction which the user is moving towards. Must be in the range of 1-350. */
     heading?: number;
-    /** The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only. */
+    /** The maximum distance for proximity alerts on approaching another chat member in meters. Must be in the range 1-100,000. */
     proximityAlertRadius?: number;
 }
 export declare function constructLocation(geo_: types.MessageMediaGeo | types.MessageMediaGeoLive | types.GeoPoint): Location;

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

@@ -1,11 +1,10 @@
-/** This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login) when the user is coming from Telegram. */
 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). */
+    /** An HTTPS URL to be opened with the authorization data appended 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. */
     url: string;
-    /** New text of the button in forwarded messages. */
+    /** A different text to use for the button when the message is forwarded. */
     forwardText?: string;
-    /** 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 [Learn more.](https://core.telegram.org/widgets/login#setting-up-a-bot) 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. [Learn more.](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) */
     botUsername?: string;
-    /** Pass True to request the permission for your bot to send messages to the user. */
+    /** Whether to ask the user to allow messages to be received from the specified bot. */
     requestWriteAccess?: boolean;
 }

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

@@ -1,5 +1,4 @@
 import { types } from "../2_tl.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";

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

@@ -31,7 +31,7 @@ export declare namespace MessageEntity {
     }
     interface Pre extends Base {
         type: "pre";
-        /** For "pre" only, the programming language of the entity text */
+        /** The language identifier of the code. */
         language: string;
     }
     interface Code extends Base {
@@ -39,12 +39,12 @@ export declare namespace MessageEntity {
     }
     interface TextLink extends Base {
         type: "textLink";
-        /** For "textLink" only, URL that will be opened after user taps on the text */
+        /** A URL that will be opened after the text is tapped. */
         url: string;
     }
     interface TextMention extends Base {
         type: "textMention";
-        /** For "textMention" only, the ID of the mentioned user */
+        /** The identifier of the user to mention. */
         userId: number;
     }
     interface Cashtag extends Base {
@@ -70,11 +70,11 @@ export declare namespace MessageEntity {
     }
     interface CustomEmoji extends Base {
         type: "customEmoji";
-        /** For "customEmoji" only, unique identifier of the custom emoji */
+        /** The identifier of the custom emoji. */
         customEmojiId: string;
     }
 }
-/** This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc. */
+/** A single entity of a message's text or caption. */
 export type MessageEntity = MessageEntity.Mention | MessageEntity.Hashtag | MessageEntity.BotCommand | MessageEntity.URL | MessageEntity.EmailAddress | MessageEntity.Bold | MessageEntity.Italic | MessageEntity.Code | MessageEntity.Pre | MessageEntity.TextLink | MessageEntity.TextMention | MessageEntity.Cashtag | MessageEntity.PhoneNumber | MessageEntity.Underline | MessageEntity.Strikethrough | MessageEntity.Blockquote | MessageEntity.BankCard | MessageEntity.Spoiler | MessageEntity.CustomEmoji;
 export declare function constructMessageEntity(obj: types.TypeMessageEntity): MessageEntity | null;
 export declare function messageEntityToTlObject(entity: MessageEntity): types.MessageEntityMention | types.MessageEntityHashtag | types.MessageEntityBotCommand | types.MessageEntityURL | types.MessageEntityEmail | types.MessageEntityBold | types.MessageEntityItalic | types.MessageEntityCode | types.MessageEntityPre | types.MessageEntityTextURL | types.MessageEntityMentionName | types.MessageEntityPhone | types.MessageEntityCashtag | types.MessageEntityUnderline | types.MessageEntityStrike | types.MessageEntityBlockquote | types.MessageEntityBankCard | types.MessageEntitySpoiler | types.MessageEntityCustomEmoji;

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

@@ -1 +1,2 @@
+/** Message parse mode. */
 export type ParseMode = "HTML" | null;

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

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

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

@@ -1,9 +1,9 @@
 import { types } from "../2_tl.js";
-/** Upon receiving a message with this object, Telegram clients will remove the current custom keyboard and display the default letter-keyboard. By default, custom keyboards are displayed until a new keyboard is sent by a bot. An exception is made for one-time keyboards that are hidden immediately after the user presses a button. */
+/** Makes the user's client hide the current custom keyboard. */
 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`) */
+    /** Differentiate from other reply markup types. */
     removeKeyboard: true;
-    /** 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. */
+    /** Whether to only affect specific users. If true, only users that were mentioned will be affected along with the author of the replied message if any. */
     selective?: boolean;
 }
 export declare function constructReplyKeyboardRemove(replyMarkup_: types.ReplyKeyboardHide): ReplyKeyboardRemove;

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

@@ -1,15 +1,15 @@
 import { types } from "../2_tl.js";
-/** This object represents thumbnail of a file or a sticker. */
+/** A file or sticker thumbnail. */
 export interface Thumbnail {
-    /** Identifier for this file, which can be used to download or reuse the file */
+    /** A file identifier that can be used to download or reuse the thumbnail. */
     fileId: string;
-    /** Unique identifier for this file, which is supposed to be the same over time and for different users and bots. Can't be used to download or reuse the file. */
+    /** A file identifier that can be used to identify the thumbnail. */
     fileUniqueId: string;
-    /** Photo width */
+    /** The width of the thumbnail. */
     width: number;
-    /** Photo height */
+    /** The height of the thumbnail. */
     height: number;
-    /** File size in bytes */
+    /** Size of the file 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,16 +1,16 @@
 import { types } from "../2_tl.js";
 import { Location } from "./0_location.js";
-/**  */
+/** A shared venue. */
 export interface Venue {
-    /** Venue location. Can't be a live location */
+    /** The location of the venue. Cannot be a live location. */
     location: Location;
-    /** Name of the venue */
+    /** The name of the venue. */
     title: string;
-    /** Address of the venue */
+    /** The address of the venue. */
     address: string;
-    /** Foursquare identifier of the venue */
+    /** The Foursquare identifier of the venue. */
     foursquareId?: string;
-    /** Foursquare type of the venue. (For example, "arts_entertainment/default", "arts_entertainment/aquarium" or "food/icecream".) */
+    /** The Foursquare type of the venue. */
     foursquareType?: string;
 }
 export declare function constructVenue(media_: types.MessageMediaVenue): Venue;

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

@@ -1,15 +1,15 @@
 import { types } from "../2_tl.js";
-/** This object represents a voice note. */
+/** A voice note. */
 export interface Voice {
-    /** Identifier for this file, which can be used to download or reuse the file */
+    /** A file identifier that can be used to download or reuse this file. */
     fileId: string;
-    /** Unique identifier for this file, which is supposed to be the same over time and for different users and bots. Can't be used to download or reuse the file. */
+    /** A file identifier that can be used to identify this file. */
     fileUniqueId: string;
-    /** Duration of the audio in seconds as defined by sender */
+    /** Duration of the audio in seconds. */
     duration: number;
-    /** MIME type of the file as defined by sender */
+    /** MIME type of the file. */
     mimeType: string;
-    /** File size in bytes */
+    /** Size of the file in bytes. */
     fileSize: number;
 }
 export declare function constructVoice(document: types.Document, audioAttributes: types.DocumentAttributeAudio, fileId: string, fileUniqueId: string): Voice;

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

@@ -1,6 +1,5 @@
-/** Describes a Web App */
 export interface WebAppInfo {
-    /** An HTTPS URL of a Web App to be opened with additional data */
+    /** An HTTPS URL of the Web App to be opened with additional data. */
     url: string;
 }
 export declare function constructWebAppInfo(url: string): WebAppInfo;

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

@@ -2,23 +2,23 @@ import { types } from "../2_tl.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 */
+    /** A file identifier that can be used to download or reuse this file. */
     fileId: string;
-    /** Unique identifier for this file, which is supposed to be the same over time and for different users and bots. Can't be used to download or reuse the file. */
+    /** A file identifier that can be used to identify this file. */
     fileUniqueId: string;
-    /** Video width as defined by sender */
+    /** The width of the animation. */
     width: number;
-    /** Video height as defined by sender */
+    /** The height of the animation. */
     height: number;
-    /** Duration of the video in seconds as defined by sender */
+    /** Duration of the animation in seconds. */
     duration: number;
-    /** Animation thumbnail as defined by sender */
+    /** Thumbnails of the animation. */
     thumbnails: Thumbnail[];
-    /** Original animation filename as defined by sender */
+    /** The original file name. */
     fileName?: string;
-    /** MIME type of the file as defined by sender */
+    /** MIME type of the file. */
     mimeType: string;
-    /** File size in bytes */
+    /** Size of the file in bytes. */
     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

@@ -5,82 +5,77 @@ import { RestrictionReason } from "./0_restriction_reason.js";
 export type ChatType = "private" | "group" | "supergroup" | "channel";
 export declare namespace Chat {
     interface Base {
-        /** Type of chat, can be either "private", "group", "supergroup" or "channel" */
+        /** The type of the chat. */
         type: ChatType;
-        /** Unique identifier for this chat */
+        /** The identifier of the chat. */
         id: number;
+        /** A color that can be displayed instead of the chat's photo. */
         color: Color;
-        /** Chat photo. */
+        /** The chat's photo. */
         photo?: ChatPhoto;
     }
     interface Private extends Base {
         type: "private";
-        /** True, if this user is a bot */
+        /** Whether this is a bot's chat. */
         isBot?: boolean;
-        /** First name of the other party in a private chat */
+        /** The first name of the user. */
         firstName: string;
-        /** Last name of the other party in a private chat */
+        /** The last name of the user. */
         lastName?: string;
-        /** Username, for private chats, supergroups and channels if available */
+        /** The user's main username. */
         username?: string;
-        /** Additional usernames */
+        /** The user's other usernames. */
         also?: string[];
-        /** Chat photo. */
+        /** The user's profile photo. */
         photo?: ChatPhoto.User;
-        /** True, if the user is a scam user */
+        /** Whether the user has been identified as scam. */
         isScam: boolean;
-        /** True, if this user was reported by many users as a fake or scam user: be careful when interacting with them. */
+        /** Whether the user has been identified as an impersonator. */
         isFake: boolean;
-        /** True, if the user is an official support user */
+        /** Whether the user is official support. */
         isSupport: boolean;
-        /** True, if the user is verified */
+        /** Whether the user has been verified. */
         isVerified: boolean;
-        /** True, if the access to the user must be restricted for the reason specified in `restriction_reason` */
+        /** Whether the user has been restricted. */
         isRestricted?: boolean;
-        /** Contains the reason why access to the user must be restricted. */
+        /** The reason why the user has been restricted. */
         restrictionReason?: RestrictionReason[];
     }
     interface Group extends Base {
         type: "group";
-        /** Title, for supergroups, channels and group chats */
+        /** The title of the chat. */
         title: string;
-        /** Chat photo. */
+        /** The chat's photo. */
         photo?: ChatPhoto.Chat;
-        /** True, if the user is creator of the chat */
+        /** Whether the current user is the owner of the chat. */
         isCreator: boolean;
     }
     interface ChannelBase extends Base {
-        /** Title, for supergroups, channels and group chats */
+        /** The title of the chat or channel. */
         title: string;
-        /** Username, for private chats, supergroups and channels if available */
+        /** The main username of the chat or channel. */
         username?: string;
-        /** Additional usernames */
+        /** The other usernames of the chat or channel. */
         also?: string[];
-        /** Chat photo. */
+        /** The chat or channel's photo. */
         photo?: ChatPhoto.Chat;
-        /** True, if the user is a scam user */
+        /** Whether the chat or channel has been identified as scam. */
         isScam: boolean;
-        /** True, if this user was reported by many users as a fake or scam user: be careful when interacting with them. */
+        /** Whether the chat or channel has been identified as an impersonator. */
         isFake: boolean;
-        /** True, if the user is verified */
+        /** Whether the chat or channel has been verified. */
         isVerified: boolean;
-        /** True, if the access to the user must be restricted for the reason specified in `restriction_reason` */
+        /** Whether the chat or channel has been restricted. */
         isRestricted: boolean;
-        /** Contains the reason why access to the user must be restricted. */
+        /** The reason why the chat or channel has been restricted. */
         restrictionReason?: RestrictionReason[];
     }
     interface Channel extends ChannelBase {
         type: "channel";
-        /** Title, for supergroups, channels and group chats */
-        title: string;
-        /** Username, for private chats, supergroups and channels if available */
-        username?: string;
-        /** Additional usernames */
-        also?: string[];
     }
     interface Supergroup extends ChannelBase {
         type: "supergroup";
-        /** True, if the supergroup chat is a forum (has [topics](https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups) enabled) */
+        /** Whether the chat is a forum. */
         isForum: boolean;
     }
 }