@grammyjs/types 2.3.0 → 2.4.2

package/inline.d.ts

@@ -30,7 +30,7 @@ export namespace InlineKeyboardButton {
     text: string;
   }
   export interface UrlButton extends AbstractInlineKeyboardButton {
-    /** HTTP or tg:// url to be opened when button is pressed */
+    /** 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. */
     url: string;
   }
   export interface LoginButton extends AbstractInlineKeyboardButton {
@@ -63,7 +63,7 @@ export namespace InlineKeyboardButton {
   export interface PayButton extends AbstractInlineKeyboardButton {
     /** Specify True, to send a Pay button.
 
-    NOTE: This type of button must always be the first button in the first row. */
+    NOTE: This type of button must always be the first button in the first row and can only be used in invoice messages. */
     pay: boolean;
   }
 }

package/manage.d.ts

@@ -103,6 +103,8 @@ export namespace Chat {
     pinned_message?: Message;
     /** The time after which all messages sent to the chat will be automatically deleted; in seconds. Returned only in getChat. */
     message_auto_delete_time?: number;
+    /** True, if messages from the chat can't be forwarded to other chats. Returned only in getChat. */
+    has_protected_content?: true;
   }
   /** Internal type holding properties that those group, supergroup, and channel chats returned from `getChat` share. */
   interface NonPrivateGetChat extends GetChat {
@@ -129,6 +131,8 @@ export namespace Chat {
   export interface PrivateGetChat extends PrivateChat, GetChat {
     /** Bio of the other party in a private chat. Returned only in getChat. */
     bio?: string;
+    /** True, if privacy settings of the other party in the private chat allows to use tg://user?id=<user_id> links only in chats with the user. Returned only in getChat. */
+    has_private_forwards?: true;
   }
   /** Internal type representing group chats returned from `getChat`. */
   export interface GroupGetChat extends GroupChat, MultiUserGetChat {}

package/message.d.ts

@@ -31,12 +31,16 @@ export namespace Message {
     forward_sender_name?: string;
     /** For forwarded messages, date the original message was sent in Unix time */
     forward_date?: number;
+    /** True, if the message is a channel post that was automatically forwarded to the connected discussion group */
+    is_automatic_forward?: true;
     /** For replies, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply. */
     reply_to_message?: ReplyMessage;
     /** Bot through which the message was sent */
     via_bot?: User;
     /** Date the message was last edited in Unix time */
     edit_date?: number;
+    /** True, if the message can't be forwarded */
+    has_protected_content?: true;
     /** Signature of the post author for messages in channels, or the custom title of an anonymous group administrator */
     author_signature?: string;
     /** Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons. */
@@ -219,8 +223,8 @@ Message entities can be nested, providing following restrictions are met:
 
 Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username. Please note:
 
-- These links will work only if they are used inside an inline link. For example, they will not work, when used in an inline keyboard button or in a message text.
-- These mentions are only guaranteed to work if the user has contacted the bot in the past, has sent a callback query to the bot via inline button or is a member in the group where he was mentioned.
+- These links will work only if they are used inside an inline link or in an inline keyboard button. For example, they will not work, when used in a message text.
+- These mentions are only guaranteed to work if the user has contacted the bot in the past, has sent a callback query to the bot via an inline button or is a member in the group where he was mentioned.
 
 #### MarkdownV2 style
 To use this mode, pass *MarkdownV2* in the *parse_mode* field. Use the following syntax in your message:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grammyjs/types",
-  "version": "2.3.0",
+  "version": "2.4.2",
   "description": "Telegram Bot API type declarations for grammY",
   "main": "index.js",
   "repository": {

package/proxied.d.ts

@@ -620,6 +620,7 @@ export interface InputFileProxy<F> {
         | "record_voice"
         | "upload_voice"
         | "upload_document"
+        | "choose_sticker"
         | "find_location"
         | "record_video_note"
         | "upload_video_note";
@@ -721,6 +722,29 @@ export interface InputFileProxy<F> {
       custom_title: string;
     }): true;
 
+    /**
+     * Use this method to ban a channel chat in a supergroup or a channel. Until the chat is unbanned, the owner of the banned chat:
+     *
+     * - Won't be able to send messages on behalf of any of their channels.
+     * - Won't be able to join live streams on behalf of the banned chat.
+     *
+     * The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns True on success.
+     */
+    banChatSenderChat(args: {
+      /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+      chat_id: number | string;
+      /** Unique identifier of the target sender chat */
+      sender_chat_id: number;
+    }): true;
+
+    /** Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns True on success. */
+    unbanChatSenderChat(args: {
+      /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+      chat_id: number | string;
+      /** Unique identifier of the target sender chat */
+      sender_chat_id: number;
+    }): true;
+
     /** Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the can_restrict_members administrator rights. Returns True on success. */
     setChatPermissions(args: {
       /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */