@telegram.ts/types 1.10.0 → 1.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telegram.ts/types",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Comprehensive Type Declarations for Telegram Bot API with telegramsjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -11,6 +11,7 @@
     "api",
     "types"
   ],
+  "homepage": "https://telegramsjs.vercel.app/",
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/telegramsjs/types/issues"

package/src/apiMethodsTypes.d.ts

@@ -43,7 +43,11 @@ import type {
   StickerSet,
 } from "./messageTypes.ts";
 import type { PassportElementError } from "./passportTypes.ts";
-import type { LabeledPrice, ShippingOption } from "./invoiceTypes.ts";
+import type {
+  LabeledPrice,
+  ShippingOption,
+  StarTransactions,
+} from "./invoiceTypes.ts";
 import type {
   BotCommandScope,
   BotDescription,
@@ -140,7 +144,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -262,7 +266,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -306,7 +310,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -344,7 +348,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -392,7 +396,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -438,7 +442,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -474,7 +478,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -509,7 +513,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -539,7 +543,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent messages from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -576,7 +580,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -592,6 +596,8 @@ export type ApiMethods = {
 
   /** Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
   editMessageLiveLocation(args: {
+    /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+    business_connection_id?: string;
     /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id?: number | string;
     /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -616,6 +622,8 @@ export type ApiMethods = {
 
   /** Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned. */
   stopMessageLiveLocation(args: {
+    /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+    business_connection_id?: string;
     /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id?: number | string;
     /** Required if inline_message_id is not specified. Identifier of the message with live location to stop */
@@ -654,7 +662,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -688,7 +696,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -742,7 +750,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -770,7 +778,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -1351,8 +1359,10 @@ export type ApiMethods = {
     for_channels?: boolean;
   }): ChatAdministratorRights;
 
-  /** Use this method to edit text and game messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
+  /** Use this method to edit text and game messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent. */
   editMessageText(args: {
+    /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+    business_connection_id?: string;
     /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id?: number | string;
     /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -1371,8 +1381,10 @@ export type ApiMethods = {
     reply_markup?: InlineKeyboardMarkup;
   }): (Update.Edited & Message.TextMessage) | true;
 
-  /** Use this method to edit captions of messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
+  /** Use this method to edit captions of messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent. */
   editMessageCaption(args: {
+    /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+    business_connection_id?: string;
     /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id?: number | string;
     /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -1391,8 +1403,10 @@ export type ApiMethods = {
     reply_markup?: InlineKeyboardMarkup;
   }): (Update.Edited & Message.CaptionableMessage) | true;
 
-  /** Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
+  /** Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent. */
   editMessageMedia(args: {
+    /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+    business_connection_id?: string;
     /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id?: number | string;
     /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -1405,8 +1419,10 @@ export type ApiMethods = {
     reply_markup?: InlineKeyboardMarkup;
   }): (Update.Edited & Message) | true;
 
-  /** Use this method to edit only the reply markup of messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
+  /** Use this method to edit only the reply markup of messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent. */
   editMessageReplyMarkup(args: {
+    /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+    business_connection_id?: string;
     /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id?: number | string;
     /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -1419,6 +1435,8 @@ export type ApiMethods = {
 
   /** Use this method to stop a poll which was sent by the bot. On success, the stopped Poll is returned. */
   stopPoll(args: {
+    /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+    business_connection_id?: string;
     /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id: number | string;
     /** Identifier of the original message with the poll */
@@ -1468,7 +1486,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -1693,7 +1711,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;
@@ -1777,6 +1795,14 @@ export type ApiMethods = {
     telegram_payment_charge_id: string;
   }): true;
 
+  /** Returns the bot's Telegram Star transactions in chronological order. On success, returns a StarTransactions object. */
+  getStarTransactions(args: {
+    /** Number of transactions to skip in the response */
+    offset?: number;
+    /** The maximum number of transactions to be retrieved. Values between 1-100 are accepted. Defaults to 100. */
+    limit?: number;
+  }): StarTransactions;
+
   /** Informs a user that some of the Telegram Passport elements they provided contains errors. The user will not be able to re-submit their Passport to you until the errors are fixed (the contents of the field for which you returned the error must change). Returns True on success.
 
   Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues. */
@@ -1801,7 +1827,7 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
-    /** Unique identifier of the message effect to be added to the message */
+    /** Unique identifier of the message effect to be added to the message; for private chats only */
     message_effect_id?: string;
     /** Description of the message to reply to */
     reply_parameters?: ReplyParameters;

package/src/invoiceTypes.d.ts

@@ -143,3 +143,85 @@ export interface PreCheckoutQuery {
   /** The order information provided by the user. */
   order_info?: OrderInfo;
 }
+
+/** This object describes the state of a revenue withdrawal operation. Currently, it can be one of
+- RevenueWithdrawalStatePending
+- RevenueWithdrawalStateSucceeded
+- RevenueWithdrawalStateFailed */
+export type RevenueWithdrawalState =
+  | RevenueWithdrawalStatePending
+  | RevenueWithdrawalStateSucceeded
+  | RevenueWithdrawalStateFailed;
+
+/** The withdrawal is in progress. */
+export interface RevenueWithdrawalStatePending {
+  /** Type of the state, always “pending” */
+  type: "pending";
+}
+
+/** The withdrawal succeeded. */
+export interface RevenueWithdrawalStateSucceeded {
+  /** Type of the state, always “succeeded” */
+  type: "succeeded";
+  /** Date the withdrawal was completed in Unix time */
+  date: number;
+  /** An HTTPS URL that can be used to see transaction details */
+  url: string;
+}
+
+/** The withdrawal failed and the transaction was refunded. */
+export interface RevenueWithdrawalStateFailed {
+  /** Type of the state, always “failed” */
+  type: "failed";
+}
+
+/** This object describes the source of a transaction, or its recipient for outgoing transactions. Currently, it can be one of
+- TransactionPartnerFragment
+- TransactionPartnerUser
+- TransactionPartnerOther */
+export type TransactionPartner =
+  | TransactionPartnerFragment
+  | TransactionPartnerUser
+  | TransactionPartnerOther;
+
+/** Describes a withdrawal transaction with Fragment. */
+export interface TransactionPartnerFragment {
+  /** Type of the transaction partner, always “fragment” */
+  type: "fragment";
+  /** State of the transaction if the transaction is outgoing */
+  withdrawal_state?: RevenueWithdrawalState;
+}
+
+/** Describes a transaction with a user. */
+export interface TransactionPartnerUser {
+  /** Type of the transaction partner, always “user” */
+  type: "user";
+  /** Information about the user */
+  user: User;
+}
+
+/** Describes a transaction with an unknown source or recipient. */
+export interface TransactionPartnerOther {
+  /** Type of the transaction partner, always “other” */
+  type: "other";
+}
+
+/** Describes a Telegram Star transaction. */
+export interface StarTransaction {
+  /** Unique identifier of the transaction. Coincides with the identifer of the original transaction for refund transactions. Coincides with SuccessfulPayment.telegram_payment_charge_id for successful incoming payments from users. */
+  id: string;
+  /** Number of Telegram Stars transferred by the transaction */
+  amount: number;
+  /** Date the transaction was created in Unix time */
+  date: number;
+  /** Source of an incoming transaction (e.g., a user purchasing goods or services, Fragment refunding a failed withdrawal). Only for incoming transactions */
+  source?: TransactionPartner;
+  /** Receiver of an outgoing transaction (e.g., a user for a purchase refund, Fragment for a withdrawal). Only for outgoing transactions */
+  receiver?: TransactionPartner;
+}
+
+/** Contains a list of Telegram Star transactions. */
+export interface StarTransactions {
+  /** The list of transactions */
+  transactions: StarTransaction[];
+}

package/src/markupTypes.d.ts

@@ -17,7 +17,7 @@ export declare namespace InlineKeyboardButton {
     url: string;
   }
   export interface CallbackButton extends AbstractInlineKeyboardButton {
-    /** Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes. Not supported for messages sent on behalf of a Telegram Business account. */
+    /** Data to be sent in a callback query to the bot when the button is pressed, 1-64 bytes. */
     callback_data: string;
   }
   export interface WebAppButton extends AbstractInlineKeyboardButton {