feat: handle new response codes for better error feedback

Author: tpetry

phpstan-baseline.neon

@@ -1,5 +1,20 @@
 parameters:
 	ignoreErrors:
+		-
+			message: "#^Cannot access offset 'error' on mixed\\.$#"
+			count: 2
+			path: src/MySqlExplainException.php
+
+		-
+			message: "#^Cannot access offset 'message' on mixed\\.$#"
+			count: 2
+			path: src/MySqlExplainException.php
+
+		-
+			message: "#^Part \\$response\\['message'\\] \\(mixed\\) of encapsed string cannot be cast to string\\.$#"
+			count: 2
+			path: src/MySqlExplainException.php
+
 		-
 			message: "#^Parameter \\$explainJson of class Tpetry\\\\MysqlExplain\\\\Values\\\\QueryMetrics constructor expects string, float\\|int\\|string\\|null given\\.$#"
 			count: 1

src/Helpers/ApiHelper.php

@@ -5,7 +5,8 @@
 namespace Tpetry\MysqlExplain\Helpers;
 
 use GuzzleHttp\Client;
-use GuzzleHttp\Exception\GuzzleException;
+use GuzzleHttp\Exception\BadResponseException;
+use Throwable;
 use Tpetry\MysqlExplain\MysqlExplain;
 use Tpetry\MysqlExplain\MySqlExplainException;
 use Tpetry\MysqlExplain\Values\QueryMetrics;
@@ -46,8 +47,10 @@ public function submitPlan(QueryMetrics $metrics): string
             $json = json_decode($response->getBody()->getContents(), true);
 
             return $json['url'];
-        } catch (GuzzleException $e) {
-            throw MySqlExplainException::fromException($e);
+        } catch (BadResponseException $e) {
+            throw MySqlExplainException::fromBadResponseException($e);
+        } catch (Throwable $t) {
+            throw MySqlExplainException::fromThrowable($t);
         }
     }
 }

src/MySqlExplainException.php

@@ -5,12 +5,28 @@
 namespace Tpetry\MysqlExplain;
 
 use Exception;
+use GuzzleHttp\Exception\BadResponseException;
 use Throwable;
 
 class MySqlExplainException extends Exception
 {
-    public static function fromException(Throwable $exception): self
+    public static function fromBadResponseException(BadResponseException $e): self
     {
-        return new self('Submitting query to explainmysql.com failed.', 0, $exception);
+        $response = json_decode($e->getResponse()->getBody()->getContents(), true);
+        if ($response) {
+            if (isset($response['error'], $response['message']) && $response['error'] === 'unsupported_database') {
+                return new self("Submitting EXPLAIN failed (Unsupported Datatabase: {$response['message']}).", 0, $e);
+            }
+            if (isset($response['error'], $response['message']) && $response['error'] === 'unsupported_query') {
+                return new self("Submitting EXPLAIN failed (Unsupported Query: {$response['message']}).", 0, $e);
+            }
+        }
+
+        return self::fromThrowable($e);
+    }
+
+    public static function fromThrowable(Throwable $t): self
+    {
+        return new self("Submitting EXPLAIN failed ({$t->getMessage()}).", 0, $t);
     }
 }