feat: add back session flashing

Author: innocenzi

packages/http/src/IsResponse.php

@@ -8,7 +8,9 @@
 use JsonSerializable;
 use Tempest\Http\Cookie\Cookie;
 use Tempest\Http\Cookie\CookieManager;
+use Tempest\Http\Session\Session;
 use Tempest\View\View;
+use UnitEnum;
 
 use function Tempest\get;
 
@@ -26,6 +28,10 @@ trait IsResponse
         get => get(CookieManager::class);
     }
 
+    public Session $session {
+        get => get(Session::class);
+    }
+
     private(set) ?View $view = null;
 
     public function getHeader(string $name): ?Header
@@ -102,4 +108,11 @@ public function setBody(View|string|array|Generator|null $body): self
 
         return $this;
     }
+
+    public function flash(string|UnitEnum $key, mixed $value): self
+    {
+        $this->session->flash($key, $value);
+
+        return $this;
+    }
 }

packages/http/src/Response.php

@@ -8,33 +8,70 @@
 use JsonSerializable;
 use Tempest\Http\Cookie\Cookie;
 use Tempest\View\View;
+use UnitEnum;
 
 interface Response
 {
+    /**
+     * Gets the status code of the response.
+     */
     public Status $status {
         get;
     }
 
-    /** @var \Tempest\Http\Header[] $headers */
+    /**
+     * Gets the headers of the response.
+     *
+     * @var \Tempest\Http\Header[] $headers
+     */
     public array $headers {
         get;
     }
 
+    /**
+     * Gets the body of the response.
+     */
     public View|string|array|Generator|JsonSerializable|null $body {
         get;
     }
 
+    /**
+     * Gets a header by its name, case insensitive.
+     */
     public function getHeader(string $name): ?Header;
 
+    /**
+     * Adds a header to the response.
+     */
     public function addHeader(string $key, string $value): self;
 
+    /**
+     * Removes a header from the response.
+     */
     public function removeHeader(string $key): self;
 
+    /**
+     * Adds a cookie to the response.
+     */
     public function addCookie(Cookie $cookie): self;
 
+    /**
+     * Removes a cookie from the response.
+     */
     public function removeCookie(string $key): self;
 
+    /**
+     * Sets the status code of the response.
+     */
     public function setStatus(Status $status): self;
 
+    /**
+     * Sets the body of the response.
+     */
     public function setBody(View|string|array|Generator|null $body): self;
+
+    /**
+     * Flash a value to the session for the next request.
+     */
+    public function flash(string|UnitEnum $key, mixed $value): self;
 }

tests/Integration/Http/Responses/GenericResponseTest.php

@@ -4,9 +4,11 @@
 
 namespace Tests\Tempest\Integration\Http\Responses;
 
+use PHPUnit\Framework\Attributes\Test;
 use Tempest\Http\Cookie\Cookie;
 use Tempest\Http\Cookie\CookieManager;
 use Tempest\Http\Responses\Ok;
+use Tempest\Http\Session\Session;
 use Tempest\Http\Status;
 use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 
@@ -15,26 +17,18 @@
  */
 final class GenericResponseTest extends FrameworkIntegrationTestCase
 {
-    // public function test_sessions(): void
-    // {
-    //     $response = new Ok()
-    //         ->addSession('test', 'test')
-    //         ->addSession('original', 'original');
-
-    //     $session = $this->container->get(Session::class);
-
-    //     $this->assertSame('test', $session->get('test'));
-
-    //     $response->removeSession('test');
-
-    //     $this->assertNull($session->get('test'));
+    #[Test]
+    public function sessions(): void
+    {
+        new Ok()->flash('success', 'Operation successful');
 
-    //     $response->destroySession();
+        $session = $this->container->get(Session::class);
 
-    //     $this->assertNull($session->get('original'));
-    // }
+        $this->assertSame('Operation successful', $session->get('success'));
+    }
 
-    public function test_cookies(): void
+    #[Test]
+    public function cookies(): void
     {
         $response = new Ok()->addCookie(new Cookie('test'));
 
@@ -47,7 +41,8 @@ public function test_cookies(): void
         $this->assertSame(-1, $cookieManager->get('test')->expiresAt);
     }
 
-    public function test_set_status(): void
+    #[Test]
+    public function set_status(): void
     {
         $response = new Ok()->setStatus(Status::ACCEPTED);