fix: auto retry when "too many request" error from API

Author: darkdarin

src/DTO/Response.php

@@ -9,5 +9,6 @@ public function __construct(
         public mixed $result = null,
         public ?int $error_code = null,
         public ?string $description = null,
+        public ?ResponseParameters $parameters = null,
     ) {}
 }

src/DTO/ResponseParameters.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace DarkDarin\TelegramBotSdk\DTO;
+
+/**
+ * Describes why a request was unsuccessful.
+ *
+ * @link https://core.telegram.org/bots/api#responseparameters
+ */
+readonly class ResponseParameters
+{
+    public function __construct(
+        public ?int $migrate_to_chat_id = null,
+        public ?int $retry_after = null,
+    ) {}
+}

src/TransportClient/TransportClient.php

@@ -18,6 +18,7 @@
 class TransportClient implements TransportClientInterface
 {
     private const BASE_URL = 'https://api.telegram.org';
+    private const MAX_RETRY = 10;
 
     public function __construct(
         private readonly ClientInterface $client,
@@ -55,9 +56,22 @@ public function executeMethod(
             } else {
                 $request = $this->makeJsonRequest($method, $parameters);
             }
-            $rawResponse = $this->client->sendRequest($request);
-            /** @var Response $response */
-            $response = $this->serializer->deserialize($rawResponse->getBody()->getContents(), Response::class, 'json');
+
+            $result = false;
+            $retryCount = 0;
+
+            do {
+                $retryCount++;
+                $rawResponse = $this->client->sendRequest($request);
+                /** @var Response $response */
+                $response = $this->serializer->deserialize($rawResponse->getBody()->getContents(), Response::class, 'json');
+                // If returned "Too many requests" - retry after some time
+                if ($response->error_code === 429) {
+                    sleep($response->parameters?->retry_after ?? 1);
+                    continue;
+                }
+                $result = true;
+            } while (!$result || $retryCount >= self::MAX_RETRY);
 
             if ($response->error_code !== null || $rawResponse->getStatusCode() !== 200) {
                 throw new TelegramException(