feat: add header to error source objects (#24)

Author: ennorehling

src/Core/Document/ErrorSource.php

@@ -31,6 +31,11 @@ class ErrorSource implements Serializable
      */
     private ?string $parameter;
 
+    /**
+     * @var string|null
+     */
+    private ?string $header;
+
     /**
      * @param ErrorSource|array|null $value
      * @return ErrorSource
@@ -60,7 +65,8 @@ public static function fromArray(array $source): self
     {
         return new self(
             $source['pointer'] ?? null,
-            $source['parameter'] ?? null
+            $source['parameter'] ?? null,
+            $source['header'] ?? null,
         );
     }
 
@@ -69,11 +75,13 @@ public static function fromArray(array $source): self
      *
      * @param string|null $pointer
      * @param string|null $parameter
+     * @param string|null $header
      */
-    public function __construct(?string $pointer = null, ?string $parameter = null)
+    public function __construct(?string $pointer = null, ?string $parameter = null, ?string $header = null)
     {
         $this->pointer = $pointer;
         $this->parameter = $parameter;
+        $this->header = $header;
     }
 
     /**
@@ -149,12 +157,47 @@ public function withoutParameter(): self
         return $this;
     }
 
+    /**
+     * A string indicating which request header caused the error.
+     *
+     * @return string|null
+     */
+    public function header(): ?string
+    {
+        return $this->header;
+    }
+
+    /**
+     * Add a string indicating which request header caused the error.
+     *
+     * @param string|null $header
+     * @return $this
+     */
+    public function setHeader(?string $header): self
+    {
+        $this->header = $header;
+
+        return $this;
+    }
+
+    /**
+     * Remove the source header.
+     *
+     * @return $this
+     */
+    public function withoutHeader(): self
+    {
+        $this->header = null;
+
+        return $this;
+    }
+
     /**
      * @return bool
      */
     public function isEmpty(): bool
     {
-        return empty($this->pointer) && empty($this->parameter);
+        return empty($this->pointer) && empty($this->parameter) && empty($this->header);
     }
 
     /**
@@ -173,6 +216,7 @@ public function toArray()
         return array_filter([
             'parameter' => $this->parameter,
             'pointer' => $this->pointer,
+            'header' => $this->header,
         ]);
     }