feat!(koa): router v15, improve middleware support, fix overlapping route matching (#442)

fixes #437

- Updates the `@koa/router` dependency to v15, and updates the peer
requirements for `koa` to v3
- Adds a failing e2e test showing the issue described in #437
- Solves the overlapping route issue by no longer calling `next` after
route handlers
- Adds support for mounting middleware on any individual router, as an
optional parameter to `createRouter`

Author: mnahkies

e2e/openapi.yaml

@@ -7,6 +7,7 @@ tags:
   - name: validation
   - name: escape hatches
   - name: media types
+  - name: route matching
 servers:
   - url: '{protocol}://{host}:{port}'
     variables:
@@ -196,6 +197,7 @@ paths:
                     type: array
                     items:
                       type: string
+
   /validation/numbers/random-number:
     get:
       tags:
@@ -384,6 +386,36 @@ paths:
               schema:
                 type: string
 
+  /route-matching/fixed-field:
+    get:
+      operationId: routeMatchingGetByFixedField
+      tags:
+        - route matching
+      responses:
+        200:
+          description: 'ok'
+          content:
+            application/json:
+              schema: {}
+
+  /route-matching/{id}:
+    get:
+      operationId: routeMatchingGetById
+      tags:
+        - route matching
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: 'ok'
+          content:
+            application/json:
+              schema: {}
+
 components:
   responses:
     GetHeaders:

e2e/package.json

@@ -14,7 +14,7 @@
     "start": "node ./dist/index.js"
   },
   "dependencies": {
-    "@koa/router": "^14.0.0",
+    "@koa/router": "^15.5.0",
     "@nahkies/typescript-axios-runtime": "workspace:*",
     "@nahkies/typescript-express-runtime": "workspace:*",
     "@nahkies/typescript-fetch-runtime": "workspace:*",
@@ -29,7 +29,6 @@
     "@nahkies/openapi-code-generator": "workspace:*",
     "@types/express": "^5.0.6",
     "@types/koa": "^3.0.2",
-    "@types/koa__router": "^12.0.5",
     "expect": "^30.3.0",
     "jest": "^30.3.0",
     "typescript": "^6.0.3"

e2e/src/express.entrypoint.ts

@@ -4,6 +4,7 @@ import {createEscapeHatchesRouter} from "./routes/express/escape-hatches.ts"
 import {createMediaTypesRouter} from "./routes/express/media-types.ts"
 import {createQueryParametersRouter} from "./routes/express/query-parameters.ts"
 import {createRequestHeadersRouter} from "./routes/express/request-headers.ts"
+import {createRouteMatchingRouter} from "./routes/express/route-matching.ts"
 import {createValidationRouter} from "./routes/express/validation.ts"
 import {createErrorResponse} from "./shared.ts"
 
@@ -15,12 +16,14 @@ function createRouter() {
   const escapeHatchesRouter = createEscapeHatchesRouter()
   const mediaTypesRouter = createMediaTypesRouter()
   const queryParametersRouter = createQueryParametersRouter()
+  const routeMatchingRouter = createRouteMatchingRouter()
 
   router.use(requestHeadersRouter)
   router.use(validationRouter)
   router.use(escapeHatchesRouter)
   router.use(mediaTypesRouter)
   router.use(queryParametersRouter)
+  router.use(routeMatchingRouter)
 
   return router
 }