@mokup/cli 0.1.0 → 0.3.0

package/dist/index.mjs

@@ -1,10 +1,855 @@
-export { b as buildManifest } from './shared/cli.DqkcmI0-.mjs';
-import 'node:fs';
-import 'node:process';
-import 'pathe';
-import 'node:buffer';
-import 'node:module';
-import 'node:url';
-import 'esbuild';
-import '@mokup/runtime';
-import 'jsonc-parser';
+import { promises } from 'node:fs';
+import process, { cwd } from 'node:process';
+import { join, normalize, dirname, resolve, isAbsolute, basename, extname, relative } from '@mokup/shared/pathe';
+import { Buffer } from 'node:buffer';
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+import { build } from '@mokup/shared/esbuild';
+import { parseRouteTemplate, compareRouteScore } from '@mokup/runtime';
+import { parse } from '@mokup/shared/jsonc-parser';
+import { serve } from '@hono/node-server';
+import { createFetchServer } from '@mokup/server';
+import { Command } from 'commander';
+
+async function writeBundle(outDir, hasHandlers) {
+  const lines = [
+    "import manifest from './mokup.manifest.mjs'"
+  ];
+  if (hasHandlers) {
+    lines.push(
+      "import { mokupModuleMap } from './mokup-handlers/index.mjs'",
+      "",
+      "const mokupBundle = {",
+      "  manifest,",
+      "  moduleMap: mokupModuleMap,",
+      "  moduleBase: './',",
+      "}"
+    );
+  } else {
+    lines.push(
+      "",
+      "const mokupBundle = {",
+      "  manifest,",
+      "}"
+    );
+  }
+  lines.push("", "export default mokupBundle", "export { mokupBundle }", "");
+  const dts = [
+    "import type { Manifest, ModuleMap } from '@mokup/runtime'",
+    "export interface MokupBundle {",
+    "  manifest: Manifest",
+    "  moduleMap?: ModuleMap",
+    "  moduleBase?: string | URL",
+    "}",
+    "declare const mokupBundle: MokupBundle",
+    "export default mokupBundle",
+    "export { mokupBundle }",
+    ""
+  ];
+  await promises.writeFile(join(outDir, "mokup.bundle.mjs"), lines.join("\n"), "utf8");
+  await promises.writeFile(join(outDir, "mokup.bundle.d.ts"), dts.join("\n"), "utf8");
+  await promises.writeFile(join(outDir, "mokup.bundle.d.mts"), dts.join("\n"), "utf8");
+}
+async function writeManifestModule(outDir, manifest) {
+  const lines = [
+    `const manifest = ${JSON.stringify(manifest, null, 2)}`,
+    "",
+    "export default manifest",
+    ""
+  ];
+  const dts = [
+    "import type { Manifest } from '@mokup/runtime'",
+    "declare const manifest: Manifest",
+    "export default manifest",
+    ""
+  ];
+  await promises.writeFile(join(outDir, "mokup.manifest.mjs"), lines.join("\n"), "utf8");
+  await promises.writeFile(join(outDir, "mokup.manifest.d.mts"), dts.join("\n"), "utf8");
+}
+
+const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
+async function loadModule$1(file) {
+  const ext = configExtensions.find((extension) => file.endsWith(extension));
+  if (ext === ".cjs") {
+    const require = createRequire(import.meta.url);
+    delete require.cache[file];
+    return require(file);
+  }
+  if (ext === ".js" || ext === ".mjs") {
+    return import(`${pathToFileURL(file).href}?t=${Date.now()}`);
+  }
+  if (ext === ".ts") {
+    const result = await 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,${Buffer.from(code).toString(
+      "base64"
+    )}`;
+    return import(`${dataUrl}#${Date.now()}`);
+  }
+  return null;
+}
+function getConfigFileCandidates(dir) {
+  return configExtensions.map((extension) => 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 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, log) {
+  if (!value) {
+    return [];
+  }
+  const list = Array.isArray(value) ? value : [value];
+  const middlewares = [];
+  list.forEach((entry, index) => {
+    if (typeof entry !== "function") {
+      log?.(`Invalid middleware in ${source}`);
+      return;
+    }
+    middlewares.push({ file: source, index });
+  });
+  return middlewares;
+}
+async function resolveDirectoryConfig(params) {
+  const { file, rootDir, log, configCache, fileCache } = params;
+  const resolvedRoot = normalize(rootDir);
+  const resolvedFileDir = normalize(dirname(file));
+  const chain = [];
+  let current = resolvedFileDir;
+  while (true) {
+    chain.push(current);
+    if (current === resolvedRoot) {
+      break;
+    }
+    const parent = 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) {
+      log?.(`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, log);
+    if (normalized.length > 0) {
+      merged.middlewares.push(...normalized);
+    }
+  }
+  return merged;
+}
+
+function toPosix(value) {
+  return value.replace(/\\/g, "/");
+}
+
+const supportedExtensions = /* @__PURE__ */ new Set([
+  ".json",
+  ".jsonc",
+  ".ts",
+  ".js",
+  ".mjs",
+  ".cjs"
+]);
+async function exists(path) {
+  try {
+    await promises.stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function walkDir(dir, rootDir, files) {
+  const entries = await promises.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === "node_modules" || entry.name === ".git") {
+      continue;
+    }
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await walkDir(fullPath, rootDir, files);
+      continue;
+    }
+    if (entry.isFile()) {
+      files.push({ file: fullPath, rootDir });
+    }
+  }
+}
+async function collectFiles(dirs) {
+  const files = [];
+  for (const dir of dirs) {
+    if (!await exists(dir)) {
+      continue;
+    }
+    await walkDir(dir, dir, files);
+  }
+  return files;
+}
+function resolveDirs(dir, root) {
+  const raw = dir;
+  const resolved = Array.isArray(raw) ? raw : raw ? [raw] : ["mock"];
+  const normalized = resolved.map(
+    (entry) => isAbsolute(entry) ? entry : resolve(root, entry)
+  );
+  return Array.from(new Set(normalized));
+}
+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 isSupportedFile(file) {
+  if (file.endsWith(".d.ts")) {
+    return false;
+  }
+  if (basename(file).startsWith("index.config.")) {
+    return false;
+  }
+  const ext = extname(file).toLowerCase();
+  return supportedExtensions.has(ext);
+}
+
+function getHandlerModulePath(file, handlersDir, root) {
+  const relFromRoot = relative(root, file);
+  const ext = extname(relFromRoot);
+  const relNoExt = `${relFromRoot.slice(0, relFromRoot.length - ext.length)}.mjs`;
+  const outputPath = join(handlersDir, relNoExt);
+  const relFromOutDir = relative(dirname(handlersDir), outputPath);
+  const normalized = toPosix(relFromOutDir);
+  return normalized.startsWith(".") ? normalized : `./${normalized}`;
+}
+async function writeHandlerIndex(handlerModuleMap, handlersDir, outDir) {
+  const modulePaths = Array.from(new Set(handlerModuleMap.values()));
+  if (modulePaths.length === 0) {
+    return;
+  }
+  const imports = [];
+  const entries = [];
+  modulePaths.forEach((modulePath, index) => {
+    const absolutePath = resolve(outDir, modulePath);
+    const relImport = toPosix(relative(handlersDir, absolutePath));
+    const importPath = relImport.startsWith(".") ? relImport : `./${relImport}`;
+    const name = `module${index}`;
+    imports.push(`import * as ${name} from '${importPath}'`);
+    entries.push({ key: modulePath, name });
+  });
+  const lines = [
+    ...imports,
+    "",
+    "export const mokupModuleMap = {",
+    ...entries.map((entry) => `  '${entry.key}': ${entry.name},`),
+    "}",
+    ""
+  ];
+  await promises.writeFile(join(handlersDir, "index.mjs"), lines.join("\n"), "utf8");
+  const dts = [
+    "export type MokupModuleMap = Record<string, Record<string, unknown>>",
+    "export declare const mokupModuleMap: MokupModuleMap",
+    ""
+  ];
+  await promises.writeFile(join(handlersDir, "index.d.ts"), dts.join("\n"), "utf8");
+  await promises.writeFile(join(handlersDir, "index.d.mts"), dts.join("\n"), "utf8");
+}
+function buildResponse(handler, options) {
+  if (typeof handler === "function") {
+    if (!options.handlers) {
+      return null;
+    }
+    const moduleRel = getHandlerModulePath(
+      options.file,
+      options.handlersDir,
+      options.root
+    );
+    options.handlerSources.add(options.file);
+    options.handlerModuleMap.set(options.file, moduleRel);
+    return {
+      type: "module",
+      module: moduleRel,
+      ruleIndex: options.ruleIndex
+    };
+  }
+  if (typeof handler === "string") {
+    return {
+      type: "text",
+      body: handler
+    };
+  }
+  if (handler instanceof Uint8Array || handler instanceof ArrayBuffer) {
+    return {
+      type: "binary",
+      body: Buffer.from(handler).toString("base64"),
+      encoding: "base64"
+    };
+  }
+  if (Buffer.isBuffer(handler)) {
+    return {
+      type: "binary",
+      body: handler.toString("base64"),
+      encoding: "base64"
+    };
+  }
+  return {
+    type: "json",
+    body: handler
+  };
+}
+async function bundleHandlers(files, root, handlersDir) {
+  await build({
+    entryPoints: files,
+    bundle: true,
+    format: "esm",
+    platform: "neutral",
+    target: "es2020",
+    outdir: handlersDir,
+    outbase: root,
+    entryNames: "[dir]/[name]",
+    outExtension: { ".js": ".mjs" },
+    logLevel: "silent"
+  });
+}
+
+const methodSet = /* @__PURE__ */ new Set([
+  "GET",
+  "POST",
+  "PUT",
+  "PATCH",
+  "DELETE",
+  "OPTIONS",
+  "HEAD"
+]);
+const methodSuffixSet = new Set(
+  Array.from(methodSet, (method) => method.toLowerCase())
+);
+const jsonExtensions = /* @__PURE__ */ new Set([".json", ".jsonc"]);
+function normalizePrefix(prefix) {
+  if (!prefix) {
+    return "";
+  }
+  const normalized = prefix.startsWith("/") ? prefix : `/${prefix}`;
+  return normalized.endsWith("/") ? normalized.slice(0, -1) : normalized;
+}
+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, log) {
+  const rel = toPosix(relative(rootDir, file));
+  const ext = extname(rel);
+  const withoutExt = rel.slice(0, rel.length - ext.length);
+  const dir = dirname(withoutExt);
+  const base = basename(withoutExt);
+  const { name, method } = stripMethodSuffix(base);
+  const resolvedMethod = method ?? (jsonExtensions.has(ext) ? "GET" : void 0);
+  if (!resolvedMethod) {
+    log?.(`Skip mock without method suffix: ${file}`);
+    return null;
+  }
+  if (!name) {
+    log?.(`Skip mock with empty route name: ${file}`);
+    return null;
+  }
+  const joined = dir === "." ? name : join(dir, name);
+  const segments = toPosix(joined).split("/");
+  if (segments.at(-1) === "index") {
+    segments.pop();
+  }
+  const template = segments.length === 0 ? "/" : `/${segments.join("/")}`;
+  const parsed = parseRouteTemplate(template);
+  if (parsed.errors.length > 0) {
+    for (const error of parsed.errors) {
+      log?.(`${error} in ${file}`);
+    }
+    return null;
+  }
+  for (const warning of parsed.warnings) {
+    log?.(`${warning} in ${file}`);
+  }
+  return {
+    template: parsed.template,
+    method: resolvedMethod,
+    tokens: parsed.tokens,
+    score: parsed.score
+  };
+}
+function resolveRule(params) {
+  const method = params.derivedMethod;
+  if (!method) {
+    return null;
+  }
+  const template = resolveTemplate(params.derivedTemplate, params.prefix);
+  const parsed = parseRouteTemplate(template);
+  if (parsed.errors.length > 0) {
+    for (const error of parsed.errors) {
+      params.log?.(`${error} in ${params.file}`);
+    }
+    return null;
+  }
+  for (const warning of parsed.warnings) {
+    params.log?.(`${warning} in ${params.file}`);
+  }
+  return {
+    method,
+    template: parsed.template,
+    tokens: parsed.tokens,
+    score: parsed.score
+  };
+}
+function sortRoutes(routes) {
+  return routes.sort((a, b) => {
+    if (a.method !== b.method) {
+      return a.method.localeCompare(b.method);
+    }
+    return compareRouteScore(a.score ?? [], b.score ?? []);
+  });
+}
+
+async function readJsonFile(file) {
+  try {
+    const content = await promises.readFile(file, "utf8");
+    const errors = [];
+    const data = parse(content, errors, {
+      allowTrailingComma: true,
+      disallowComments: false
+    });
+    if (errors.length > 0) {
+      return void 0;
+    }
+    return data;
+  } catch {
+    return void 0;
+  }
+}
+async function loadModule(file) {
+  const ext = extname(file).toLowerCase();
+  if (ext === ".cjs") {
+    const require = createRequire(import.meta.url);
+    delete require.cache[file];
+    return require(file);
+  }
+  if (ext === ".js" || ext === ".mjs") {
+    return import(`${pathToFileURL(file).href}?t=${Date.now()}`);
+  }
+  if (ext === ".ts") {
+    const result = await 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,${Buffer.from(code).toString(
+      "base64"
+    )}`;
+    return import(`${dataUrl}#${Date.now()}`);
+  }
+  return null;
+}
+async function loadRules(file) {
+  const ext = extname(file).toLowerCase();
+  if (ext === ".json" || ext === ".jsonc") {
+    const json = await readJsonFile(file);
+    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 buildManifest(options = {}) {
+  const root = options.root ?? cwd();
+  const outDir = resolve(root, options.outDir ?? ".mokup");
+  const handlersDir = join(outDir, "mokup-handlers");
+  const dirs = resolveDirs(options.dir, root);
+  const files = await collectFiles(dirs);
+  const routes = [];
+  const seen = /* @__PURE__ */ new Set();
+  const handlerSources = /* @__PURE__ */ new Set();
+  const handlerModuleMap = /* @__PURE__ */ new Map();
+  const configCache = /* @__PURE__ */ new Map();
+  const configFileCache = /* @__PURE__ */ new Map();
+  for (const fileInfo of files) {
+    if (!isSupportedFile(fileInfo.file)) {
+      continue;
+    }
+    if (!matchesFilter(fileInfo.file, options.include, options.exclude)) {
+      continue;
+    }
+    const configParams = {
+      file: fileInfo.file,
+      rootDir: fileInfo.rootDir,
+      configCache,
+      fileCache: configFileCache
+    };
+    if (options.log) {
+      configParams.log = options.log;
+    }
+    const config = await resolveDirectoryConfig(configParams);
+    if (config.enabled === false) {
+      continue;
+    }
+    const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, options.log);
+    if (!derived) {
+      continue;
+    }
+    const rules = await loadRules(fileInfo.file);
+    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) {
+        options.log?.(
+          `Skip mock with unsupported fields (${unsupportedKeys.join(", ")}): ${fileInfo.file}`
+        );
+        continue;
+      }
+      if (typeof rule.handler === "undefined") {
+        continue;
+      }
+      const resolveParams = {
+        rule,
+        derivedTemplate: derived.template,
+        derivedMethod: derived.method,
+        prefix: options.prefix ?? "",
+        file: fileInfo.file
+      };
+      if (options.log) {
+        resolveParams.log = options.log;
+      }
+      const resolved = resolveRule(resolveParams);
+      if (!resolved) {
+        continue;
+      }
+      const key = `${resolved.method} ${resolved.template}`;
+      if (seen.has(key)) {
+        options.log?.(`Duplicate mock route ${key} from ${fileInfo.file}`);
+      }
+      seen.add(key);
+      const response = buildResponse(
+        rule.handler,
+        {
+          file: fileInfo.file,
+          handlers: options.handlers !== false,
+          handlerSources,
+          handlerModuleMap,
+          handlersDir,
+          root,
+          ruleIndex: index
+        }
+      );
+      if (!response) {
+        continue;
+      }
+      const source = toPosix(relative(root, fileInfo.file));
+      const middlewareRefs = options.handlers === false ? [] : config.middlewares.map((entry) => {
+        handlerSources.add(entry.file);
+        const modulePath = getHandlerModulePath(entry.file, handlersDir, root);
+        handlerModuleMap.set(entry.file, modulePath);
+        return {
+          module: modulePath,
+          ruleIndex: entry.index
+        };
+      });
+      const route = {
+        method: resolved.method,
+        url: resolved.template,
+        tokens: resolved.tokens,
+        score: resolved.score,
+        source,
+        response
+      };
+      if (typeof rule.status === "number") {
+        route.status = rule.status;
+      }
+      if (config.headers) {
+        route.headers = { ...config.headers };
+      }
+      if (rule.headers) {
+        route.headers = { ...route.headers ?? {}, ...rule.headers };
+      }
+      if (typeof rule.delay === "number") {
+        route.delay = rule.delay;
+      }
+      if (typeof route.status === "undefined" && typeof config.status === "number") {
+        route.status = config.status;
+      }
+      if (typeof route.delay === "undefined" && typeof config.delay === "number") {
+        route.delay = config.delay;
+      }
+      if (middlewareRefs.length > 0) {
+        route.middleware = middlewareRefs;
+      }
+      routes.push(route);
+    }
+  }
+  const manifest = {
+    version: 1,
+    routes: sortRoutes(routes)
+  };
+  await promises.mkdir(outDir, { recursive: true });
+  if (handlerSources.size > 0) {
+    await promises.mkdir(handlersDir, { recursive: true });
+    await bundleHandlers(Array.from(handlerSources), root, handlersDir);
+    await writeHandlerIndex(handlerModuleMap, handlersDir, outDir);
+  }
+  const manifestPath = join(outDir, "mokup.manifest.json");
+  await promises.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf8");
+  await writeManifestModule(outDir, manifest);
+  await writeBundle(outDir, handlerSources.size > 0);
+  options.log?.(`Manifest written to ${manifestPath}`);
+  return {
+    manifest,
+    manifestPath
+  };
+}
+
+function collectValues(value, previous) {
+  return [...previous ?? [], value];
+}
+function collectRegex(value, previous) {
+  const next = previous ?? [];
+  next.push(new RegExp(value));
+  return next;
+}
+function toBuildOptions(options) {
+  const buildOptions = {
+    handlers: options.handlers !== false,
+    log: (message) => {
+      console.log(message);
+    }
+  };
+  if (options.dir && options.dir.length > 0) {
+    buildOptions.dir = options.dir;
+  }
+  if (options.out) {
+    buildOptions.outDir = options.out;
+  }
+  if (options.prefix) {
+    buildOptions.prefix = options.prefix;
+  }
+  if (options.include && options.include.length > 0) {
+    buildOptions.include = options.include;
+  }
+  if (options.exclude && options.exclude.length > 0) {
+    buildOptions.exclude = options.exclude;
+  }
+  return buildOptions;
+}
+function toServeOptions(options) {
+  const serveOptions = {
+    watch: options.watch !== false,
+    log: options.log !== false
+  };
+  if (options.dir && options.dir.length > 0) {
+    serveOptions.dir = options.dir;
+  }
+  if (options.prefix) {
+    serveOptions.prefix = options.prefix;
+  }
+  if (options.include && options.include.length > 0) {
+    serveOptions.include = options.include;
+  }
+  if (options.exclude && options.exclude.length > 0) {
+    serveOptions.exclude = options.exclude;
+  }
+  if (options.host) {
+    serveOptions.host = options.host;
+  }
+  if (typeof options.port === "string" && options.port.length > 0) {
+    const parsed = Number(options.port);
+    if (!Number.isFinite(parsed)) {
+      throw new TypeError(`Invalid port: ${options.port}`);
+    }
+    serveOptions.port = parsed;
+  }
+  if (typeof options.playground !== "undefined") {
+    serveOptions.playground = options.playground;
+  }
+  return serveOptions;
+}
+function createCli() {
+  const program = new Command();
+  program.name("mokup").description("Mock utilities for file-based routes.").showHelpAfterError();
+  program.command("build").description("Generate .mokup build output").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("-o, --out <dir>", "Output directory (default: .mokup)").option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--no-handlers", "Skip function handler output").action(async (options) => {
+    const buildOptions = toBuildOptions(options);
+    await buildManifest(buildOptions);
+  });
+  program.command("serve").description("Start a Node.js mock server").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--host <host>", "Hostname (default: localhost)").option("--port <port>", "Port (default: 8080)").option("--no-watch", "Disable file watching").option("--no-playground", "Disable Playground").option("--no-log", "Disable logging").action(async (options) => {
+    const serveOptions = toServeOptions(options);
+    const host = serveOptions.host ?? "localhost";
+    const port = serveOptions.port ?? 8080;
+    const playgroundEnabled = serveOptions.playground !== false;
+    const playgroundPath = "/_mokup";
+    const server = await createFetchServer(serveOptions);
+    const nodeServer = serve(
+      {
+        fetch: server.fetch,
+        hostname: host,
+        port
+      },
+      (info) => {
+        const resolvedHost = typeof info === "string" ? host : info?.address ?? host;
+        const resolvedPort = typeof info === "string" ? port : info?.port ?? port;
+        console.log(`Mock server ready at http://${resolvedHost}:${resolvedPort}`);
+        if (playgroundEnabled) {
+          console.log(`Playground at http://${resolvedHost}:${resolvedPort}${playgroundPath}`);
+        }
+      }
+    );
+    const shutdown = async () => {
+      try {
+        if (server.close) {
+          await server.close();
+        }
+        await new Promise((resolve, reject) => {
+          nodeServer.close((error) => {
+            if (error) {
+              reject(error);
+              return;
+            }
+            resolve();
+          });
+        });
+      } finally {
+        process.exit(0);
+      }
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+  });
+  program.command("help").description("Show help").action(() => {
+    program.help();
+  });
+  return program;
+}
+async function runCli(argv = process.argv) {
+  const program = createCli();
+  if (argv.length <= 2) {
+    program.help();
+    return;
+  }
+  await program.parseAsync(argv);
+}
+
+export { buildManifest, createCli, runCli };