Merge pull request #617 from ivankuraev/main

Added chatAdministrators() method
defstudio · Aug 26, 2024 · 847276d · 847276d
2 parents 9af9435 + dfe4e77
commit 847276d
Show file tree

Hide file tree

Showing 4 changed files with 25 additions and 0 deletions.
diff --git a/docs/13.api/2.chats.md b/docs/13.api/2.chats.md
@@ -155,6 +155,14 @@ retrieves a Chat member
 Telegraph::chatMember($userId)->send();
 ```
 
+## `chatAdministrators()`
+
+retrieves a list of administrators in a chat, which aren't bots
+
+```php
+Telegraph::chatAdministrators()->send();
+```
+
 ## `userProfilePhotos()`
 
 retrieves the User's profile photos

diff --git a/src/Concerns/HasBotsAndChats.php b/src/Concerns/HasBotsAndChats.php
@@ -386,6 +386,16 @@ public function chatMember(string $userId): Telegraph
         return $telegraph;
     }
 
+    public function chatAdministrators(): Telegraph
+    {
+        $telegraph = clone $this;
+
+        $telegraph->endpoint = self::ENDPOINT_GET_CHAT_ADMINISTRATORS;
+        $telegraph->data['chat_id'] = $telegraph->getChatId();
+
+        return $telegraph;
+    }
+
     /**
      * @param array<int|string, string|bool> $permissions
      */

diff --git a/src/Telegraph.php b/src/Telegraph.php
@@ -92,6 +92,7 @@ class Telegraph
     public const ENDPOINT_GET_CHAT_INFO = 'getChat';
     public const ENDPOINT_GET_CHAT_MEMBER_COUNT = 'getChatMemberCount';
     public const ENDPOINT_GET_CHAT_MEMBER = 'getChatMember';
+    public const ENDPOINT_GET_CHAT_ADMINISTRATORS = 'getChatAdministrators';
     public const ENDPOINT_SET_CHAT_PERMISSIONS = 'setChatPermissions';
     public const ENDPOINT_BAN_CHAT_MEMBER = 'banChatMember';
     public const ENDPOINT_UNBAN_CHAT_MEMBER = 'unbanChatMember';

diff --git a/tests/Unit/Concerns/HasBotsAndChatsTest.php b/tests/Unit/Concerns/HasBotsAndChatsTest.php
@@ -221,6 +221,12 @@
     })->toMatchTelegramSnapshot();
 });
 
+it('can retrieve a chat administrators', function () {
+    expect(function (\DefStudio\Telegraph\Telegraph $telegraph) {
+        return $telegraph->chat(make_chat())->chatAdministrators();
+    })->toMatchTelegramSnapshot();
+});
+
 it('can generate a chat primary invite link', function () {
     expect(function (\DefStudio\Telegraph\Telegraph $telegraph) {
         return $telegraph->chat(make_chat())->generateChatPrimaryInviteLink();