@mtkruto/node 0.0.957 → 0.0.960

package/esm/storage/1_storage_local_storage.js

@@ -1,4 +1,5 @@
 import { Storage } from "./0_storage.js";
+import { fromString, toString } from "./0_utilities.js";
 export class StorageLocalStorage extends Storage {
     constructor(prefix) {
         if (typeof localStorage === "undefined") {
@@ -20,14 +21,20 @@ export class StorageLocalStorage extends Storage {
     }
     init() {
     }
-    get(key) {
-        key = this.prefix + key;
-        return localStorage.getItem(key);
+    get(key_) {
+        const key = this.prefix + toString(key_);
+        const value = localStorage.getItem(key);
+        if (value != null) {
+            return fromString(value);
+        }
+        else {
+            return null;
+        }
     }
-    set(key, value) {
-        key = this.prefix + key;
+    set(key_, value) {
+        const key = this.prefix + toString(key_);
         if (value != null) {
-            localStorage.setItem(key, value);
+            localStorage.setItem(key, toString(value));
         }
         else {
             localStorage.removeItem(key);

package/esm/storage/1_storage_memory.d.ts

@@ -1,8 +1,8 @@
 import { MaybePromise } from "../utilities/0_types.js";
-import { Storage } from "./0_storage.js";
+import { Storage, StorageKeyPart } from "./0_storage.js";
 export declare class StorageMemory extends Storage implements Storage {
-    protected map: Map<string, string>;
+    protected map: Map<string, unknown>;
     init(): void;
-    get(key: string): string | null;
-    set(key: string, value: string | null): MaybePromise<void>;
+    get<T>(key: readonly StorageKeyPart[]): NonNullable<T> | null;
+    set(key_: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
 }

package/esm/storage/1_storage_memory.js

@@ -1,4 +1,5 @@
 import { Storage } from "./0_storage.js";
+import { toString } from "./0_utilities.js";
 export class StorageMemory extends Storage {
     constructor() {
         super(...arguments);
@@ -12,9 +13,10 @@ export class StorageMemory extends Storage {
     init() {
     }
     get(key) {
-        return this.map.get(key) ?? null;
+        return this.map.get(toString(key)) ?? null;
     }
-    set(key, value) {
+    set(key_, value) {
+        const key = toString(key_);
         if (value != null) {
             this.map.set(key, value);
         }

package/esm/storage/1_storage_session_storage.d.ts

@@ -1,9 +1,9 @@
 import { MaybePromise } from "../utilities/0_types.js";
-import { Storage } from "./0_storage.js";
+import { Storage, StorageKeyPart } from "./0_storage.js";
 export declare class StorageSessionStorage extends Storage implements Storage {
     private readonly prefix;
     constructor(prefix: string);
     init(): void;
-    get(key: string): string | null;
-    set(key: string, value: string | null): MaybePromise<void>;
+    get(key_: readonly StorageKeyPart[]): any;
+    set(key_: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
 }

package/esm/storage/1_storage_session_storage.js

@@ -1,4 +1,5 @@
 import { Storage } from "./0_storage.js";
+import { fromString, toString } from "./0_utilities.js";
 export class StorageSessionStorage extends Storage {
     constructor(prefix) {
         if (typeof sessionStorage === "undefined") {
@@ -20,14 +21,20 @@ export class StorageSessionStorage extends Storage {
     }
     init() {
     }
-    get(key) {
-        key = this.prefix + key;
-        return sessionStorage.getItem(key);
+    get(key_) {
+        const key = this.prefix + toString(key_);
+        const value = sessionStorage.getItem(key);
+        if (value != null) {
+            return fromString(value);
+        }
+        else {
+            return null;
+        }
     }
-    set(key, value) {
-        key = this.prefix + key;
+    set(key_, value) {
+        const key = this.prefix + toString(key_);
         if (value != null) {
-            sessionStorage.setItem(key, value);
+            sessionStorage.setItem(key, toString(value));
         }
         else {
             sessionStorage.removeItem(key);

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;

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

@@ -8,34 +8,34 @@ export declare namespace InlineKeyboardButton {
         text: string;
     }
     interface URL extends Base {
-        /** Optional. HTTP or tg:// URL to be opened when the button is pressed. Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings. */
+        /** HTTP or tg:// URL to be opened when the button is pressed. Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings. */
         url: string;
     }
     interface Callback extends Base {
-        /** Optional. Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
+        /** Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
         callbackData: string;
     }
     interface WebApp extends Base {
-        /** Optional. Description of the [Web App](https://core.telegram.org/bots/webapps) that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Available only in private chats between a user and the bot. */
+        /** Description of the [Web App](https://core.telegram.org/bots/webapps) that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Available only in private chats between a user and the bot. */
         webApp: WebAppInfo;
     }
     interface Login extends Base {
-        /** Optional. An HTTPS URL used to automatically authorize the user. Can be used as a replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login). */
+        /** An HTTPS URL used to automatically authorize the user. Can be used as a replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login). */
         loginUrl: LoginUrl;
     }
     interface SwitchInline extends Base {
-        /** Optional. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. */
+        /** If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. */
         switchInlineQuery: string;
     }
     interface SwitchInlineCurrent extends Base {
-        /** Optional. If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted. */
+        /** If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted. */
         switchInlineQueryCurrentChat: string;
     }
     interface Game extends Base {
         callbackGame: Record<never, never>;
     }
     interface Pay extends Base {
-        /** Optional. Specify True, to send a [Pay button](https://core.telegram.org/bots/api#payments). */
+        /** Specify True, to send a [Pay button](https://core.telegram.org/bots/api#payments). */
         pay: boolean;
     }
 }

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

@@ -9,52 +9,52 @@ export declare namespace KeyboardButton {
     }
     /** This object defines the criteria used to request a suitable user. The identifier of the selected user will be shared with the bot when the corresponding button is pressed. [More about requesting users](https://core.telegram.org/bots/features#chat-and-user-selection) */
     interface RequestUser extends Text {
-        /** Optional. If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a “user_shared” service message. Available in private chats only. */
+        /** If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a “user_shared” service message. Available in private chats only. */
         requestUser: {
             /** Signed 32-bit identifier of the request, which will be received back in the [UserShared](https://core.telegram.org/bots/api#usershared) object. Must be unique within the message */
             requestId: number;
-            /** Optional. Pass True to request a bot, pass False to request a regular user. If not specified, no additional restrictions are applied. */
+            /** Pass True to request a bot, pass False to request a regular user. If not specified, no additional restrictions are applied. */
             userIsBot?: boolean;
-            /** Optional. Pass True to request a premium user, pass False to request a non-premium user. If not specified, no additional restrictions are applied. */
+            /** Pass True to request a premium user, pass False to request a non-premium user. If not specified, no additional restrictions are applied. */
             userIsPremium?: boolean;
         };
     }
     /** This object defines the criteria used to request a suitable chat. The identifier of the selected chat will be shared with the bot when the corresponding button is pressed. [More about requesting chats](https://core.telegram.org/bots/features#chat-and-user-selection) */
     interface RequestChat extends Text {
-        /** Optional. If specified, pressing the button will open a list of suitable chats. Tapping on a chat will send its identifier to the bot in a “chat_shared” service message. Available in private chats only. */
+        /** If specified, pressing the button will open a list of suitable chats. Tapping on a chat will send its identifier to the bot in a “chat_shared” service message. Available in private chats only. */
         requestChat: {
             /** Signed 32-bit identifier of the request, which will be received back in the [ChatShared](https://core.telegram.org/bots/api#chatshared) object. Must be unique within the message */
             requestId: number;
             /** Pass True to request a channel chat, pass False to request a group or a supergroup chat. */
             chatIsChannel: boolean;
-            /** Optional. Pass True to request a forum supergroup, pass False to request a non-forum chat. If not specified, no additional restrictions are applied. */
+            /** Pass True to request a forum supergroup, pass False to request a non-forum chat. If not specified, no additional restrictions are applied. */
             chatIsForum?: boolean;
-            /** Optional. Pass True to request a supergroup or a channel with a username, pass False to request a chat without a username. If not specified, no additional restrictions are applied. */
+            /** Pass True to request a supergroup or a channel with a username, pass False to request a chat without a username. If not specified, no additional restrictions are applied. */
             chatHasUsername?: boolean;
-            /** Optional. Pass True to request a chat owned by the user. Otherwise, no additional restrictions are applied. */
+            /** Pass True to request a chat owned by the user. Otherwise, no additional restrictions are applied. */
             chatIsCreated?: boolean;
-            /** Optional. A JSON-serialized object listing the required administrator rights of the user in the chat. The rights must be a superset of _bot_administrator_rights_. If not specified, no additional restrictions are applied. */
+            /** A JSON-serialized object listing the required administrator rights of the user in the chat. The rights must be a superset of _bot_administrator_rights_. If not specified, no additional restrictions are applied. */
             userAdministratorRights?: ChatAdministratorRights;
-            /** Optional. A JSON-serialized object listing the required administrator rights of the bot in the chat. The rights must be a subset of _user_administrator_rights_. If not specified, no additional restrictions are applied. */
+            /** A JSON-serialized object listing the required administrator rights of the bot in the chat. The rights must be a subset of _user_administrator_rights_. If not specified, no additional restrictions are applied. */
             botAdministratorRights?: ChatAdministratorRights;
-            /** Optional. Pass True to request a chat with the bot as a member. Otherwise, no additional restrictions are applied. */
+            /** Pass True to request a chat with the bot as a member. Otherwise, no additional restrictions are applied. */
             botIsMember?: boolean;
         };
     }
     interface RequestContact extends Text {
-        /** Optional. If True, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only. */
+        /** If True, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only. */
         requestContact: true;
     }
     interface RequestLocation extends Text {
-        /** Optional. If True, the user's current location will be sent when the button is pressed. Available in private chats only. */
+        /** If True, the user's current location will be sent when the button is pressed. Available in private chats only. */
         requestLocation: true;
     }
     interface RequestPoll extends Text {
-        /** Optional. If specified, the user will be asked to create a poll and send it to the bot when the button is pressed. Available in private chats only. */
+        /** If specified, the user will be asked to create a poll and send it to the bot when the button is pressed. Available in private chats only. */
         requestPoll: KeyboardButtonPollType;
     }
     interface WebApp extends Text {
-        /** Optional. If specified, the described [Web App](https://core.telegram.org/bots/webapps) will be launched when the button is pressed. The Web App will be able to send a “web_app_data” service message. Available in private chats only. */
+        /** If specified, the described [Web App](https://core.telegram.org/bots/webapps) will be launched when the button is pressed. The Web App will be able to send a “web_app_data” service message. Available in private chats only. */
         webApp: WebAppInfo;
     }
 }

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

@@ -1,5 +1,6 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a photo. */
 export interface Photo {
     /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
@@ -9,7 +10,7 @@ export interface Photo {
     width: number;
     /** Photo height */
     height: number;
-    /** Optional. File size in bytes */
+    /** File size in bytes */
     fileSize: number;
     thumbnails: Thumbnail[];
 }