Feature: add withRedirect() shortcut method

Add a convenience method for HTTP redirects that simplifies the common
pattern of setting status code and Location header together.

Closes #19

Author: claude

src/Extra/ExtraResponseTrait.php

@@ -81,4 +81,15 @@ public function withHeaders(array $headers): static
 		return $new;
 	}
 
+	/*
+	 * REDIRECT ***************************************************************
+	 */
+
+	public function withRedirect(string $url, int $statusCode = 302): static
+	{
+		return $this
+			->withStatus($statusCode)
+			->withHeader('Location', $url);
+	}
+
 }

tests/Cases/Psr7ResponseTest.php

@@ -88,6 +88,30 @@ public function testWithAttributes(): void
 		Assert::equal('baz', $this->response->getHeaderLine('X-Bar'));
 	}
 
+	public function testWithRedirect(): void
+	{
+		$this->response = $this->response->withRedirect('https://example.com');
+
+		Assert::equal(302, $this->response->getStatusCode());
+		Assert::equal('https://example.com', $this->response->getHeaderLine('Location'));
+	}
+
+	public function testWithRedirectCustomStatusCode(): void
+	{
+		$this->response = $this->response->withRedirect('https://example.com', 301);
+
+		Assert::equal(301, $this->response->getStatusCode());
+		Assert::equal('https://example.com', $this->response->getHeaderLine('Location'));
+	}
+
+	public function testWithRedirect303(): void
+	{
+		$this->response = $this->response->withRedirect('https://example.com/other', 303);
+
+		Assert::equal(303, $this->response->getStatusCode());
+		Assert::equal('https://example.com/other', $this->response->getHeaderLine('Location'));
+	}
+
 	public function testOf(): void
 	{
 		$this->response = $this->response