@mokup/runtime 0.0.0 → 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# @mokup/runtime
+
+English | [Chinese](./README.zh-CN.md)
+
+## Overview
+
+The Mokup runtime evaluates manifests and resolves mock responses at request time. It is shared by server adapters and Workers. For detailed usage, see https://mokup.icebreaker.top.

package/README.zh-CN.md

@@ -0,0 +1,7 @@
+# @mokup/runtime
+
+[English](./README.md) | 中文
+
+## 概览
+
+Mokup runtime 用于在请求时读取 manifest 并返回 mock 响应，是 Server 适配器与 Worker 的共享核心。完整文档见 https://mokup.icebreaker.top。

package/dist/index.cjs

@@ -1,5 +1,8 @@
 'use strict';
 
+const hono = require('hono');
+const patternRouter = require('hono/router/pattern-router');
+
 const paramNamePattern = /^[\w-]+$/;
 const paramPattern = /^\[([^\]/]+)\]$/;
 const catchallPattern = /^\[\.\.\.([^\]/]+)\]$/;
@@ -227,14 +230,14 @@ function normalizeRules(value) {
     }
   ];
 }
-async function executeRule(rule, req, responder, ctx) {
+async function executeRule(rule, context) {
   if (!rule) {
     return void 0;
   }
   const value = rule.response;
   if (typeof value === "function") {
     const handler = value;
-    return handler(req, responder, ctx);
+    return handler(context);
   }
   return value;
 }
@@ -340,108 +343,153 @@ function normalizeMethod(method) {
   }
   return void 0;
 }
-function mergeHeaders(base, override) {
-  if (!override) {
-    return base;
-  }
-  return {
-    ...base,
-    ...override
-  };
-}
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-class ResponseController {
-  statusCode = 200;
-  headers = /* @__PURE__ */ new Map();
-  setHeader(key, value) {
-    this.headers.set(key.toLowerCase(), value);
-  }
-  getHeader(key) {
-    return this.headers.get(key.toLowerCase());
-  }
-  removeHeader(key) {
-    this.headers.delete(key.toLowerCase());
-  }
-  toRecord() {
-    const record = {};
-    for (const [key, value] of this.headers.entries()) {
-      record[key] = value;
+function decodeBase64(value) {
+  if (typeof atob === "function") {
+    const binary = atob(value);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
+      bytes[i] = binary.charCodeAt(i);
     }
-    return record;
+    return bytes;
   }
+  throw new Error("Base64 decoding is not supported in this runtime.");
 }
-function normalizeBody(body, contentType) {
-  if (typeof body === "undefined") {
-    return { body: null };
-  }
-  if (typeof body === "string") {
-    return {
-      body,
-      contentType: contentType ?? "text/plain; charset=utf-8"
-    };
+
+function toHonoPath(tokens) {
+  if (!tokens || tokens.length === 0) {
+    return "/";
   }
-  if (body instanceof Uint8Array) {
+  const segments = 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 compileRoutes(manifest) {
+  const compiled = [];
+  for (const route of manifest.routes) {
+    const method = normalizeMethod(route.method) ?? "GET";
+    const parsed = route.tokens ? {
+      tokens: route.tokens,
+      score: route.score ?? scoreRouteTokens(route.tokens),
+      errors: []
+    } : parseRouteTemplate(route.url);
+    if (parsed.errors.length > 0) {
+      continue;
+    }
+    compiled.push({
+      route,
+      method,
+      tokens: route.tokens ?? parsed.tokens,
+      score: route.score ?? parsed.score
+    });
+  }
+  return compiled.sort((a, b) => {
+    if (a.method !== b.method) {
+      return a.method.localeCompare(b.method);
+    }
+    return compareRouteScore(a.score, b.score);
+  });
+}
+function shouldTreatAsText(contentType) {
+  const normalized = contentType.toLowerCase();
+  return normalized.startsWith("text/") || normalized.includes("json") || normalized.includes("xml") || normalized.includes("javascript");
+}
+async function toRuntimeResult(response) {
+  const headers = {};
+  response.headers.forEach((value, key) => {
+    headers[key.toLowerCase()] = value;
+  });
+  if (!response.body || [204, 205, 304].includes(response.status)) {
     return {
-      body,
-      contentType: contentType ?? "application/octet-stream"
+      status: response.status,
+      headers,
+      body: null
     };
   }
-  if (body instanceof ArrayBuffer) {
+  const contentType = headers["content-type"] ?? "";
+  if (shouldTreatAsText(contentType)) {
     return {
-      body: new Uint8Array(body),
-      contentType: contentType ?? "application/octet-stream"
+      status: response.status,
+      headers,
+      body: await response.text()
     };
   }
+  const buffer = new Uint8Array(await response.arrayBuffer());
   return {
-    body: JSON.stringify(body),
-    contentType: contentType ?? "application/json; charset=utf-8"
+    status: response.status,
+    headers,
+    body: buffer
   };
 }
-function decodeBase64(value) {
-  if (typeof atob === "function") {
-    const binary = atob(value);
-    const bytes = new Uint8Array(binary.length);
-    for (let i = 0; i < binary.length; i += 1) {
-      bytes[i] = binary.charCodeAt(i);
+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 bytes;
   }
-  throw new Error("Base64 decoding is not supported in this runtime.");
+  const status = route.status ?? response.status;
+  if (status === response.status && !hasHeaders) {
+    return response;
+  }
+  return new Response(response.body, { status, headers });
 }
-function finalizeStatus(status, body) {
-  if (status === 200 && body === null) {
-    return 204;
+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);
   }
-  return status;
+  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 ? value : new Uint8Array(value);
+    return c.body(data);
+  }
+  return c.json(value);
 }
-
-async function executeRoute(route, req, moduleCache, middlewareCache, moduleBase, moduleMap) {
-  const responder = new ResponseController();
-  const ctx = {
-    delay,
-    json: (data) => data
-  };
-  const runHandler = async () => {
+function createRouteHandler(params) {
+  const { route, moduleCache, moduleBase, moduleMap } = params;
+  return async (c) => {
     if (route.response.type === "json") {
-      return {
-        value: route.response.body,
-        contentType: "application/json; charset=utf-8"
-      };
+      if (typeof route.response.body === "undefined") {
+        return normalizeHandlerValue(c, void 0);
+      }
+      return c.json(route.response.body);
     }
     if (route.response.type === "text") {
-      return {
-        value: route.response.body,
-        contentType: "text/plain; charset=utf-8"
-      };
+      return c.text(route.response.body);
     }
     if (route.response.type === "binary") {
-      return {
-        value: decodeBase64(route.response.body),
-        contentType: "application/octet-stream"
-      };
+      const data = new Uint8Array(decodeBase64(route.response.body));
+      c.header("content-type", "application/octet-stream");
+      return c.body(data);
     }
     const rule = await loadModuleRule(
       route.response,
@@ -449,75 +497,106 @@ async function executeRoute(route, req, moduleCache, middlewareCache, moduleBase
       moduleBase,
       moduleMap
     );
-    const value = await executeRule(rule, req, responder, ctx);
-    return { value };
+    const value = await executeRule(rule, c);
+    return normalizeHandlerValue(c, value);
   };
-  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 handler = middlewares[index];
-      if (!handler) {
-        return runHandler();
-      }
-      let nextResult;
-      const next = async () => {
-        nextResult = await dispatch(index + 1);
-        return nextResult.value;
-      };
-      const value = await handler(req, responder, ctx, next);
-      if (typeof value !== "undefined") {
-        return { value };
-      }
-      if (nextResult) {
-        return nextResult;
-      }
-      return { value: void 0 };
-    };
-    return dispatch(0);
+}
+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);
   };
-  const middlewareHandlers = [];
-  for (const entry of route.middleware ?? []) {
-    const handler = await loadModuleMiddleware(
-      entry,
-      middlewareCache,
-      moduleBase,
-      moduleMap
+}
+async function buildApp(params) {
+  const { manifest, moduleCache, middlewareCache, moduleBase, moduleMap } = params;
+  const app = new hono.Hono({ router: new patternRouter.PatternRouter(), strict: false });
+  const compiled = compileRoutes(manifest);
+  for (const entry of compiled) {
+    const middlewares = [];
+    for (const middleware of entry.route.middleware ?? []) {
+      const handler2 = await loadModuleMiddleware(
+        middleware,
+        middlewareCache,
+        moduleBase,
+        moduleMap
+      );
+      if (handler2) {
+        middlewares.push(handler2);
+      }
+    }
+    const handler = createRouteHandler({
+      route: entry.route,
+      moduleCache,
+      ...typeof moduleBase !== "undefined" ? { moduleBase } : {},
+      ...typeof moduleMap !== "undefined" ? { moduleMap } : {}
+    });
+    app.on(
+      entry.method,
+      toHonoPath(entry.tokens),
+      createFinalizeMiddleware(entry.route),
+      ...middlewares,
+      handler
     );
-    if (handler) {
-      middlewareHandlers.push(handler);
+  }
+  return app;
+}
+function appendQueryParams(url, query) {
+  for (const [key, value] of Object.entries(query)) {
+    if (Array.isArray(value)) {
+      for (const entry of value) {
+        url.searchParams.append(key, entry);
+      }
+    } else {
+      url.searchParams.append(key, value);
     }
   }
-  const result = middlewareHandlers.length > 0 ? await runMiddlewares(middlewareHandlers) : await runHandler();
-  const responseValue = result.value;
-  const contentType = result.contentType;
-  if (route.delay && route.delay > 0) {
-    await delay(route.delay);
+}
+function resolveRequestBody(req, contentType) {
+  if (typeof req.rawBody !== "undefined") {
+    return req.rawBody;
   }
-  const headers = mergeHeaders(responder.toRecord(), route.headers);
-  if (contentType && !headers["content-type"]) {
-    headers["content-type"] = contentType;
+  const body = req.body;
+  if (typeof body === "undefined") {
+    return void 0;
   }
-  const normalized = normalizeBody(responseValue, headers["content-type"]);
-  const status = finalizeStatus(
-    route.status ?? responder.statusCode,
-    normalized.body
-  );
-  if (normalized.contentType && !headers["content-type"]) {
-    headers["content-type"] = normalized.contentType;
+  if (typeof body === "string") {
+    return body;
   }
-  return {
-    status,
-    headers,
-    body: normalized.body
-  };
+  if (body instanceof Uint8Array || body instanceof ArrayBuffer) {
+    return body;
+  }
+  if (typeof body === "object") {
+    const normalized = contentType.toLowerCase();
+    if (normalized.includes("json")) {
+      return JSON.stringify(body);
+    }
+    return JSON.stringify(body);
+  }
+  return String(body);
+}
+function toFetchRequest(req) {
+  const url = new URL(req.path, "http://mokup.local");
+  appendQueryParams(url, req.query);
+  const headers = new Headers();
+  for (const [key, value] of Object.entries(req.headers)) {
+    headers.set(key, value);
+  }
+  const method = normalizeMethod(req.method) ?? "GET";
+  const contentType = headers.get("content-type") ?? "";
+  const body = resolveRequestBody(req, contentType);
+  const init = { method, headers };
+  if (typeof body !== "undefined" && method !== "GET" && method !== "HEAD") {
+    init.body = body;
+  }
+  return new Request(url.toString(), init);
 }
 function createRuntime(options) {
   let manifestCache = null;
-  let compiledRoutes = null;
+  let appPromise = null;
   const moduleCache = /* @__PURE__ */ new Map();
   const middlewareCache = /* @__PURE__ */ new Map();
   const getManifest = async () => {
@@ -526,56 +605,31 @@ function createRuntime(options) {
     }
     return manifestCache;
   };
-  const getRouteList = async () => {
-    if (compiledRoutes) {
-      return compiledRoutes;
-    }
-    const manifest = await getManifest();
-    const map = /* @__PURE__ */ new Map();
-    for (const route of manifest.routes) {
-      const method = normalizeMethod(route.method) ?? "GET";
-      const parsed = route.tokens ? { tokens: route.tokens, score: route.score ?? scoreRouteTokens(route.tokens), errors: [] } : parseRouteTemplate(route.url);
-      if (parsed.errors.length > 0) {
-        continue;
-      }
-      const tokens = route.tokens ?? parsed.tokens;
-      const score = route.score ?? parsed.score;
-      const list = map.get(method) ?? [];
-      list.push({ route, tokens, score });
-      map.set(method, list);
-    }
-    for (const list of map.values()) {
-      list.sort((a, b) => compareRouteScore(a.score, b.score));
+  const getApp = async () => {
+    if (!appPromise) {
+      appPromise = (async () => {
+        const manifest = await getManifest();
+        return buildApp({
+          manifest,
+          moduleCache,
+          middlewareCache,
+          ...typeof options.moduleBase !== "undefined" ? { moduleBase: options.moduleBase } : {},
+          ...typeof options.moduleMap !== "undefined" ? { moduleMap: options.moduleMap } : {}
+        });
+      })();
     }
-    compiledRoutes = map;
-    return compiledRoutes;
+    return appPromise;
   };
   const handle = async (req) => {
+    const app = await getApp();
     const method = normalizeMethod(req.method) ?? "GET";
-    const map = await getRouteList();
-    const list = map.get(method);
-    if (!list || list.length === 0) {
+    const matchMethod = method === "HEAD" ? "GET" : method;
+    const match = app.router.match(matchMethod, req.path);
+    if (!match || match[0].length === 0) {
       return null;
     }
-    for (const entry of list) {
-      const matched = matchRouteTokens(entry.tokens, req.path);
-      if (!matched) {
-        continue;
-      }
-      const requestWithParams = {
-        ...req,
-        params: matched.params
-      };
-      return executeRoute(
-        entry.route,
-        requestWithParams,
-        moduleCache,
-        middlewareCache,
-        options.moduleBase,
-        options.moduleMap
-      );
-    }
-    return null;
+    const response = await app.fetch(toFetchRequest(req));
+    return await toRuntimeResult(response);
   };
   return {
     handle

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+import { Context, MiddlewareHandler } from 'hono';
+
 type RouteToken = {
     type: 'static';
     value: string;
@@ -75,18 +77,9 @@ interface RuntimeResult {
     headers: Record<string, string>;
     body: string | Uint8Array | null;
 }
-interface MockContext {
-    delay: (ms: number) => Promise<void>;
-    json: <T>(data: T) => T;
-}
-interface MockResponder {
-    statusCode: number;
-    setHeader: (key: string, value: string) => void;
-    getHeader: (key: string) => string | undefined;
-    removeHeader: (key: string) => void;
-}
-type MockMiddleware = (req: RuntimeRequest, res: MockResponder, ctx: MockContext, next: () => Promise<unknown>) => unknown | Promise<unknown>;
-type MockResponseHandler = (req: RuntimeRequest, res: MockResponder, ctx: MockContext) => unknown | Promise<unknown>;
+type MockContext = Context;
+type MockMiddleware = MiddlewareHandler;
+type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
 interface RuntimeOptions {
     manifest: Manifest | (() => Promise<Manifest>);
     moduleBase?: string | URL;
@@ -99,4 +92,4 @@ declare function createRuntime(options: RuntimeOptions): {
 };
 
 export { compareRouteScore, createRuntime, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
-export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponder, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };
+export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { Context, MiddlewareHandler } from 'hono';
+
 type RouteToken = {
     type: 'static';
     value: string;
@@ -75,18 +77,9 @@ interface RuntimeResult {
     headers: Record<string, string>;
     body: string | Uint8Array | null;
 }
-interface MockContext {
-    delay: (ms: number) => Promise<void>;
-    json: <T>(data: T) => T;
-}
-interface MockResponder {
-    statusCode: number;
-    setHeader: (key: string, value: string) => void;
-    getHeader: (key: string) => string | undefined;
-    removeHeader: (key: string) => void;
-}
-type MockMiddleware = (req: RuntimeRequest, res: MockResponder, ctx: MockContext, next: () => Promise<unknown>) => unknown | Promise<unknown>;
-type MockResponseHandler = (req: RuntimeRequest, res: MockResponder, ctx: MockContext) => unknown | Promise<unknown>;
+type MockContext = Context;
+type MockMiddleware = MiddlewareHandler;
+type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
 interface RuntimeOptions {
     manifest: Manifest | (() => Promise<Manifest>);
     moduleBase?: string | URL;
@@ -99,4 +92,4 @@ declare function createRuntime(options: RuntimeOptions): {
 };
 
 export { compareRouteScore, createRuntime, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
-export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponder, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };
+export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { Context, MiddlewareHandler } from 'hono';
+
 type RouteToken = {
     type: 'static';
     value: string;
@@ -75,18 +77,9 @@ interface RuntimeResult {
     headers: Record<string, string>;
     body: string | Uint8Array | null;
 }
-interface MockContext {
-    delay: (ms: number) => Promise<void>;
-    json: <T>(data: T) => T;
-}
-interface MockResponder {
-    statusCode: number;
-    setHeader: (key: string, value: string) => void;
-    getHeader: (key: string) => string | undefined;
-    removeHeader: (key: string) => void;
-}
-type MockMiddleware = (req: RuntimeRequest, res: MockResponder, ctx: MockContext, next: () => Promise<unknown>) => unknown | Promise<unknown>;
-type MockResponseHandler = (req: RuntimeRequest, res: MockResponder, ctx: MockContext) => unknown | Promise<unknown>;
+type MockContext = Context;
+type MockMiddleware = MiddlewareHandler;
+type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
 interface RuntimeOptions {
     manifest: Manifest | (() => Promise<Manifest>);
     moduleBase?: string | URL;
@@ -99,4 +92,4 @@ declare function createRuntime(options: RuntimeOptions): {
 };
 
 export { compareRouteScore, createRuntime, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
-export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponder, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };
+export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };

package/dist/index.mjs

@@ -1,3 +1,6 @@
+import { Hono } from 'hono';
+import { PatternRouter } from 'hono/router/pattern-router';
+
 const paramNamePattern = /^[\w-]+$/;
 const paramPattern = /^\[([^\]/]+)\]$/;
 const catchallPattern = /^\[\.\.\.([^\]/]+)\]$/;
@@ -225,14 +228,14 @@ function normalizeRules(value) {
     }
   ];
 }
-async function executeRule(rule, req, responder, ctx) {
+async function executeRule(rule, context) {
   if (!rule) {
     return void 0;
   }
   const value = rule.response;
   if (typeof value === "function") {
     const handler = value;
-    return handler(req, responder, ctx);
+    return handler(context);
   }
   return value;
 }
@@ -338,108 +341,153 @@ function normalizeMethod(method) {
   }
   return void 0;
 }
-function mergeHeaders(base, override) {
-  if (!override) {
-    return base;
-  }
-  return {
-    ...base,
-    ...override
-  };
-}
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-class ResponseController {
-  statusCode = 200;
-  headers = /* @__PURE__ */ new Map();
-  setHeader(key, value) {
-    this.headers.set(key.toLowerCase(), value);
-  }
-  getHeader(key) {
-    return this.headers.get(key.toLowerCase());
-  }
-  removeHeader(key) {
-    this.headers.delete(key.toLowerCase());
-  }
-  toRecord() {
-    const record = {};
-    for (const [key, value] of this.headers.entries()) {
-      record[key] = value;
+function decodeBase64(value) {
+  if (typeof atob === "function") {
+    const binary = atob(value);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
+      bytes[i] = binary.charCodeAt(i);
     }
-    return record;
+    return bytes;
   }
+  throw new Error("Base64 decoding is not supported in this runtime.");
 }
-function normalizeBody(body, contentType) {
-  if (typeof body === "undefined") {
-    return { body: null };
-  }
-  if (typeof body === "string") {
-    return {
-      body,
-      contentType: contentType ?? "text/plain; charset=utf-8"
-    };
+
+function toHonoPath(tokens) {
+  if (!tokens || tokens.length === 0) {
+    return "/";
   }
-  if (body instanceof Uint8Array) {
+  const segments = 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 compileRoutes(manifest) {
+  const compiled = [];
+  for (const route of manifest.routes) {
+    const method = normalizeMethod(route.method) ?? "GET";
+    const parsed = route.tokens ? {
+      tokens: route.tokens,
+      score: route.score ?? scoreRouteTokens(route.tokens),
+      errors: []
+    } : parseRouteTemplate(route.url);
+    if (parsed.errors.length > 0) {
+      continue;
+    }
+    compiled.push({
+      route,
+      method,
+      tokens: route.tokens ?? parsed.tokens,
+      score: route.score ?? parsed.score
+    });
+  }
+  return compiled.sort((a, b) => {
+    if (a.method !== b.method) {
+      return a.method.localeCompare(b.method);
+    }
+    return compareRouteScore(a.score, b.score);
+  });
+}
+function shouldTreatAsText(contentType) {
+  const normalized = contentType.toLowerCase();
+  return normalized.startsWith("text/") || normalized.includes("json") || normalized.includes("xml") || normalized.includes("javascript");
+}
+async function toRuntimeResult(response) {
+  const headers = {};
+  response.headers.forEach((value, key) => {
+    headers[key.toLowerCase()] = value;
+  });
+  if (!response.body || [204, 205, 304].includes(response.status)) {
     return {
-      body,
-      contentType: contentType ?? "application/octet-stream"
+      status: response.status,
+      headers,
+      body: null
     };
   }
-  if (body instanceof ArrayBuffer) {
+  const contentType = headers["content-type"] ?? "";
+  if (shouldTreatAsText(contentType)) {
     return {
-      body: new Uint8Array(body),
-      contentType: contentType ?? "application/octet-stream"
+      status: response.status,
+      headers,
+      body: await response.text()
     };
   }
+  const buffer = new Uint8Array(await response.arrayBuffer());
   return {
-    body: JSON.stringify(body),
-    contentType: contentType ?? "application/json; charset=utf-8"
+    status: response.status,
+    headers,
+    body: buffer
   };
 }
-function decodeBase64(value) {
-  if (typeof atob === "function") {
-    const binary = atob(value);
-    const bytes = new Uint8Array(binary.length);
-    for (let i = 0; i < binary.length; i += 1) {
-      bytes[i] = binary.charCodeAt(i);
+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 bytes;
   }
-  throw new Error("Base64 decoding is not supported in this runtime.");
+  const status = route.status ?? response.status;
+  if (status === response.status && !hasHeaders) {
+    return response;
+  }
+  return new Response(response.body, { status, headers });
 }
-function finalizeStatus(status, body) {
-  if (status === 200 && body === null) {
-    return 204;
+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);
   }
-  return status;
+  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 ? value : new Uint8Array(value);
+    return c.body(data);
+  }
+  return c.json(value);
 }
-
-async function executeRoute(route, req, moduleCache, middlewareCache, moduleBase, moduleMap) {
-  const responder = new ResponseController();
-  const ctx = {
-    delay,
-    json: (data) => data
-  };
-  const runHandler = async () => {
+function createRouteHandler(params) {
+  const { route, moduleCache, moduleBase, moduleMap } = params;
+  return async (c) => {
     if (route.response.type === "json") {
-      return {
-        value: route.response.body,
-        contentType: "application/json; charset=utf-8"
-      };
+      if (typeof route.response.body === "undefined") {
+        return normalizeHandlerValue(c, void 0);
+      }
+      return c.json(route.response.body);
     }
     if (route.response.type === "text") {
-      return {
-        value: route.response.body,
-        contentType: "text/plain; charset=utf-8"
-      };
+      return c.text(route.response.body);
     }
     if (route.response.type === "binary") {
-      return {
-        value: decodeBase64(route.response.body),
-        contentType: "application/octet-stream"
-      };
+      const data = new Uint8Array(decodeBase64(route.response.body));
+      c.header("content-type", "application/octet-stream");
+      return c.body(data);
     }
     const rule = await loadModuleRule(
       route.response,
@@ -447,75 +495,106 @@ async function executeRoute(route, req, moduleCache, middlewareCache, moduleBase
       moduleBase,
       moduleMap
     );
-    const value = await executeRule(rule, req, responder, ctx);
-    return { value };
+    const value = await executeRule(rule, c);
+    return normalizeHandlerValue(c, value);
   };
-  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 handler = middlewares[index];
-      if (!handler) {
-        return runHandler();
-      }
-      let nextResult;
-      const next = async () => {
-        nextResult = await dispatch(index + 1);
-        return nextResult.value;
-      };
-      const value = await handler(req, responder, ctx, next);
-      if (typeof value !== "undefined") {
-        return { value };
-      }
-      if (nextResult) {
-        return nextResult;
-      }
-      return { value: void 0 };
-    };
-    return dispatch(0);
+}
+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);
   };
-  const middlewareHandlers = [];
-  for (const entry of route.middleware ?? []) {
-    const handler = await loadModuleMiddleware(
-      entry,
-      middlewareCache,
-      moduleBase,
-      moduleMap
+}
+async function buildApp(params) {
+  const { manifest, moduleCache, middlewareCache, moduleBase, moduleMap } = params;
+  const app = new Hono({ router: new PatternRouter(), strict: false });
+  const compiled = compileRoutes(manifest);
+  for (const entry of compiled) {
+    const middlewares = [];
+    for (const middleware of entry.route.middleware ?? []) {
+      const handler2 = await loadModuleMiddleware(
+        middleware,
+        middlewareCache,
+        moduleBase,
+        moduleMap
+      );
+      if (handler2) {
+        middlewares.push(handler2);
+      }
+    }
+    const handler = createRouteHandler({
+      route: entry.route,
+      moduleCache,
+      ...typeof moduleBase !== "undefined" ? { moduleBase } : {},
+      ...typeof moduleMap !== "undefined" ? { moduleMap } : {}
+    });
+    app.on(
+      entry.method,
+      toHonoPath(entry.tokens),
+      createFinalizeMiddleware(entry.route),
+      ...middlewares,
+      handler
     );
-    if (handler) {
-      middlewareHandlers.push(handler);
+  }
+  return app;
+}
+function appendQueryParams(url, query) {
+  for (const [key, value] of Object.entries(query)) {
+    if (Array.isArray(value)) {
+      for (const entry of value) {
+        url.searchParams.append(key, entry);
+      }
+    } else {
+      url.searchParams.append(key, value);
     }
   }
-  const result = middlewareHandlers.length > 0 ? await runMiddlewares(middlewareHandlers) : await runHandler();
-  const responseValue = result.value;
-  const contentType = result.contentType;
-  if (route.delay && route.delay > 0) {
-    await delay(route.delay);
+}
+function resolveRequestBody(req, contentType) {
+  if (typeof req.rawBody !== "undefined") {
+    return req.rawBody;
   }
-  const headers = mergeHeaders(responder.toRecord(), route.headers);
-  if (contentType && !headers["content-type"]) {
-    headers["content-type"] = contentType;
+  const body = req.body;
+  if (typeof body === "undefined") {
+    return void 0;
   }
-  const normalized = normalizeBody(responseValue, headers["content-type"]);
-  const status = finalizeStatus(
-    route.status ?? responder.statusCode,
-    normalized.body
-  );
-  if (normalized.contentType && !headers["content-type"]) {
-    headers["content-type"] = normalized.contentType;
+  if (typeof body === "string") {
+    return body;
   }
-  return {
-    status,
-    headers,
-    body: normalized.body
-  };
+  if (body instanceof Uint8Array || body instanceof ArrayBuffer) {
+    return body;
+  }
+  if (typeof body === "object") {
+    const normalized = contentType.toLowerCase();
+    if (normalized.includes("json")) {
+      return JSON.stringify(body);
+    }
+    return JSON.stringify(body);
+  }
+  return String(body);
+}
+function toFetchRequest(req) {
+  const url = new URL(req.path, "http://mokup.local");
+  appendQueryParams(url, req.query);
+  const headers = new Headers();
+  for (const [key, value] of Object.entries(req.headers)) {
+    headers.set(key, value);
+  }
+  const method = normalizeMethod(req.method) ?? "GET";
+  const contentType = headers.get("content-type") ?? "";
+  const body = resolveRequestBody(req, contentType);
+  const init = { method, headers };
+  if (typeof body !== "undefined" && method !== "GET" && method !== "HEAD") {
+    init.body = body;
+  }
+  return new Request(url.toString(), init);
 }
 function createRuntime(options) {
   let manifestCache = null;
-  let compiledRoutes = null;
+  let appPromise = null;
   const moduleCache = /* @__PURE__ */ new Map();
   const middlewareCache = /* @__PURE__ */ new Map();
   const getManifest = async () => {
@@ -524,56 +603,31 @@ function createRuntime(options) {
     }
     return manifestCache;
   };
-  const getRouteList = async () => {
-    if (compiledRoutes) {
-      return compiledRoutes;
-    }
-    const manifest = await getManifest();
-    const map = /* @__PURE__ */ new Map();
-    for (const route of manifest.routes) {
-      const method = normalizeMethod(route.method) ?? "GET";
-      const parsed = route.tokens ? { tokens: route.tokens, score: route.score ?? scoreRouteTokens(route.tokens), errors: [] } : parseRouteTemplate(route.url);
-      if (parsed.errors.length > 0) {
-        continue;
-      }
-      const tokens = route.tokens ?? parsed.tokens;
-      const score = route.score ?? parsed.score;
-      const list = map.get(method) ?? [];
-      list.push({ route, tokens, score });
-      map.set(method, list);
-    }
-    for (const list of map.values()) {
-      list.sort((a, b) => compareRouteScore(a.score, b.score));
+  const getApp = async () => {
+    if (!appPromise) {
+      appPromise = (async () => {
+        const manifest = await getManifest();
+        return buildApp({
+          manifest,
+          moduleCache,
+          middlewareCache,
+          ...typeof options.moduleBase !== "undefined" ? { moduleBase: options.moduleBase } : {},
+          ...typeof options.moduleMap !== "undefined" ? { moduleMap: options.moduleMap } : {}
+        });
+      })();
     }
-    compiledRoutes = map;
-    return compiledRoutes;
+    return appPromise;
   };
   const handle = async (req) => {
+    const app = await getApp();
     const method = normalizeMethod(req.method) ?? "GET";
-    const map = await getRouteList();
-    const list = map.get(method);
-    if (!list || list.length === 0) {
+    const matchMethod = method === "HEAD" ? "GET" : method;
+    const match = app.router.match(matchMethod, req.path);
+    if (!match || match[0].length === 0) {
       return null;
     }
-    for (const entry of list) {
-      const matched = matchRouteTokens(entry.tokens, req.path);
-      if (!matched) {
-        continue;
-      }
-      const requestWithParams = {
-        ...req,
-        params: matched.params
-      };
-      return executeRoute(
-        entry.route,
-        requestWithParams,
-        moduleCache,
-        middlewareCache,
-        options.moduleBase,
-        options.moduleMap
-      );
-    }
-    return null;
+    const response = await app.fetch(toFetchRequest(req));
+    return await toRuntimeResult(response);
   };
   return {
     handle

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@mokup/runtime",
   "type": "module",
-  "version": "0.0.0",
+  "version": "0.1.0",
   "description": "Cross-runtime mock matching and response handling for mokup.",
   "license": "MIT",
+  "homepage": "https://mokup.icebreaker.top",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sonofmagic/mokup.git",
@@ -25,7 +26,9 @@
   "files": [
     "dist"
   ],
-  "dependencies": {},
+  "dependencies": {
+    "hono": "^4.11.4"
+  },
   "devDependencies": {
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1"