@telegram.ts/types 1.20.0 → 1.21.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telegram.ts/types",
-  "version": "1.20.0",
+  "version": "1.21.1",
   "description": "Comprehensive Type Declarations for Telegram Bot API with telegramsjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",

package/src/apiMethodsTypes.d.ts

@@ -170,6 +170,8 @@ export type ApiMethods = {
     message_thread_id?: number;
     /** Unique identifier for the chat where the original message was sent (or channel username in the format @channelusername) */
     from_chat_id: number | string;
+    /** New start timestamp for the copied video in the message */
+    video_start_timestamp?: number;
     /** Sends the message silently. Users will receive a notification with no sound. */
     disable_notification?: boolean;
     /** Protects the contents of the forwarded message from forwarding and saving */
@@ -202,6 +204,8 @@ export type ApiMethods = {
     message_thread_id?: number;
     /** Unique identifier for the chat where the original message was sent (or channel username in the format @channelusername) */
     from_chat_id: number | string;
+    /** New start timestamp for the copied video in the message */
+    video_start_timestamp?: number;
     /** Message identifier in the chat specified in from_chat_id */
     message_id: number;
     /** New caption for media, 0-1024 characters after entities parsing. If not specified, the original caption is kept */
@@ -384,6 +388,10 @@ export type ApiMethods = {
     height?: number;
     /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
     thumbnail?: Buffer | ReadStream | string;
+    /** Cover for the video in the message. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. */
+    cover?: Buffer | ReadStream | string;
+    /** Start timestamp for the video in the message */
+    start_timestamp?: number;
     /** Video caption (may also be used when resending videos by file_id), 0-1024 characters after entities parsing */
     caption?: string;
     /** Mode for parsing entities in the video caption. See formatting options for more details. */
@@ -859,7 +867,7 @@ export type ApiMethods = {
     message_thread_id?: number;
   }): true;
 
-  /** Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns True on success. */
+  /** Use this method to change the chosen reactions on a message. Service messages of some types can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns True on success. */
   setMessageReaction(args: {
     /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id: number | string;
@@ -1703,13 +1711,15 @@ export type ApiMethods = {
     custom_emoji_id?: string;
   }): true;
 
-  /** Returns the list of gifts that can be sent by the bot to users. Requires no parameters. Returns a Gifts object. */
+  /** Returns the list of gifts that can be sent by the bot to users and chennel chats. Requires no parameters. Returns a Gifts object. */
   getAvailableGifts(): Gifts;
 
-  /** Sends a gift to the given user. The gift can't be converted to Telegram Stars by the user. Returns True on success. */
+  /** Sends a gift to the given user or channel chat. The gift can't be converted to Telegram Stars by the receiver. Returns True on success. */
   sendGift(args: {
-    /** Unique identifier of the target user that will receive the gift */
-    user_id: number;
+    /** Required if chat_id is not specified. Unique identifier of the target user who will receive the gift. */
+    user_id?: number;
+    /** Required if user_id is not specified. Unique identifier for the chat or username of the channel (in the format @channelusername) that will receive the gift. */
+    chat_id?: number | string;
     /** Identifier of the gift */
     gift_id: string;
     /** Pass True to pay for the gift upgrade from the bot's balance, thereby making the upgrade free for the receiver */
@@ -1921,7 +1931,7 @@ export type ApiMethods = {
     ok: boolean;
     /** Required if ok is True. An array of available shipping options. */
     shipping_options?: readonly ShippingOption[];
-    /** Required if ok is False. Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable'). Telegram will display this message to the user. */
+    /** Required if ok is False. Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable"). Telegram will display this message to the user. */
     error_message?: string;
   }): true;
 
@@ -2071,6 +2081,10 @@ export interface InputMediaVideo {
   media: Buffer | ReadStream | string;
   /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
   thumbnail?: Buffer | ReadStream | string;
+  /** Cover for the video in the message. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. */
+  cover?: Buffer | ReadStream | string;
+  /** Start timestamp for the video in the message */
+  start_timestamp?: number;
   /** Caption of the video to be sent, 0-1024 characters after entities parsing */
   caption?: string;
   /** Pass True, if the caption must be shown above the message media */
@@ -2178,6 +2192,10 @@ export interface InputPaidMediaVideo {
   media: Buffer | ReadStream | string;
   /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files » */
   thumbnail?: Buffer | ReadStream | string;
+  /** Cover for the video in the message. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. */
+  cover?: Buffer | ReadStream | string;
+  /** Start timestamp for the video in the message */
+  start_timestamp?: number;
   /** Video width */
   width?: number;
   /** Video height */

package/src/invoiceTypes.d.ts

@@ -178,6 +178,7 @@ export interface AffiliateInfo {
 /** This object describes the source of a transaction, or its recipient for outgoing transactions. Currently, it can be one of
 
 - TransactionPartnerUser
+- TransactionPartnerChat
 - TransactionPartnerFragment
 - TransactionPartnerAffiliateProgram
 - TransactionPartnerTelegramAds
@@ -185,6 +186,7 @@ export interface AffiliateInfo {
 - TransactionPartnerOther */
 export type TransactionPartner =
   | TransactionPartnerUser
+  | TransactionPartnerChat
   | TransactionPartnerFragment
   | TransactionPartnerAffiliateProgram
   | TransactionPartnerTelegramAds
@@ -208,7 +210,17 @@ export interface TransactionPartnerUser {
   /** Bot-specified paid media payload */
   paid_media_payload?: string;
   /** The gift sent to the user by the bot */
-  gift?: string;
+  gift?: Gift;
+}
+
+/** Describes a transaction with a chat. */
+export interface TransactionPartnerChat {
+  /** Type of the transaction partner, always “chat” */
+  type: "chat";
+  /** Information about the chat */
+  chat: Chat;
+  /** The gift sent to the chat by the bot */
+  gift?: Gift;
 }
 
 /** Describes the affiliate program that issued the affiliate commission received via this transaction. */

package/src/messageTypes.d.ts

@@ -712,6 +712,10 @@ export interface Video {
   duration: number;
   /** Video thumbnail */
   thumbnail?: PhotoSize;
+  /** Available sizes of the cover of the video in the message */
+  cover?: PhotoSize[];
+  /** Timestamp in seconds from which the video will play in the message */
+  start_timestamp?: number;
   /** Original filename as defined by sender */
   file_name?: string;
   /** MIME type of the file as defined by sender */