Update doc

Change url address

README.md

@@ -16,6 +16,8 @@
 
 > Если вы новичок, то можете прочитать [официальную документацию](https://dev.max.ru/), написанную разработчиками Max.
 
+> ℹ️ С полной документацией [вы можете ознакомиться тут](./docs/README.md).
+
 ### Получение токена
 
 Откройте диалог с [MasterBot](https://max.ru/MasterBot), следуйте инструкциям и создайте нового бота. После создания
@@ -43,6 +45,55 @@ composer require bushlanov-dev/max-bot-api-client-php
 
 ### Использование
 
+> [!NOTE] 
+> С 19 июля 2026 основной домен api изменится с platform-api.max.ru на platform-api2.max.ru и начнет использовать чебурнетовский сертификат!  
+> Вам необходимо либо установить сертификат, либо отключить его проверку, оба варианта описаны ниже.
+
+Установка сертификата на примере ОС Ubuntu
+
+```bash
+# корневой сертификат
+curl -k -O "https://gu-st.ru/content/Other/doc/russian_trusted_root_ca.cer"
+# промежуточный сертификат
+curl -k -O "https://gu-st.ru/content/Other/doc/russian_trusted_sub_ca.cer"
+
+sudo cp russian_trusted_root_ca.cer /usr/local/share/ca-certificates/russian_trusted_root_ca.crt
+sudo cp russian_trusted_sub_ca.cer  /usr/local/share/ca-certificates/russian_trusted_sub_ca.crt
+
+sudo update-ca-certificates
+```
+
+> [!TIP] 
+> **Гибкая настройка Guzzle**  
+> Мах часто меняют домен API а теперь еще и сертификат.  
+> Если вы не хотите или не можете установить сертификат на прямую в систему, можно собрать объект API с кастомным Guzzle клиентом и отключить проверку сертификата.  
+> Во всех остальных случаях достаточно минимального $api = new Api('YOUR_BOT_API_TOKEN');
+
+```php
+$guzzle = new \GuzzleHttp\Client([
+    'timeout' => 10,
+    'connect_timeout' => 5,
+    'read_timeout' => 10,
+    'headers' => ['User-Agent' => 'max-bot-api-client-php'],
+    'verify' => false, // Отключить проверку либо путь до сертификата '/path/to/cert.pem'
+]);
+
+$httpFactory = new \GuzzleHttp\Psr7\HttpFactory();
+
+$client = new \BushlanovDev\MaxMessengerBot\Client(
+    accessToken: 'YOUR_BOT_API_TOKEN',
+    httpClient: $guzzle,
+    requestFactory: $httpFactory,
+    streamFactory: $httpFactory,
+    baseUrl: 'https://platform-api2.max.ru',
+);
+
+$api = new BushlanovDev\MaxMessengerBot\Api(
+    client: $client,
+    modelFactory: new BushlanovDev\MaxMessengerBot\ModelFactory(),
+);
+```
+
 Отправка сообщения с клавиатурой
 
 ```php
@@ -134,7 +185,7 @@ $handler->handle();
 
 #### Chats
 
-- [x] `GET /chats` (`getChats`) - [*Получение списка всех чатов бота.*](./docs/README.md#Получение-списка-всех-чатов-бота)
+- [x] ~~`GET /chats` (`getChats`) - [*Получение списка всех чатов бота.*](./docs/README.md#Получение-списка-всех-чатов-бота-deprecated)~~ (deprecated)
 - [x] `GET /chats/{chatLink}` (`getChatByLink`) - [*Получение информации о чате по ссылке.*](./docs/README.md#Получение-информации-о-чате-по-ссылке)
 - [x] `GET /chats/{chatId}` (`getChat`) - [*Получение информации о чате по ID.*](./docs/README.md#Получение-информации-о-чате-по-ID)
 - [x] `PATCH /chats/{chatId}` (`editChat`) - [*Редактирование информации о чате.*](./docs/README.md#Редактирование-информации-о-чате)

composer.json

@@ -33,10 +33,10 @@
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.77",
         "bushlanov-dev/php-coverage-badger": "^2.1",
-        "laravel/framework": "^11.0",
+        "laravel/framework": "^12.0",
         "mikey179/vfsstream": "^1.6",
         "mockery/mockery": "^1.6",
-        "orchestra/testbench": "^9.0",
+        "orchestra/testbench": "^10.0",
         "php-mock/php-mock-phpunit": "^2.13",
         "phpstan/phpstan": "^2.1",
         "phpunit/phpunit": "^12.0",

docs/README.md

@@ -6,7 +6,7 @@
     - `GET /me` (`getBotInfo`) - [*Получение информации о боте.*](#Получение-информации-о-боте)
     - `PATCH /me` (`editBotInfo`) - [*Редактирование информации о боте.*](#Редактирование-информации-о-боте)
 - [Чаты](#Чаты)
-    - `GET /chats` (`getChats`) - [*Получение списка всех чатов бота.*](#Получение-списка-всех-чатов-бота)
+    - ~~`GET /chats` (`getChats`)~~ - [*Получение списка всех чатов бота.*](#Получение-списка-всех-чатов-бота-deprecated) (deprecated)
     - `GET /chats/{chatLink}` (`getChatByLink`) - [*Получение информации о чате по ссылке.*](#Получение-информации-о-чате-по-ссылке)
     - `GET /chats/{chatId}` (`getChat`) - [*Получение информации о чате по ID.*](#Получение-информации-о-чате-по-ID)
     - `PATCH /chats/{chatId}` (`editChat`) - [*Редактирование информации о чате.*](#Редактирование-информации-о-чате)
@@ -84,10 +84,27 @@ $api = new Api('YOUR_BOT_API_TOKEN');
 Так же вы можете создать экземпляр бота гибко настроив все зависимости под свои нужды.
 
 ```php
-$api = new Api(
-    client: new Client(...),
-    modelFactory: new ModelFactory(),
-    logger: new YourPsrLogger(),
+$guzzle = new \GuzzleHttp\Client([
+    'timeout' => 10,
+    'connect_timeout' => 5,
+    'read_timeout' => 10,
+    'headers' => ['User-Agent' => 'max-bot-api-client-php'],
+    // 'verify' => false, // Отключить проверку либо путь до сертификата '/path/to/cert.pem'
+]);
+
+$httpFactory = new \GuzzleHttp\Psr7\HttpFactory();
+
+$client = new \BushlanovDev\MaxMessengerBot\Client(
+    accessToken: 'YOUR_BOT_API_TOKEN',
+    httpClient: $guzzle,
+    requestFactory: $httpFactory,
+    streamFactory: $httpFactory,
+    baseUrl: 'https://platform-api2.max.ru',
+);
+
+$api = new BushlanovDev\MaxMessengerBot\Api(
+    client: $client,
+    modelFactory: new BushlanovDev\MaxMessengerBot\ModelFactory(),
 );
 ```
 
@@ -119,7 +136,7 @@ $botInfo = $api->editBotInfo(
 
 ## Чаты
 
-### Получение списка всех чатов бота
+### Получение списка всех чатов бота (deprecated)
 
 Возвращает информацию о чатах, в которых участвовал бот. 
 Результат включает список чатов и маркер для перехода к следующей странице.

src/Api.php

@@ -48,11 +48,11 @@ use RuntimeException;
  */
 class Api
 {
-    public const string LIBRARY_VERSION = '1.6.2';
+    public const string LIBRARY_VERSION = '1.6.4';
 
     public const string API_VERSION = '1.2.5';
 
-    private const string API_BASE_URL = 'https://platform-api.max.ru';
+    private const string API_BASE_URL = 'https://platform-api2.max.ru';
 
     private const string METHOD_GET = 'GET';
     private const string METHOD_POST = 'POST';

src/Enums/InlineButtonType.php

@@ -13,4 +13,5 @@ enum InlineButtonType: string
     case OpenApp = 'open_app';
     case Message = 'message';
     case Chat = 'chat';
+    case Clipboard = 'clipboard';
 }

src/ModelFactory.php

@@ -14,6 +14,7 @@ use BushlanovDev\MaxMessengerBot\Models\Attachments\AudioAttachment;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\AbstractInlineButton;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\CallbackButton;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\ChatButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\ClipboardButton;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\LinkButton;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\MessageButton;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\OpenAppButton;
@@ -300,6 +301,7 @@ readonly class ModelFactory
             InlineButtonType::RequestGeoLocation => RequestGeoLocationButton::fromArray($data),
             InlineButtonType::Chat => ChatButton::fromArray($data),
             InlineButtonType::OpenApp => OpenAppButton::fromArray($data),
+            InlineButtonType::Clipboard => ClipboardButton::fromArray($data),
             InlineButtonType::Message => MessageButton::fromArray($data),
             default => throw new LogicException(
                 'Unknown or unsupported inline button type: ' . ($data['type'] ?? 'none')

src/Models/Attachments/Buttons/Inline/ClipboardButton.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline;
+
+use BushlanovDev\MaxMessengerBot\Enums\InlineButtonType;
+
+/**
+ * A button that, when clicked, copies text to the clipboard.
+ */
+final readonly class ClipboardButton extends AbstractInlineButton
+{
+    public ?string $payload;
+
+    /**
+     * @param string $text Visible button text (1 to 128 characters).
+     * @param string $payload Text which will be copied.
+     */
+    public function __construct(string $text, string $payload)
+    {
+        parent::__construct(InlineButtonType::Clipboard, $text);
+
+        $this->payload = $payload;
+    }
+}

tests/ApiFactoryMethodsTest.php

@@ -10,6 +10,7 @@ use BushlanovDev\MaxMessengerBot\LongPollingHandler;
 use BushlanovDev\MaxMessengerBot\ModelFactory;
 use BushlanovDev\MaxMessengerBot\UpdateDispatcher;
 use BushlanovDev\MaxMessengerBot\WebhookHandler;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\Attributes\UsesClass;
@@ -19,6 +20,7 @@ use Psr\Log\LoggerInterface;
 use ReflectionClass;
 
 #[CoversClass(Api::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(UpdateDispatcher::class)]
 #[UsesClass(WebhookHandler::class)]
 #[UsesClass(LongPollingHandler::class)]

tests/ApiTest.php

@@ -62,6 +62,7 @@ use InvalidArgumentException;
 use LogicException;
 use org\bovigo\vfs\vfsStream;
 use phpmock\phpunit\PHPMock;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\PreserveGlobalState;
 use PHPUnit\Framework\Attributes\RunInSeparateProcess;
@@ -75,6 +76,7 @@ use ReflectionClass;
 use RuntimeException;
 
 #[CoversClass(Api::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(Result::class)]
 #[UsesClass(Client::class)]
 #[UsesClass(BotInfo::class)]

tests/ClientTest.php

@@ -16,6 +16,7 @@ use BushlanovDev\MaxMessengerBot\Exceptions\SerializationException;
 use BushlanovDev\MaxMessengerBot\Exceptions\UnauthorizedException;
 use GuzzleHttp\Psr7\HttpFactory;
 use InvalidArgumentException;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
@@ -32,6 +33,7 @@ use Psr\Http\Message\StreamInterface;
 use Psr\Log\LoggerInterface;
 
 #[CoversClass(Client::class)]
+#[AllowMockObjectsWithoutExpectations]
 final class ClientTest extends TestCase
 {
     private const string FAKE_TOKEN = '12345:abcdef';

tests/Laravel/Commands/PollingStartCommandTest.php

@@ -7,6 +7,7 @@ namespace BushlanovDev\MaxMessengerBot\Tests\Laravel\Commands;
 use BushlanovDev\MaxMessengerBot\Laravel\Commands\PollingStartCommand;
 use BushlanovDev\MaxMessengerBot\Laravel\MaxBotManager;
 use Illuminate\Support\Facades\Log;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\Attributes\UsesClass;
@@ -15,6 +16,7 @@ use Symfony\Component\Console\Application as ConsoleApplication;
 use Symfony\Component\Console\Tester\CommandTester;
 
 #[CoversClass(PollingStartCommand::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(MaxBotManager::class)]
 final class PollingStartCommandTest extends TestCase
 {

tests/Laravel/Commands/WebhookListCommandTest.php

@@ -9,6 +9,7 @@ use BushlanovDev\MaxMessengerBot\Enums\UpdateType;
 use BushlanovDev\MaxMessengerBot\Laravel\Commands\WebhookListCommand;
 use BushlanovDev\MaxMessengerBot\Models\Subscription;
 use Illuminate\Support\Facades\Log;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\Attributes\UsesClass;
@@ -17,6 +18,7 @@ use Symfony\Component\Console\Application as ConsoleApplication;
 use Symfony\Component\Console\Tester\CommandTester;
 
 #[CoversClass(WebhookListCommand::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(Api::class)]
 #[UsesClass(Subscription::class)]
 final class WebhookListCommandTest extends TestCase

tests/Laravel/Commands/WebhookSubscribeCommandTest.php

@@ -10,6 +10,7 @@ use BushlanovDev\MaxMessengerBot\Laravel\Commands\WebhookSubscribeCommand;
 use BushlanovDev\MaxMessengerBot\Models\Result;
 use Illuminate\Contracts\Config\Repository as Config;
 use Illuminate\Support\Facades\Log;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\Attributes\UsesClass;
@@ -18,6 +19,7 @@ use Symfony\Component\Console\Application as ConsoleApplication;
 use Symfony\Component\Console\Tester\CommandTester;
 
 #[CoversClass(WebhookSubscribeCommand::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(Api::class)]
 #[UsesClass(Result::class)]
 final class WebhookSubscribeCommandTest extends TestCase

tests/Laravel/Commands/WebhookUnsubscribeCommandTest.php

@@ -8,6 +8,7 @@ use BushlanovDev\MaxMessengerBot\Api;
 use BushlanovDev\MaxMessengerBot\Laravel\Commands\WebhookUnsubscribeCommand;
 use BushlanovDev\MaxMessengerBot\Models\Result;
 use Illuminate\Support\Facades\Log;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\Attributes\UsesClass;
@@ -16,6 +17,7 @@ use Symfony\Component\Console\Application as ConsoleApplication;
 use Symfony\Component\Console\Tester\CommandTester;
 
 #[CoversClass(WebhookUnsubscribeCommand::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(Api::class)]
 #[UsesClass(Result::class)]
 final class WebhookUnsubscribeCommandTest extends TestCase

tests/Laravel/MaxBotManagerTest.php

@@ -20,6 +20,7 @@ use Illuminate\Container\Container;
 use Illuminate\Contracts\Config\Repository;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Facade;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\Attributes\UsesClass;
@@ -28,6 +29,7 @@ use PHPUnit\Framework\TestCase;
 use Psr\Log\LoggerInterface;
 
 #[CoversClass(MaxBotManager::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(Message::class)]
 #[UsesClass(MessageBody::class)]
 #[UsesClass(Recipient::class)]

tests/Laravel/MaxBotServiceProviderTest.php

@@ -22,6 +22,7 @@ use InvalidArgumentException;
 use LogicException;
 use Orchestra\Testbench\TestCase;
 use phpmock\phpunit\PHPMock;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\PreserveGlobalState;
@@ -33,6 +34,7 @@ use Psr\Log\NullLogger;
 use ReflectionClass;
 
 #[CoversClass(MaxBotServiceProvider::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(Api::class)]
 #[UsesClass(Client::class)]
 #[UsesClass(UpdateDispatcher::class)]

tests/LongPollingHandlerTest.php

@@ -16,6 +16,7 @@ use BushlanovDev\MaxMessengerBot\UpdateDispatcher;
 use Error;
 use Exception;
 use phpmock\phpunit\PHPMock;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\PreserveGlobalState;
@@ -26,6 +27,7 @@ use PHPUnit\Framework\TestCase;
 use Psr\Log\LoggerInterface;
 
 #[CoversClass(LongPollingHandler::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(UpdateDispatcher::class)]
 #[UsesClass(UpdateList::class)]
 #[UsesClass(AbstractUpdate::class)]

tests/Models/Attachments/Buttons/Inline/ClipboardButtonTest.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Tests\Models\Attachments\Buttons\Inline;
+
+use BushlanovDev\MaxMessengerBot\Enums\InlineButtonType;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\ClipboardButton;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(ClipboardButton::class)]
+final class ClipboardButtonTest extends TestCase
+{
+    #[Test]
+    public function toArraySerializesCorrectly(): void
+    {
+        $button = new ClipboardButton('display', 'copy');
+
+        $expectedArray = [
+            'payload' => 'copy',
+            'type' => InlineButtonType::Clipboard->value,
+            'text' => 'display',
+        ];
+
+        $resultArray = $button->toArray();
+
+        $this->assertSame($expectedArray, $resultArray);
+    }
+
+    #[Test]
+    public function fromArrayHydratesCorrectly(): void
+    {
+        $data = [
+            'type' => 'clipboard',
+            'text' => 'display',
+            'payload' => 'copy'
+        ];
+
+        $button = ClipboardButton::fromArray($data);
+
+        $this->assertInstanceOf(ClipboardButton::class, $button);
+        $this->assertSame(InlineButtonType::Clipboard, $button->type);
+        $this->assertSame('display', $button->text);
+        $this->assertSame('copy', $button->payload);
+    }
+}

tests/UpdateDispatcherTest.php

@@ -14,12 +14,14 @@ use BushlanovDev\MaxMessengerBot\Models\Updates\BotStartedUpdate;
 use BushlanovDev\MaxMessengerBot\Models\Updates\MessageCreatedUpdate;
 use BushlanovDev\MaxMessengerBot\Models\UserWithPhoto;
 use BushlanovDev\MaxMessengerBot\UpdateDispatcher;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\Attributes\UsesClass;
 use PHPUnit\Framework\TestCase;
 
 #[CoversClass(UpdateDispatcher::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(UserWithPhoto::class)]
 #[UsesClass(BotStartedUpdate::class)]
 #[UsesClass(Message::class)]

tests/WebhookHandlerTest.php

@@ -19,6 +19,7 @@ use BushlanovDev\MaxMessengerBot\UpdateDispatcher;
 use BushlanovDev\MaxMessengerBot\WebhookHandler;
 use LogicException;
 use phpmock\phpunit\PHPMock;
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\PreserveGlobalState;
@@ -32,6 +33,7 @@ use Psr\Http\Message\StreamInterface;
 use Psr\Log\LoggerInterface;
 
 #[CoversClass(WebhookHandler::class)]
+#[AllowMockObjectsWithoutExpectations]
 #[UsesClass(UpdateDispatcher::class)]
 #[UsesClass(Message::class)]
 #[UsesClass(MessageBody::class)]