@telegram.ts/types 1.25.1 → 1.26.0

package/README.md

@@ -1,4 +1,4 @@
-[![Bot API](https://img.shields.io/badge/Bot%20API-v.9.2-00aced.svg?style=flat-square&logo=telegram)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-v.9.4-00aced.svg?style=flat-square&logo=telegram)](https://core.telegram.org/bots/api)
 [![NPM Version](https://img.shields.io/npm/v/@telegram.ts/types.svg?maxAge=3600)](https://www.npmjs.com/package/@telegram.ts/types)
 [![NPM Downloads](https://img.shields.io/npm/dt/@telegram.ts/types.svg?maxAge=3600)](https://www.npmjs.com/package/@telegram.ts/types)
 

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@telegram.ts/types",
-  "version": "1.25.1",
+  "version": "1.26.0",
   "description": "Comprehensive Type Declarations for Telegram Bot API with telegramsjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "keywords": [
     "telegramsjs",
     "telegram",
+    "telegram.ts",
     "telegramapi",
     "api",
     "bot",

package/src/apiMethodsTypes.d.ts

@@ -22,6 +22,7 @@ import type {
   UserFromGetMe,
   UserProfilePhotos,
   WebhookInfo,
+  UserProfileAudios,
 } from "./manageTypes";
 import type {
   ForceReply,
@@ -1025,6 +1026,16 @@ export type ApiMethods = {
     limit?: number;
   }): UserProfilePhotos;
 
+  /** Use this method to get a list of profile audios for a user. Returns a UserProfileAudios object. */
+  getUserProfileAudios(args: {
+    /** Unique identifier of the target user */
+    user_id: number;
+    /** Sequential number of the first audio to be returned. By default, all audios are returned. */
+    offset?: number;
+    /** Limits the number of audios to be retrieved. Values between 1-100 are accepted. Defaults to 100. */
+    limit?: number;
+  }): UserProfileAudios;
+
   /** Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess. Returns True on success. */
   setUserEmojiStatus(args: {
     /** Unique identifier of the target user */
@@ -1365,7 +1376,8 @@ export type ApiMethods = {
 
   /** Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user. Requires no parameters. Returns an Array of Sticker objects. */
   getForumTopicIconStickers(): Sticker[];
-  /** Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a ForumTopic object. */
+
+  /** Use this method to create a topic in a forum supergroup chat or a private chat with a user. In the case of a supergroup chat the bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator right. Returns information about the created topic as a ForumTopic object. */
   createForumTopic(args: {
     /** Unique identifier for the target chat or username of the target supergroup (in the format `@supergroupusername`) */
     chat_id: number | string;
@@ -1613,6 +1625,15 @@ export type ApiMethods = {
     language_code?: LanguageCode;
   }): BotShortDescription;
 
+  /** Changes the profile photo of the bot. Returns True on success. */
+  setMyProfilePhoto(args: {
+    /** The new profile photo to set */
+    photo: InputProfilePhoto;
+  }): true;
+
+  /** Removes the profile photo of the bot. Requires no parameters. Returns True on success. */
+  removeMyProfilePhoto(): true;
+
   /** Use this method to change the bot's menu button in a private chat, or the default menu button. Returns True on success. */
   setChatMenuButton(args: {
     /** Unique identifier for the target private chat. If not specified, default bot's menu button will be changed */

package/src/invoiceTypes.d.ts

@@ -357,8 +357,10 @@ export interface UniqueGiftModel {
   name: string;
   /** The sticker that represents the unique gift */
   sticker: Sticker;
-  /** The number of unique gifts that receive this model for every 1000 gifts upgraded */
+  /** The number of unique gifts that receive this model for every 1000 gift upgrades. Always 0 for crafted gifts. */
   rarity_per_mille: number;
+  /** Rarity of the model if it is a crafted model. Currently, can be “uncommon”, “rare”, “epic”, or “legendary”. */
+  rarity?: "uncommon" | "rare" | "epic" | "legendary";
 }
 
 /** This object describes the symbol shown on the pattern of a unique gift. */
@@ -417,6 +419,8 @@ export interface UniqueGift {
   backdrop: UniqueGiftBackdrop;
   /** The color scheme that can be used by the gift's owner for the chat's name, replies to messages and link previews */
   colors?: UniqueGiftColors;
+  /** True, if the gift was used to craft another gift and isn't available anymore */
+  is_burned?: true;
 }
 
 /** This object contains information about the color scheme for a user's name, message replies and link previews based on a unique gift. */

package/src/manageTypes.d.ts

@@ -1,4 +1,5 @@
 import type {
+  Audio,
   Location,
   Message,
   PhotoSize,
@@ -58,7 +59,7 @@ export interface User {
   /** User's or bot's username */
   username?: string;
   /** IETF language tag of the user's language */
-  language_code?: LanguageCode;
+  language_code?: string;
   /** True, if this user is a Telegram Premium user */
   is_premium?: true;
   /** True, if this user added the bot to the attachment menu */
@@ -80,7 +81,21 @@ export interface UserFromGetMe extends User {
   /** True, if the bot has main Web App. Returned only in getMe. */
   has_main_web_app: boolean;
   /** True, if the bot has forum topic mode enabled in private chats. Returned only in getMe. */
-  has_topics_enabled?: boolean;
+  has_topics_enabled: boolean;
+  /** True, if the bot allows users to create and delete topics in private chats. Returned only in getMe. */
+  allows_users_to_create_topics: boolean;
+}
+
+/** Describes a service message about the chat owner leaving the chat. */
+export interface ChatOwnerLeft {
+  /** The user which will be the new owner of the chat if the previous owner does not return to the chat */
+  new_owner?: User;
+}
+
+/** Describes a service message about an ownership change in the chat. */
+export interface ChatOwnerChanged {
+  /** The new owner of the chat */
+  new_owner: User;
 }
 
 /** This object describes the rating of a user based on their Telegram Star spendings. */
@@ -206,6 +221,8 @@ export declare namespace ChatFullInfo {
     max_reaction_count: number;
     /** Chat photo */
     photo?: ChatPhoto;
+    /** For private chats, the first audio added to the profile of the user */
+    first_profile_audio?: Audio;
     /** If non-empty, the list of all active chat usernames; for private chats, supergroups and channels */
     active_usernames?: string[];
     /** For private chats, the date of birth of the user */
@@ -307,6 +324,8 @@ export declare namespace ChatFullInfo {
     max_reaction_count: number;
     /** Chat photo */
     photo?: ChatPhoto;
+    /** For private chats, the first audio added to the profile of the user */
+    first_profile_audio?: undefined;
     /** If non-empty, the list of all active chat usernames; for private chats, supergroups and channels */
     active_usernames?: undefined;
     /** For private chats, the date of birth of the user */
@@ -408,6 +427,8 @@ export declare namespace ChatFullInfo {
     max_reaction_count: number;
     /** Chat photo */
     photo?: ChatPhoto;
+    /** For private chats, the first audio added to the profile of the user */
+    first_profile_audio?: undefined;
     /** If non-empty, the list of all active chat usernames; for private chats, supergroups and channels */
     active_usernames?: string[];
     /** For private chats, the date of birth of the user */
@@ -509,6 +530,8 @@ export declare namespace ChatFullInfo {
     max_reaction_count: number;
     /** Chat photo */
     photo?: ChatPhoto;
+    /** For private chats, the first audio added to the profile of the user */
+    first_profile_audio?: undefined;
     /** If non-empty, the list of all active chat usernames; for private chats, supergroups and channels */
     active_usernames?: string[];
     /** For private chats, the date of birth of the user */
@@ -605,6 +628,14 @@ export interface UserProfilePhotos {
   photos: PhotoSize[][];
 }
 
+/** This object represents the audios displayed on a user's profile. */
+export interface UserProfileAudios {
+  /** Total number of profile audios for the target user */
+  total_count: number;
+  /** Requested profile audios */
+  audios: Audio[];
+}
+
 /** This object represents a chat photo. */
 export interface ChatPhoto {
   /** 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. */

package/src/markupTypes.d.ts

@@ -8,9 +8,13 @@ export interface InlineKeyboardMarkup {
 }
 
 export declare namespace InlineKeyboardButton {
-  interface AbstractInlineKeyboardButton {
+  export interface AbstractInlineKeyboardButton {
     /** Label text on the button */
     text: string;
+    /** Unique identifier of the custom emoji shown before the text of the button. Can only be used by bots that purchased additional usernames on Fragment or in the messages directly sent by the bot to private, group and supergroup chats if the owner of the bot has a Telegram Premium subscription. */
+    icon_custom_emoji_id?: string;
+    /** Style of the button. Must be one of “danger” (red), “success” (green) or “primary” (blue). If omitted, then an app-specific style is used. */
+    style?: "danger" | "success" | "primary";
   }
   export interface UrlButton extends AbstractInlineKeyboardButton {
     /** 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. */
@@ -60,7 +64,7 @@ export declare namespace InlineKeyboardButton {
   }
 }
 
-/** This object represents one button of an inline keyboard. You must use exactly one of the optional fields. */
+/** This object represents one button of an inline keyboard. Exactly one of the fields other than text, icon_custom_emoji_id, and style must be used to specify the type of the button. */
 export type InlineKeyboardButton =
   | InlineKeyboardButton.CallbackButton
   | InlineKeyboardButton.GameButton
@@ -145,8 +149,12 @@ export interface ReplyKeyboardMarkup {
 
 export declare namespace KeyboardButton {
   export interface CommonButton {
-    /** Text of the button. If none of the optional fields are used, it will be sent as a message when the button is pressed */
+    /** Text of the button. If none of the fields other than text, icon_custom_emoji_id, and style are used, it will be sent as a message when the button is pressed */
     text: string;
+    /** Unique identifier of the custom emoji shown before the text of the button. Can only be used by bots that purchased additional usernames on Fragment or in the messages directly sent by the bot to private, group and supergroup chats if the owner of the bot has a Telegram Premium subscription. */
+    icon_custom_emoji_id?: string;
+    /** Style of the button. Must be one of “danger” (red), “success” (green) or “primary” (blue). If omitted, then an app-specific style is used. */
+    style?: "danger" | "success" | "primary";
   }
   export interface RequestUsersButton extends CommonButton {
     /** If specified, pressing the button will open a list of suitable users. Identifiers of selected users will be sent to the bot in a “users_shared” service message. Available in private chats only. */
@@ -174,7 +182,7 @@ export declare namespace KeyboardButton {
   }
 }
 
-/** This object represents one button of the reply keyboard. At most one of the optional fields must be used to specify type of the button. For simple text buttons, String can be used instead of this object to specify the button text. */
+/** This object represents one button of the reply keyboard. At most one of the fields other than text, icon_custom_emoji_id, and style must be used to specify the type of the button. For simple text buttons, String can be used instead of this object to specify the button text. */
 export type KeyboardButton =
   | KeyboardButton.CommonButton
   | KeyboardButton.RequestUsersButton

package/src/messageTypes.d.ts

@@ -1,4 +1,3 @@
-import type { Chat, User } from "./manageTypes";
 import type { InlineKeyboardMarkup } from "./markupTypes";
 import type { PassportData } from "./passportTypes";
 import type { LanguageCode } from "./languageTypes";
@@ -7,6 +6,12 @@ import type {
   ChecklistTasksAdded,
   ChecklistTasksDone,
 } from "./checkListTask";
+import type {
+  Chat,
+  ChatOwnerChanged,
+  ChatOwnerLeft,
+  User,
+} from "./manageTypes";
 import type {
   GiftInfo,
   Invoice,
@@ -139,6 +144,10 @@ export declare namespace Message {
     MsgWith<"suggested_post_paid">;
   export type SuggestedPostRefundedMessage = ServiceMessage &
     MsgWith<"suggested_post_refunded">;
+  export type ChatOwnerLeftMessage = ServiceMessage &
+    MsgWith<"chat_owner_left">;
+  export type ChatOwnerChangedMessage = ServiceMessage &
+    MsgWith<"chat_owner_changed">;
   export type NewChatMembersMessage = ServiceMessage &
     MsgWith<"new_chat_members">;
   export type LeftChatMemberMessage = ServiceMessage &
@@ -270,6 +279,10 @@ export interface Message extends Message.MediaMessage {
   suggested_post_paid?: SuggestedPostPaid;
   /** Service message: payment for a suggested post was refunded */
   suggested_post_refunded?: SuggestedPostRefunded;
+  /** Service message: chat owner has left */
+  chat_owner_left?: ChatOwnerLeft;
+  /** Service message: chat owner has changed */
+  chat_owner_changed?: ChatOwnerChanged;
   /** New members that were added to the group or supergroup and information about them (the bot itself may be one of these members) */
   new_chat_members?: User[];
   /** A member was removed from the group, information about them (this member may be the bot itself) */
@@ -804,6 +817,24 @@ export interface Video {
   mime_type?: string;
   /** File size in bytes */
   file_size?: number;
+  /** List of available qualities of the video. */
+  qualities?: VideoQuality[];
+}
+
+/** This object represents a video file of a specific quality. */
+export interface VideoQuality {
+  /** Identifier for this file, which can be used to download or reuse the file */
+  file_id: 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. */
+  file_unique_id: string;
+  /** Video width */
+  width: number;
+  /** Video height */
+  height: number;
+  /** Codec that was used to encode the video, for example, “h264”, “h265”, or “av01” */
+  codec: 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. */
+  file_size?: number;
 }
 
 /** This object represents a video message (available in Telegram apps as of v.4.0). */