Update to bot API 5.1

Author: XenosOrdo

context.js

@@ -9,7 +9,9 @@ const UpdateTypes = [
   'pre_checkout_query',
   'message',
   'poll',
-  'poll_answer'
+  'poll_answer',
+  'my_chat_member',
+  'chat_member'
 ]
 
 const MessageSubTypes = [
@@ -43,7 +45,11 @@ const MessageSubTypes = [
   'connected_website',
   'passport_data',
   'poll',
-  'forward_date'
+  'forward_date',
+  'message_auto_delete_timer_changed',
+  'voice_chat_started',
+  'voice_chat_ended',
+  'voice_chat_participants_invited'
 ]
 
 const MessageSubTypesMapping = {
@@ -120,12 +126,22 @@ class TelegrafContext {
     return this.update.poll_answer
   }
 
+  get myChatMember () {
+    return this.update.my_chat_member
+  }
+
+  get chatMember () {
+    return this.update.chat_member
+  }
+
   get chat () {
     return (this.message && this.message.chat) ||
       (this.editedMessage && this.editedMessage.chat) ||
       (this.callbackQuery && this.callbackQuery.message && this.callbackQuery.message.chat) ||
       (this.channelPost && this.channelPost.chat) ||
-      (this.editedChannelPost && this.editedChannelPost.chat)
+      (this.editedChannelPost && this.editedChannelPost.chat) ||
+      (this.myChatMember && this.myChatMember.chat) ||
+      (this.chatMember && this.chatMember.chat)
   }
 
   get from () {
@@ -137,7 +153,9 @@ class TelegrafContext {
       (this.editedChannelPost && this.editedChannelPost.from) ||
       (this.shippingQuery && this.shippingQuery.from) ||
       (this.preCheckoutQuery && this.preCheckoutQuery.from) ||
-      (this.chosenInlineResult && this.chosenInlineResult.from)
+      (this.chosenInlineResult && this.chosenInlineResult.from) ||
+      (this.myChatMember && this.myChatMember.from) ||
+      (this.chatMember && this.chatMember.from)
   }
 
   get inlineMessageId () {
@@ -605,6 +623,21 @@ class TelegrafContext {
     this.assert(message, 'copyMessage')
     return this.telegram.copyMessage(chatId, message.chat.id, message.message_id, extra)
   }
+
+  createChatInviteLink (...args) {
+    this.assert(this.chat, 'createChatInviteLink')
+    return this.telegram.createChatInviteLink(this.chat.id, ...args)
+  }
+
+  editChatInviteLink (...args) {
+    this.assert(this.chat, 'editChatInviteLink')
+    return this.telegram.editChatInviteLink(this.chat.id, ...args)
+  }
+
+  revokeChatInviteLink (...args) {
+    this.assert(this.chat, 'revokeChatInviteLink')
+    return this.telegram.revokeChatInviteLink(this.chat.id, ...args)
+  }
 }
 
 module.exports = TelegrafContext

package.json

@@ -40,7 +40,7 @@
     "module-alias": "^2.2.2",
     "node-fetch": "^2.2.0",
     "sandwich-stream": "^2.0.1",
-    "typegram": "^3.1.5"
+    "typegram": "^3.4.3"
   },
   "devDependencies": {
     "@types/node": "^13.1.0",

telegram.js

@@ -445,6 +445,28 @@ class Telegram extends ApiClient {
       ...extra
     })
   }
+
+  createChatInviteLink (chatId, extra) {
+    return this.callApi('createChatInviteLink', {
+      chat_id: chatId,
+      ...extra
+    })
+  }
+
+  editChatInviteLink (chatId, inviteLink, extra) {
+    return this.callApi('editChatInviteLink', {
+      chat_id: chatId,
+      invite_link: inviteLink,
+      ...extra
+    })
+  }
+
+  revokeChatInviteLink (chatId, inviteLink) {
+    return this.callApi('revokeChatInviteLink', {
+      chat_id: chatId,
+      invite_link: inviteLink
+    })
+  }
 }
 
 module.exports = Telegram

typings/context.d.ts

@@ -717,4 +717,33 @@ export declare class TelegrafContext {
    * @returns True on success
    */
   setMyCommands(commands: tt.BotCommand[]): Promise<boolean>
+
+  /**
+   * Use this method to create an additional invite link for a chat.
+   * @param extra Extra parameters for createChatInviteLink
+   * @returns the new invite link as ChatInviteLink object
+   */
+  createChatInviteLink(
+    extra?: tt.ExtraCreateChatIviteLink
+  ): Promise<tt.ChatInviteLink>
+
+  /**
+   * Use this method to edit a non-primary invite link created by the bot.
+   * @param inviteLink The invite link to edit
+   * @param extra Extra parameters for editChatInviteLink
+   * @returns the edited invite link as a ChatInviteLink object
+   */
+  editChatInviteLink(
+    inviteLink: string,
+    extra?: tt.ExtraEditChatIviteLink
+  ): Promise<tt.ChatInviteLink>
+
+  /**
+   * Use this method to revoke an invite link created by the bot.
+   * @param inviteLink The invite link to revoke
+   * @returns the revoked invite link as a ChatInviteLink object
+   */
+  revokeChatInviteLink(
+    inviteLink: string
+  ): Promise<tt.ChatInviteLink>
 }

typings/telegram-types.d.ts

@@ -34,7 +34,9 @@ export type UpdateType =
   'pre_checkout_query' |
   'shipping_query' |
   'poll' |
-  'poll_answer'
+  'poll_answer' |
+  'my_chat_member' |
+  'chat_member'
 
 export type MessageSubTypes =
   'voice' |
@@ -67,7 +69,11 @@ export type MessageSubTypes =
   'connected_website' |
   'passport_data' |
   'poll' |
-  'forward'
+  'forward' |
+  'message_auto_delete_timer_changed' |
+  'voice_chat_started' |
+  'voice_chat_ended' |
+  'voice_chat_participants_invited'
 
 export type InputMediaTypes =
   'photo'
@@ -83,6 +89,7 @@ export type ChatMemberStatus =
   | 'restricted'
   | 'left'
   | 'kicked'
+
 export type MessageEntityType =
   'mention'
   | 'hashtag'
@@ -276,6 +283,9 @@ export interface ExtraPromoteChatMember {
   /** Pass True, if the administrator can delete messages of other users */
   can_delete_messages?: boolean
 
+  /** Pass True, if the administrator can manage voice chats */
+  can_manage_voice_chats?: boolean,
+
   /** Pass True, if the administrator can invite new users to the chat */
   can_invite_users?: boolean
 
@@ -661,10 +671,42 @@ export type Extra = ExtraSendMessage
   | ExtraCopyMessage
 
 export interface ExtraUnban {
-  /** Do nothing if the user is not banned */
+  /** 
+   * Do nothing if the user is not banned 
+   */
   only_if_banned?: Boolean
 }
 
+export interface ExtraBan {
+  /**
+   * 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.
+   * Applied for supergroups and channels only.
+   */
+   until_date?: number,
+
+   /**
+    * Pass True to delete all messages from the chat for the user that is being removed.
+    * If False, the user will be able to see messages in the group that were sent before the user was removed.
+    * Always True for supergroups and channels.
+    */
+    revoke_messages: boolean
+}
+
+export interface ExtraCreateChatIviteLink {
+  /** 
+   * Point in time (Unix timestamp) when the link will expire 
+   */
+  expire_date?: number,
+
+  /** 
+   * Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999
+   */
+  member_limit?: number
+}
+
+export interface ExtraEditChatIviteLink extends ExtraCreateChatIviteLink {}
+
 export type MessageAudio = TT.Message.AudioMessage
 export type MessageContact = TT.Message.ContactMessage
 export type MessageDocument = TT.Message.DocumentMessage
@@ -697,6 +739,10 @@ type ServiceMessageBundle = TT.Message.ChannelChatCreatedMessage
   & TT.Message.PinnedMessageMessage
   & TT.Message.SuccessfulPaymentMessage
   & TT.Message.SupergroupChatCreated
+  & TT.Message.MessageAutoDeleteTimerChangedMessage
+  & TT.Message.VoiceChatStartedMessage
+  & TT.Message.VoiceChatEndedMessage
+  & TT.Message.VoiceChatEndedMessage
 
 type CommonMessageBundle = TT.Message.AnimationMessage
   & TT.Message.AudioMessage
@@ -727,6 +773,8 @@ export type Update = TT.Update.CallbackQueryUpdate
   & TT.Update.PollAnswerUpdate
   & TT.Update.PollUpdate
   & TT.Update.ShippingQueryUpdate
+  & TT.Update.MyChatMemberUpdate
+  & TT.Update.ChatMemberUpdate
 
 export interface CallbackQuery extends TT.CallbackQuery.DataCallbackQuery, TT.CallbackQuery.GameShortGameCallbackQuery {
   message: Message
@@ -855,3 +903,5 @@ export interface BotCommand {
    */
   description: string
 }
+
+export type ChatInviteLink = TT.ChatInviteLink

typings/telegram.d.ts

@@ -962,4 +962,39 @@ export declare class Telegram extends ApiClient {
     messageId: number,
     extra?: tt.ExtraCopyMessage
   ): Promise<tt.MessageId>
+
+  /**
+   * Use this method to create an additional invite link for a chat.
+   * @param chatId Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+   * @param extra Extra parameters for createChatInviteLink
+   * @returns the new invite link as ChatInviteLink object
+   */
+  createChatInviteLink(
+    chatId: number | string,
+    extra?: tt.ExtraCreateChatIviteLink
+  ): Promise<tt.ChatInviteLink>
+
+  /**
+   * Use this method to edit a non-primary invite link created by the bot.
+   * @param chatId Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+   * @param inviteLink The invite link to edit
+   * @param extra Extra parameters for editChatInviteLink
+   * @returns the edited invite link as a ChatInviteLink object
+   */
+  editChatInviteLink(
+    chatId: number | string,
+    inviteLink: string,
+    extra?: tt.ExtraEditChatIviteLink
+  ): Promise<tt.ChatInviteLink>
+
+  /**
+   * Use this method to revoke an invite link created by the bot.
+   * @param chatId Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+   * @param inviteLink The invite link to revoke
+   * @returns the revoked invite link as a ChatInviteLink object
+   */
+  revokeChatInviteLink(
+    chatId: number | string,
+    inviteLink: string
+  ): Promise<tt.ChatInviteLink>
 }