@koa/router 15.6.0 → 15.7.1

package/dist/index.d.mts

@@ -375,6 +375,12 @@ declare class RouterImplementation<StateT = koa.DefaultState, ContextT = koa.Def
      * @returns This router instance
      */
     prefix(prefixPath: string): Router<StateT, ContextT>;
+    private _determineMiddlewarePath;
+    private _hasPathParameters;
+    private _updatePrefix;
+    private _getUnprefixedPath;
+    private _updateRoutePrefix;
+    private _updateRouteCaptureOptions;
     /**
      * Returns router middleware which dispatches a route matching the request.
      *
@@ -943,7 +949,7 @@ type RouterContext<StateT = DefaultState, ContextT = DefaultContext, BodyT = unk
     /**
      * Track param middleware execution (internal)
      */
-    _matchedParams?: WeakMap<Function, boolean>;
+    _matchedParams?: WeakMap<Function, Map<string, string>>;
 };
 /**
  * Router middleware function type

package/dist/index.d.ts

@@ -375,6 +375,12 @@ declare class RouterImplementation<StateT = koa.DefaultState, ContextT = koa.Def
      * @returns This router instance
      */
     prefix(prefixPath: string): Router<StateT, ContextT>;
+    private _determineMiddlewarePath;
+    private _hasPathParameters;
+    private _updatePrefix;
+    private _getUnprefixedPath;
+    private _updateRoutePrefix;
+    private _updateRouteCaptureOptions;
     /**
      * Returns router middleware which dispatches a route matching the request.
      *
@@ -943,7 +949,7 @@ type RouterContext<StateT = DefaultState, ContextT = DefaultContext, BodyT = unk
     /**
      * Track param middleware execution (internal)
      */
-    _matchedParams?: WeakMap<Function, boolean>;
+    _matchedParams?: WeakMap<Function, Map<string, string>>;
 };
 /**
  * Router middleware function type

package/dist/index.js

@@ -271,7 +271,7 @@ var Layer = class {
   _configurePathMatching() {
     if (this.opts.pathAsRegExp === true) {
       this.regexp = this.path instanceof RegExp ? this.path : new RegExp(this.path);
-    } else if (this.path) {
+    } else if (this.path || this.path === "") {
       this._configurePathToRegexp();
     }
   }
@@ -504,11 +504,17 @@ var Layer = class {
       if (!context._matchedParams) {
         context._matchedParams = /* @__PURE__ */ new WeakMap();
       }
-      if (context._matchedParams.has(parameterHandler)) {
+      const parameterValue = context.params[parameterName];
+      const matchedParameters = context._matchedParams.get(parameterHandler) ?? /* @__PURE__ */ new Map();
+      const hasMatchedParameter = matchedParameters.has(parameterName);
+      const matchedValue = matchedParameters.get(parameterName);
+      const hasMatchedValue = hasMatchedParameter && matchedValue === parameterValue;
+      if (hasMatchedValue) {
         return next();
       }
-      context._matchedParams.set(parameterHandler, true);
-      return parameterHandler(context.params[parameterName], context, next);
+      matchedParameters.set(parameterName, parameterValue);
+      context._matchedParams.set(parameterHandler, matchedParameters);
+      return parameterHandler(parameterValue, context, next);
     });
     middleware.param = parameterName;
     middleware._originalFn = parameterHandler;
@@ -519,12 +525,12 @@ var Layer = class {
    * @private
    */
   _insertParamMiddleware(middlewareStack, parameterMiddleware, parameterNamesList, currentParameterPosition) {
-    let inserted = false;
+    let isInserted = false;
     for (let stackIndex = 0; stackIndex < middlewareStack.length; stackIndex++) {
       const existingMiddleware = middlewareStack[stackIndex];
       if (!existingMiddleware.param) {
         middlewareStack.splice(stackIndex, 0, parameterMiddleware);
-        inserted = true;
+        isInserted = true;
         break;
       }
       const existingParameterPosition = parameterNamesList.indexOf(
@@ -532,11 +538,11 @@ var Layer = class {
       );
       if (existingParameterPosition > currentParameterPosition) {
         middlewareStack.splice(stackIndex, 0, parameterMiddleware);
-        inserted = true;
+        isInserted = true;
         break;
       }
     }
-    if (!inserted) {
+    if (!isInserted) {
       middlewareStack.push(parameterMiddleware);
     }
   }
@@ -548,10 +554,7 @@ var Layer = class {
    * @private
    */
   setPrefix(prefixPath) {
-    if (!this.path) {
-      return this;
-    }
-    if (this.path instanceof RegExp) {
+    if (typeof this.path !== "string") {
       return this;
     }
     this.path = this._applyPrefix(prefixPath);
@@ -565,13 +568,18 @@ var Layer = class {
   _applyPrefix(prefixPath) {
     const isRootPath = this.path === "/";
     const isStrictMode = this.opts.strict === true;
-    const prefixHasParameters = prefixPath.includes(":");
-    const pathIsRawRegex = this.opts.pathAsRegExp === true && typeof this.path === "string";
-    if (prefixHasParameters && pathIsRawRegex) {
+    const isPrefixHasParameters = prefixPath.includes(":");
+    const isPathIsRawRegex = this.opts.pathAsRegExp === true && typeof this.path === "string";
+    if (isPrefixHasParameters && isPathIsRawRegex) {
       const currentPath = this.path;
-      if (currentPath === String.raw`(?:\/|$)` || currentPath === String.raw`(?:\\\/|$)`) {
-        this.path = "{/*rest}";
+      const middlewareBoundary = [
+        String.raw`(?:\/|$)`,
+        String.raw`(?:\\\/|$)`
+      ].find((boundary) => currentPath.endsWith(boundary));
+      if (middlewareBoundary) {
+        this.path = `${currentPath.slice(0, -middlewareBoundary.length)}{/*rest}`;
         this.opts.pathAsRegExp = false;
+        this.opts.ignoreWildcardParameter = "rest";
       }
     }
     if (isRootPath && !isStrictMode) {
@@ -584,9 +592,9 @@ var Layer = class {
    * @private
    */
   _reconfigurePathMatching(prefixPath) {
-    const treatAsRegExp = this.opts.pathAsRegExp === true;
+    const isTreatAsRegExp = this.opts.pathAsRegExp === true;
     const prefixHasParameters = prefixPath && prefixPath.includes(":");
-    if (prefixHasParameters && treatAsRegExp) {
+    if (prefixHasParameters && isTreatAsRegExp) {
       const options = normalizeLayerOptionsToPathToRegexp(this.opts);
       const { regexp, keys } = compilePathToRegexp(
         this.path,
@@ -595,10 +603,10 @@ var Layer = class {
       this.regexp = regexp;
       this.paramNames = keys;
       this.opts.pathAsRegExp = false;
-    } else if (treatAsRegExp) {
+    } else if (isTreatAsRegExp) {
       const pathString = this.path;
       const anchoredPattern = pathString.startsWith("^") ? pathString : `^${pathString}`;
-      this.regexp = this.path instanceof RegExp ? this.path : new RegExp(anchoredPattern);
+      this.regexp = this.path instanceof RegExp ? this.path : new RegExp(anchoredPattern, this.opts.sensitive ? "" : "i");
     } else {
       const options = normalizeLayerOptionsToPathToRegexp(this.opts);
       const { regexp, keys } = compilePathToRegexp(
@@ -657,57 +665,14 @@ function applyAllParameterMiddleware(route, parametersObject) {
   }
 }
 
-// src/utils/path-helpers.ts
-function hasPathParameters(path, options = {}) {
-  if (!path) {
-    return false;
-  }
-  const { keys } = compilePathToRegexp(path, options);
-  return keys.length > 0;
-}
-function determineMiddlewarePath(explicitPath, hasPrefixParameters) {
-  if (explicitPath !== void 0) {
-    if (typeof explicitPath === "string") {
-      if (explicitPath === "") {
-        return {
-          path: "{/*rest}",
-          pathAsRegExp: false
-        };
-      }
-      if (explicitPath === "/") {
-        return {
-          path: "/",
-          pathAsRegExp: false
-        };
-      }
-      return {
-        path: explicitPath,
-        pathAsRegExp: false
-      };
-    }
-    return {
-      path: explicitPath,
-      pathAsRegExp: true
-    };
-  }
-  if (hasPrefixParameters) {
-    return {
-      path: "{/*rest}",
-      pathAsRegExp: false
-    };
-  }
-  return {
-    path: String.raw`(?:\/|$)`,
-    pathAsRegExp: true
-  };
-}
-
 // src/utils/debug.ts
 var import_debug = __toESM(require("debug"));
 var debug = (0, import_debug.default)("koa-router");
 
 // src/router.ts
 var httpMethods = getAllHttpMethods();
+var MIDDLEWARE_BOUNDARY_PATH = String.raw`(?:\/|$)`;
+var MIDDLEWARE_WILDCARD_PATH = "{/*rest}";
 var RouterImplementation = class {
   opts;
   methods;
@@ -783,10 +748,10 @@ var RouterImplementation = class {
     return temporaryLayer.url(...arguments_);
   }
   use(...middleware) {
-    let explicitPath;
     if (this._isPathArray(middleware[0])) {
       return this._useWithPathArray(middleware);
     }
+    let explicitPath;
     const hasExplicitPath = this._hasExplicitPath(middleware[0]);
     if (hasExplicitPath) {
       explicitPath = middleware.shift();
@@ -853,7 +818,10 @@ var RouterImplementation = class {
   _mountNestedRouter(middlewareWithRouter, mountPath) {
     const nestedRouter = middlewareWithRouter.router;
     const clonedRouter = this._cloneRouter(nestedRouter);
-    const mountPathHasParameters = mountPath && typeof mountPath === "string" && hasPathParameters(mountPath, this.opts);
+    const isMountPathHasParameters = this._hasPathParameters(mountPath);
+    const isRouterPrefixHasParameters = this._hasPathParameters(
+      this.opts.prefix
+    );
     for (let routeIndex = 0; routeIndex < clonedRouter.stack.length; routeIndex++) {
       const nestedLayer = clonedRouter.stack[routeIndex];
       const clonedLayer = this._cloneLayer(nestedLayer);
@@ -863,7 +831,7 @@ var RouterImplementation = class {
       if (this.opts.prefix) {
         clonedLayer.setPrefix(this.opts.prefix);
       }
-      if (clonedLayer.methods.length === 0 && mountPathHasParameters) {
+      if (clonedLayer.methods.length === 0 && (isMountPathHasParameters || isRouterPrefixHasParameters)) {
         clonedLayer.opts.ignoreCaptures = false;
       }
       this.stack.push(clonedLayer);
@@ -924,33 +892,27 @@ var RouterImplementation = class {
    * @private
    */
   _registerMiddleware(middleware, explicitPath, hasExplicitPath) {
-    const prefixHasParameters = hasPathParameters(
-      this.opts.prefix || "",
-      this.opts
-    );
+    const isPrefixHasParameters = this._hasPathParameters(this.opts.prefix);
     const effectiveExplicitPath = (() => {
       if (explicitPath !== void 0) return explicitPath;
-      if (prefixHasParameters) return "";
+      if (isPrefixHasParameters) return "";
       return;
     })();
-    const effectiveHasExplicitPath = hasExplicitPath || explicitPath === void 0 && prefixHasParameters;
-    const { path: middlewarePath, pathAsRegExp } = determineMiddlewarePath(
-      effectiveExplicitPath,
-      prefixHasParameters
-    );
+    const isEffectiveHasExplicitPath = hasExplicitPath || explicitPath === void 0 && isPrefixHasParameters;
+    const { path: middlewarePath, pathAsRegExp } = this._determineMiddlewarePath(effectiveExplicitPath);
     let finalPath = middlewarePath;
-    let usePathToRegexp = pathAsRegExp;
-    const isRootPath = effectiveHasExplicitPath && middlewarePath === "/";
-    if (effectiveHasExplicitPath && typeof middlewarePath === "string") {
+    let isUsePathToRegexp = pathAsRegExp;
+    const isRootPath = isEffectiveHasExplicitPath && middlewarePath === "/";
+    if (isEffectiveHasExplicitPath && typeof middlewarePath === "string") {
       finalPath = middlewarePath;
-      usePathToRegexp = false;
+      isUsePathToRegexp = false;
     }
-    const ignoreWildcardParameter = effectiveExplicitPath === "" && middlewarePath === "{/*rest}" ? "rest" : void 0;
+    const ignoreWildcardParameter = effectiveExplicitPath === "" && middlewarePath === MIDDLEWARE_WILDCARD_PATH ? "rest" : void 0;
     this.register(finalPath, [], middleware, {
       end: isRootPath,
-      ignoreCaptures: !effectiveHasExplicitPath && !prefixHasParameters,
+      ignoreCaptures: !isEffectiveHasExplicitPath && !isPrefixHasParameters,
       ignoreWildcardParameter,
-      pathAsRegExp: usePathToRegexp
+      pathAsRegExp: isUsePathToRegexp
     });
   }
   /**
@@ -967,19 +929,56 @@ var RouterImplementation = class {
    * @returns This router instance
    */
   prefix(prefixPath) {
-    const normalizedPrefix = prefixPath.replace(/\/$/, "");
+    this._updatePrefix(prefixPath);
+    return this;
+  }
+  _determineMiddlewarePath(explicitPath) {
+    if (explicitPath === "") {
+      return { path: MIDDLEWARE_WILDCARD_PATH, pathAsRegExp: false };
+    }
+    if (explicitPath === void 0) {
+      return { path: MIDDLEWARE_BOUNDARY_PATH, pathAsRegExp: true };
+    }
+    const isPathAsRegExp = typeof explicitPath !== "string";
+    return { path: explicitPath, pathAsRegExp: isPathAsRegExp };
+  }
+  _hasPathParameters(path = "") {
+    if (typeof path !== "string" || !path) return false;
+    const { keys } = compilePathToRegexp(path, this.opts);
+    return keys.length > 0;
+  }
+  _updatePrefix(currentPrefix) {
     const previousPrefix = this.opts.prefix || "";
+    const normalizedPrefix = currentPrefix.replace(/\/$/, "");
+    const isPrefixHasParameters = this._hasPathParameters(normalizedPrefix);
     this.opts.prefix = normalizedPrefix;
     for (const route of this.stack) {
-      if (typeof route.path === "string" && previousPrefix) {
-        const stripBoundary = previousPrefix + "/";
-        if (route.path === previousPrefix || route.path.startsWith(stripBoundary)) {
-          route.path = route.path.slice(previousPrefix.length) || "/";
-        }
-      }
-      route.setPrefix(normalizedPrefix);
+      this._updateRoutePrefix(route, previousPrefix);
+      this._updateRouteCaptureOptions(route, isPrefixHasParameters);
+    }
+  }
+  _getUnprefixedPath(route, previousPrefix) {
+    if (typeof route.path !== "string" || !previousPrefix) return route.path;
+    const prefixedMiddlewarePaths = /* @__PURE__ */ new Set([
+      previousPrefix + MIDDLEWARE_BOUNDARY_PATH,
+      previousPrefix + MIDDLEWARE_WILDCARD_PATH
+    ]);
+    const stripBoundary = previousPrefix + "/";
+    const isExactPrefix = route.path === previousPrefix;
+    const hasPrefixBoundary = route.path.startsWith(stripBoundary);
+    const isPathlessMiddleware = route.methods.length === 0 && prefixedMiddlewarePaths.has(route.path);
+    const hasReplaceablePrefix = isExactPrefix || hasPrefixBoundary || isPathlessMiddleware;
+    if (!hasReplaceablePrefix) return route.path;
+    return route.path.slice(previousPrefix.length) || "/";
+  }
+  _updateRoutePrefix(route, previousPrefix) {
+    route.path = this._getUnprefixedPath(route, previousPrefix);
+    route.setPrefix(this.opts.prefix || "");
+  }
+  _updateRouteCaptureOptions(route, isPrefixHasParameters) {
+    if (route.methods.length === 0 && isPrefixHasParameters) {
+      route.opts.ignoreCaptures = false;
     }
-    return this;
   }
   /**
    * Returns router middleware which dispatches a route matching the request.
@@ -1058,23 +1057,29 @@ var RouterImplementation = class {
    */
   _buildMiddlewareChain(matchedLayers, requestPath) {
     let layersToExecute;
+    let chosenLayer;
     if (this.exclusive) {
-      let chosenLayer;
+      const routeLayers = matchedLayers.filter(
+        (layer) => layer.methods.length > 0
+      );
       if (this.opts.exclusive === "specificity") {
-        for (const layer of matchedLayers) {
+        for (const layer of routeLayers) {
           if (!chosenLayer || layer.paramNames.length < chosenLayer.paramNames.length) {
             chosenLayer = layer;
           }
         }
       } else {
-        chosenLayer = matchedLayers.at(-1);
+        chosenLayer = routeLayers.at(-1);
       }
-      layersToExecute = chosenLayer ? [chosenLayer] : [];
+      layersToExecute = matchedLayers.filter(
+        (layer) => layer.methods.length === 0 || layer === chosenLayer
+      );
     } else {
       layersToExecute = matchedLayers;
     }
     const middlewareChain = [];
     for (const layer of layersToExecute) {
+      const metadataLayer = chosenLayer ?? layer;
       middlewareChain.push(
         (context, next) => {
           const routerContext = context;
@@ -1085,11 +1090,11 @@ var RouterImplementation = class {
             routerContext.params
           );
           routerContext.params = routerContext.request.params;
-          routerContext.routerPath = layer.path;
-          routerContext.routerName = layer.name || void 0;
-          routerContext._matchedRoute = layer.path;
-          if (layer.name) {
-            routerContext._matchedRouteName = layer.name;
+          routerContext.routerPath = metadataLayer.path;
+          routerContext.routerName = metadataLayer.name || void 0;
+          routerContext._matchedRoute = metadataLayer.path;
+          if (this.exclusive || metadataLayer.name) {
+            routerContext._matchedRouteName = metadataLayer.name || void 0;
           }
           return next();
         },
@@ -1473,8 +1478,8 @@ var RouterImplementation = class {
       if (layer.match(path)) {
         matchResult.path.push(layer);
         const isMiddleware = layer.methods.length === 0;
-        const matchesMethod = layer.methods.includes(normalizedMethod);
-        if (isMiddleware || matchesMethod) {
+        const isMatchesMethod = layer.methods.includes(normalizedMethod);
+        if (isMiddleware || isMatchesMethod) {
           matchResult.pathAndMethod.push(layer);
           if (layer.methods.length > 0) {
             matchResult.route = true;

package/dist/index.mjs

@@ -232,7 +232,7 @@ var Layer = class {
   _configurePathMatching() {
     if (this.opts.pathAsRegExp === true) {
       this.regexp = this.path instanceof RegExp ? this.path : new RegExp(this.path);
-    } else if (this.path) {
+    } else if (this.path || this.path === "") {
       this._configurePathToRegexp();
     }
   }
@@ -465,11 +465,17 @@ var Layer = class {
       if (!context._matchedParams) {
         context._matchedParams = /* @__PURE__ */ new WeakMap();
       }
-      if (context._matchedParams.has(parameterHandler)) {
+      const parameterValue = context.params[parameterName];
+      const matchedParameters = context._matchedParams.get(parameterHandler) ?? /* @__PURE__ */ new Map();
+      const hasMatchedParameter = matchedParameters.has(parameterName);
+      const matchedValue = matchedParameters.get(parameterName);
+      const hasMatchedValue = hasMatchedParameter && matchedValue === parameterValue;
+      if (hasMatchedValue) {
         return next();
       }
-      context._matchedParams.set(parameterHandler, true);
-      return parameterHandler(context.params[parameterName], context, next);
+      matchedParameters.set(parameterName, parameterValue);
+      context._matchedParams.set(parameterHandler, matchedParameters);
+      return parameterHandler(parameterValue, context, next);
     });
     middleware.param = parameterName;
     middleware._originalFn = parameterHandler;
@@ -480,12 +486,12 @@ var Layer = class {
    * @private
    */
   _insertParamMiddleware(middlewareStack, parameterMiddleware, parameterNamesList, currentParameterPosition) {
-    let inserted = false;
+    let isInserted = false;
     for (let stackIndex = 0; stackIndex < middlewareStack.length; stackIndex++) {
       const existingMiddleware = middlewareStack[stackIndex];
       if (!existingMiddleware.param) {
         middlewareStack.splice(stackIndex, 0, parameterMiddleware);
-        inserted = true;
+        isInserted = true;
         break;
       }
       const existingParameterPosition = parameterNamesList.indexOf(
@@ -493,11 +499,11 @@ var Layer = class {
       );
       if (existingParameterPosition > currentParameterPosition) {
         middlewareStack.splice(stackIndex, 0, parameterMiddleware);
-        inserted = true;
+        isInserted = true;
         break;
       }
     }
-    if (!inserted) {
+    if (!isInserted) {
       middlewareStack.push(parameterMiddleware);
     }
   }
@@ -509,10 +515,7 @@ var Layer = class {
    * @private
    */
   setPrefix(prefixPath) {
-    if (!this.path) {
-      return this;
-    }
-    if (this.path instanceof RegExp) {
+    if (typeof this.path !== "string") {
       return this;
     }
     this.path = this._applyPrefix(prefixPath);
@@ -526,13 +529,18 @@ var Layer = class {
   _applyPrefix(prefixPath) {
     const isRootPath = this.path === "/";
     const isStrictMode = this.opts.strict === true;
-    const prefixHasParameters = prefixPath.includes(":");
-    const pathIsRawRegex = this.opts.pathAsRegExp === true && typeof this.path === "string";
-    if (prefixHasParameters && pathIsRawRegex) {
+    const isPrefixHasParameters = prefixPath.includes(":");
+    const isPathIsRawRegex = this.opts.pathAsRegExp === true && typeof this.path === "string";
+    if (isPrefixHasParameters && isPathIsRawRegex) {
       const currentPath = this.path;
-      if (currentPath === String.raw`(?:\/|$)` || currentPath === String.raw`(?:\\\/|$)`) {
-        this.path = "{/*rest}";
+      const middlewareBoundary = [
+        String.raw`(?:\/|$)`,
+        String.raw`(?:\\\/|$)`
+      ].find((boundary) => currentPath.endsWith(boundary));
+      if (middlewareBoundary) {
+        this.path = `${currentPath.slice(0, -middlewareBoundary.length)}{/*rest}`;
         this.opts.pathAsRegExp = false;
+        this.opts.ignoreWildcardParameter = "rest";
       }
     }
     if (isRootPath && !isStrictMode) {
@@ -545,9 +553,9 @@ var Layer = class {
    * @private
    */
   _reconfigurePathMatching(prefixPath) {
-    const treatAsRegExp = this.opts.pathAsRegExp === true;
+    const isTreatAsRegExp = this.opts.pathAsRegExp === true;
     const prefixHasParameters = prefixPath && prefixPath.includes(":");
-    if (prefixHasParameters && treatAsRegExp) {
+    if (prefixHasParameters && isTreatAsRegExp) {
       const options = normalizeLayerOptionsToPathToRegexp(this.opts);
       const { regexp, keys } = compilePathToRegexp(
         this.path,
@@ -556,10 +564,10 @@ var Layer = class {
       this.regexp = regexp;
       this.paramNames = keys;
       this.opts.pathAsRegExp = false;
-    } else if (treatAsRegExp) {
+    } else if (isTreatAsRegExp) {
       const pathString = this.path;
       const anchoredPattern = pathString.startsWith("^") ? pathString : `^${pathString}`;
-      this.regexp = this.path instanceof RegExp ? this.path : new RegExp(anchoredPattern);
+      this.regexp = this.path instanceof RegExp ? this.path : new RegExp(anchoredPattern, this.opts.sensitive ? "" : "i");
     } else {
       const options = normalizeLayerOptionsToPathToRegexp(this.opts);
       const { regexp, keys } = compilePathToRegexp(
@@ -618,57 +626,14 @@ function applyAllParameterMiddleware(route, parametersObject) {
   }
 }
 
-// src/utils/path-helpers.ts
-function hasPathParameters(path, options = {}) {
-  if (!path) {
-    return false;
-  }
-  const { keys } = compilePathToRegexp(path, options);
-  return keys.length > 0;
-}
-function determineMiddlewarePath(explicitPath, hasPrefixParameters) {
-  if (explicitPath !== void 0) {
-    if (typeof explicitPath === "string") {
-      if (explicitPath === "") {
-        return {
-          path: "{/*rest}",
-          pathAsRegExp: false
-        };
-      }
-      if (explicitPath === "/") {
-        return {
-          path: "/",
-          pathAsRegExp: false
-        };
-      }
-      return {
-        path: explicitPath,
-        pathAsRegExp: false
-      };
-    }
-    return {
-      path: explicitPath,
-      pathAsRegExp: true
-    };
-  }
-  if (hasPrefixParameters) {
-    return {
-      path: "{/*rest}",
-      pathAsRegExp: false
-    };
-  }
-  return {
-    path: String.raw`(?:\/|$)`,
-    pathAsRegExp: true
-  };
-}
-
 // src/utils/debug.ts
 import debugModule from "debug";
 var debug = debugModule("koa-router");
 
 // src/router.ts
 var httpMethods = getAllHttpMethods();
+var MIDDLEWARE_BOUNDARY_PATH = String.raw`(?:\/|$)`;
+var MIDDLEWARE_WILDCARD_PATH = "{/*rest}";
 var RouterImplementation = class {
   opts;
   methods;
@@ -744,10 +709,10 @@ var RouterImplementation = class {
     return temporaryLayer.url(...arguments_);
   }
   use(...middleware) {
-    let explicitPath;
     if (this._isPathArray(middleware[0])) {
       return this._useWithPathArray(middleware);
     }
+    let explicitPath;
     const hasExplicitPath = this._hasExplicitPath(middleware[0]);
     if (hasExplicitPath) {
       explicitPath = middleware.shift();
@@ -814,7 +779,10 @@ var RouterImplementation = class {
   _mountNestedRouter(middlewareWithRouter, mountPath) {
     const nestedRouter = middlewareWithRouter.router;
     const clonedRouter = this._cloneRouter(nestedRouter);
-    const mountPathHasParameters = mountPath && typeof mountPath === "string" && hasPathParameters(mountPath, this.opts);
+    const isMountPathHasParameters = this._hasPathParameters(mountPath);
+    const isRouterPrefixHasParameters = this._hasPathParameters(
+      this.opts.prefix
+    );
     for (let routeIndex = 0; routeIndex < clonedRouter.stack.length; routeIndex++) {
       const nestedLayer = clonedRouter.stack[routeIndex];
       const clonedLayer = this._cloneLayer(nestedLayer);
@@ -824,7 +792,7 @@ var RouterImplementation = class {
       if (this.opts.prefix) {
         clonedLayer.setPrefix(this.opts.prefix);
       }
-      if (clonedLayer.methods.length === 0 && mountPathHasParameters) {
+      if (clonedLayer.methods.length === 0 && (isMountPathHasParameters || isRouterPrefixHasParameters)) {
         clonedLayer.opts.ignoreCaptures = false;
       }
       this.stack.push(clonedLayer);
@@ -885,33 +853,27 @@ var RouterImplementation = class {
    * @private
    */
   _registerMiddleware(middleware, explicitPath, hasExplicitPath) {
-    const prefixHasParameters = hasPathParameters(
-      this.opts.prefix || "",
-      this.opts
-    );
+    const isPrefixHasParameters = this._hasPathParameters(this.opts.prefix);
     const effectiveExplicitPath = (() => {
       if (explicitPath !== void 0) return explicitPath;
-      if (prefixHasParameters) return "";
+      if (isPrefixHasParameters) return "";
       return;
     })();
-    const effectiveHasExplicitPath = hasExplicitPath || explicitPath === void 0 && prefixHasParameters;
-    const { path: middlewarePath, pathAsRegExp } = determineMiddlewarePath(
-      effectiveExplicitPath,
-      prefixHasParameters
-    );
+    const isEffectiveHasExplicitPath = hasExplicitPath || explicitPath === void 0 && isPrefixHasParameters;
+    const { path: middlewarePath, pathAsRegExp } = this._determineMiddlewarePath(effectiveExplicitPath);
     let finalPath = middlewarePath;
-    let usePathToRegexp = pathAsRegExp;
-    const isRootPath = effectiveHasExplicitPath && middlewarePath === "/";
-    if (effectiveHasExplicitPath && typeof middlewarePath === "string") {
+    let isUsePathToRegexp = pathAsRegExp;
+    const isRootPath = isEffectiveHasExplicitPath && middlewarePath === "/";
+    if (isEffectiveHasExplicitPath && typeof middlewarePath === "string") {
       finalPath = middlewarePath;
-      usePathToRegexp = false;
+      isUsePathToRegexp = false;
     }
-    const ignoreWildcardParameter = effectiveExplicitPath === "" && middlewarePath === "{/*rest}" ? "rest" : void 0;
+    const ignoreWildcardParameter = effectiveExplicitPath === "" && middlewarePath === MIDDLEWARE_WILDCARD_PATH ? "rest" : void 0;
     this.register(finalPath, [], middleware, {
       end: isRootPath,
-      ignoreCaptures: !effectiveHasExplicitPath && !prefixHasParameters,
+      ignoreCaptures: !isEffectiveHasExplicitPath && !isPrefixHasParameters,
       ignoreWildcardParameter,
-      pathAsRegExp: usePathToRegexp
+      pathAsRegExp: isUsePathToRegexp
     });
   }
   /**
@@ -928,19 +890,56 @@ var RouterImplementation = class {
    * @returns This router instance
    */
   prefix(prefixPath) {
-    const normalizedPrefix = prefixPath.replace(/\/$/, "");
+    this._updatePrefix(prefixPath);
+    return this;
+  }
+  _determineMiddlewarePath(explicitPath) {
+    if (explicitPath === "") {
+      return { path: MIDDLEWARE_WILDCARD_PATH, pathAsRegExp: false };
+    }
+    if (explicitPath === void 0) {
+      return { path: MIDDLEWARE_BOUNDARY_PATH, pathAsRegExp: true };
+    }
+    const isPathAsRegExp = typeof explicitPath !== "string";
+    return { path: explicitPath, pathAsRegExp: isPathAsRegExp };
+  }
+  _hasPathParameters(path = "") {
+    if (typeof path !== "string" || !path) return false;
+    const { keys } = compilePathToRegexp(path, this.opts);
+    return keys.length > 0;
+  }
+  _updatePrefix(currentPrefix) {
     const previousPrefix = this.opts.prefix || "";
+    const normalizedPrefix = currentPrefix.replace(/\/$/, "");
+    const isPrefixHasParameters = this._hasPathParameters(normalizedPrefix);
     this.opts.prefix = normalizedPrefix;
     for (const route of this.stack) {
-      if (typeof route.path === "string" && previousPrefix) {
-        const stripBoundary = previousPrefix + "/";
-        if (route.path === previousPrefix || route.path.startsWith(stripBoundary)) {
-          route.path = route.path.slice(previousPrefix.length) || "/";
-        }
-      }
-      route.setPrefix(normalizedPrefix);
+      this._updateRoutePrefix(route, previousPrefix);
+      this._updateRouteCaptureOptions(route, isPrefixHasParameters);
+    }
+  }
+  _getUnprefixedPath(route, previousPrefix) {
+    if (typeof route.path !== "string" || !previousPrefix) return route.path;
+    const prefixedMiddlewarePaths = /* @__PURE__ */ new Set([
+      previousPrefix + MIDDLEWARE_BOUNDARY_PATH,
+      previousPrefix + MIDDLEWARE_WILDCARD_PATH
+    ]);
+    const stripBoundary = previousPrefix + "/";
+    const isExactPrefix = route.path === previousPrefix;
+    const hasPrefixBoundary = route.path.startsWith(stripBoundary);
+    const isPathlessMiddleware = route.methods.length === 0 && prefixedMiddlewarePaths.has(route.path);
+    const hasReplaceablePrefix = isExactPrefix || hasPrefixBoundary || isPathlessMiddleware;
+    if (!hasReplaceablePrefix) return route.path;
+    return route.path.slice(previousPrefix.length) || "/";
+  }
+  _updateRoutePrefix(route, previousPrefix) {
+    route.path = this._getUnprefixedPath(route, previousPrefix);
+    route.setPrefix(this.opts.prefix || "");
+  }
+  _updateRouteCaptureOptions(route, isPrefixHasParameters) {
+    if (route.methods.length === 0 && isPrefixHasParameters) {
+      route.opts.ignoreCaptures = false;
     }
-    return this;
   }
   /**
    * Returns router middleware which dispatches a route matching the request.
@@ -1019,23 +1018,29 @@ var RouterImplementation = class {
    */
   _buildMiddlewareChain(matchedLayers, requestPath) {
     let layersToExecute;
+    let chosenLayer;
     if (this.exclusive) {
-      let chosenLayer;
+      const routeLayers = matchedLayers.filter(
+        (layer) => layer.methods.length > 0
+      );
       if (this.opts.exclusive === "specificity") {
-        for (const layer of matchedLayers) {
+        for (const layer of routeLayers) {
           if (!chosenLayer || layer.paramNames.length < chosenLayer.paramNames.length) {
             chosenLayer = layer;
           }
         }
       } else {
-        chosenLayer = matchedLayers.at(-1);
+        chosenLayer = routeLayers.at(-1);
       }
-      layersToExecute = chosenLayer ? [chosenLayer] : [];
+      layersToExecute = matchedLayers.filter(
+        (layer) => layer.methods.length === 0 || layer === chosenLayer
+      );
     } else {
       layersToExecute = matchedLayers;
     }
     const middlewareChain = [];
     for (const layer of layersToExecute) {
+      const metadataLayer = chosenLayer ?? layer;
       middlewareChain.push(
         (context, next) => {
           const routerContext = context;
@@ -1046,11 +1051,11 @@ var RouterImplementation = class {
             routerContext.params
           );
           routerContext.params = routerContext.request.params;
-          routerContext.routerPath = layer.path;
-          routerContext.routerName = layer.name || void 0;
-          routerContext._matchedRoute = layer.path;
-          if (layer.name) {
-            routerContext._matchedRouteName = layer.name;
+          routerContext.routerPath = metadataLayer.path;
+          routerContext.routerName = metadataLayer.name || void 0;
+          routerContext._matchedRoute = metadataLayer.path;
+          if (this.exclusive || metadataLayer.name) {
+            routerContext._matchedRouteName = metadataLayer.name || void 0;
           }
           return next();
         },
@@ -1434,8 +1439,8 @@ var RouterImplementation = class {
       if (layer.match(path)) {
         matchResult.path.push(layer);
         const isMiddleware = layer.methods.length === 0;
-        const matchesMethod = layer.methods.includes(normalizedMethod);
-        if (isMiddleware || matchesMethod) {
+        const isMatchesMethod = layer.methods.includes(normalizedMethod);
+        if (isMiddleware || isMatchesMethod) {
           matchResult.pathAndMethod.push(layer);
           if (layer.methods.length > 0) {
             matchResult.route = true;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@koa/router",
   "description": "Router middleware for Koa.",
-  "version": "15.6.0",
+  "version": "15.7.1",
   "author": "Koa.js",
   "bugs": {
     "url": "https://github.com/koajs/router/issues",
@@ -31,30 +31,30 @@
     "path-to-regexp": "^8.4.2"
   },
   "devDependencies": {
-    "@commitlint/cli": "^21.0.2",
-    "@commitlint/config-conventional": "^21.0.2",
+    "@commitlint/cli": "^21.2.2",
+    "@commitlint/config-conventional": "^21.2.2",
     "@eslint/js": "^10.0.1",
     "@koa/bodyparser": "^6.1.0",
     "@types/debug": "^4.1.13",
     "@types/jsonwebtoken": "^9.0.10",
     "@types/koa": "^3.0.3",
-    "@types/node": "^25.9.1",
-    "@types/supertest": "^7.2.0",
-    "@typescript-eslint/eslint-plugin": "^8.60.0",
-    "@typescript-eslint/parser": "^8.60.0",
-    "c8": "^11.0.0",
-    "chalk": "^5.6.2",
-    "eslint": "^10.4.1",
-    "eslint-plugin-unicorn": "^64.0.0",
+    "@types/node": "^26.6.2",
+    "@types/supertest": "^7.2.1",
+    "@typescript-eslint/eslint-plugin": "^8.70.0",
+    "@typescript-eslint/parser": "^8.70.0",
+    "c8": "^12.0.0",
+    "chalk": "^6.0.0",
+    "eslint": "^10.11.0",
+    "eslint-plugin-unicorn": "^73.0.0",
     "husky": "^9.1.7",
-    "joi": "^18.2.1",
+    "joi": "^18.2.9",
     "jsonwebtoken": "^9.0.3",
     "koa": "^3.2.1",
-    "lint-staged": "^17.0.6",
-    "np": "^11.2.1",
-    "prettier": "^3.8.3",
+    "lint-staged": "^17.5.1",
+    "np": "^12.1.1",
+    "prettier": "^3.9.8",
     "rimraf": "^6.1.3",
-    "supertest": "^7.2.2",
+    "supertest": "^7.3.1",
     "ts-node": "^10.9.2",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
@@ -104,6 +104,7 @@
     "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,md,yml,yaml}\"",
     "lint:ts": "eslint src test --fix",
     "lint": "npm run lint:ts",
+    "lint:ci": "eslint src test",
     "test:core": "TS_NODE_PROJECT=tsconfig.ts-node.json node --require ts-node/register --test test/*.test.ts test/**/*.test.ts",
     "test:recipes": "TS_NODE_PROJECT=tsconfig.recipes.json node --require ts-node/register --test recipes/**/*.test.ts",
     "pretest:all": "npm run lint && npm run build",
@@ -115,8 +116,5 @@
     "build": "tsup",
     "prepublishOnly": "npm run build",
     "release": "np --test-script test:all"
-  },
-  "resolutions": {
-    "c8/yargs": "^18.0.0"
   }
 }