Added getChats & getChatByLink & deleteChat & sendAction

Author: BushlanovDev

README.md

@@ -30,12 +30,12 @@
 
 #### Chats
 
-- [ ] `GET /chats` (`getChats`) — *Получение списка всех чатов бота.*
-- [ ] `GET /chats/{chatLink}` (`getChatByLink`) — *Получение информации о чате по ссылке.*
+- [x] `GET /chats` (`getChats`) — *Получение списка всех чатов бота.*
+- [x] `GET /chats/{chatLink}` (`getChatByLink`) — *Получение информации о чате по ссылке.*
 - [x] `GET /chats/{chatId}` (`getChat`) — *Получение информации о чате по ID.*
 - [ ] `PATCH /chats/{chatId}` (`editChat`) — *Редактирование информации о чате.*
-- [ ] `DELETE /chats/{chatId}` (`deleteChat`) — *Удаление чата.*
-- [ ] `POST /chats/{chatId}/actions` (`sendAction`) — *Отправка действия в чат (например, "печатает...").*
+- [x] `DELETE /chats/{chatId}` (`deleteChat`) — *Удаление чата.*
+- [x] `POST /chats/{chatId}/actions` (`sendAction`) — *Отправка действия в чат (например, "печатает...").*
 - [ ] `GET /chats/{chatId}/pin` (`getPinnedMessage`) — *Получение закрепленного сообщения.*
 - [ ] `PUT /chats/{chatId}/pin` (`pinMessage`) — *Закрепление сообщения.*
 - [ ] `DELETE /chats/{chatId}/pin` (`unpinMessage`) — *Открепление сообщения.*
@@ -68,3 +68,7 @@
 - [ ] `GET /messages/{messageId}` (`getMessageById`) — *Получение сообщения по ID.*
 - [ ] `GET /videos/{videoToken}` (`getVideoAttachmentDetails`) — *Получение детальной информации о видео.*
 - [ ] `POST /answers` (`answerOnCallback`) — *Ответ на нажатие callback-кнопки.*
+
+## Лицензия
+
+Данная библиотека распространяется по лицензии MIT - подробности см. в файле [LICENSE](LICENSE).

src/Api.php

@@ -5,6 +5,7 @@
 namespace BushlanovDev\MaxMessengerBot;
 
 use BushlanovDev\MaxMessengerBot\Enums\MessageFormat;
+use BushlanovDev\MaxMessengerBot\Enums\SenderAction;
 use BushlanovDev\MaxMessengerBot\Enums\UpdateType;
 use BushlanovDev\MaxMessengerBot\Enums\UploadType;
 use BushlanovDev\MaxMessengerBot\Exceptions\ClientApiException;
@@ -19,6 +20,7 @@
 use BushlanovDev\MaxMessengerBot\Models\Attachments\Requests\VideoAttachmentRequest;
 use BushlanovDev\MaxMessengerBot\Models\BotInfo;
 use BushlanovDev\MaxMessengerBot\Models\Chat;
+use BushlanovDev\MaxMessengerBot\Models\ChatList;
 use BushlanovDev\MaxMessengerBot\Models\Message;
 use BushlanovDev\MaxMessengerBot\Models\MessageLink;
 use BushlanovDev\MaxMessengerBot\Models\Result;
@@ -46,6 +48,7 @@ class Api
     private const string METHOD_GET = 'GET';
     private const string METHOD_POST = 'POST';
     private const string METHOD_DELETE = 'DELETE';
+//    private const string METHOD_PATCH = 'PATCH';
 
     private const string ACTION_ME = '/me';
     private const string ACTION_SUBSCRIPTIONS = '/subscriptions';
@@ -477,4 +480,99 @@ public function getChat(int $chatId): Chat
             $this->client->request(self::METHOD_GET, self::ACTION_CHATS . '/' . $chatId)
         );
     }
+
+    /**
+     * Returns chat/channel information by its public link or a dialog with a user by their username.
+     * The link should be prefixed with '@' or can be passed without it.
+     *
+     * @param string $chatLink Public chat link (e.g., '@mychannel') or username (e.g., '@john_doe').
+     *
+     * @return Chat
+     * @throws ClientApiException
+     * @throws NetworkException
+     * @throws ReflectionException
+     * @throws SerializationException
+     */
+    public function getChatByLink(string $chatLink): Chat
+    {
+        return $this->modelFactory->createChat(
+            $this->client->request(
+                self::METHOD_GET,
+                self::ACTION_CHATS . '/' . $chatLink,
+            )
+        );
+    }
+
+    /**
+     * Returns information about chats that the bot participated in. The result is a paginated list.
+     *
+     * @param int|null $count Number of chats requested (1-100, default 50).
+     * @param int|null $marker Points to the next data page. Use null for the first page.
+     *
+     * @return ChatList
+     * @throws ClientApiException
+     * @throws NetworkException
+     * @throws ReflectionException
+     * @throws SerializationException
+     */
+    public function getChats(?int $count = null, ?int $marker = null): ChatList
+    {
+        $query = [
+            'count' => $count,
+            'marker' => $marker,
+        ];
+
+        return $this->modelFactory->createChatList(
+            $this->client->request(
+                self::METHOD_GET,
+                self::ACTION_CHATS,
+                array_filter($query, fn($value) => $value !== null),
+            )
+        );
+    }
+
+    /**
+     * Deletes a chat for all participants. The bot must have appropriate permissions.
+     *
+     * @param int $chatId Chat identifier to delete.
+     *
+     * @return Result
+     * @throws ClientApiException
+     * @throws NetworkException
+     * @throws ReflectionException
+     * @throws SerializationException
+     */
+    public function deleteChat(int $chatId): Result
+    {
+        return $this->modelFactory->createResult(
+            $this->client->request(
+                self::METHOD_DELETE,
+                self::ACTION_CHATS . '/' . $chatId,
+            )
+        );
+    }
+
+    /**
+     * Sends a specific action to a chat, such as 'typing...'. This is used to show bot activity to the user.
+     *
+     * @param int $chatId The identifier of the target chat.
+     * @param SenderAction $action The action to be sent.
+     *
+     * @return Result
+     * @throws ClientApiException
+     * @throws NetworkException
+     * @throws ReflectionException
+     * @throws SerializationException
+     */
+    public function sendAction(int $chatId, SenderAction $action): Result
+    {
+        return $this->modelFactory->createResult(
+            $this->client->request(
+                self::METHOD_POST,
+                self::ACTION_CHATS . '/' . $chatId . '/actions',
+                [],
+                ['action' => $action->value],
+            )
+        );
+    }
 }

src/Enums/SenderAction.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Enums;
+
+/**
+ * Represents the different actions a bot can send to a chat to indicate its status.
+ */
+enum SenderAction: string
+{
+    case TypingOn = 'typing_on';
+    case SendingPhoto = 'sending_photo';
+    case SendingVideo = 'sending_video';
+    case SendingAudio = 'sending_audio';
+    case SendingFile = 'sending_file';
+    case MarkSeen = 'mark_seen';
+}

src/ModelFactory.php

@@ -7,6 +7,7 @@
 use BushlanovDev\MaxMessengerBot\Enums\UpdateType;
 use BushlanovDev\MaxMessengerBot\Models\BotInfo;
 use BushlanovDev\MaxMessengerBot\Models\Chat;
+use BushlanovDev\MaxMessengerBot\Models\ChatList;
 use BushlanovDev\MaxMessengerBot\Models\Message;
 use BushlanovDev\MaxMessengerBot\Models\Result;
 use BushlanovDev\MaxMessengerBot\Models\Subscription;
@@ -178,4 +179,17 @@ public function createUpdate(array $data): AbstractUpdate
             ),
         };
     }
+
+    /**
+     * Information about chat list.
+     *
+     * @param array<string, mixed> $data
+     *
+     * @return ChatList
+     * @throws ReflectionException
+     */
+    public function createChatList(array $data): ChatList
+    {
+        return ChatList::fromArray($data);
+    }
 }

src/Models/ChatList.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models;
+
+use BushlanovDev\MaxMessengerBot\Attributes\ArrayOf;
+
+/**
+ * Represents a paginated list of chats.
+ */
+final readonly class ChatList extends AbstractModel
+{
+    /**
+     * @param Chat[] $chats List of requested chats.
+     * @param int|null $marker Reference to the next page of requested chats. Can be null if it's the last page.
+     */
+    public function __construct(
+        #[ArrayOf(Chat::class)]
+        public array $chats,
+        public ?int $marker,
+    ) {
+    }
+}