feat: support CHIPS partitioned cookies SetCookie::withPartitioned()

Author: battis

src/Dflydev/FigCookies/SetCookie.php

@@ -42,6 +42,8 @@ class SetCookie
     private $httpOnly = false;
     /** @var SameSite|null */
     private $sameSite;
+    /** @var bool */
+    private $partitioned = false;
 
     private function __construct(string $name, ?string $value = null)
     {
@@ -94,6 +96,11 @@ public function getSameSite(): ?SameSite
         return $this->sameSite;
     }
 
+    public function getPartitioned(): bool
+    {
+        return $this->partitioned;
+    }
+
     public function withValue(?string $value = null): self
     {
         $clone = clone $this;
@@ -212,6 +219,15 @@ public function withoutSameSite(): self
         return $clone;
     }
 
+    public function withPartitioned(bool $partitioned = true): self
+    {
+        $clone = clone $this;
+
+        $clone->partitioned = $partitioned;
+
+        return $clone;
+    }
+
     public function __toString(): string
     {
         $cookieStringParts = [
@@ -225,6 +241,7 @@ public function __toString(): string
         $cookieStringParts = $this->appendFormattedSecurePartIfSet($cookieStringParts);
         $cookieStringParts = $this->appendFormattedHttpOnlyPartIfSet($cookieStringParts);
         $cookieStringParts = $this->appendFormattedSameSitePartIfSet($cookieStringParts);
+        $cookieStringParts = $this->appendFormattedPartitionedPartIfSet($cookieStringParts);
 
         return implode('; ', $cookieStringParts);
     }
@@ -301,6 +318,9 @@ public static function fromSetCookieString(string $string): self
                 case 'samesite':
                     $setCookie = $setCookie->withSameSite(SameSite::fromString((string) $attributeValue));
                     break;
+                case 'partitioned':
+                    $setCookie = $setCookie->withPartitioned();
+                    break;
             }
         }
 
@@ -406,4 +426,18 @@ private function appendFormattedSameSitePartIfSet(array $cookieStringParts): arr
 
         return $cookieStringParts;
     }
+
+    /**
+     * @param string[] $cookieStringParts 
+     * 
+     * @return string[] 
+     */
+    private function appendFormattedPartitionedPartIfSet(array $cookieStringParts): array
+    {
+        if ($this->partitioned) {
+            $cookieStringParts[] = 'Partitioned';
+        }
+
+        return $cookieStringParts;
+    }
 }