refactor(kernel): unify HTTP and CLI application lifecycle

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>
2026-07-27 00:48:11 -04:00
parent 98826143a8
commit 65c1b5fb75
67 changed files with 2737 additions and 1070 deletions
@@ -0,0 +1,96 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KTXC\Runtime\Http;
+
+use KTXC\Application\Execution\ExecutionDescriptor;
+use KTXC\Application\Execution\ExecutionOutcome;
+use KTXC\Http\Middleware\AuthenticationMiddleware;
+use KTXC\Http\Middleware\FirewallMiddleware;
+use KTXC\Http\Middleware\MiddlewarePipeline;
+use KTXC\Http\Middleware\RouterMiddleware;
+use KTXC\Http\Middleware\TenantMiddleware;
+use KTXC\Http\Request\Request;
+use KTXC\Http\Response\Response;
+use KTXC\KernelInterface;
+
+final class HttpRuntime
+{
+    public function __construct(
+        private readonly KernelInterface $kernel,
+        private readonly bool $debug,
+    ) {
+    }
+
+    public function run(?Request $request = null): Response
+    {
+        return $this->execute(
+            $request ?? Request::createFromGlobals(),
+            send: true,
+        );
+    }
+
+    public function handle(Request $request): Response
+    {
+        return $this->execute($request, send: false);
+    }
+
+    private function execute(Request $request, bool $send): Response
+    {
+        $scope = null;
+        $outcome = ExecutionOutcome::incomplete();
+
+        try {
+            $scope = $this->kernel->beginExecution(ExecutionDescriptor::http());
+            $response = $this->pipeline()->handle($request);
+            $outcome = ExecutionOutcome::success($response);
+            if ($send) {
+                $response->send();
+            }
+
+            return $response;
+        } catch (\Throwable $error) {
+            $response = $this->errorResponse($error);
+            $outcome = ExecutionOutcome::failure($error, $response);
+            if ($send) {
+                $response->send();
+            }
+
+            return $response;
+        } finally {
+            if ($scope !== null) {
+                $this->kernel->terminateExecution($scope, $outcome);
+            }
+        }
+    }
+
+    private function pipeline(): MiddlewarePipeline
+    {
+        $pipeline = new MiddlewarePipeline($this->kernel->container());
+        $pipeline->pipe(TenantMiddleware::class);
+        $pipeline->pipe(FirewallMiddleware::class);
+        $pipeline->pipe(AuthenticationMiddleware::class);
+        $pipeline->pipe(RouterMiddleware::class);
+
+        return $pipeline;
+    }
+
+    private function errorResponse(\Throwable $error): Response
+    {
+        error_log(sprintf(
+            'Application error: %s in %s:%d',
+            $error->getMessage(),
+            $error->getFile(),
+            $error->getLine(),
+        ));
+
+        $content = $this->debug
+            ? '<pre>' . htmlspecialchars((string) $error) . '</pre>'
+            : 'An error occurred. Please try again later.';
+
+        return new Response($content, Response::HTTP_INTERNAL_SERVER_ERROR, [
+            'Content-Type' => 'text/html; charset=UTF-8',
+        ]);
+    }
+}