feature: Add the ability to send a list of expected status codes

Breaking change: If you implement SendRequestActionContract then update your signature from ?int $expectedResponseStatusCode = null to int|array|null $expectedResponseStatusCode = null,

Author: pionl

src/Actions/SendRequestAction.php

@@ -43,7 +43,7 @@ public function execute(
         string $responseClass,
         OptionsInterface|StreamInterface|string|null $body = null,
         array $headers = [],
-        ?int $expectedResponseStatusCode = null,
+        int|array|null $expectedResponseStatusCode = null,
         ?ResponseInterface $fakedResponse = null,
         ?Closure $shouldIgnoreLoggersOnError = null,
     ): AbstractResponse {
@@ -175,7 +175,7 @@ private function getRequestDuration(float $timeStart): float
     private function handleResponse(
         ApiInterface $api,
         ResponseInterface $response,
-        ?int $expectedResponseStatusCode,
+        int|array|null $expectedResponseStatusCode,
         string $responseClass,
         ?EventDispatcherInterface $dispatcher,
         ?ApiLoggerInterface $logger,
@@ -189,10 +189,15 @@ private function handleResponse(
             $container = $api->factory()
                 ->container();
 
+            if (is_array($expectedResponseStatusCode) === false) {
+                $expectedResponseStatusCode = $expectedResponseStatusCode === null ? [200, 201] : [
+                    $expectedResponseStatusCode,
+                ];
+            }
+
             $statusCode = $response->getStatusCode();
 
-            if ($expectedResponseStatusCode === $statusCode ||
-                ($expectedResponseStatusCode === null && ($statusCode === 200 || $statusCode === 201))) {
+            if (in_array($statusCode, $expectedResponseStatusCode, true)) {
                 $body = $this->makeBodyFromResponseAction->execute($responseClass, $response);
 
                 $finalResponse = $container->makeResponse($responseClass, $response, $body);

src/Contracts/SendRequestActionContract.php

@@ -23,10 +23,10 @@ interface SendRequestActionContract
      *
      * @param array<int|string,HeadersInterface|string|string[]> $headers
      * @param class-string<TResponse>                            $responseClass
-     * @param int|null                                           $expectedResponseStatusCode Will raise and failed
-     *                                                                                      exception if response
-     *                                                                                      status code is different
-     * @param IgnoreLoggersOnExceptionClosure|null                    $shouldIgnoreLoggersOnError
+     * @param int|array<int>|null                                $expectedResponseStatusCode Will raise and failed
+     *     exception if response status code is different
+     * @param IgnoreLoggersOnExceptionClosure|null               $shouldIgnoreLoggersOnError
+     *
      * @return TResponse
      */
     public function execute(
@@ -35,7 +35,7 @@ public function execute(
         string $responseClass,
         OptionsInterface|StreamInterface|string|null $body = null,
         array $headers = [],
-        ?int $expectedResponseStatusCode = null,
+        int|array|null $expectedResponseStatusCode = null,
         ?ResponseInterface $fakedResponse = null,
         ?Closure $shouldIgnoreLoggersOnError = null
     ): AbstractResponse;

src/Testing/Assertions/SendTestRequestActionAssert.php

@@ -29,7 +29,7 @@ public function __construct(
         private readonly string $expectedMethod = 'GET',
         private readonly Closure|StreamInterface|string|OptionsInterface|array|null $expectedBody = null,
         private readonly array $expectedHeaders = [],
-        private readonly ?int $expectedResponseStatusCode = null,
+        private readonly int|array|null $expectedResponseStatusCode = null,
     ) {
         $this->buildHeadersAction = new BuildHeadersAction();
     }
@@ -40,7 +40,7 @@ public function execute(
         string $responseClass,
         StreamInterface|string|OptionsInterface|null $body = null,
         array $headers = [],
-        ?int $expectedResponseStatusCode = null,
+        int|array|null $expectedResponseStatusCode = null,
         ?ResponseInterface $fakedResponse = null,
         ?Closure $shouldIgnoreLoggersOnError = null,
     ): TResponse {

tests/Endpoints/TestShouldIgnoreLoggersSendRequestActionAssert.php

@@ -34,7 +34,7 @@ public function execute(
         string $responseClass,
         StreamInterface|string|OptionsInterface|null $body = null,
         array $headers = [],
-        ?int $expectedResponseStatusCode = null,
+        int|array|null $expectedResponseStatusCode = null,
         ?ResponseInterface $fakedResponse = null,
         ?Closure $shouldIgnoreLoggersOnError = null
     ): AbstractResponse {