Runtime API

mokup/runtime 是路由匹配与响应处理的核心。

createRuntime

使用场景：

• 在自定义运行时或测试环境中直接调用 runtime.handle。
• 需要在非 Hono 环境中运行 mock（SSR、Worker、集成测试）。

示例：

import { createRuntime } from 'mokup/runtime'

const runtime = createRuntime({ manifest })
const result = await runtime.handle({
  method: 'GET',
  path: '/users',
  query: {},
  headers: {},
  body: undefined,
})

直接使用 CLI bundle

可直接加载 CLI 生成的 bundle：

使用场景：

• 在生产或受限运行时中复用预构建 bundle。
• 多个部署共享同一份构建产物。

示例：

pnpm

pnpm exec mokup build --dir mock --out .mokup

npm

npm exec mokup build --dir mock --out .mokup

yarn

yarn mokup build --dir mock --out .mokup

bun

bunx mokup build --dir mock --out .mokup

import { createRuntime } from 'mokup/runtime'
import mokupBundle from './.mokup/mokup.bundle.mjs'

const runtime = createRuntime({
  manifest: mokupBundle.manifest,
  moduleMap: mokupBundle.moduleMap,
  moduleBase: mokupBundle.moduleBase,
})

如果没有打包函数处理器，可以省略 moduleMap 与 moduleBase。

createRuntimeApp

根据 manifest 构建 Hono app（适用于 Service Worker 或自定义 fetch 处理）。

使用场景：

• 在 Worker / Service Worker 中使用 Hono 风格的 fetch 入口。
• 在任意支持 Hono 的运行时复用 Mokup 路由。

示例：

import { createRuntimeApp } from 'mokup/runtime'

const app = await createRuntimeApp({ manifest })
const response = await app.fetch(new Request('http://localhost/api/users'))

Service Worker helper

mokup/runtime 也会导出 hono/service-worker 的 handle。

使用场景：

• 在 Service Worker 的 fetch 事件中挂载 Hono app。
• 用最少的胶水代码运行 Mokup。

示例：

import { createRuntimeApp, handle } from 'mokup/runtime'

const app = await createRuntimeApp({ manifest })
globalThis.addEventListener('fetch', handle(app))

RuntimeOptions

使用场景：

• 延迟加载 manifest（按需读取或动态 import）。
• Worker 等无法直接 import 本地文件时传入 moduleMap/moduleBase。

export interface RuntimeOptions {
  manifest: Manifest | (() => Promise<Manifest>)
  moduleBase?: string | URL
  moduleMap?: Record<string, Record<string, unknown>>
}

moduleMap 用于 Worker 等无法动态 import 本地文件的场景，通常由 mokup.bundle.mjs 生成。

示例：

import type { RuntimeOptions } from 'mokup/runtime'
import mokupBundle from './.mokup/mokup.bundle.mjs'

const options: RuntimeOptions = {
  manifest: mokupBundle.manifest,
  moduleMap: mokupBundle.moduleMap,
  moduleBase: mokupBundle.moduleBase,
}