Added support for editing the media content of messages

Added the method editMessageMedia and new types inputMediaAnimation,
inputMediaAudio, and inputMediaDocument.

Author: unreal4u

src/Telegram/Methods/EditMessageMedia.php

@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace unreal4u\TelegramAPI\Telegram\Methods;
+
+use Psr\Log\LoggerInterface;
+use unreal4u\TelegramAPI\Abstracts\TelegramMethods;
+use unreal4u\TelegramAPI\Abstracts\TelegramTypes;
+use unreal4u\TelegramAPI\Exceptions\InvalidResultType;
+use unreal4u\TelegramAPI\InternalFunctionality\TelegramRawData;
+use unreal4u\TelegramAPI\Telegram\Types\Custom\ResultBoolean;
+use unreal4u\TelegramAPI\Telegram\Types\Inline\Keyboard\Markup;
+use unreal4u\TelegramAPI\Telegram\Types\InputMedia;
+use unreal4u\TelegramAPI\Telegram\Types\Message;
+
+/**
+ * Use this method to edit audio, document, photo, or video messages. If a message is a part of a message album, then it
+ * can be edited only to a photo or a video. Otherwise, message type can be changed arbitrarily. When inline message is
+ * edited, new file can't be uploaded. Use previously uploaded file via its file_id or specify a URL. On success, if the
+ * edited message was sent by the bot, the edited Message is returned, otherwise True is returned.
+ *
+ * Objects defined as-is july 2018
+ *
+ * @see https://core.telegram.org/bots/api#editmessagemedia
+ */
+class EditMessageMedia extends TelegramMethods
+{
+    /**
+     * Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target
+     * channel (in the format @channelusername)
+     * @var string
+     */
+    public $chat_id = '';
+
+    /**
+     * Required if inline_message_id is not specified. Unique identifier of the sent message
+     * @var int
+     */
+    public $message_id = 0;
+
+    /**
+     * Required if chat_id and message_id are not specified. Identifier of the inline message
+     * @var string
+     */
+    public $inline_message_id = '';
+
+    /**
+     * A JSON-serialized object for a new media content of the message
+     * @var InputMedia
+     */
+    public $media;
+
+    /**
+     * Optional. A JSON-serialized object for an inline keyboard.
+     * @var Markup
+     */
+    public $reply_markup;
+
+    public function getMandatoryFields(): array
+    {
+        $returnValue[] = 'media';
+        $this->mandatoryUserOrInlineMessageId($returnValue);
+        return $returnValue;
+    }
+
+    /**
+     * @param TelegramRawData $data
+     * @param LoggerInterface $logger
+     * @return TelegramTypes
+     * @throws InvalidResultType
+     */
+    public static function bindToObject(TelegramRawData $data, LoggerInterface $logger): TelegramTypes
+    {
+        $typeOfResult = $data->getTypeOfResult();
+        switch ($typeOfResult) {
+            case 'array':
+                return new Message($data->getResult(), $logger);
+            case 'boolean':
+                return new ResultBoolean($data->getResultBoolean(), $logger);
+            default:
+                throw new InvalidResultType(sprintf(
+                    'Result is of type: %s. Expecting one of array or boolean',
+                    $typeOfResult
+                ));
+        }
+    }
+}

src/Telegram/Methods/SendPhoto.php

@@ -6,6 +6,7 @@
 
 use unreal4u\TelegramAPI\Abstracts\TelegramMethods;
 use unreal4u\TelegramAPI\Telegram\Types\Custom\InputFile;
+use unreal4u\TelegramAPI\Telegram\Types\Inline\Keyboard\Markup;
 
 /**
  * Use this method to send photos. On success, the sent Message is returned
@@ -61,7 +62,7 @@ class SendPhoto extends TelegramMethods
     /**
      * Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to
      * hide keyboard or to force a reply from the user
-     * @var null
+     * @var Markup
      */
     public $reply_markup;
 

src/Telegram/Methods/SendVideo.php

@@ -52,6 +52,12 @@ class SendVideo extends TelegramMethods
      */
     public $height = 0;
 
+    /**
+     *
+     * @var InputFile
+     */
+    public $thumb;
+
     /**
      * Video caption (may also be used when resending videos by file_id).
      * @var string

src/Telegram/Types/InputMedia/Animation.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace unreal4u\TelegramAPI\Telegram\Types\InputMedia;
+
+use unreal4u\TelegramAPI\Telegram\Types\Custom\InputFile;
+use unreal4u\TelegramAPI\Telegram\Types\InputMedia;
+
+/**
+ * Represents a video to be sent.
+ *
+ * Objects defined as-is February 2018
+ *
+ * @see https://core.telegram.org/bots/api#inputmediavideo
+ */
+class Animation extends InputMedia
+{
+    /**
+     * Type of the result, must be video
+     * @var string
+     */
+    public $type = 'animation';
+
+    /**
+     * Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A
+     * thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data.
+     * Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>”
+     * if the thumbnail was uploaded using multipart/form-data under <file_attach_name>.
+     * @var InputFile
+     */
+    public $thumb;
+
+    /**
+     * Optional. Animation width
+     * @var int
+     */
+    public $width = 0;
+
+    /**
+     * Optional. Animation height
+     * @var int
+     */
+    public $height = 0;
+
+    /**
+     * Optional. Duration of the audio in seconds
+     * @var int
+     */
+    public $duration = 0;
+}

src/Telegram/Types/InputMedia/Audio.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace unreal4u\TelegramAPI\Telegram\Types\InputMedia;
+
+use unreal4u\TelegramAPI\Telegram\Types\Custom\InputFile;
+use unreal4u\TelegramAPI\Telegram\Types\InputMedia;
+
+/**
+ * Represents a video to be sent.
+ *
+ * Objects defined as-is February 2018
+ *
+ * @see https://core.telegram.org/bots/api#inputmediavideo
+ */
+class Audio extends InputMedia
+{
+    /**
+     * Type of the result, must be video
+     * @var string
+     */
+    public $type = 'audio';
+
+    /**
+     * Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A
+     * thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data.
+     * Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>”
+     * if the thumbnail was uploaded using multipart/form-data under <file_attach_name>.
+     * @var InputFile
+     */
+    public $thumb;
+
+    /**
+     * Optional. Duration of the audio in seconds
+     * @var int
+     */
+    public $duration = 0;
+
+    /**
+     * Optional. Performer of the audio
+     * @var string
+     */
+    public $performer = '';
+
+    /**
+     * Optional. Title of the audio
+     * @var string
+     */
+    public $title = '';
+}

src/Telegram/Types/InputMedia/Document.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace unreal4u\TelegramAPI\Telegram\Types\InputMedia;
+
+use unreal4u\TelegramAPI\Telegram\Types\Custom\InputFile;
+use unreal4u\TelegramAPI\Telegram\Types\InputMedia;
+
+/**
+ * Represents a photo to be sent.
+ *
+ * Objects defined as-is november 2017
+ *
+ * @see https://core.telegram.org/bots/api#inputmediaphoto
+ */
+class Document extends InputMedia
+{
+    /**
+     * Type of the result, must be photo
+     * @var string
+     */
+    public $type = 'document';
+
+    /**
+     * Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A
+     * thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data.
+     * Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>”
+     * if the thumbnail was uploaded using multipart/form-data under <file_attach_name>.
+     * @var InputFile
+     */
+    public $thumb;
+}