refactor: create custom exception for invalid payload format

Author: carlalexander

src/Exception/InvalidFormatVersionException.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of Ymir PHP Runtime.
+ *
+ * (c) Carl Alexander <support@ymirapp.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Ymir\Runtime\Exception;
+
+/**
+ * Exception thrown when an invalid format version is used.
+ */
+class InvalidFormatVersionException extends \InvalidArgumentException implements ExceptionInterface
+{
+    /**
+     * Constructor.
+     */
+    public function __construct(string $formatVersion)
+    {
+        parent::__construct(sprintf('Format must be either "1.0" or "2.0", "%s" given', $formatVersion));
+    }
+}

src/Lambda/Response/Http/HttpResponse.php

@@ -15,6 +15,7 @@
 
 use Tightenco\Collect\Support\Arr;
 use Tightenco\Collect\Support\Collection;
+use Ymir\Runtime\Exception\InvalidFormatVersionException;
 use Ymir\Runtime\Lambda\Response\ResponseInterface;
 
 /**
@@ -65,7 +66,7 @@ class HttpResponse implements ResponseInterface
     public function __construct(string $body, array $headers = [], int $statusCode = 200, string $formatVersion = '1.0', bool $compressible = true)
     {
         if (!in_array($formatVersion, ['1.0', '2.0'])) {
-            throw new \InvalidArgumentException('"formatVersion" must be either "1.0" or "2.0"');
+            throw new InvalidFormatVersionException($formatVersion);
         }
 
         $this->body = $body;

tests/Unit/Lambda/Response/Http/HttpResponseTest.php

@@ -14,10 +14,18 @@
 namespace Ymir\Runtime\Tests\Unit\Lambda\Response\Http;
 
 use PHPUnit\Framework\TestCase;
+use Ymir\Runtime\Exception\InvalidFormatVersionException;
 use Ymir\Runtime\Lambda\Response\Http\HttpResponse;
 
 class HttpResponseTest extends TestCase
 {
+    public function testConstructorThrowsExceptionWithInvalidFormatVersion(): void
+    {
+        $this->expectException(InvalidFormatVersionException::class);
+
+        new HttpResponse('foo', [], 200, '3.0');
+    }
+
     public function testGetResponseDataWithFormatVersion1And304Status(): void
     {
         $response = new HttpResponse('foo', [], 304);