@mokup/server 0.0.1 → 1.0.0

package/dist/index.cjs

@@ -2,7 +2,17 @@
 
 const runtime = require('@mokup/runtime');
 const fetch = require('./shared/server.BdTl0qJd.cjs');
+const node_process = require('node:process');
+const hono = require('@mokup/shared/hono');
+const pathe = require('@mokup/shared/pathe');
+const node_fs = require('node:fs');
+const node_module = require('node:module');
+const node_buffer = require('node:buffer');
+const node_url = require('node:url');
+const esbuild = require('@mokup/shared/esbuild');
+const jsoncParser = require('@mokup/shared/jsonc-parser');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function createConnectMiddleware(options) {
   const runtime$1 = runtime.createRuntime(fetch.toRuntimeOptions(options));
   const onNotFound = options.onNotFound ?? "next";
@@ -59,6 +69,1061 @@ function createFastifyPlugin(options) {
   };
 }
 
+const methodSet = /* @__PURE__ */ new Set([
+  "GET",
+  "POST",
+  "PUT",
+  "PATCH",
+  "DELETE",
+  "OPTIONS",
+  "HEAD"
+]);
+const methodSuffixSet = new Set(
+  Array.from(methodSet, (method) => method.toLowerCase())
+);
+const supportedExtensions = /* @__PURE__ */ new Set([
+  ".json",
+  ".jsonc",
+  ".ts",
+  ".js",
+  ".mjs",
+  ".cjs"
+]);
+
+function normalizePrefix(prefix) {
+  if (!prefix) {
+    return "";
+  }
+  const normalized = prefix.startsWith("/") ? prefix : `/${prefix}`;
+  return normalized.endsWith("/") ? normalized.slice(0, -1) : normalized;
+}
+function resolveDirs(dir, root) {
+  const raw = typeof dir === "function" ? dir(root) : dir;
+  const resolved = Array.isArray(raw) ? raw : raw ? [raw] : ["mock"];
+  const normalized = resolved.map(
+    (entry) => pathe.isAbsolute(entry) ? entry : pathe.resolve(root, entry)
+  );
+  return Array.from(new Set(normalized));
+}
+function createDebouncer(delayMs, fn) {
+  let timer = null;
+  return () => {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      timer = null;
+      fn();
+    }, delayMs);
+  };
+}
+function toPosix(value) {
+  return value.replace(/\\/g, "/");
+}
+function isInDirs(file, dirs) {
+  const normalized = toPosix(file);
+  return dirs.some((dir) => {
+    const normalizedDir = toPosix(dir).replace(/\/$/, "");
+    return normalized === normalizedDir || normalized.startsWith(`${normalizedDir}/`);
+  });
+}
+function testPatterns(patterns, value) {
+  const list = Array.isArray(patterns) ? patterns : [patterns];
+  return list.some((pattern) => pattern.test(value));
+}
+function matchesFilter(file, include, exclude) {
+  const normalized = toPosix(file);
+  if (exclude && testPatterns(exclude, normalized)) {
+    return false;
+  }
+  if (include) {
+    return testPatterns(include, normalized);
+  }
+  return true;
+}
+function delay(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+
+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 isValidStatus(status) {
+  return typeof status === "number" && Number.isFinite(status) && status >= 200 && status <= 599;
+}
+function resolveStatus(routeStatus, responseStatus) {
+  if (isValidStatus(routeStatus)) {
+    return routeStatus;
+  }
+  if (isValidStatus(responseStatus)) {
+    return responseStatus;
+  }
+  return 200;
+}
+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 = resolveStatus(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.Hono({ router: new hono.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;
+}
+
+function createLogger(enabled) {
+  return {
+    info: (...args) => {
+      if (enabled) {
+        console.info("[mokup]", ...args);
+      }
+    },
+    warn: (...args) => {
+      if (enabled) {
+        console.warn("[mokup]", ...args);
+      }
+    },
+    error: (...args) => {
+      if (enabled) {
+        console.error("[mokup]", ...args);
+      }
+    }
+  };
+}
+
+const mimeTypes = {
+  ".html": "text/html; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".map": "application/json; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".ico": "image/x-icon"
+};
+function normalizePlaygroundPath(value) {
+  if (!value) {
+    return "/_mokup";
+  }
+  const normalized = value.startsWith("/") ? value : `/${value}`;
+  return normalized.length > 1 && normalized.endsWith("/") ? normalized.slice(0, -1) : normalized;
+}
+function resolvePlaygroundOptions(playground) {
+  if (playground === false) {
+    return { enabled: false, path: "/_mokup" };
+  }
+  if (playground && typeof playground === "object") {
+    return {
+      enabled: playground.enabled !== false,
+      path: normalizePlaygroundPath(playground.path)
+    };
+  }
+  return { enabled: true, path: "/_mokup" };
+}
+function resolvePlaygroundDist() {
+  const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+  const pkgPath = require$1.resolve("@mokup/playground/package.json");
+  return pathe.join(pkgPath, "..", "dist");
+}
+function toPosixPath(value) {
+  return value.replace(/\\/g, "/");
+}
+function normalizePath(value) {
+  return toPosixPath(pathe.normalize(value));
+}
+function isAncestor(parent, child) {
+  const normalizedParent = normalizePath(parent).replace(/\/$/, "");
+  const normalizedChild = normalizePath(child);
+  return normalizedChild === normalizedParent || normalizedChild.startsWith(`${normalizedParent}/`);
+}
+function resolveGroupRoot(dirs, serverRoot) {
+  if (!dirs || dirs.length === 0) {
+    return serverRoot ?? node_process.cwd();
+  }
+  if (serverRoot) {
+    const normalizedRoot = normalizePath(serverRoot);
+    const canUseRoot = dirs.every((dir) => isAncestor(normalizedRoot, dir));
+    if (canUseRoot) {
+      return normalizedRoot;
+    }
+  }
+  if (dirs.length === 1) {
+    return normalizePath(pathe.dirname(dirs[0]));
+  }
+  let common = normalizePath(dirs[0]);
+  for (const dir of dirs.slice(1)) {
+    const normalizedDir = normalizePath(dir);
+    while (common && !isAncestor(common, normalizedDir)) {
+      const parent = normalizePath(pathe.dirname(common));
+      if (parent === common) {
+        break;
+      }
+      common = parent;
+    }
+  }
+  if (!common || common === "/") {
+    return serverRoot ?? node_process.cwd();
+  }
+  return common;
+}
+function formatRouteFile(file, root) {
+  if (!root) {
+    return toPosixPath(file);
+  }
+  const rel = toPosixPath(pathe.relative(root, file));
+  if (!rel || rel.startsWith("..")) {
+    return toPosixPath(file);
+  }
+  return rel;
+}
+function resolveGroups(dirs, root) {
+  const groups = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const dir of dirs) {
+    const normalized = normalizePath(dir);
+    if (seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    const rel = toPosixPath(pathe.relative(root, normalized));
+    const label = rel && !rel.startsWith("..") ? rel : normalized;
+    groups.push({
+      key: normalized,
+      label,
+      path: normalized
+    });
+  }
+  return groups;
+}
+function resolveRouteGroup(routeFile, groups) {
+  if (groups.length === 0) {
+    return void 0;
+  }
+  const normalizedFile = toPosixPath(pathe.normalize(routeFile));
+  let matched;
+  for (const group of groups) {
+    if (normalizedFile === group.path || normalizedFile.startsWith(`${group.path}/`)) {
+      if (!matched || group.path.length > matched.path.length) {
+        matched = group;
+      }
+    }
+  }
+  return matched;
+}
+function toPlaygroundRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  const middlewareSources = route.middlewares?.map((entry) => formatRouteFile(entry.source, root));
+  return {
+    method: route.method,
+    url: route.template,
+    file: formatRouteFile(route.file, root),
+    type: typeof route.handler === "function" ? "handler" : "static",
+    status: route.status,
+    delay: route.delay,
+    middlewareCount: middlewareSources?.length ?? 0,
+    middlewares: middlewareSources,
+    groupKey: matchedGroup?.key,
+    group: matchedGroup?.label
+  };
+}
+function registerPlaygroundRoutes(params) {
+  if (!params.config.enabled) {
+    return;
+  }
+  const playgroundPath = normalizePlaygroundPath(params.config.path);
+  const distDir = resolvePlaygroundDist();
+  const indexPath = pathe.join(distDir, "index.html");
+  const serveIndex = async () => {
+    try {
+      const html = await node_fs.promises.readFile(indexPath, "utf8");
+      const contentType = mimeTypes[".html"] ?? "text/html; charset=utf-8";
+      return new Response(html, { headers: { "Content-Type": contentType } });
+    } catch (error) {
+      params.logger.error("Failed to load playground index:", error);
+      return new Response("Playground is not available.", { status: 500 });
+    }
+  };
+  params.app.get(playgroundPath, (c) => c.redirect(`${playgroundPath}/`));
+  params.app.get(`${playgroundPath}/`, () => serveIndex());
+  params.app.get(`${playgroundPath}/index.html`, () => serveIndex());
+  params.app.get(`${playgroundPath}/routes`, (c) => {
+    const baseRoot = resolveGroupRoot(params.dirs, params.root);
+    const groups = resolveGroups(params.dirs, baseRoot);
+    return c.json({
+      basePath: playgroundPath,
+      root: baseRoot,
+      count: params.routes.length,
+      groups: groups.map((group) => ({ key: group.key, label: group.label })),
+      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups))
+    });
+  });
+  params.app.get(`${playgroundPath}/*`, async (c) => {
+    const pathname = c.req.path;
+    const relPath = pathname.slice(playgroundPath.length).replace(/^\/+/, "");
+    if (!relPath || relPath === "/") {
+      return serveIndex();
+    }
+    if (relPath.includes("..")) {
+      return new Response("Invalid path.", { status: 400 });
+    }
+    const normalizedPath = pathe.normalize(relPath);
+    const filePath = pathe.join(distDir, normalizedPath);
+    try {
+      const content = await node_fs.promises.readFile(filePath);
+      const ext = pathe.extname(filePath);
+      const contentType = mimeTypes[ext] ?? "application/octet-stream";
+      return new Response(content, { headers: { "Content-Type": contentType } });
+    } catch {
+      return c.notFound();
+    }
+  });
+}
+
+const jsonExtensions = /* @__PURE__ */ new Set([".json", ".jsonc"]);
+function resolveTemplate(template, prefix) {
+  const normalized = template.startsWith("/") ? template : `/${template}`;
+  if (!prefix) {
+    return normalized;
+  }
+  const normalizedPrefix = normalizePrefix(prefix);
+  if (!normalizedPrefix) {
+    return normalized;
+  }
+  if (normalized === normalizedPrefix || normalized.startsWith(`${normalizedPrefix}/`)) {
+    return normalized;
+  }
+  if (normalized === "/") {
+    return `${normalizedPrefix}/`;
+  }
+  return `${normalizedPrefix}${normalized}`;
+}
+function stripMethodSuffix(base) {
+  const segments = base.split(".");
+  const last = segments.at(-1);
+  if (last && methodSuffixSet.has(last.toLowerCase())) {
+    segments.pop();
+    return {
+      name: segments.join("."),
+      method: last.toUpperCase()
+    };
+  }
+  return {
+    name: base,
+    method: void 0
+  };
+}
+function deriveRouteFromFile(file, rootDir, logger) {
+  const rel = toPosix(pathe.relative(rootDir, file));
+  const ext = pathe.extname(rel);
+  const withoutExt = rel.slice(0, rel.length - ext.length);
+  const dir = pathe.dirname(withoutExt);
+  const base = pathe.basename(withoutExt);
+  const { name, method } = stripMethodSuffix(base);
+  const resolvedMethod = method ?? (jsonExtensions.has(ext) ? "GET" : void 0);
+  if (!resolvedMethod) {
+    logger.warn(`Skip mock without method suffix: ${file}`);
+    return null;
+  }
+  if (!name) {
+    logger.warn(`Skip mock with empty route name: ${file}`);
+    return null;
+  }
+  const joined = dir === "." ? name : pathe.join(dir, name);
+  const segments = toPosix(joined).split("/");
+  if (segments.at(-1) === "index") {
+    segments.pop();
+  }
+  const template = segments.length === 0 ? "/" : `/${segments.join("/")}`;
+  const parsed = runtime.parseRouteTemplate(template);
+  if (parsed.errors.length > 0) {
+    for (const error of parsed.errors) {
+      logger.warn(`${error} in ${file}`);
+    }
+    return null;
+  }
+  for (const warning of parsed.warnings) {
+    logger.warn(`${warning} in ${file}`);
+  }
+  return {
+    template: parsed.template,
+    method: resolvedMethod,
+    tokens: parsed.tokens,
+    score: parsed.score
+  };
+}
+function resolveRule(params) {
+  const method = params.derivedMethod;
+  if (!method) {
+    params.logger.warn(`Skip mock without method suffix: ${params.file}`);
+    return null;
+  }
+  const template = resolveTemplate(params.derivedTemplate, params.prefix);
+  const parsed = runtime.parseRouteTemplate(template);
+  if (parsed.errors.length > 0) {
+    for (const error of parsed.errors) {
+      params.logger.warn(`${error} in ${params.file}`);
+    }
+    return null;
+  }
+  for (const warning of parsed.warnings) {
+    params.logger.warn(`${warning} in ${params.file}`);
+  }
+  const route = {
+    file: params.file,
+    template: parsed.template,
+    method,
+    tokens: parsed.tokens,
+    score: parsed.score,
+    handler: params.rule.handler
+  };
+  if (typeof params.rule.status === "number") {
+    route.status = params.rule.status;
+  }
+  if (params.rule.headers) {
+    route.headers = params.rule.headers;
+  }
+  if (typeof params.rule.delay === "number") {
+    route.delay = params.rule.delay;
+  }
+  return route;
+}
+function sortRoutes(routes) {
+  return routes.sort((a, b) => {
+    if (a.method !== b.method) {
+      return a.method.localeCompare(b.method);
+    }
+    const scoreCompare = runtime.compareRouteScore(a.score, b.score);
+    if (scoreCompare !== 0) {
+      return scoreCompare;
+    }
+    return a.template.localeCompare(b.template);
+  });
+}
+
+const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
+async function loadModule$1(file) {
+  const ext = configExtensions.find((extension) => file.endsWith(extension));
+  if (ext === ".cjs") {
+    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+    delete require$1.cache[file];
+    return require$1(file);
+  }
+  if (ext === ".js" || ext === ".mjs") {
+    return import(`${node_url.pathToFileURL(file).href}?t=${Date.now()}`);
+  }
+  if (ext === ".ts") {
+    const result = await esbuild.build({
+      entryPoints: [file],
+      bundle: true,
+      format: "esm",
+      platform: "node",
+      sourcemap: "inline",
+      target: "es2020",
+      write: false
+    });
+    const output = result.outputFiles[0];
+    const code = output?.text ?? "";
+    const dataUrl = `data:text/javascript;base64,${node_buffer.Buffer.from(code).toString(
+      "base64"
+    )}`;
+    return import(`${dataUrl}#${Date.now()}`);
+  }
+  return null;
+}
+function getConfigFileCandidates(dir) {
+  return configExtensions.map((extension) => pathe.join(dir, `index.config${extension}`));
+}
+async function findConfigFile(dir, cache) {
+  const cached = cache.get(dir);
+  if (cached !== void 0) {
+    return cached;
+  }
+  for (const candidate of getConfigFileCandidates(dir)) {
+    try {
+      await node_fs.promises.stat(candidate);
+      cache.set(dir, candidate);
+      return candidate;
+    } catch {
+      continue;
+    }
+  }
+  cache.set(dir, null);
+  return null;
+}
+async function loadConfig(file) {
+  const mod = await loadModule$1(file);
+  if (!mod) {
+    return null;
+  }
+  const value = mod?.default ?? mod;
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  return value;
+}
+function normalizeMiddlewares(value, source, logger) {
+  if (!value) {
+    return [];
+  }
+  const list = Array.isArray(value) ? value : [value];
+  const middlewares = [];
+  for (const [index, entry] of list.entries()) {
+    if (typeof entry !== "function") {
+      logger.warn(`Invalid middleware in ${source}`);
+      continue;
+    }
+    middlewares.push({ handle: entry, source, index });
+  }
+  return middlewares;
+}
+async function resolveDirectoryConfig(params) {
+  const { file, rootDir, logger, configCache, fileCache } = params;
+  const resolvedRoot = pathe.normalize(rootDir);
+  const resolvedFileDir = pathe.normalize(pathe.dirname(file));
+  const chain = [];
+  let current = resolvedFileDir;
+  while (true) {
+    chain.push(current);
+    if (current === resolvedRoot) {
+      break;
+    }
+    const parent = pathe.dirname(current);
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  chain.reverse();
+  const merged = { middlewares: [] };
+  for (const dir of chain) {
+    const configPath = await findConfigFile(dir, fileCache);
+    if (!configPath) {
+      continue;
+    }
+    let config = configCache.get(configPath);
+    if (config === void 0) {
+      config = await loadConfig(configPath);
+      configCache.set(configPath, config);
+    }
+    if (!config) {
+      logger.warn(`Invalid config in ${configPath}`);
+      continue;
+    }
+    if (config.headers) {
+      merged.headers = { ...merged.headers ?? {}, ...config.headers };
+    }
+    if (typeof config.status === "number") {
+      merged.status = config.status;
+    }
+    if (typeof config.delay === "number") {
+      merged.delay = config.delay;
+    }
+    if (typeof config.enabled === "boolean") {
+      merged.enabled = config.enabled;
+    }
+    const normalized = normalizeMiddlewares(config.middleware, configPath, logger);
+    if (normalized.length > 0) {
+      merged.middlewares.push(...normalized);
+    }
+  }
+  return merged;
+}
+
+async function walkDir(dir, rootDir, files) {
+  const entries = await node_fs.promises.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === "node_modules" || entry.name === ".git") {
+      continue;
+    }
+    const fullPath = pathe.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await walkDir(fullPath, rootDir, files);
+      continue;
+    }
+    if (entry.isFile()) {
+      files.push({ file: fullPath, rootDir });
+    }
+  }
+}
+async function exists(path) {
+  try {
+    await node_fs.promises.stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function collectFiles(dirs) {
+  const files = [];
+  for (const dir of dirs) {
+    if (!await exists(dir)) {
+      continue;
+    }
+    await walkDir(dir, dir, files);
+  }
+  return files;
+}
+function isSupportedFile(file) {
+  if (file.endsWith(".d.ts")) {
+    return false;
+  }
+  if (pathe.basename(file).startsWith("index.config.")) {
+    return false;
+  }
+  const ext = pathe.extname(file).toLowerCase();
+  return supportedExtensions.has(ext);
+}
+
+async function loadModule(file) {
+  const ext = pathe.extname(file).toLowerCase();
+  if (ext === ".cjs") {
+    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+    delete require$1.cache[file];
+    return require$1(file);
+  }
+  if (ext === ".js" || ext === ".mjs") {
+    return import(`${node_url.pathToFileURL(file).href}?t=${Date.now()}`);
+  }
+  if (ext === ".ts") {
+    const result = await esbuild.build({
+      entryPoints: [file],
+      bundle: true,
+      format: "esm",
+      platform: "node",
+      sourcemap: "inline",
+      target: "es2020",
+      write: false
+    });
+    const output = result.outputFiles[0];
+    const code = output?.text ?? "";
+    const dataUrl = `data:text/javascript;base64,${node_buffer.Buffer.from(code).toString(
+      "base64"
+    )}`;
+    return import(`${dataUrl}#${Date.now()}`);
+  }
+  return null;
+}
+async function readJsonFile(file, logger) {
+  try {
+    const content = await node_fs.promises.readFile(file, "utf8");
+    const errors = [];
+    const data = jsoncParser.parse(content, errors, {
+      allowTrailingComma: true,
+      disallowComments: false
+    });
+    if (errors.length > 0) {
+      logger.warn(`Invalid JSONC in ${file}`);
+      return void 0;
+    }
+    return data;
+  } catch (error) {
+    logger.warn(`Failed to read ${file}: ${String(error)}`);
+    return void 0;
+  }
+}
+async function loadRules(file, logger) {
+  const ext = pathe.extname(file).toLowerCase();
+  if (ext === ".json" || ext === ".jsonc") {
+    const json = await readJsonFile(file, logger);
+    if (typeof json === "undefined") {
+      return [];
+    }
+    return [
+      {
+        handler: json
+      }
+    ];
+  }
+  const mod = await loadModule(file);
+  const value = mod?.default ?? mod;
+  if (!value) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    return value;
+  }
+  if (typeof value === "function") {
+    return [
+      {
+        handler: value
+      }
+    ];
+  }
+  return [value];
+}
+
+async function scanRoutes(params) {
+  const routes = [];
+  const seen = /* @__PURE__ */ new Set();
+  const files = await collectFiles(params.dirs);
+  const configCache = /* @__PURE__ */ new Map();
+  const fileCache = /* @__PURE__ */ new Map();
+  for (const fileInfo of files) {
+    if (!isSupportedFile(fileInfo.file)) {
+      continue;
+    }
+    if (!matchesFilter(fileInfo.file, params.include, params.exclude)) {
+      continue;
+    }
+    const config = await resolveDirectoryConfig({
+      file: fileInfo.file,
+      rootDir: fileInfo.rootDir,
+      logger: params.logger,
+      configCache,
+      fileCache
+    });
+    if (config.enabled === false) {
+      continue;
+    }
+    const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
+    if (!derived) {
+      continue;
+    }
+    const rules = await loadRules(fileInfo.file, params.logger);
+    for (const [index, rule] of rules.entries()) {
+      if (!rule || typeof rule !== "object") {
+        continue;
+      }
+      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({
+        rule,
+        derivedTemplate: derived.template,
+        derivedMethod: derived.method,
+        prefix: params.prefix,
+        file: fileInfo.file,
+        logger: params.logger
+      });
+      if (!resolved) {
+        continue;
+      }
+      resolved.ruleIndex = index;
+      if (config.headers) {
+        resolved.headers = { ...config.headers, ...resolved.headers ?? {} };
+      }
+      if (typeof resolved.status === "undefined" && typeof config.status === "number") {
+        resolved.status = config.status;
+      }
+      if (typeof resolved.delay === "undefined" && typeof config.delay === "number") {
+        resolved.delay = config.delay;
+      }
+      if (config.middlewares.length > 0) {
+        resolved.middlewares = config.middlewares;
+      }
+      const key = `${resolved.method} ${resolved.template}`;
+      if (seen.has(key)) {
+        params.logger.warn(`Duplicate mock route ${key} from ${fileInfo.file}`);
+      }
+      seen.add(key);
+      routes.push(resolved);
+    }
+  }
+  return sortRoutes(routes);
+}
+
+function normalizeOptions(options) {
+  const list = Array.isArray(options) ? options : [options];
+  return list.length > 0 ? list : [{}];
+}
+function resolvePlaygroundInput(list) {
+  for (const entry of list) {
+    if (typeof entry.playground !== "undefined") {
+      return entry.playground;
+    }
+  }
+  return void 0;
+}
+function resolveFirst(list, getter) {
+  for (const entry of list) {
+    const value = getter(entry);
+    if (typeof value !== "undefined") {
+      return value;
+    }
+  }
+  return void 0;
+}
+function resolveRoot(list) {
+  const explicit = resolveFirst(list, (entry) => entry.root);
+  if (explicit) {
+    return explicit;
+  }
+  const deno = globalThis.Deno;
+  if (deno?.cwd) {
+    return deno.cwd();
+  }
+  return node_process.cwd();
+}
+function resolveAllDirs(list, root) {
+  const dirs = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of list) {
+    for (const dir of resolveDirs(entry.dir, root)) {
+      if (seen.has(dir)) {
+        continue;
+      }
+      seen.add(dir);
+      dirs.push(dir);
+    }
+  }
+  return dirs;
+}
+function buildApp(params) {
+  const app = new hono.Hono({ strict: false });
+  registerPlaygroundRoutes({
+    app,
+    routes: params.routes,
+    dirs: params.dirs,
+    logger: params.logger,
+    config: params.playground,
+    root: params.root
+  });
+  if (params.routes.length > 0) {
+    const mockApp = createHonoApp(params.routes);
+    app.route("/", mockApp);
+  }
+  return app;
+}
+async function createDenoWatcher(params) {
+  const deno = globalThis.Deno;
+  if (!deno?.watchFs) {
+    return null;
+  }
+  const watcher = deno.watchFs(params.dirs, { recursive: true });
+  let closed = false;
+  (async () => {
+    try {
+      for await (const event of watcher) {
+        if (closed) {
+          break;
+        }
+        if (event.kind === "access") {
+          continue;
+        }
+        params.onChange();
+      }
+    } catch (error) {
+      if (!closed) {
+        params.logger.warn("Watcher failed:", error);
+      }
+    }
+  })();
+  return {
+    close: async () => {
+      closed = true;
+      watcher.close();
+    }
+  };
+}
+async function createChokidarWatcher(params) {
+  try {
+    const { default: chokidar } = await import('@mokup/shared/chokidar');
+    const watcher = chokidar.watch(params.dirs, { ignoreInitial: true });
+    watcher.on("add", (file) => {
+      if (isInDirs(file, params.dirs)) {
+        params.onChange();
+      }
+    });
+    watcher.on("change", (file) => {
+      if (isInDirs(file, params.dirs)) {
+        params.onChange();
+      }
+    });
+    watcher.on("unlink", (file) => {
+      if (isInDirs(file, params.dirs)) {
+        params.onChange();
+      }
+    });
+    return {
+      close: async () => {
+        await watcher.close();
+      }
+    };
+  } catch {
+    return null;
+  }
+}
+async function createWatcher(params) {
+  if (!params.enabled || params.dirs.length === 0) {
+    return null;
+  }
+  const denoWatcher = await createDenoWatcher(params);
+  if (denoWatcher) {
+    return denoWatcher;
+  }
+  const chokidarWatcher = await createChokidarWatcher(params);
+  if (chokidarWatcher) {
+    return chokidarWatcher;
+  }
+  params.logger.warn("Watcher is not available in this runtime; file watching disabled.");
+  return null;
+}
+async function createFetchServer(options = {}) {
+  const optionList = normalizeOptions(options);
+  const root = resolveRoot(optionList);
+  const logEnabled = optionList.every((entry) => entry.log !== false);
+  const watchEnabled = optionList.every((entry) => entry.watch !== false);
+  const logger = createLogger(logEnabled);
+  const playgroundConfig = resolvePlaygroundOptions(resolvePlaygroundInput(optionList));
+  const dirs = resolveAllDirs(optionList, root);
+  let routes = [];
+  let app = buildApp({
+    routes,
+    dirs,
+    playground: playgroundConfig,
+    root,
+    logger
+  });
+  const refreshRoutes = async () => {
+    try {
+      const collected = [];
+      for (const entry of optionList) {
+        const scanParams = {
+          dirs: resolveDirs(entry.dir, root),
+          prefix: entry.prefix ?? "",
+          logger
+        };
+        if (entry.include) {
+          scanParams.include = entry.include;
+        }
+        if (entry.exclude) {
+          scanParams.exclude = entry.exclude;
+        }
+        const scanned = await scanRoutes(scanParams);
+        collected.push(...scanned);
+      }
+      const resolvedRoutes = sortRoutes(collected);
+      routes = resolvedRoutes;
+      app = buildApp({
+        routes,
+        dirs,
+        playground: playgroundConfig,
+        root,
+        logger
+      });
+      logger.info(`Loaded ${routes.length} mock routes.`);
+    } catch (error) {
+      logger.error("Failed to scan mock routes:", error);
+    }
+  };
+  await refreshRoutes();
+  const scheduleRefresh = createDebouncer(80, () => {
+    void refreshRoutes();
+  });
+  const watcher = await createWatcher({
+    enabled: watchEnabled,
+    dirs,
+    onChange: scheduleRefresh,
+    logger
+  });
+  const fetch = async (request) => await app.fetch(request);
+  const server = {
+    fetch,
+    refresh: refreshRoutes,
+    getRoutes: () => routes
+  };
+  if (watcher) {
+    server.close = async () => {
+      await watcher.close();
+    };
+  }
+  return server;
+}
+
 function createHonoMiddleware(options) {
   const handler = fetch.createFetchHandler(options);
   const middleware = async (context, next) => {
@@ -182,6 +1247,7 @@ exports.createFetchHandler = fetch.createFetchHandler;
 exports.createConnectMiddleware = createConnectMiddleware;
 exports.createExpressMiddleware = createExpressMiddleware;
 exports.createFastifyPlugin = createFastifyPlugin;
+exports.createFetchServer = createFetchServer;
 exports.createHonoMiddleware = createHonoMiddleware;
 exports.createKoaMiddleware = createKoaMiddleware;
 exports.createMokupWorker = createMokupWorker;