mokup 0.0.1 → 0.1.0

package/dist/index.d.cts

@@ -1,27 +1,23 @@
-import { IncomingMessage, ServerResponse } from 'node:http';
+import { MiddlewareHandler, Context } from 'hono';
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-interface MockRequest {
-    url: string;
-    method: HttpMethod;
-    headers: IncomingMessage['headers'];
-    query: Record<string, string | string[]>;
-    body: unknown;
-    rawBody?: string;
-    params?: Record<string, string | string[]>;
-}
-interface MockContext {
-    delay: (ms: number) => Promise<void>;
-    json: (data: unknown) => unknown;
-}
-type MockResponseHandler = (req: MockRequest, res: ServerResponse, ctx: MockContext) => unknown | Promise<unknown>;
+type MockContext = Context;
+type MockMiddleware = MiddlewareHandler;
+type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
 type MockResponse = unknown | MockResponseHandler;
 interface MockRule {
-    response: MockResponse;
+    handler: MockResponse;
     status?: number;
     headers?: Record<string, string>;
     delay?: number;
 }
+interface DirectoryConfig {
+    headers?: Record<string, string>;
+    status?: number;
+    delay?: number;
+    enabled?: boolean;
+    middleware?: MockMiddleware | MockMiddleware[];
+}
 interface MokupViteOptions {
     dir?: string | string[] | ((root: string) => string | string[]);
     prefix?: string;
@@ -36,4 +32,4 @@ interface MokupViteOptions {
 }
 type MokupViteOptionsInput = MokupViteOptions | MokupViteOptions[];
 
-export type { HttpMethod, MockContext, MockRequest, MockResponse, MockResponseHandler, MockRule, MokupViteOptions, MokupViteOptionsInput };
+export type { DirectoryConfig, HttpMethod, MockContext, MockMiddleware, MockResponse, MockResponseHandler, MockRule, MokupViteOptions, MokupViteOptionsInput };

package/dist/index.d.mts

@@ -1,27 +1,23 @@
-import { IncomingMessage, ServerResponse } from 'node:http';
+import { MiddlewareHandler, Context } from 'hono';
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-interface MockRequest {
-    url: string;
-    method: HttpMethod;
-    headers: IncomingMessage['headers'];
-    query: Record<string, string | string[]>;
-    body: unknown;
-    rawBody?: string;
-    params?: Record<string, string | string[]>;
-}
-interface MockContext {
-    delay: (ms: number) => Promise<void>;
-    json: (data: unknown) => unknown;
-}
-type MockResponseHandler = (req: MockRequest, res: ServerResponse, ctx: MockContext) => unknown | Promise<unknown>;
+type MockContext = Context;
+type MockMiddleware = MiddlewareHandler;
+type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
 type MockResponse = unknown | MockResponseHandler;
 interface MockRule {
-    response: MockResponse;
+    handler: MockResponse;
     status?: number;
     headers?: Record<string, string>;
     delay?: number;
 }
+interface DirectoryConfig {
+    headers?: Record<string, string>;
+    status?: number;
+    delay?: number;
+    enabled?: boolean;
+    middleware?: MockMiddleware | MockMiddleware[];
+}
 interface MokupViteOptions {
     dir?: string | string[] | ((root: string) => string | string[]);
     prefix?: string;
@@ -36,4 +32,4 @@ interface MokupViteOptions {
 }
 type MokupViteOptionsInput = MokupViteOptions | MokupViteOptions[];
 
-export type { HttpMethod, MockContext, MockRequest, MockResponse, MockResponseHandler, MockRule, MokupViteOptions, MokupViteOptionsInput };
+export type { DirectoryConfig, HttpMethod, MockContext, MockMiddleware, MockResponse, MockResponseHandler, MockRule, MokupViteOptions, MokupViteOptionsInput };

package/dist/index.d.ts

@@ -1,27 +1,23 @@
-import { IncomingMessage, ServerResponse } from 'node:http';
+import { MiddlewareHandler, Context } from 'hono';
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-interface MockRequest {
-    url: string;
-    method: HttpMethod;
-    headers: IncomingMessage['headers'];
-    query: Record<string, string | string[]>;
-    body: unknown;
-    rawBody?: string;
-    params?: Record<string, string | string[]>;
-}
-interface MockContext {
-    delay: (ms: number) => Promise<void>;
-    json: (data: unknown) => unknown;
-}
-type MockResponseHandler = (req: MockRequest, res: ServerResponse, ctx: MockContext) => unknown | Promise<unknown>;
+type MockContext = Context;
+type MockMiddleware = MiddlewareHandler;
+type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
 type MockResponse = unknown | MockResponseHandler;
 interface MockRule {
-    response: MockResponse;
+    handler: MockResponse;
     status?: number;
     headers?: Record<string, string>;
     delay?: number;
 }
+interface DirectoryConfig {
+    headers?: Record<string, string>;
+    status?: number;
+    delay?: number;
+    enabled?: boolean;
+    middleware?: MockMiddleware | MockMiddleware[];
+}
 interface MokupViteOptions {
     dir?: string | string[] | ((root: string) => string | string[]);
     prefix?: string;
@@ -36,4 +32,4 @@ interface MokupViteOptions {
 }
 type MokupViteOptionsInput = MokupViteOptions | MokupViteOptions[];
 
-export type { HttpMethod, MockContext, MockRequest, MockResponse, MockResponseHandler, MockRule, MokupViteOptions, MokupViteOptionsInput };
+export type { DirectoryConfig, HttpMethod, MockContext, MockMiddleware, MockResponse, MockResponseHandler, MockRule, MokupViteOptions, MokupViteOptionsInput };

package/dist/vite.cjs

@@ -3,10 +3,12 @@
 const node_process = require('node:process');
 const chokidar = require('chokidar');
 const node_buffer = require('node:buffer');
-const runtime = require('@mokup/runtime');
+const hono = require('hono');
+const patternRouter = require('hono/router/pattern-router');
 const pathe = require('pathe');
 const node_fs = require('node:fs');
 const node_module = require('node:module');
+const runtime = require('@mokup/runtime');
 const node_url = require('node:url');
 const esbuild = require('esbuild');
 const jsoncParser = require('jsonc-parser');
@@ -122,25 +124,113 @@ function delay(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 
-function extractQuery(parsedUrl) {
-  const query = {};
-  for (const [key, value] of parsedUrl.searchParams.entries()) {
-    const current = query[key];
-    if (typeof current === "undefined") {
-      query[key] = value;
-    } else if (Array.isArray(current)) {
-      current.push(value);
-    } else {
-      query[key] = [current, value];
+function toHonoPath(route) {
+  if (!route.tokens || route.tokens.length === 0) {
+    return "/";
+  }
+  const segments = route.tokens.map((token) => {
+    if (token.type === "static") {
+      return token.value;
+    }
+    if (token.type === "param") {
+      return `:${token.name}`;
+    }
+    if (token.type === "catchall") {
+      return `:${token.name}{.+}`;
+    }
+    return `:${token.name}{.+}?`;
+  });
+  return `/${segments.join("/")}`;
+}
+function applyRouteOverrides(response, route) {
+  const headers = new Headers(response.headers);
+  const hasHeaders = !!route.headers && Object.keys(route.headers).length > 0;
+  if (route.headers) {
+    for (const [key, value] of Object.entries(route.headers)) {
+      headers.set(key, value);
+    }
+  }
+  const status = route.status ?? response.status;
+  if (status === response.status && !hasHeaders) {
+    return response;
+  }
+  return new Response(response.body, { status, headers });
+}
+function normalizeHandlerValue(c, value) {
+  if (value instanceof Response) {
+    return value;
+  }
+  if (typeof value === "undefined") {
+    const response = c.body(null);
+    if (response.status === 200) {
+      return new Response(response.body, {
+        status: 204,
+        headers: response.headers
+      });
+    }
+    return response;
+  }
+  if (typeof value === "string") {
+    return c.text(value);
+  }
+  if (value instanceof Uint8Array || value instanceof ArrayBuffer) {
+    if (!c.res.headers.get("content-type")) {
+      c.header("content-type", "application/octet-stream");
     }
+    const data = value instanceof ArrayBuffer ? new Uint8Array(value) : new Uint8Array(value);
+    return c.body(data);
   }
-  return query;
+  return c.json(value);
+}
+function createRouteHandler(route) {
+  return async (c) => {
+    const value = typeof route.handler === "function" ? await route.handler(c) : route.handler;
+    return normalizeHandlerValue(c, value);
+  };
+}
+function createFinalizeMiddleware(route) {
+  return async (c, next) => {
+    const response = await next();
+    const resolved = response ?? c.res;
+    if (route.delay && route.delay > 0) {
+      await delay(route.delay);
+    }
+    return applyRouteOverrides(resolved, route);
+  };
+}
+function wrapMiddleware(handler) {
+  return async (c, next) => {
+    const response = await handler(c, next);
+    return response ?? c.res;
+  };
+}
+function createHonoApp(routes) {
+  const app = new hono.Hono({ router: new patternRouter.PatternRouter(), strict: false });
+  for (const route of routes) {
+    const middlewares = route.middlewares?.map((entry) => wrapMiddleware(entry.handle)) ?? [];
+    app.on(
+      route.method,
+      toHonoPath(route),
+      createFinalizeMiddleware(route),
+      ...middlewares,
+      createRouteHandler(route)
+    );
+  }
+  return app;
 }
 async function readRawBody(req) {
-  return new Promise((resolve, reject) => {
+  return await new Promise((resolve, reject) => {
     const chunks = [];
     req.on("data", (chunk) => {
-      chunks.push(node_buffer.Buffer.isBuffer(chunk) ? chunk : node_buffer.Buffer.from(chunk));
+      if (typeof chunk === "string") {
+        chunks.push(node_buffer.Buffer.from(chunk));
+        return;
+      }
+      if (chunk instanceof Uint8Array) {
+        chunks.push(chunk);
+        return;
+      }
+      chunks.push(node_buffer.Buffer.from(String(chunk)));
     });
     req.on("end", () => {
       if (chunks.length === 0) {
@@ -152,148 +242,74 @@ async function readRawBody(req) {
     req.on("error", reject);
   });
 }
-async function readRequestBody(req, parsedUrl) {
-  const query = extractQuery(parsedUrl);
-  const rawBody = await readRawBody(req);
-  if (!rawBody) {
-    return { query, body: void 0, rawBody: void 0 };
-  }
-  const rawText = rawBody.toString("utf8");
-  const contentTypeHeader = req.headers["content-type"];
-  const contentTypeValue = Array.isArray(contentTypeHeader) ? contentTypeHeader[0] ?? "" : contentTypeHeader ?? "";
-  const contentType = contentTypeValue.split(";")[0]?.trim() ?? "";
-  if (contentType === "application/json" || contentType.endsWith("+json")) {
-    try {
-      return { query, body: JSON.parse(rawText), rawBody: rawText };
-    } catch {
-      return { query, body: rawText, rawBody: rawText };
+function buildHeaders(headers) {
+  const result = new Headers();
+  for (const [key, value] of Object.entries(headers)) {
+    if (typeof value === "undefined") {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      result.set(key, value.join(","));
+    } else {
+      result.set(key, value);
     }
   }
-  if (contentType === "application/x-www-form-urlencoded") {
-    const params = new URLSearchParams(rawText);
-    const body = Object.fromEntries(params.entries());
-    return { query, body, rawBody: rawText };
-  }
-  return { query, body: rawText, rawBody: rawText };
+  return result;
 }
-function applyHeaders(res, headers) {
-  if (!headers) {
-    return;
-  }
-  for (const [key, value] of Object.entries(headers)) {
-    res.setHeader(key, value);
+async function toRequest(req) {
+  const url = new URL(req.url ?? "/", "http://mokup.local");
+  const method = req.method ?? "GET";
+  const headers = buildHeaders(req.headers);
+  const init = { method, headers };
+  const rawBody = await readRawBody(req);
+  if (rawBody && method !== "GET" && method !== "HEAD") {
+    init.body = rawBody;
   }
+  return new Request(url.toString(), init);
 }
-function writeResponse(res, body) {
-  if (typeof body === "undefined") {
-    if (!res.headersSent && res.statusCode === 200) {
-      res.statusCode = 204;
-    }
+async function sendResponse(res, response) {
+  res.statusCode = response.status;
+  response.headers.forEach((value, key) => {
+    res.setHeader(key, value);
+  });
+  if (!response.body) {
     res.end();
     return;
   }
-  if (node_buffer.Buffer.isBuffer(body)) {
-    if (!res.getHeader("Content-Type")) {
-      res.setHeader("Content-Type", "application/octet-stream");
-    }
-    res.end(body);
-    return;
-  }
-  if (typeof body === "string") {
-    if (!res.getHeader("Content-Type")) {
-      res.setHeader("Content-Type", "text/plain; charset=utf-8");
-    }
-    res.end(body);
-    return;
-  }
-  if (!res.getHeader("Content-Type")) {
-    res.setHeader("Content-Type", "application/json; charset=utf-8");
-  }
-  res.end(JSON.stringify(body));
+  const buffer = new Uint8Array(await response.arrayBuffer());
+  res.end(buffer);
 }
-function findMatchingRoute(routes, method, pathname) {
-  for (const route of routes) {
-    if (route.method !== method) {
-      continue;
-    }
-    const matched = runtime.matchRouteTokens(route.tokens, pathname);
-    if (matched) {
-      return { route, params: matched.params };
-    }
-  }
-  return null;
+function hasMatch(app, method, pathname) {
+  const matchMethod = method === "HEAD" ? "GET" : method;
+  const match = app.router.match(matchMethod, pathname);
+  return !!match && match[0].length > 0;
 }
-function createMiddleware(getRoutes, logger) {
+function createMiddleware(getApp, logger) {
   return async (req, res, next) => {
+    const app = getApp();
+    if (!app) {
+      return next();
+    }
     const url = req.url ?? "/";
     const parsedUrl = new URL(url, "http://mokup.local");
     const pathname = parsedUrl.pathname;
     const method = normalizeMethod(req.method) ?? "GET";
-    const matched = findMatchingRoute(getRoutes(), method, pathname);
-    if (!matched) {
+    if (!hasMatch(app, method, pathname)) {
       return next();
     }
+    const startedAt = Date.now();
     try {
-      const { query, body, rawBody } = await readRequestBody(req, parsedUrl);
-      const mockReq = {
-        url: pathname,
-        method,
-        headers: req.headers,
-        query,
-        body,
-        params: matched.params
-      };
-      if (rawBody) {
-        mockReq.rawBody = rawBody;
-      }
-      const ctx = {
-        delay: (ms) => delay(ms),
-        json: (data) => data
-      };
-      const startedAt = Date.now();
-      const executeHandler = async () => {
-        return typeof matched.route.response === "function" ? await matched.route.response(mockReq, res, ctx) : matched.route.response;
-      };
-      const runMiddlewares = async (middlewares) => {
-        let lastIndex = -1;
-        const dispatch = async (index) => {
-          if (index <= lastIndex) {
-            throw new Error("Middleware next() called multiple times.");
-          }
-          lastIndex = index;
-          const entry = middlewares[index];
-          if (!entry) {
-            return executeHandler();
-          }
-          let nextResult;
-          const next2 = async () => {
-            nextResult = await dispatch(index + 1);
-            return nextResult;
-          };
-          const value = await entry.handle(mockReq, res, ctx, next2);
-          if (typeof value !== "undefined") {
-            return value;
-          }
-          return nextResult;
-        };
-        return dispatch(0);
-      };
-      const responseValue = matched.route.middlewares && matched.route.middlewares.length > 0 ? await runMiddlewares(matched.route.middlewares) : await executeHandler();
+      const response = await app.fetch(await toRequest(req));
       if (res.writableEnded) {
         return;
       }
-      if (matched.route.delay && matched.route.delay > 0) {
-        await delay(matched.route.delay);
-      }
-      applyHeaders(res, matched.route.headers);
-      if (matched.route.status) {
-        res.statusCode = matched.route.status;
-      }
-      writeResponse(res, responseValue);
+      await sendResponse(res, response);
       logger.info(`${method} ${pathname} ${Date.now() - startedAt}ms`);
     } catch (error) {
-      res.statusCode = 500;
-      res.setHeader("Content-Type", "text/plain; charset=utf-8");
+      if (!res.headersSent) {
+        res.statusCode = 500;
+        res.setHeader("Content-Type", "text/plain; charset=utf-8");
+      }
       res.end("Mock handler error");
       logger.error("Mock handler failed:", error);
     }
@@ -475,7 +491,7 @@ function toPlaygroundRoute(route, root, groups) {
     method: route.method,
     url: route.template,
     file: formatRouteFile(route.file, root),
-    type: typeof route.response === "function" ? "handler" : "static",
+    type: typeof route.handler === "function" ? "handler" : "static",
     status: route.status,
     delay: route.delay,
     middlewareCount: middlewareSources?.length ?? 0,
@@ -648,7 +664,7 @@ function resolveRule(params) {
     method,
     tokens: parsed.tokens,
     score: parsed.score,
-    response: params.rule.response
+    handler: params.rule.handler
   };
   if (typeof params.rule.status === "number") {
     route.status = params.rule.status;
@@ -926,7 +942,7 @@ async function loadRules(file, server, logger) {
     }
     return [
       {
-        response: json
+        handler: json
       }
     ];
   }
@@ -941,7 +957,7 @@ async function loadRules(file, server, logger) {
   if (typeof value === "function") {
     return [
       {
-        response: value
+        handler: value
       }
     ];
   }
@@ -984,8 +1000,18 @@ async function scanRoutes(params) {
       if (!rule || typeof rule !== "object") {
         continue;
       }
-      if (typeof rule.response === "undefined") {
-        params.logger.warn(`Skip mock without response: ${fileInfo.file}`);
+      const ruleValue = rule;
+      const unsupportedKeys = ["response", "url", "method"].filter(
+        (key2) => key2 in ruleValue
+      );
+      if (unsupportedKeys.length > 0) {
+        params.logger.warn(
+          `Skip mock with unsupported fields (${unsupportedKeys.join(", ")}): ${fileInfo.file}`
+        );
+        continue;
+      }
+      if (typeof rule.handler === "undefined") {
+        params.logger.warn(`Skip mock without handler: ${fileInfo.file}`);
         continue;
       }
       const resolved = resolveRule({
@@ -1028,7 +1054,7 @@ function buildRouteSignature(routes) {
       route.method,
       route.template,
       route.file,
-      typeof route.response === "function" ? "handler" : "static",
+      typeof route.handler === "function" ? "handler" : "static",
       route.status ?? "",
       route.delay ?? ""
     ].join("|")
@@ -1052,6 +1078,7 @@ function resolvePlaygroundInput(list) {
 function createMokupPlugin(options = {}) {
   let root = node_process.cwd();
   let routes = [];
+  let app = null;
   let previewWatcher = null;
   let currentServer = null;
   let lastSignature = null;
@@ -1103,6 +1130,7 @@ function createMokupPlugin(options = {}) {
       collected.push(...scanned);
     }
     routes = sortRoutes(collected);
+    app = createHonoApp(routes);
     const signature = buildRouteSignature(routes);
     if (isViteDevServer(server) && server.ws) {
       if (lastSignature && signature !== lastSignature) {
@@ -1125,7 +1153,7 @@ function createMokupPlugin(options = {}) {
       currentServer = server;
       await refreshRoutes(server);
       server.middlewares.use(playgroundMiddleware);
-      server.middlewares.use(createMiddleware(() => routes, logger));
+      server.middlewares.use(createMiddleware(() => app, logger));
       if (!watchEnabled) {
         return;
       }
@@ -1152,7 +1180,7 @@ function createMokupPlugin(options = {}) {
       currentServer = server;
       await refreshRoutes(server);
       server.middlewares.use(playgroundMiddleware);
-      server.middlewares.use(createMiddleware(() => routes, logger));
+      server.middlewares.use(createMiddleware(() => app, logger));
       if (!watchEnabled) {
         return;
       }

package/dist/vite.d.cts

@@ -1,7 +1,7 @@
 import { Plugin } from 'vite';
 import { MokupViteOptionsInput } from './index.cjs';
-export { HttpMethod, MockContext, MockRequest, MockResponse, MockResponseHandler, MockRule, MokupViteOptions } from './index.cjs';
-import 'node:http';
+export { DirectoryConfig, HttpMethod, MockContext, MockMiddleware, MockResponse, MockResponseHandler, MockRule, MokupViteOptions } from './index.cjs';
+import 'hono';
 
 declare function createMokupPlugin(options?: MokupViteOptionsInput): Plugin;
 

package/dist/vite.d.mts

@@ -1,7 +1,7 @@
 import { Plugin } from 'vite';
 import { MokupViteOptionsInput } from './index.mjs';
-export { HttpMethod, MockContext, MockRequest, MockResponse, MockResponseHandler, MockRule, MokupViteOptions } from './index.mjs';
-import 'node:http';
+export { DirectoryConfig, HttpMethod, MockContext, MockMiddleware, MockResponse, MockResponseHandler, MockRule, MokupViteOptions } from './index.mjs';
+import 'hono';
 
 declare function createMokupPlugin(options?: MokupViteOptionsInput): Plugin;
 

package/dist/vite.d.ts

@@ -1,7 +1,7 @@
 import { Plugin } from 'vite';
 import { MokupViteOptionsInput } from './index.js';
-export { HttpMethod, MockContext, MockRequest, MockResponse, MockResponseHandler, MockRule, MokupViteOptions } from './index.js';
-import 'node:http';
+export { DirectoryConfig, HttpMethod, MockContext, MockMiddleware, MockResponse, MockResponseHandler, MockRule, MokupViteOptions } from './index.js';
+import 'hono';
 
 declare function createMokupPlugin(options?: MokupViteOptionsInput): Plugin;
 

package/dist/vite.mjs

@@ -1,10 +1,12 @@
 import { cwd } from 'node:process';
 import chokidar from 'chokidar';
 import { Buffer } from 'node:buffer';
-import { matchRouteTokens, compareRouteScore, parseRouteTemplate } from '@mokup/runtime';
+import { Hono } from 'hono';
+import { PatternRouter } from 'hono/router/pattern-router';
 import { resolve, isAbsolute, join, normalize, extname, dirname, relative, basename } from 'pathe';
 import { promises } from 'node:fs';
 import { createRequire } from 'node:module';
+import { compareRouteScore, parseRouteTemplate } from '@mokup/runtime';
 import { pathToFileURL } from 'node:url';
 import { build } from 'esbuild';
 import { parse } from 'jsonc-parser';
@@ -115,25 +117,113 @@ function delay(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 
-function extractQuery(parsedUrl) {
-  const query = {};
-  for (const [key, value] of parsedUrl.searchParams.entries()) {
-    const current = query[key];
-    if (typeof current === "undefined") {
-      query[key] = value;
-    } else if (Array.isArray(current)) {
-      current.push(value);
-    } else {
-      query[key] = [current, value];
+function toHonoPath(route) {
+  if (!route.tokens || route.tokens.length === 0) {
+    return "/";
+  }
+  const segments = route.tokens.map((token) => {
+    if (token.type === "static") {
+      return token.value;
+    }
+    if (token.type === "param") {
+      return `:${token.name}`;
+    }
+    if (token.type === "catchall") {
+      return `:${token.name}{.+}`;
+    }
+    return `:${token.name}{.+}?`;
+  });
+  return `/${segments.join("/")}`;
+}
+function applyRouteOverrides(response, route) {
+  const headers = new Headers(response.headers);
+  const hasHeaders = !!route.headers && Object.keys(route.headers).length > 0;
+  if (route.headers) {
+    for (const [key, value] of Object.entries(route.headers)) {
+      headers.set(key, value);
     }
   }
-  return query;
+  const status = route.status ?? response.status;
+  if (status === response.status && !hasHeaders) {
+    return response;
+  }
+  return new Response(response.body, { status, headers });
+}
+function normalizeHandlerValue(c, value) {
+  if (value instanceof Response) {
+    return value;
+  }
+  if (typeof value === "undefined") {
+    const response = c.body(null);
+    if (response.status === 200) {
+      return new Response(response.body, {
+        status: 204,
+        headers: response.headers
+      });
+    }
+    return response;
+  }
+  if (typeof value === "string") {
+    return c.text(value);
+  }
+  if (value instanceof Uint8Array || value instanceof ArrayBuffer) {
+    if (!c.res.headers.get("content-type")) {
+      c.header("content-type", "application/octet-stream");
+    }
+    const data = value instanceof ArrayBuffer ? new Uint8Array(value) : new Uint8Array(value);
+    return c.body(data);
+  }
+  return c.json(value);
+}
+function createRouteHandler(route) {
+  return async (c) => {
+    const value = typeof route.handler === "function" ? await route.handler(c) : route.handler;
+    return normalizeHandlerValue(c, value);
+  };
+}
+function createFinalizeMiddleware(route) {
+  return async (c, next) => {
+    const response = await next();
+    const resolved = response ?? c.res;
+    if (route.delay && route.delay > 0) {
+      await delay(route.delay);
+    }
+    return applyRouteOverrides(resolved, route);
+  };
+}
+function wrapMiddleware(handler) {
+  return async (c, next) => {
+    const response = await handler(c, next);
+    return response ?? c.res;
+  };
+}
+function createHonoApp(routes) {
+  const app = new Hono({ router: new PatternRouter(), strict: false });
+  for (const route of routes) {
+    const middlewares = route.middlewares?.map((entry) => wrapMiddleware(entry.handle)) ?? [];
+    app.on(
+      route.method,
+      toHonoPath(route),
+      createFinalizeMiddleware(route),
+      ...middlewares,
+      createRouteHandler(route)
+    );
+  }
+  return app;
 }
 async function readRawBody(req) {
-  return new Promise((resolve, reject) => {
+  return await new Promise((resolve, reject) => {
     const chunks = [];
     req.on("data", (chunk) => {
-      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+      if (typeof chunk === "string") {
+        chunks.push(Buffer.from(chunk));
+        return;
+      }
+      if (chunk instanceof Uint8Array) {
+        chunks.push(chunk);
+        return;
+      }
+      chunks.push(Buffer.from(String(chunk)));
     });
     req.on("end", () => {
       if (chunks.length === 0) {
@@ -145,148 +235,74 @@ async function readRawBody(req) {
     req.on("error", reject);
   });
 }
-async function readRequestBody(req, parsedUrl) {
-  const query = extractQuery(parsedUrl);
-  const rawBody = await readRawBody(req);
-  if (!rawBody) {
-    return { query, body: void 0, rawBody: void 0 };
-  }
-  const rawText = rawBody.toString("utf8");
-  const contentTypeHeader = req.headers["content-type"];
-  const contentTypeValue = Array.isArray(contentTypeHeader) ? contentTypeHeader[0] ?? "" : contentTypeHeader ?? "";
-  const contentType = contentTypeValue.split(";")[0]?.trim() ?? "";
-  if (contentType === "application/json" || contentType.endsWith("+json")) {
-    try {
-      return { query, body: JSON.parse(rawText), rawBody: rawText };
-    } catch {
-      return { query, body: rawText, rawBody: rawText };
+function buildHeaders(headers) {
+  const result = new Headers();
+  for (const [key, value] of Object.entries(headers)) {
+    if (typeof value === "undefined") {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      result.set(key, value.join(","));
+    } else {
+      result.set(key, value);
     }
   }
-  if (contentType === "application/x-www-form-urlencoded") {
-    const params = new URLSearchParams(rawText);
-    const body = Object.fromEntries(params.entries());
-    return { query, body, rawBody: rawText };
-  }
-  return { query, body: rawText, rawBody: rawText };
+  return result;
 }
-function applyHeaders(res, headers) {
-  if (!headers) {
-    return;
-  }
-  for (const [key, value] of Object.entries(headers)) {
-    res.setHeader(key, value);
+async function toRequest(req) {
+  const url = new URL(req.url ?? "/", "http://mokup.local");
+  const method = req.method ?? "GET";
+  const headers = buildHeaders(req.headers);
+  const init = { method, headers };
+  const rawBody = await readRawBody(req);
+  if (rawBody && method !== "GET" && method !== "HEAD") {
+    init.body = rawBody;
   }
+  return new Request(url.toString(), init);
 }
-function writeResponse(res, body) {
-  if (typeof body === "undefined") {
-    if (!res.headersSent && res.statusCode === 200) {
-      res.statusCode = 204;
-    }
+async function sendResponse(res, response) {
+  res.statusCode = response.status;
+  response.headers.forEach((value, key) => {
+    res.setHeader(key, value);
+  });
+  if (!response.body) {
     res.end();
     return;
   }
-  if (Buffer.isBuffer(body)) {
-    if (!res.getHeader("Content-Type")) {
-      res.setHeader("Content-Type", "application/octet-stream");
-    }
-    res.end(body);
-    return;
-  }
-  if (typeof body === "string") {
-    if (!res.getHeader("Content-Type")) {
-      res.setHeader("Content-Type", "text/plain; charset=utf-8");
-    }
-    res.end(body);
-    return;
-  }
-  if (!res.getHeader("Content-Type")) {
-    res.setHeader("Content-Type", "application/json; charset=utf-8");
-  }
-  res.end(JSON.stringify(body));
+  const buffer = new Uint8Array(await response.arrayBuffer());
+  res.end(buffer);
 }
-function findMatchingRoute(routes, method, pathname) {
-  for (const route of routes) {
-    if (route.method !== method) {
-      continue;
-    }
-    const matched = matchRouteTokens(route.tokens, pathname);
-    if (matched) {
-      return { route, params: matched.params };
-    }
-  }
-  return null;
+function hasMatch(app, method, pathname) {
+  const matchMethod = method === "HEAD" ? "GET" : method;
+  const match = app.router.match(matchMethod, pathname);
+  return !!match && match[0].length > 0;
 }
-function createMiddleware(getRoutes, logger) {
+function createMiddleware(getApp, logger) {
   return async (req, res, next) => {
+    const app = getApp();
+    if (!app) {
+      return next();
+    }
     const url = req.url ?? "/";
     const parsedUrl = new URL(url, "http://mokup.local");
     const pathname = parsedUrl.pathname;
     const method = normalizeMethod(req.method) ?? "GET";
-    const matched = findMatchingRoute(getRoutes(), method, pathname);
-    if (!matched) {
+    if (!hasMatch(app, method, pathname)) {
       return next();
     }
+    const startedAt = Date.now();
     try {
-      const { query, body, rawBody } = await readRequestBody(req, parsedUrl);
-      const mockReq = {
-        url: pathname,
-        method,
-        headers: req.headers,
-        query,
-        body,
-        params: matched.params
-      };
-      if (rawBody) {
-        mockReq.rawBody = rawBody;
-      }
-      const ctx = {
-        delay: (ms) => delay(ms),
-        json: (data) => data
-      };
-      const startedAt = Date.now();
-      const executeHandler = async () => {
-        return typeof matched.route.response === "function" ? await matched.route.response(mockReq, res, ctx) : matched.route.response;
-      };
-      const runMiddlewares = async (middlewares) => {
-        let lastIndex = -1;
-        const dispatch = async (index) => {
-          if (index <= lastIndex) {
-            throw new Error("Middleware next() called multiple times.");
-          }
-          lastIndex = index;
-          const entry = middlewares[index];
-          if (!entry) {
-            return executeHandler();
-          }
-          let nextResult;
-          const next2 = async () => {
-            nextResult = await dispatch(index + 1);
-            return nextResult;
-          };
-          const value = await entry.handle(mockReq, res, ctx, next2);
-          if (typeof value !== "undefined") {
-            return value;
-          }
-          return nextResult;
-        };
-        return dispatch(0);
-      };
-      const responseValue = matched.route.middlewares && matched.route.middlewares.length > 0 ? await runMiddlewares(matched.route.middlewares) : await executeHandler();
+      const response = await app.fetch(await toRequest(req));
       if (res.writableEnded) {
         return;
       }
-      if (matched.route.delay && matched.route.delay > 0) {
-        await delay(matched.route.delay);
-      }
-      applyHeaders(res, matched.route.headers);
-      if (matched.route.status) {
-        res.statusCode = matched.route.status;
-      }
-      writeResponse(res, responseValue);
+      await sendResponse(res, response);
       logger.info(`${method} ${pathname} ${Date.now() - startedAt}ms`);
     } catch (error) {
-      res.statusCode = 500;
-      res.setHeader("Content-Type", "text/plain; charset=utf-8");
+      if (!res.headersSent) {
+        res.statusCode = 500;
+        res.setHeader("Content-Type", "text/plain; charset=utf-8");
+      }
       res.end("Mock handler error");
       logger.error("Mock handler failed:", error);
     }
@@ -468,7 +484,7 @@ function toPlaygroundRoute(route, root, groups) {
     method: route.method,
     url: route.template,
     file: formatRouteFile(route.file, root),
-    type: typeof route.response === "function" ? "handler" : "static",
+    type: typeof route.handler === "function" ? "handler" : "static",
     status: route.status,
     delay: route.delay,
     middlewareCount: middlewareSources?.length ?? 0,
@@ -641,7 +657,7 @@ function resolveRule(params) {
     method,
     tokens: parsed.tokens,
     score: parsed.score,
-    response: params.rule.response
+    handler: params.rule.handler
   };
   if (typeof params.rule.status === "number") {
     route.status = params.rule.status;
@@ -919,7 +935,7 @@ async function loadRules(file, server, logger) {
     }
     return [
       {
-        response: json
+        handler: json
       }
     ];
   }
@@ -934,7 +950,7 @@ async function loadRules(file, server, logger) {
   if (typeof value === "function") {
     return [
       {
-        response: value
+        handler: value
       }
     ];
   }
@@ -977,8 +993,18 @@ async function scanRoutes(params) {
       if (!rule || typeof rule !== "object") {
         continue;
       }
-      if (typeof rule.response === "undefined") {
-        params.logger.warn(`Skip mock without response: ${fileInfo.file}`);
+      const ruleValue = rule;
+      const unsupportedKeys = ["response", "url", "method"].filter(
+        (key2) => key2 in ruleValue
+      );
+      if (unsupportedKeys.length > 0) {
+        params.logger.warn(
+          `Skip mock with unsupported fields (${unsupportedKeys.join(", ")}): ${fileInfo.file}`
+        );
+        continue;
+      }
+      if (typeof rule.handler === "undefined") {
+        params.logger.warn(`Skip mock without handler: ${fileInfo.file}`);
         continue;
       }
       const resolved = resolveRule({
@@ -1021,7 +1047,7 @@ function buildRouteSignature(routes) {
       route.method,
       route.template,
       route.file,
-      typeof route.response === "function" ? "handler" : "static",
+      typeof route.handler === "function" ? "handler" : "static",
       route.status ?? "",
       route.delay ?? ""
     ].join("|")
@@ -1045,6 +1071,7 @@ function resolvePlaygroundInput(list) {
 function createMokupPlugin(options = {}) {
   let root = cwd();
   let routes = [];
+  let app = null;
   let previewWatcher = null;
   let currentServer = null;
   let lastSignature = null;
@@ -1096,6 +1123,7 @@ function createMokupPlugin(options = {}) {
       collected.push(...scanned);
     }
     routes = sortRoutes(collected);
+    app = createHonoApp(routes);
     const signature = buildRouteSignature(routes);
     if (isViteDevServer(server) && server.ws) {
       if (lastSignature && signature !== lastSignature) {
@@ -1118,7 +1146,7 @@ function createMokupPlugin(options = {}) {
       currentServer = server;
       await refreshRoutes(server);
       server.middlewares.use(playgroundMiddleware);
-      server.middlewares.use(createMiddleware(() => routes, logger));
+      server.middlewares.use(createMiddleware(() => app, logger));
       if (!watchEnabled) {
         return;
       }
@@ -1145,7 +1173,7 @@ function createMokupPlugin(options = {}) {
       currentServer = server;
       await refreshRoutes(server);
       server.middlewares.use(playgroundMiddleware);
-      server.middlewares.use(createMiddleware(() => routes, logger));
+      server.middlewares.use(createMiddleware(() => app, logger));
       if (!watchEnabled) {
         return;
       }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mokup",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Mock utilities and Vite plugin for mokup.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -37,10 +37,11 @@
   "dependencies": {
     "chokidar": "^5.0.0",
     "esbuild": "^0.27.2",
+    "hono": "^4.11.4",
     "jsonc-parser": "^3.3.1",
     "pathe": "^2.0.3",
     "@mokup/playground": "0.0.1",
-    "@mokup/runtime": "0.0.1"
+    "@mokup/runtime": "0.1.0"
   },
   "devDependencies": {
     "@types/node": "^25.0.9",