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/Http/RequestInterface.php | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 src/Http/RequestInterface.php

(limited to 'src/Http/RequestInterface.php')

diff --git a/src/Http/RequestInterface.php b/src/Http/RequestInterface.php
new file mode 100644
index 0000000..fe54667
--- /dev/null
+++ b/src/Http/RequestInterface.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BrettParson\MiniRoute\Http;
+
+/**
+ * Minimal HTTP request contract the router needs.
+ *
+ * Applications keep their own concrete Request class and implement this
+ * interface. The router only reads method/path and injects route parameters
+ * via withParams(); everything else stays application-owned.
+ */
+interface RequestInterface
+{
+    public function method(): string;
+
+    public function path(): string;
+
+    /**
+     * Get a route parameter extracted by the router (e.g. {slug}).
+     */
+    public function param(string $name, string $default = ''): string;
+
+    /**
+     * Return a copy of the request with route parameters attached.
+     *
+     * @param array<string, string> $params
+     */
+    public function withParams(array $params): RequestInterface;
+}
-- 
cgit v1.2.3