From d039a5d62a9ac6ababae70d9d96422ca59f2b2d4 Mon Sep 17 00:00:00 2001
From: Brett Parson <brett@brett-parson.com>
Date: Fri, 21 Aug 2026 13:55:37 -0500
Subject: Scaffold miniroute routing/middleware kernel

---
 src/Middleware/MiddlewarePipeline.php | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 src/Middleware/MiddlewarePipeline.php

(limited to 'src/Middleware/MiddlewarePipeline.php')

diff --git a/src/Middleware/MiddlewarePipeline.php b/src/Middleware/MiddlewarePipeline.php
new file mode 100644
index 0000000..65a300e
--- /dev/null
+++ b/src/Middleware/MiddlewarePipeline.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BrettParson\MiniRoute\Middleware;
+
+use BrettParson\MiniRoute\Http\RequestInterface;
+use BrettParson\MiniRoute\Http\ResponseInterface;
+
+final class MiddlewarePipeline
+{
+    /**
+     * Wrap a core handler with an ordered list of middleware instances.
+     *
+     * The first middleware in $middleware becomes the outermost layer, so a
+     * request flows through it first and its response post-processing runs
+     * last.
+     *
+     * @param list<MiddlewareInterface> $middleware
+     * @param callable(RequestInterface): ResponseInterface $core
+     * @return callable(RequestInterface): ResponseInterface
+     */
+    public static function compose(array $middleware, callable $core): callable
+    {
+        foreach (array_reverse($middleware) as $middlewareInstance) {
+            $next = $core;
+
+            $core = static function (RequestInterface $request) use ($middlewareInstance, $next): ResponseInterface {
+                return $middlewareInstance->handle($request, $next);
+            };
+        }
+
+        return $core;
+    }
+}
-- 
cgit v1.2.3