Update to bot Api 5.3

Author: XenosOrdo

context.js

@@ -344,6 +344,11 @@ class TelegrafContext {
     return this.telegram.exportChatInviteLink(this.chat.id, ...args)
   }
 
+  banChatMember (...args) {
+    this.assert(this.chat, 'banChatMember')
+    return this.telegram.banChatMember(this.chat.id, ...args)
+  }
+
   kickChatMember (...args) {
     this.assert(this.chat, 'kickChatMember')
     return this.telegram.kickChatMember(this.chat.id, ...args)
@@ -426,7 +431,12 @@ class TelegrafContext {
 
   getChatMembersCount (...args) {
     this.assert(this.chat, 'getChatMembersCount')
-    return this.telegram.getChatMembersCount(this.chat.id, ...args)
+    return this.telegram.getChatMemberCount(this.chat.id, ...args)
+  }
+
+  getChatMemberCount (...args) {
+    this.assert(this.chat, 'getChatMemberCount')
+    return this.telegram.getChatMemberCount(this.chat.id, ...args)
   }
 
   setPassportDataErrors (errors) {
@@ -570,14 +580,18 @@ class TelegrafContext {
     return this.telegram.addStickerToSet(this.from.id, ...args)
   }
 
-  getMyCommands () {
-    return this.telegram.getMyCommands()
+  getMyCommands (...args) {
+    return this.telegram.getMyCommands(...args)
   }
 
   setMyCommands (...args) {
     return this.telegram.setMyCommands(...args)
   }
 
+  deleteMyCommands (...args) {
+    return this.telegram.deleteMyCommands(...args)
+  }
+
   replyWithMarkdown (markdown, extra) {
     return this.reply(markdown, { parse_mode: 'Markdown', ...extra })
   }

markup.js

@@ -9,6 +9,11 @@ class Markup {
     return this
   }
 
+  inputFieldPlaceholder (placeholder) {
+    this.input_field_placeholder = placeholder
+    return this
+  }
+
   selective (value = true) {
     this.selective = value
     return this
@@ -111,6 +116,10 @@ class Markup {
     return new Markup().resize(value)
   }
 
+  static inputFieldPlaceholder (placeholder) {
+    return new Markup().inputFieldPlaceholder(placeholder)
+  }
+
   static selective (value = true) {
     return new Markup().selective(value)
   }

telegram.js

@@ -175,7 +175,11 @@ class Telegram extends ApiClient {
   }
 
   getChatMembersCount (chatId) {
-    return this.callApi('getChatMembersCount', { chat_id: chatId })
+    return this.callApi('getChatMemberCount', { chat_id: chatId })
+  }
+
+  getChatMemberCount (chatId) {
+    return this.callApi('getChatMemberCount', { chat_id: chatId })
   }
 
   answerInlineQuery (inlineQueryId, results, extra) {
@@ -186,8 +190,12 @@ class Telegram extends ApiClient {
     return this.callApi('setChatPermissions', { chat_id: chatId, permissions })
   }
 
+  banChatMember (chatId, userId, extra) {
+    return this.callApi('banChatMember', { chat_id: chatId, user_id: userId, ...extra })
+  }
+
   kickChatMember (chatId, userId, untilDate) {
-    return this.callApi('kickChatMember', { chat_id: chatId, user_id: userId, until_date: untilDate })
+    return this.callApi('banChatMember', { chat_id: chatId, user_id: userId, until_date: untilDate })
   }
 
   promoteChatMember (chatId, userId, extra) {
@@ -403,12 +411,16 @@ class Telegram extends ApiClient {
     return this.callApi('deleteStickerFromSet', { sticker })
   }
 
-  getMyCommands () {
-    return this.callApi('getMyCommands')
+  getMyCommands (extra) {
+    return this.callApi('getMyCommands', extra)
+  }
+
+  setMyCommands (commands, extra) {
+    return this.callApi('setMyCommands', { commands, ...extra })
   }
 
-  setMyCommands (commands) {
-    return this.callApi('setMyCommands', { commands })
+  deleteMyCommands (extra) {
+    return this.callApi('deleteMyCommands', extra)
   }
 
   setPassportDataErrors (userId, errors) {

test/markup.js

@@ -283,4 +283,4 @@ test('should generate correct markup with HTML tags', (t) => {
     }
   ])
   t.deepEqual(markup, '&lt;b&gt;<b>bold</b>&lt;/b&gt; &lt;i&gt;<i>italic</i>&lt;/i&gt;')
-})
+})

typings/context.d.ts

@@ -103,11 +103,17 @@ export declare class TelegrafContext {
   getChatMember(userId: number): Promise<tt.ChatMember>
 
   /**
-   * Use this method to get the number of members in a chat
+   * Legasy, see getChatMemberCount
    * @returns Number on success
    */
   getChatMembersCount(): Promise<number>
 
+  /**
+   * Use this method to get the number of members in a chat
+   * @returns Number on success
+   */
+   getChatMemberCount(): Promise<number>
+
   /**
    * Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for this to work and must have the appropriate admin rights. Pass True for all boolean parameters to lift restrictions from a user. Returns True on success.
    * @param userId Unique identifier of the target user
@@ -571,7 +577,18 @@ export declare class TelegrafContext {
   ): Promise<tt.MessageLocation | boolean>
 
   /**
-   * Use this method to kick a user from a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the group on their own using invite links, etc., unless unbanned first. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights
+   * Use this method to ban a user in a group, a supergroup or a channel.
+   * @param userId Unique identifier of the target user
+   * @param extra Extra params
+   * @returns True on success
+   */
+   banChatMember(
+    userId: number,
+    extra?: tt.ExtraBan
+  ): Promise<boolean>
+
+  /**
+   * Legacy, see banChatMember
    * @param userId Unique identifier of the target user
    * @param untilDate Date when the user will be unbanned, unix time. If user is banned for more than 366 days or less than 30 seconds from the current time they are considered to be banned forever
    * @returns True on success
@@ -706,17 +723,34 @@ export declare class TelegrafContext {
   ): Promise<boolean>
 
   /**
-   * Use this method to get the current list of the bot's commands. Requires no parameters.
+   * Use this method to get the current list of the bot's commands for the given scope and user language.
+   * @param extra Extra parameters for getMyCommands
    * @returns Array of BotCommand on success.
    */
-  getMyCommands(): Promise<tt.BotCommand[]>
+  getMyCommands(
+    extra?: tt.ExtraGetMyCommands
+  ): Promise<tt.BotCommand[]>
 
   /**
    * Use this method to change the list of the bot's commands.
    * @param commands A list of bot commands to be set as the list of the bot's commands. At most 100 commands can be specified.
+   * @param extra Extra parameters for setMyCommands
+   * @returns True on success
+   */
+  setMyCommands(
+    commands: tt.BotCommand[],
+    extra?: tt.ExtraSetMyCommands
+  ): Promise<boolean>
+
+  /**
+   * Use this method to delete the list of the bot's commands for the given scope and user language.
+   * After deletion, higher level commands will be shown to affected users.
+   * @param extra Extra parameters for deleteMyCommands
    * @returns True on success
    */
-  setMyCommands(commands: tt.BotCommand[]): Promise<boolean>
+  deleteMyCommands(
+    extra?: tt.ExtraDeleteMyCommands
+  ): Promise<boolean>
 
   /**
    * Use this method to create an additional invite link for a chat.

typings/markup.d.ts

@@ -87,6 +87,8 @@ export declare class Markup<T extends tt.KeyboardMarkupBundle> {
 
   removeKeyboard(value?: boolean): Markup<tt.ReplyKeyboardRemove> & tt.ReplyKeyboardRemove
 
+  inputFieldPlaceholder<T extends tt.ReplyKeyboardMarkup | tt.ForceReply>(this: Markup<T> & T, placeholder: string): this
+
   selective<T extends tt.ReplyMarkupBundle>(this: Markup<T> & T, value?: boolean): this
 
   extra<T extends tt.KeyboardMarkupBundle>(this: Markup<T> & T, options?: tt.Extra): tt.ExtraReply<T> & Extra
@@ -140,7 +142,7 @@ export declare class Markup<T extends tt.KeyboardMarkupBundle> {
 
   static removeKeyboard(value?: string): Markup<tt.ReplyKeyboardRemove> & tt.ReplyKeyboardRemove
 
-  static forceReply(value?: string): Markup<tt.ForceReply> & tt.ForceReply
+  static forceReply(value?: boolean): Markup<tt.ForceReply> & tt.ForceReply
 
   static keyboard(
     buttons: KeyboardButton[] | KeyboardButton[][],
@@ -154,6 +156,8 @@ export declare class Markup<T extends tt.KeyboardMarkupBundle> {
 
   static resize(value?: boolean): Markup<tt.ReplyKeyboardMarkup>
 
+  static inputFieldPlaceholder(placeholder: string): Markup<tt.ReplyKeyboardMarkup | tt.ForceReply>
+
   static selective(value?: boolean): Markup<tt.ReplyMarkupBundle>
 
   static oneTime(value?: boolean): Markup<tt.ReplyKeyboardMarkup>

typings/telegram-types.d.ts

@@ -694,7 +694,7 @@ export interface ExtraBan {
     revoke_messages: boolean
 }
 
-export interface ExtraCreateChatIviteLink {
+interface ExtraChatIviteLink {
   /** 
    * Point in time (Unix timestamp) when the link will expire 
    */
@@ -706,7 +706,10 @@ export interface ExtraCreateChatIviteLink {
   member_limit?: number
 }
 
-export interface ExtraEditChatIviteLink extends ExtraCreateChatIviteLink {}
+
+export interface ExtraCreateChatIviteLink extends ExtraChatIviteLink {}
+
+export interface ExtraEditChatIviteLink extends ExtraChatIviteLink {}
 
 export type MessageAudio = TT.Message.AudioMessage
 export type MessageContact = TT.Message.ContactMessage
@@ -907,6 +910,120 @@ export interface ExtraAnswerInlineQuery {
   switch_pm_parameter?: string
 }
 
+/**
+ * Represents the default scope of bot commands.
+ * Default commands are used if no commands with a narrower scope are specified for the user.
+ */
+export interface BotCommandScopeDefault {
+  /**
+   * Scope type
+   */
+  type: 'default'
+}
+
+/**
+ * Represents the scope of bot commands, covering all private chats.
+ */
+export interface BotCommandScopeAllPrivateChats {
+  /**
+   * Scope type
+   */
+  type: 'all_private_chats'
+}
+
+/**
+ * Represents the scope of bot commands, covering all group and supergroup chats.
+ */
+export interface BotCommandScopeAllGroupChats {
+  /**
+   * Scope type
+   */
+  type: 'all_groups_chats'
+}
+
+/**
+ * Represents the scope of bot commands, covering all group and supergroup chat administrators.
+ */
+export interface BotCommandScopeAllChatAdministrators {
+  /**
+   * Scope type
+   */
+  type: 'all_chat_administrators'
+}
+
+/**
+ * Represents the scope of bot commands, covering a specific chat.
+ */
+export interface BotCommandScopeChat {
+  /**
+   * Scope type
+   */
+  type: 'chat'
+}
+
+/**
+ * Represents the scope of bot commands, covering all administrators of a specific group or supergroup chat.
+ */
+export interface BotCommandScopeChatAdministrators {
+  /**
+   * Scope type
+   */
+  type: 'chat_administrators'
+}
+
+/**
+ * Represents the scope of bot commands, covering a specific member of a group or supergroup chat.
+ */
+export interface BotCommandScopeChatMember {
+  /**
+   * Scope type
+   */
+  type: 'chat_member'
+}
+
+/**
+ * This object represents the scope to which bot commands are applied.
+ */
+export type BotCommandScope = 
+  BotCommandScopeDefault
+  | BotCommandScopeAllPrivateChats
+  | BotCommandScopeAllGroupChats
+  | BotCommandScopeAllChatAdministrators
+  | BotCommandScopeChat
+  | BotCommandScopeChatAdministrators
+  | BotCommandScopeChatMember
+
+export interface ExtraScope {
+  /**
+   * A JSON-serialized object, describing scope of users for which the commands are relevant.
+   * Defaults to BotCommandScopeDefault.
+   */
+  scope?: BotCommandScope
+}
+
+export interface ExtraSetMyCommands extends ExtraScope {
+  /**
+   * A two-letter ISO 639-1 language code.
+   * If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands
+   */
+   language_code?: string
+}
+
+export interface ExtraDeleteMyCommands extends ExtraScope {
+  /**
+   * A two-letter ISO 639-1 language code.
+   * If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands
+   */
+   language_code?: string
+}
+
+export interface ExtraGetMyCommands extends ExtraScope {
+  /**
+   * A two-letter ISO 639-1 language code or an empty string
+   */
+   language_code?: string
+}
+
 /**
  * This object represents a bot command
  */