feat: .dev prefix for dev only route

src/scan.ts

@@ -8,15 +8,20 @@ type FileInfo = { path: string; fullPath: string };
 
 const httpMethodRegex =
   /\.(connect|delete|get|head|options|patch|post|put|trace)$/;
+const devSuffixRegex = /\.dev$/;
 
 export async function scanHandlers(nitro: Nitro) {
   const middleware = await scanMiddleware(nitro);
 
-  const handlers = await Promise.all([
+  let handlers = await Promise.all([
     scanServerRoutes(nitro, "api", "/api"),
     scanServerRoutes(nitro, "routes", "/"),
   ]).then((r) => r.flat());
 
+  if (!nitro.options.dev) {
+    handlers = handlers.filter((h) => !h.devOnly);
+  }
+
   nitro.scannedHandlers = [
     ...middleware,
     ...handlers.filter((h, index, array) => {
@@ -55,6 +60,12 @@ export async function scanServerRoutes(
       .replace(/\[(\w+)]/g, ":$1");
     route = withLeadingSlash(withoutTrailingSlash(withBase(route, prefix)));
 
+    let devOnly = false;
+    if (devSuffixRegex.test(route)) {
+      devOnly = true;
+      route = route.slice(0, Math.max(0, route.length - 4));
+    }
+
     let method;
     const methodMatch = route.match(httpMethodRegex);
     if (methodMatch) {
@@ -70,6 +81,7 @@ export async function scanServerRoutes(
       middleware: false,
       route,
       method,
+      devOnly,
     };
   });
 }

test/fixture/routes/dev-route-only.dev.ts

@@ -0,0 +1,4 @@
+const sharedAppConfig = useAppConfig();
+const sharedRuntimeConfig = useRuntimeConfig();
+
+export default eventHandler(() => "You should only see this in dev mode.");

test/presets/nitro-dev.test.ts

@@ -21,6 +21,11 @@ describe.skipIf(isCI)("nitro:preset:nitro-dev", async () => {
         const { status } = await callHandler({ url: "/proxy/example" });
         expect(status).toBe(200);
       });
+
+      it("load dev only route", async () => {
+        const { status } = await callHandler({ url: "/dev-route-only" });
+        expect(status).toBe(200);
+      });
     }
   );
 });