Support Bot API 4.2

Author: exileed

src/Api.php

@@ -12,6 +12,7 @@
 use Telegram\Bot\Objects\ChatMember;
 use Telegram\Bot\Objects\File;
 use Telegram\Bot\Objects\Message;
+use Telegram\Bot\Objects\Poll;
 use Telegram\Bot\Objects\StickerSet;
 use Telegram\Bot\Objects\UnknownObject;
 use Telegram\Bot\Objects\Update;
@@ -1069,6 +1070,42 @@ public function sendContact(array $params)
         return new Message($response->getDecodedBody());
     }
 
+    /**
+     * Send a native pol.
+     *
+     * <code>
+     * $params = [
+     *   'chat_id'              => '',
+     *   'question'             => '',
+     *   'options'              => '',
+     *   'disable_notification' => '',
+     *   'reply_to_message_id'  => '',
+     *   'reply_markup'         => '',
+     * ];
+     * </code>
+     *
+     * @link https://core.telegram.org/bots/api#sendpoll
+     *
+     * @param array $params
+     *
+     * @var int|string $params ['chat_id']
+     * @var string     $params ['question']
+     * @var string     $params ['options']
+     * @var string     $params ['disable_notification']
+     * @var int        $params ['reply_to_message_id']
+     * @var string     $params ['reply_markup']
+     *
+     * @throws TelegramSDKException
+     *
+     * @return Message
+     */
+    public function sendPoll(array $params)
+    {
+        $response = $this->post('sendPoll', $params);
+
+        return new Message($response->getDecodedBody());
+    }
+
     /**
      * Broadcast a Chat Action.
      *
@@ -1519,6 +1556,37 @@ public function editMessageReplyMarkup(array $params)
         return new Message($response->getDecodedBody());
     }
 
+
+    /**
+     * Stop a poll which was sent by the bot.
+     *
+     * <code>
+     * $params = [
+     *   'chat_id'                  => '',
+     *   'message_id'               => '',
+     *   'reply_markup'             => '',
+     * ];
+     * </code>
+     *
+     * @link https://core.telegram.org/bots/api#stoppoll
+     *
+     * @param array $params
+     *
+     * @var int|string $params ['chat_id']
+     * @var int        $params ['message_id']
+     * @var string     $params ['reply_markup']
+     *
+     * @throws TelegramSDKException
+     *
+     * @return Poll
+     */
+    public function stopPoll(array $params)
+    {
+        $response = $this->post('stopPoll', $params);
+
+        return new Poll($response->getDecodedBody());
+    }
+
     /**
      * Use this method to send answers to an inline query.
      *

src/Objects/ChatMember.php

@@ -5,9 +5,9 @@
 /**
  * Class ChatMember.
  *
- * @method User            getUser()             Information about the user.
- * @method string          getStatus()           (Optional). The member's status in the chat. Can be “creator”, “administrator”, “member”, “left” or “kicked”
- * @method int         getUntilDate()               (Optional). Restictred and kicked only. Date when restrictions will be lifted for this user, unix time
+ * @method User            getUser()                                Information about the user.
+ * @method string          getStatus()                  (Optional). The member's status in the chat. Can be “creator”, “administrator”, “member”, “left” or “kicked”
+ * @method int             getUntilDate()               (Optional). Restictred and kicked only. Date when restrictions will be lifted for this user, unix time
  * @method bool            getCanBeEdited()             (Optional). Administrators only. True, if the bot is allowed to edit administrator privileges of that user
  * @method bool            getCanChangeInfo()           (Optional). Administrators only. True, if the administrator can change the chat title, photo and other settings
  * @method bool            getCanPostMessages()         (Optional). Administrators only. True, if the administrator can post in the channel, channels only
@@ -17,6 +17,7 @@
  * @method bool            getCanRestrictMembers()      (Optional). Administrators only. True, if the administrator can restrict, ban or unban chat members
  * @method bool            getCanPinMessages()          (Optional). Administrators only. True, if the administrator can pin messages, supergroups only
  * @method bool            getCanPromoteMembers()       (Optional). Administrators only. True, if the administrator can add new administrators with a subset of his own privileges
+ * @method bool            getIsMember()                (Optional). Restricted only. True, if the user is a member of the chat at the moment of the request
  * @method bool            getCanSendMessages()         (Optional). Restricted only. True, if the user can send text messages, contacts, locations and venues
  * @method bool            getCanSendMediaMessages()    (Optional). Restricted only. True, if the user can send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages
  * @method bool            getCanSendOtherMessages()    (Optional). Restricted only. True, if the user can send animations, games, stickers and use inline bots, implies can_send_media_messages

src/Objects/Message.php

@@ -11,8 +11,9 @@
  * @method int              getDate()                   Date the message was sent in Unix time.
  * @method Chat             getChat()                   Conversation the message belongs to.
  * @method User             getForwardFrom()            (Optional). For forwarded messages, sender of the original message.
- * @method Chat             getForwardFromChat()        (Optional).    Optional. For messages forwarded from a channel, information about the original channel
+ * @method Chat             getForwardFromChat()        (Optional). For messages forwarded from a channel, information about the original channel
  * @method string           getForwardSignature()	    (Optional). For messages forwarded from channels, signature of the post author if present
+ * @method string           getForwardSenderName()	    (Optional). Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages
  * @method int              getForwardDate()            (Optional). For forwarded messages, date the original message was sent in Unix time.
  * @method Message          getReplyToMessage()         (Optional). 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.
  * @method int              getEditDate()               (Optional). Date the message was last edited in Unix time.
@@ -31,6 +32,7 @@
  * @method Contact          getContact()                (Optional). Message is a shared contact, information about the contact.
  * @method Location         getLocation()               (Optional). Message is a shared location, information about the location.
  * @method Venue            getVenue()                  (Optional). Message is a venue, information about the venue.
+ * @method Poll             getPoll()                   (Optional). Message is a native poll, information about the poll.
  * @method User             getNewChatMember()          (Optional). A new member was added to the group, information about them (this member may be the bot itself).
  * @method User[]           getNewChatMembers()         (Optional). New members that were added to the group or supergroup and information about them (the bot itself may be one of these members)
  * @method User             getLeftChatMember()         (Optional). A member was removed from the group, information about them (this member may be the bot itself).

src/Objects/Poll.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Telegram\Bot\Objects;
+
+/**
+ * Class Poll.
+ *
+ *
+ * @method string        getId()        Unique poll identifier
+ * @method string        getQuestion()  Poll question
+ * @method PollOption[]  getOptions()   List of poll options
+ * @method bool          getIsClosed()  True, if the poll is closed
+ */
+class Poll extends BaseObject
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function relations()
+    {
+        return [
+            'options' => PollOption::class,
+        ];
+    }
+}

src/Objects/PollOption.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Telegram\Bot\Objects;
+
+/**
+ * Class PollOption.
+ *
+ *
+ * @method string  getText()        Option text, 1-100 characters
+ * @method int     getVoterCount()  Number of users that voted for this option
+ */
+class PollOption extends BaseObject
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function relations()
+    {
+        return [];
+    }
+}

src/Objects/Update.php

@@ -16,6 +16,7 @@
  * @method CallbackQuery        getCallbackQuery()          (Optional). Incoming callback query.
  * @method ShippingQuery        getShippingQuery()          (Optional). New incoming shipping query.
  * @method PreCheckoutQuery     getPreCheckoutQuery()       (Optional). New incoming pre-checkout query.
+ * @method Poll                 getPoll()                   (Optional). New poll state. Bots receive only updates about polls, which are sent or stopped by the bot.
  *
  * @link https://core.telegram.org/bots/api#update
  */