Fix Code Style

Author: coisa

.php-cs-fixer.php

@@ -2,6 +2,17 @@
 
 declare(strict_types=1);
 
+/**
+ * This file is part of php-fast-forward/http-message.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
+ * @link      https://github.com/php-fast-forward/http-message
+ * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license   https://opensource.org/licenses/MIT MIT License
+ */
+
 use CoiSA\PhpCsFixer\PhpCsFixer;
 
 $paths = [

composer.json

@@ -44,8 +44,8 @@
         }
     },
     "scripts": {
-        "cs-check": "php-cs-fixer fix --dry-run --diff",
-        "cs-fix": "php-cs-fixer fix",
+        "cs-check": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix --dry-run --diff",
+        "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix",
         "mutation-testing": "infection --threads=4",
         "pre-commit": [
             "@cs-check",

src/JsonResponse.php

@@ -1,5 +1,18 @@
 <?php
 
+declare(strict_types=1);
+
+/**
+ * This file is part of php-fast-forward/http-message.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
+ * @link      https://github.com/php-fast-forward/http-message
+ * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license   https://opensource.org/licenses/MIT MIT License
+ */
+
 namespace FastForward\Http\Message;
 
 use Nyholm\Psr7\Response;

src/JsonResponseInterface.php

@@ -1,9 +1,20 @@
 <?php
 
+declare(strict_types=1);
+
+/**
+ * This file is part of php-fast-forward/http-message.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
+ * @link      https://github.com/php-fast-forward/http-message
+ * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license   https://opensource.org/licenses/MIT MIT License
+ */
+
 namespace FastForward\Http\Message;
 
 use Psr\Http\Message\ResponseInterface;
 
-interface JsonResponseInterface extends ResponseInterface, PayloadAwareInterface
-{
-}
+interface JsonResponseInterface extends ResponseInterface, PayloadAwareInterface {}

src/JsonStream.php

@@ -1,11 +1,24 @@
 <?php
 
+declare(strict_types=1);
+
+/**
+ * This file is part of php-fast-forward/http-message.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
+ * @link      https://github.com/php-fast-forward/http-message
+ * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license   https://opensource.org/licenses/MIT MIT License
+ */
+
 namespace FastForward\Http\Message;
 
 use Nyholm\Psr7\Stream;
 
 /**
- * Class JsonStream
+ * Class JsonStream.
  *
  * Extends Nyholm's PSR-7 Stream implementation to provide JSON-specific stream functionality.
  * This class SHALL encapsulate a JSON-encoded payload within a PHP stream, while retaining the original
@@ -26,8 +39,8 @@ final class JsonStream extends Stream implements JsonStreamInterface
      * The payload SHALL be JSON-encoded and written to an in-memory PHP stream. The original payload is retained
      * in decoded form for later retrieval via {@see getPayload()}.
      *
-     * @param mixed $payload The data to encode as JSON. MUST be JSON-encodable. Resources are explicitly prohibited.
-     * @param int $encodingOptions Optional JSON encoding flags as defined by {@see json_encode()}. Defaults to 0.
+     * @param mixed $payload         The data to encode as JSON. MUST be JSON-encodable. Resources are explicitly prohibited.
+     * @param int   $encodingOptions Optional JSON encoding flags as defined by {@see json_encode()}. Defaults to 0.
      */
     public function __construct(
         private mixed $payload = [],
@@ -39,22 +52,33 @@ public function __construct(
         $this->rewind();
     }
 
+    public function getPayload(): mixed
+    {
+        return $this->payload;
+    }
+
+    public function withPayload(mixed $payload): self
+    {
+        return new self($payload);
+    }
+
     /**
      * Encodes the given data as JSON, enforcing proper error handling.
      *
      * If the provided data is a resource, this method SHALL throw an {@see \InvalidArgumentException} as resources
      * cannot be represented in JSON format.
      *
-     * @param mixed $data The data to encode as JSON.
-     * @param int $encodingOptions JSON encoding options, combined with JSON_THROW_ON_ERROR.
-     * @return string The JSON-encoded string representation of the data.
+     * @param mixed $data            the data to encode as JSON
+     * @param int   $encodingOptions JSON encoding options, combined with JSON_THROW_ON_ERROR
      *
-     * @throws \InvalidArgumentException If the data contains a resource.
-     * @throws \JsonException If JSON encoding fails.
+     * @return string the JSON-encoded string representation of the data
+     *
+     * @throws \InvalidArgumentException if the data contains a resource
+     * @throws \JsonException            if JSON encoding fails
      */
     private function jsonEncode(mixed $data, int $encodingOptions): string
     {
-        if (is_resource($data)) {
+        if (\is_resource($data)) {
             throw new \InvalidArgumentException('Cannot JSON encode resources');
         }
 
@@ -63,14 +87,4 @@ private function jsonEncode(mixed $data, int $encodingOptions): string
 
         return json_encode($data, $encodingOptions | JSON_THROW_ON_ERROR);
     }
-
-    public function getPayload(): mixed
-    {
-        return $this->payload;
-    }
-
-    public function withPayload(mixed $payload): self
-    {
-        return new self($payload);
-    }
 }

src/JsonStreamInterface.php

@@ -1,17 +1,28 @@
 <?php
 
+declare(strict_types=1);
+
+/**
+ * This file is part of php-fast-forward/http-message.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
+ * @link      https://github.com/php-fast-forward/http-message
+ * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license   https://opensource.org/licenses/MIT MIT License
+ */
+
 namespace FastForward\Http\Message;
 
 use Psr\Http\Message\StreamInterface;
 
 /**
- * Interface JsonStreamInterface
+ * Interface JsonStreamInterface.
  *
  * Extends the PSR-7 StreamInterface to provide additional functionality for JSON payload handling.
  * Implementations of this interface MUST support both standard stream operations and structured JSON payload manipulation.
  *
  * @package FastForward\Http\Message
  */
-interface JsonStreamInterface extends StreamInterface, PayloadAwareInterface
-{
-}
+interface JsonStreamInterface extends StreamInterface, PayloadAwareInterface {}

src/PayloadAwareInterface.php

@@ -1,11 +1,22 @@
 <?php
 
-namespace FastForward\Http\Message;
+declare(strict_types=1);
+
+/**
+ * This file is part of php-fast-forward/http-message.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
+ * @link      https://github.com/php-fast-forward/http-message
+ * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license   https://opensource.org/licenses/MIT MIT License
+ */
 
-use Psr\Http\Message\StreamInterface;
+namespace FastForward\Http\Message;
 
 /**
- * Interface PayloadAwareInterface
+ * Interface PayloadAwareInterface.
  *
  * Provide functionality for JSON payload handling.
  *
@@ -19,7 +30,7 @@ interface PayloadAwareInterface
      * This method MUST return the decoded JSON payload as a native PHP type. The returned type MAY vary depending on
      * the structure of the JSON content (e.g., array, object, int, float, string, bool, or null).
      *
-     * @return mixed The decoded JSON payload, which MAY be of any type, including array, object, scalar, or null.
+     * @return mixed the decoded JSON payload, which MAY be of any type, including array, object, scalar, or null
      */
     public function getPayload(): mixed;
 
@@ -33,8 +44,9 @@ public function getPayload(): mixed;
      * by the implementation.
      *
      * @param mixed $payload The data to encode as JSON and set as the stream's payload. This MAY be of any type
-     *                    supported by json_encode.
-     * @return self A new instance with the updated JSON payload.
+     *                       supported by json_encode.
+     *
+     * @return self a new instance with the updated JSON payload
      */
     public function withPayload(mixed $payload): self;
 }

src/RequestMethod.php

@@ -1,9 +1,22 @@
 <?php
 
+declare(strict_types=1);
+
+/**
+ * This file is part of php-fast-forward/http-message.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
+ * @link      https://github.com/php-fast-forward/http-message
+ * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license   https://opensource.org/licenses/MIT MIT License
+ */
+
 namespace FastForward\Http\Message;
 
 /**
- * Enum RequestMethod
+ * Enum RequestMethod.
  *
  * Represents the set of valid HTTP request methods as defined by the IETF RFC 7231 and related specifications.
  * This enum SHALL be used to strictly define supported request methods within HTTP client and server implementations.
@@ -48,31 +61,25 @@ enum RequestMethod: string
 
     /**
      * Returns true if the method is considered safe (does not modify server state).
-     *
-     * @return bool
      */
     public function isSafe(): bool
     {
-        return in_array($this, [self::Get, self::Head, self::Options, self::Trace], true);
+        return \in_array($this, [self::Get, self::Head, self::Options, self::Trace], true);
     }
 
     /**
      * Returns true if the method is idempotent (multiple identical requests have the same effect as a single one).
-     *
-     * @return bool
      */
     public function isIdempotent(): bool
     {
-        return in_array($this, [self::Get, self::Head, self::Put, self::Delete, self::Options, self::Trace], true);
+        return \in_array($this, [self::Get, self::Head, self::Put, self::Delete, self::Options, self::Trace], true);
     }
 
     /**
      * Returns true if the method is considered cacheable by default.
-     *
-     * @return bool
      */
     public function isCacheable(): bool
     {
-        return in_array($this, [self::Get, self::Head], true);
+        return \in_array($this, [self::Get, self::Head], true);
     }
 }