Bun 适配器（s200/bun）

在 Bun.serve 上服务应用。

serve(app, options?) → BunServer

import { serve } from 's200/bun';
const server = serve(app, { port: 3000 });   // 同步 —— Bun.serve 是同步的
console.log(server.url);                      // http://localhost:3000
await server.close();

BunServeOptions：

字段	默认	含义
port	0	监听端口
hostname	—	主机名
websocket	—	s200/websocket/bun 的桥：{ upgrade, websocket } —— upgrade 在 fetch handler 内决定请求是否升级为 WebSocket（先运行应用 + 路由中间件链；拒绝中间件的 Response 以普通 HTTP 应答）；websocket 半边携带每连接回调

BunServer：

字段	含义
url / port	绑定地址
server	原始 Bun.serve 句柄（BunServedServer）：stop(closeActiveConnections?) —— stop(false) 等待在途请求，stop()/stop(true) 强制关闭。这是 s200/lifecycle 鸭子类型化的优雅排空面
close()	stop(true) —— 同时丢弃在途连接，因此 close() 立即 resolve

注意：Bun 在客户端断开时不会可靠中止 request.signal，因此适配器不做 socket 级断线接线（不同于 Node 适配器的 abortOnDisconnect）—— 该 Bun 版本随请求提供的 signal 仍会接入 ctx.signal。onFinish 回调因此改由响应体承载：只要注册了回调，适配器就包装 body —— 其 cancel（客户端离开 → { aborted: true }）或完成（{ aborted: false }）恰好触发一次；未注册回调的响应不做包装。

供 serveStatic 注入的文件系统函数

由 Bun.file 支撑 —— 与 Node 适配器相同的注入面（见 s200/node）：

函数	签名	含义
createFileReader(root, { stream?, realPath?, streamThreshold? })	(path) => Promise<Uint8Array | ReadableStream | null>	默认 Bun.file 字节，并带 Node 适配器同款安全默认：realpath 包含性检查开启（realPath: false 关闭）、目录（含符号链接指向的目录）按未命中处理、超过 streamThreshold（默认 16 MiB）的文件流式返回；{ stream: true } 一律流式
createFileStat(root)	(path) => Promise<StaticFileInfo | null>	statSync 的 size + mtimeMs，用于条件请求；与 createFileReader 相同的 realpath 包含性检查与目录拒绝
createFileRangeReader(root)	(path, start, end) => Promise<ReadableStream | null>	Bun.file(...).slice(start, end).stream()；与 createFileReader 相同的 realpath 包含性检查与目录拒绝
createRealPathGuard(root)	(path) => Promise<string | null>	经 realpathSync 的符号链接逃逸守卫 —— 与 s200/node 相同的契约与共享算法：仅逃逸的真实路径（或无法解析的 root）返回 null，命中与普通未命中都返回解析出的路径

三个工厂函数都默认应用该守卫，root 内指向别处的符号链接在普通读取、stat 与 Range 请求上同样被拒绝。null 只保留给逃逸：仅仅不存在的查找返回其解析出的（不存在的）路径，serveStatic 的目录重定向/SPA 回退因此仍可执行。createFileReader(root, { realPath: false }) 可关闭普通读取器的守卫。