Add promoteChatMember method

CHANGELOG.md

@@ -21,6 +21,7 @@
 - New #32: Add `setMessageReaction` method and `ReactionType::toRequestArray()` method.
 - New #33: Add `banChatMember` and `unbanChatMember` methods.
 - New #34: Add `restrictChatMember` method and `ChatPermissions::toRequestArray()` method.
+- New #35: Add `promoteChatMember` method.
 - Chg #24: Move update methods to `Vjik\TelegramBot\Api\Method\Update` namespace, and update types to
   `Vjik\TelegramBot\Api\Type\Update` namespace.
 - Chg #30: Remove `TelegramRequestWithFilesInterface`.

src/Method/PromoteChatMember.php

@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Vjik\TelegramBot\Api\Method;
+
+use Vjik\TelegramBot\Api\Request\HttpMethod;
+use Vjik\TelegramBot\Api\Request\TelegramRequestWithResultPreparingInterface;
+
+/**
+ * @see https://core.telegram.org/bots/api#promotechatmember
+ */
+final readonly class PromoteChatMember implements TelegramRequestWithResultPreparingInterface
+{
+    public function __construct(
+        private int|string $chatId,
+        private int $userId,
+        private ?bool $isAnonymous = null,
+        private ?bool $canManageChat = null,
+        private ?bool $canDeleteMessages = null,
+        private ?bool $canManageVideoChats = null,
+        private ?bool $canRestrictMembers = null,
+        private ?bool $canPromoteMembers = null,
+        private ?bool $canChangeInfo = null,
+        private ?bool $canInviteUsers = null,
+        private ?bool $canPostStories = null,
+        private ?bool $canEditStories = null,
+        private ?bool $canDeleteStories = null,
+        private ?bool $canPostMessages = null,
+        private ?bool $canEditMessages = null,
+        private ?bool $canPinMessages = null,
+        private ?bool $canManageTopics = null,
+    ) {
+    }
+
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::POST;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'promoteChatMember';
+    }
+
+    public function getData(): array
+    {
+        return array_filter(
+            [
+                'chat_id' => $this->chatId,
+                'user_id' => $this->userId,
+                'is_anonymous' => $this->isAnonymous,
+                'can_manage_chat' => $this->canManageChat,
+                'can_delete_messages' => $this->canDeleteMessages,
+                'can_manage_video_chats' => $this->canManageVideoChats,
+                'can_restrict_members' => $this->canRestrictMembers,
+                'can_promote_members' => $this->canPromoteMembers,
+                'can_change_info' => $this->canChangeInfo,
+                'can_invite_users' => $this->canInviteUsers,
+                'can_post_stories' => $this->canPostStories,
+                'can_edit_stories' => $this->canEditStories,
+                'can_delete_stories' => $this->canDeleteStories,
+                'can_post_messages' => $this->canPostMessages,
+                'can_edit_messages' => $this->canEditMessages,
+                'can_pin_messages' => $this->canPinMessages,
+                'can_manage_topics' => $this->canManageTopics,
+            ],
+            static fn(mixed $value): bool => $value !== null,
+        );
+    }
+
+    public function prepareResult(mixed $result): true
+    {
+        return true;
+    }
+}

src/TelegramBotApi.php

@@ -26,6 +26,7 @@
 use Vjik\TelegramBot\Api\Method\GetUserProfilePhotos;
 use Vjik\TelegramBot\Api\Method\LogOut;
 use Vjik\TelegramBot\Api\Method\Payments\GetStarTransactions;
+use Vjik\TelegramBot\Api\Method\PromoteChatMember;
 use Vjik\TelegramBot\Api\Method\RestrictChatMember;
 use Vjik\TelegramBot\Api\Method\SendAnimation;
 use Vjik\TelegramBot\Api\Method\SendAudio;
@@ -440,6 +441,53 @@ public function logOut(): FailResult|true
         return $this->send(new LogOut());
     }
 
+    /**
+     * @see https://core.telegram.org/bots/api#promotechatmember
+     *
+     * @psalm-suppress MixedInferredReturnType,MixedReturnStatement
+     */
+    public function promoteChatMember(
+        int|string $chatId,
+        int $userId,
+        ?bool $isAnonymous = null,
+        ?bool $canManageChat = null,
+        ?bool $canDeleteMessages = null,
+        ?bool $canManageVideoChats = null,
+        ?bool $canRestrictMembers = null,
+        ?bool $canPromoteMembers = null,
+        ?bool $canChangeInfo = null,
+        ?bool $canInviteUsers = null,
+        ?bool $canPostStories = null,
+        ?bool $canEditStories = null,
+        ?bool $canDeleteStories = null,
+        ?bool $canPostMessages = null,
+        ?bool $canEditMessages = null,
+        ?bool $canPinMessages = null,
+        ?bool $canManageTopics = null,
+    ): FailResult|true {
+        return $this->send(
+            new PromoteChatMember(
+                $chatId,
+                $userId,
+                $isAnonymous,
+                $canManageChat,
+                $canDeleteMessages,
+                $canManageVideoChats,
+                $canRestrictMembers,
+                $canPromoteMembers,
+                $canChangeInfo,
+                $canInviteUsers,
+                $canPostStories,
+                $canEditStories,
+                $canDeleteStories,
+                $canPostMessages,
+                $canEditMessages,
+                $canPinMessages,
+                $canManageTopics
+            )
+        );
+    }
+
     /**
      * @see https://core.telegram.org/bots/api#restrictchatmember
      *

tests/Method/PromoteChatMemberTest.php

@@ -0,0 +1,82 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Vjik\TelegramBot\Api\Tests\Method;
+
+use PHPUnit\Framework\TestCase;
+use Vjik\TelegramBot\Api\Method\PromoteChatMember;
+use Vjik\TelegramBot\Api\Request\HttpMethod;
+
+final class PromoteChatMemberTest extends TestCase
+{
+    public function testBase(): void
+    {
+        $method = new PromoteChatMember(1, 2);
+
+        $this->assertSame(HttpMethod::POST, $method->getHttpMethod());
+        $this->assertSame('promoteChatMember', $method->getApiMethod());
+        $this->assertSame(
+            [
+                'chat_id' => 1,
+                'user_id' => 2,
+            ],
+            $method->getData(),
+        );
+    }
+
+    public function testFull(): void
+    {
+        $method = new PromoteChatMember(
+            1,
+            2,
+            true,
+            true,
+            false,
+            true,
+            false,
+            false,
+            false,
+            true,
+            true,
+            false,
+            true,
+            false,
+            true,
+            true,
+            true,
+        );
+
+        $this->assertSame(
+            [
+                'chat_id' => 1,
+                'user_id' => 2,
+                'is_anonymous' => true,
+                'can_manage_chat' => true,
+                'can_delete_messages' => false,
+                'can_manage_video_chats' => true,
+                'can_restrict_members' => false,
+                'can_promote_members' => false,
+                'can_change_info' => false,
+                'can_invite_users' => true,
+                'can_post_stories' => true,
+                'can_edit_stories' => false,
+                'can_delete_stories' => true,
+                'can_post_messages' => false,
+                'can_edit_messages' => true,
+                'can_pin_messages' => true,
+                'can_manage_topics' => true,
+            ],
+            $method->getData()
+        );
+    }
+
+    public function testPrepareResult(): void
+    {
+        $method = new PromoteChatMember(1, 2);
+
+        $preparedResult = $method->prepareResult(true);
+
+        $this->assertTrue($preparedResult);
+    }
+}

tests/TelegramBotApiTest.php

@@ -450,6 +450,18 @@ public function testLogOut(): void
         $this->assertTrue($result);
     }
 
+    public function testPromoteChatMember(): void
+    {
+        $api = $this->createApi([
+            'ok' => true,
+            'result' => true,
+        ]);
+
+        $result = $api->promoteChatMember(1, 2);
+
+        $this->assertTrue($result);
+    }
+
     public function testRestrictChatMember(): void
     {
         $api = $this->createApi([