<?php

namespace App\Framework\Http;

interface HttpMiddleware
{
    /**
     * Verarbeitet den Middleware-Kontext und ruft den nächsten Handler in der Kette auf.
     *
     * @param MiddlewareContext $context Der Middleware-Kontext mit Request und optionaler Response
     * @param callable $next Der nächste Handler in der Kette
     * @param RequestStateManager $stateManager
     * @return MiddlewareContext Der aktualisierte Kontext
     */
    public function __invoke(MiddlewareContext $context, callable $next, RequestStateManager $stateManager): MiddlewareContext;
}
