refactor: parse exception to 'BrasilApiException' independent of API …

…return

src/Exceptions/BrasilApiException.php

@@ -13,9 +13,20 @@ class BrasilApiException extends Exception
      */
     private array $errors;
 
-    public function __construct(string $message = "", int $code = 0, array $errors = [])
+    /**
+     * The raw response returned by BrasilApi
+     */
+    private string $rawResponse;
+
+    public function __construct(
+        string $message = "",
+        int $code = 0,
+        array $errors = [],
+        string $rawResponse = ""
+    )
     {
         $this->errors = $errors;
+        $this->rawResponse = $rawResponse;
         parent::__construct($message, $code);
     }
 
@@ -26,4 +37,12 @@ public function getErrors(): array
     {
         return $this->errors;
     }
+
+    /**
+     * Returns the raw response returned by BrasilApi
+     */
+    public function getRawResponse(): string
+    {
+        return $this->rawResponse;
+    }
 }

src/Handlers/ResponseHandler.php

@@ -40,14 +40,13 @@ public static function failure(RequestException $exception): void
     }
 
     /**
-     * Parse a GuzzleHttp\Exception\RequestException into a BrasilApiException,
-     * if possible depending on the response body.
+     * Parse a GuzzleHttp\Exception\RequestException into a BrasilApiException.
      *
      * @param RequestException $exception The exception to be parsed
      *
-     * @return BrasilApiException|RequestException
+     * @return BrasilApiException
      */
-    private static function parseException(RequestException $exception): BrasilApiException|RequestException
+    private static function parseException(RequestException $exception): BrasilApiException
     {
         $response = $exception->getResponse();
 
@@ -56,13 +55,14 @@ private static function parseException(RequestException $exception): BrasilApiEx
         try {
             $error = self::toArray($body);
         } catch (InvalidJsonException) {
-            return $exception;
+            $error = [];
         }
 
         return new BrasilApiException(
             $error["message"] ?? "An error occurred",
             $response->getStatusCode(),
-            $error["errors"] ?? []
+            $error["errors"] ?? [],
+            $body
         );
     }