@telegram.ts/types 1.19.1 → 1.20.0

package/package.json

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

package/src/apiMethodsTypes.d.ts

@@ -77,11 +77,11 @@ export type ApiMethods = {
     timeout?: number;
     /** A list of the update types you want your bot to receive. For example, specify ["message", "edited_channel_post", "callback_query"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member, message_reaction, and message_reaction_count (default). If not specified, the previous setting will be used.
 
-    Please note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time. */
+    Please note that this parameter doesn't affect updates created before the call to getUpdates, so unwanted updates may be received for a short period of time. */
     allowed_updates?: ReadonlyArray<Exclude<keyof Update, "update_id">>;
   }): Update[];
 
-  /** Use this method to specify a URL and receive incoming updates via an outgoing webhook. Whenever there is an update for the bot, we will send an HTTPS POST request to the specified URL, containing a JSON-serialized Update. In case of an unsuccessful request, we will give up after a reasonable amount of attempts. Returns True on success.
+  /** Use this method to specify a URL and receive incoming updates via an outgoing webhook. Whenever there is an update for the bot, we will send an HTTPS POST request to the specified URL, containing a JSON-serialized Update. In case of an unsuccessful request (a request with response HTTP status code different from 2XY), we will repeat the request  and give up after a reasonable amount of attempts. Returns True on success.
 
   If you'd like to make sure that the webhook was set by you, you can specify secret data in the parameter secret_token. If specified, the request will contain a header “X-Telegram-Bot-Api-Secret-Token” with the secret token as content.
 
@@ -1689,9 +1689,9 @@ export type ApiMethods = {
     name: string;
     /** User identifier of the sticker set owner */
     user_id: number;
-    /** A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animation-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail. */
+    /** A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animation-requirements for animated sticker technical requirements), or a .WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail. */
     thumbnail?: Buffer | ReadStream | string;
-    /** Format of the thumbnail, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, or “video” for a WEBM video */
+    /** Format of the thumbnail, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, or “video” for a .WEBM video */
     format: "static" | "animated" | "video";
   }): true;
 
@@ -1712,6 +1712,8 @@ export type ApiMethods = {
     user_id: number;
     /** 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 */
+    pay_for_upgrade?: boolean;
     /** Text that will be shown along with the gift; 0-255 characters */
     text?: string;
     /** Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored. */
@@ -1883,6 +1885,34 @@ export type ApiMethods = {
     is_canceled: boolean;
   }): true;
 
+  /** Verifies a user on behalf of the organization which is represented by the bot. Returns True on success. */
+  verifyUser(args: {
+    /** Unique identifier of the target user */
+    user_id: number;
+    /** Custom description for the verification; 0-70 characters. Must be empty if the organization isn't allowed to provide a custom verification description. */
+    custom_description?: string;
+  }): true;
+
+  /** Verifies a chat on behalf of the organization which is represented by the bot. Returns True on success. */
+  verifyChat(args: {
+    /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+    chat_id: number | string;
+    /** Custom description for the verification; 0-70 characters. Must be empty if the organization isn't allowed to provide a custom verification description. */
+    custom_description?: string;
+  }): true;
+
+  /** Removes verification from a user who is currently verified on behalf of the organization represented by the bot. Returns True on success. */
+  removeUserVerification(args: {
+    /** Unique identifier of the target user */
+    user_id: number;
+  }): true;
+
+  /** Removes verification from a chat that is currently verified on behalf of the organization represented by the bot. Returns True on success. */
+  removeChatVerification(args: {
+    /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+    chat_id: number | string;
+  }): true;
+
   /** If you sent an invoice requesting a shipping address and the parameter is_flexible was specified, the Bot API will send an Update with a shipping_query field to the bot. Use this method to reply to shipping queries. On success, True is returned. */
   answerShippingQuery(args: {
     /** Unique identifier for the query to be answered */
@@ -1992,7 +2022,7 @@ export type ApiMethods = {
 export interface InputSticker {
   /** The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. */
   sticker: Buffer | ReadStream | string;
-  /** Format of the added sticker, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, “video” for a WEBM video */
+  /** Format of the added sticker, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, “video” for a .WEBM video */
   format: "static" | "animated" | "video";
   /** List of 1-20 emoji associated with the sticker */
   emoji_list: string[];

package/src/inlineTypes.d.ts

@@ -80,8 +80,6 @@ export interface InlineQueryResultArticle {
   reply_markup?: InlineKeyboardMarkup;
   /** URL of the result */
   url?: string;
-  /** Pass True if you don't want the URL to be shown in the message */
-  hide_url?: boolean;
   /** Short description of the result */
   description?: string;
   /** Url of the thumbnail for the result */
@@ -128,7 +126,7 @@ export interface InlineQueryResultGif {
   type: "gif";
   /** Unique identifier for this result, 1-64 bytes */
   id: string;
-  /** A valid URL for the GIF file. File size must not exceed 1MB */
+  /** A valid URL for the GIF file */
   gif_url: string;
   /** Width of the GIF */
   gif_width?: number;
@@ -161,7 +159,7 @@ export interface InlineQueryResultMpeg4Gif {
   type: "mpeg4_gif";
   /** Unique identifier for this result, 1-64 bytes */
   id: string;
-  /** A valid URL for the MPEG4 file. File size must not exceed 1MB */
+  /** A valid URL for the MPEG4 file */
   mpeg4_url: string;
   /** Video width */
   mpeg4_width?: number;

package/src/invoiceTypes.d.ts

@@ -287,6 +287,8 @@ export interface Gift {
   sticker: Sticker;
   /** The number of Telegram Stars that must be paid to send the sticker */
   star_count: number;
+  /** The number of Telegram Stars that must be paid to upgrade the gift to a unique one */
+  upgrade_star_count?: number;
   /** The total number of the gifts of this type that can be sent; for limited gifts only */
   total_count?: number;
   /** The number of remaining gifts of this type that can be sent; for limited gifts only */

package/src/messageTypes.d.ts

@@ -1041,7 +1041,7 @@ export interface BackgroundTypeWallpaper {
   is_moving?: true;
 }
 
-/** The background is a PNG or TGV (gzipped subset of SVG with MIME type “application/x-tgwallpattern”) pattern to be combined with the background fill chosen by the user. */
+/** The background is a .PNG or .TGV (gzipped subset of SVG with MIME type “application/x-tgwallpattern”) pattern to be combined with the background fill chosen by the user. */
 export interface BackgroundTypePattern {
   /** Type of the background, always “pattern” */
   type: "pattern";