HTTP Middleware (Hooks + Conditional Decoration)

<?php
require 'examples/boot.php';

use Cognesy\Http\Data\HttpRequest;
use Cognesy\Http\Data\HttpResponse;
use Cognesy\Http\Drivers\Mock\MockHttpDriver;
use Cognesy\Http\HttpClient;
use Cognesy\Http\Middleware\Base\BaseMiddleware;
use Cognesy\Http\Middleware\Base\BaseResponseDecorator;
use Cognesy\Http\Stream\ArrayStream;

// Scenario: Demonstrate BaseMiddleware hooks and conditional decoration

class HooksExampleMiddleware extends BaseMiddleware
{
    protected function beforeRequest(HttpRequest $request): HttpRequest {
        // attach a request-id header
        return $request->withHeader('X-Request-ID', 'hooks-demo-123');
    }

    protected function afterRequest(HttpRequest $request, HttpResponse $response): HttpResponse {
        // log status to stdout (example side-effect)
        fwrite(STDOUT, "afterRequest: status=" . $response->statusCode() . "\n");
        return $response;
    }

    protected function shouldDecorateResponse(HttpRequest $request, HttpResponse $response): bool {
        return $response->isStreamed();
    }

    protected function toResponse(HttpRequest $request, HttpResponse $response): HttpResponse {
        // decorate: number each emitted chunk (composition)
        $i = 0;
        return BaseResponseDecorator::decorate(
            $response,
            function (string $chunk) use (&$i): string {
                $i += 1;
                return sprintf("[%02d] %s", $i, $chunk);
            }
        );
    }
}

// Mock driver returns a streamed response (full lines as chunks for simplicity)
$driver = new MockHttpDriver();
$driver->addResponse(
    HttpResponse::streaming(
        statusCode: 200,
        headers: ['Content-Type' => 'text/plain'],
        stream: new ArrayStream(["alpha\n", "beta\n", "gamma\n"]),
    ),
    url: 'https://api.example.local/lines',
    method: 'GET'
);

$client = new HttpClient(driver: $driver);
$client = $client->withMiddleware(new HooksExampleMiddleware());

$request = new HttpRequest(
    url: 'https://api.example.local/lines',
    method: 'GET',
    headers: ['Accept' => 'text/plain'],
    body: '',
    options: ['stream' => true],
);

foreach ($client->withRequest($request)->stream() as $chunk) {
    echo $chunk; // chunks are numbered by middleware
}
?>