Add support for sanitizing any object

Author: nyamsprod

CHANGELOG.md

@@ -8,8 +8,10 @@ All Notable changes to `bakame/http-strucured-fields` will be documented in this
 
 - `Item::fromPair` named constructor to create a new instance from a pair expressed as an array list with two values.
 - `Parameters::sanitize` ensure the container always contains only Bare Items.
-- `InnerList::sanitize` ensure the list is without gaps.
-- `OrderedLost::sanitize` ensure the list is without gaps.
+- `InnerList::sanitize` ensure the list is without gaps and calls `Parameters::sanitize`.
+- `OrderedList::sanitize` ensure the list is without gaps and calls `Parameters::sanitize`.
+- `Dictionnary::sanitize` ensure the list is without gaps and calls `Parameters::sanitize`.
+- `Item::sanitize` calls `Parameters::sanitize`.
 - `autoload.php` script to allow non composer application to load the package
 - `OrderedList` and `InnerList` now implements the PHP `ArrayAccess` interface.
 

README.md

@@ -82,7 +82,7 @@ For each of these top-level types, the package provides a dedicated value object
 representation of the field and to serialize the value object back to the textual representation. 
 
 - Parsing is done via a common named constructor `fromHttpValue` which expects the Header or Trailer string value.
-- Serializing is done via a common `toHttpValue` public method. The method returns the normalized string representation suited for HTTP textual representation.
+- Serializing is done via a common `toHttpValue` public method. The method returns the **normalized string** representation suited for HTTP textual representation.
 
 Building Structured Fields
 ------------

src/Dictionary.php

@@ -258,6 +258,18 @@ public function clear(): self
         return $this;
     }
 
+    /**
+     * Ensure the container contains valid members.
+     */
+    public function sanitize(): self
+    {
+        foreach ($this->members as $member) {
+            $member->sanitize();
+        }
+
+        return $this;
+    }
+
     /**
      * Adds a member at the end of the instance and deletes any previous reference to the key if present.
      *

src/InnerList.php

@@ -198,6 +198,12 @@ public function remove(int ...$indexes): self
      */
     public function sanitize(): self
     {
+        $this->parameters->sanitize();
+
+        foreach ($this->members as $member) {
+            $member->parameters->sanitize();
+        }
+
         if (!array_is_list($this->members)) {
             $this->members = array_values($this->members);
         }

src/Item.php

@@ -315,4 +315,11 @@ public function isByteSequence(): bool
     {
         return $this->value instanceof ByteSequence;
     }
+
+    public function sanitize(): self
+    {
+        $this->parameters->sanitize();
+
+        return $this;
+    }
 }

src/OrderedList.php

@@ -200,7 +200,6 @@ public function remove(int ...$indexes): self
         return $this;
     }
 
-
     /**
      * Ensure the container always contains list.
      *
@@ -209,6 +208,10 @@ public function remove(int ...$indexes): self
      */
     public function sanitize(): self
     {
+        foreach ($this->members as $member) {
+            $member->parameters->sanitize();
+        }
+
         if (!array_is_list($this->members)) {
             $this->members = array_values($this->members);
         }