Add Fetch classes and exceptions for HTTP handling

composer.json

@@ -24,11 +24,14 @@
         ]
     },
     "require": {
-        "php": "^8.0",
+        "php": "^8.3",
         "guzzlehttp/guzzle": "^7.9",
         "guzzlehttp/psr7": "^2.7",
-        "psr/http-message": "^1.0|^2.0",
-        "jerome/matrix": "^2.0"
+        "illuminate/contracts": "^11.37",
+        "illuminate/events": "^11.37",
+        "illuminate/support": "^11.37",
+        "jerome/matrix": "^3.1",
+        "psr/http-message": "^1.0|^2.0"
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.64",

src/Fetch/Enum/Status.php

@@ -31,8 +31,15 @@ enum Status: int
     case UNSUPPORTED_MEDIA_TYPE = 415;
     case RANGE_NOT_SATISFIABLE = 416;
     case EXPECTATION_FAILED = 417;
-    case UPGRADE_REQUIRED = 426;
+    case IM_A_TEAPOT = 418;
+    case MISDIRECTED_REQUEST = 421;
+    case UNPROCESSABLE_ENTITY = 422;
+    case LOCKED = 423;
+    case FAILED_DEPENDENCY = 424;
+    case PRECONDITION_REQUIRED = 428;
     case TOO_MANY_REQUESTS = 429;
+    case REQUEST_HEADER_FIELDS_TOO_LARGE = 431;
+    case UNAVAILABLE_FOR_LEGAL_REASONS = 451;
     case INTERNAL_SERVER_ERROR = 500;
     case NOT_IMPLEMENTED = 501;
     case BAD_GATEWAY = 502;

src/Fetch/Events/ConnectionFailed.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Fetch\Events;
+
+use Fetch\Exceptions\ConnectionException;
+use Fetch\Request;
+
+class ConnectionFailed
+{
+    /**
+     * The request instance.
+     */
+    public Request $request;
+
+    /**
+     * The exception instance.
+     */
+    public ConnectionException $exception;
+
+    /**
+     * Create a new event instance.
+     *
+     * @return void
+     */
+    public function __construct(Request $request, ConnectionException $exception)
+    {
+        $this->request = $request;
+        $this->exception = $exception;
+    }
+}

src/Fetch/Events/RequestSending.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Fetch\Events;
+
+use Fetch\Request;
+
+class RequestSending
+{
+    /**
+     * The request instance.
+     */
+    public Request $request;
+
+    /**
+     * Create a new event instance.
+     *
+     * @return void
+     */
+    public function __construct(Request $request)
+    {
+        $this->request = $request;
+    }
+}

src/Fetch/Events/ResponseReceived.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Fetch\Events;
+
+use Fetch\Request;
+use Fetch\Response;
+
+class ResponseReceived
+{
+    /**
+     * The request instance.
+     */
+    public Request $request;
+
+    /**
+     * The response instance.
+     */
+    public Response $response;
+
+    /**
+     * Create a new event instance.
+     *
+     * @return void
+     */
+    public function __construct(Request $request, Response $response)
+    {
+        $this->request = $request;
+        $this->response = $response;
+    }
+}

src/Fetch/Exceptions/ConnectionException.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Fetch\Exceptions;
+
+class ConnectionException extends HttpClientException
+{
+    //
+}

src/Fetch/Exceptions/HttpClientException.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Fetch\Exceptions;
+
+use Exception;
+
+class HttpClientException extends Exception
+{
+    //
+}

src/Fetch/Exceptions/RequestException.php

@@ -0,0 +1,74 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Fetch\Exceptions;
+
+use Fetch\Response;
+use GuzzleHttp\Psr7\Message;
+
+class RequestException extends HttpClientException
+{
+    /**
+     * The response instance.
+     */
+    public Response $response;
+
+    /**
+     * The truncation length for the exception message.
+     */
+    public static int|false $truncateAt = 120;
+
+    /**
+     * Create a new exception instance.
+     *
+     * @return void
+     */
+    public function __construct(Response $response)
+    {
+        parent::__construct(
+            $this->prepareMessage($response),
+            $response->status()
+        );
+
+        $this->response = $response;
+    }
+
+    /**
+     * Enable truncation of request exception messages.
+     */
+    public static function truncate(): void
+    {
+        static::$truncateAt = 120;
+    }
+
+    /**
+     * Set the truncation length for request exception messages.
+     */
+    public static function truncateAt(int $length): void
+    {
+        static::$truncateAt = $length;
+    }
+
+    /**
+     * Disable truncation of request exception messages.
+     */
+    public static function dontTruncate(): void
+    {
+        static::$truncateAt = false;
+    }
+
+    /**
+     * Prepare the exception message.
+     */
+    protected function prepareMessage(Response $response): string
+    {
+        $message = "HTTP request returned status code {$response->status()}";
+
+        $summary = static::$truncateAt
+            ? Message::bodySummary($response->toPsrResponse(), static::$truncateAt)
+            : Message::toString($response->toPsrResponse());
+
+        return is_null($summary) ? $message : $message .= ":\n{$summary}\n";
+    }
+}