merge: #9 from telegraf/feat/api-8.3

Author: MKRhere

methods.ts

@@ -180,6 +180,8 @@ export type ApiMethods<F> = {
     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 forwarded 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 */
@@ -214,6 +216,8 @@ export type ApiMethods<F> = {
     from_chat_id: number | string;
     /** Message identifier in the chat specified in from_chat_id */
     message_id: number;
+    /** New start timestamp for the copied video in the message */
+    video_start_timestamp?: number;
     /** New caption for media, 0-1024 characters after entities parsing. If not specified, the original caption is kept */
     caption?: string;
     /** Mode for parsing entities in the new caption. See formatting options for more details. */
@@ -832,7 +836,7 @@ export type ApiMethods<F> = {
       | "upload_video_note";
   }): 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. Bots can't use paid reactions. 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. Bots can't use paid reactions. 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;
@@ -1730,13 +1734,15 @@ export type ApiMethods<F> = {
     name: 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 channel 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 */
@@ -2099,6 +2105,10 @@ export interface InputMediaVideo<F> {
   media: F | 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. Thumbnails can't be reused and can be only uploaded as a new file. Use Telegraf's [Input helpers](https://telegraf.js.org/modules/Input.html) to upload a new thumbnail. */
   thumbnail?: F;
+  /** 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 use Telegraf's [Input helpers](https://telegraf.js.org/modules/Input.html) to upload a new one. */
+  cover?: F | 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;
   /** Mode for parsing entities in the video caption. See formatting options for more details. */
@@ -2208,6 +2218,10 @@ export interface InputPaidMediaVideo<F> {
   media: F | 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. Thumbnails can't be reused and can be only uploaded as a new file. Use Telegraf's [Input helpers](https://telegraf.js.org/modules/Input.html) to upload a new thumbnail. */
   thumbnail?: F | 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 use Telegraf's [Input helpers](https://telegraf.js.org/modules/Input.html) to upload a new one. */
+  cover?: F | string;
+  /** Start timestamp for the video in the message */
+  start_timestamp?: number;
   /** Video width */
   width?: number;
   /** Video height */

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@telegraf/types",
   "private": false,
-  "version": "8.2.0",
+  "version": "8.3.0",
   "description": "Type declarations for the Telegram API",
   "main": "index.js",
   "repository": {

payment.ts

@@ -186,13 +186,15 @@ 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
 - TransactionPartnerAffiliateProgram
 - TransactionPartnerFragment
 - TransactionPartnerTelegramAds
 - TransactionPartnerTelegramApi
 - TransactionPartnerOther */
 export type TransactionPartner =
   | TransactionPartnerUser
+  | TransactionPartnerChat
   | TransactionPartnerAffiliateProgram
   | TransactionPartnerFragment
   | TransactionPartnerTelegramAds
@@ -219,6 +221,16 @@ export interface TransactionPartnerUser {
   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. */
 export interface TransactionPartnerAffiliateProgram {
   /** Type of the transaction partner, always “affiliate_program” */