/**
 * 给妙搭沙箱外壳提供统一的 health endpoint。
 *
 * 协议（飞书文档 - 妙搭应用 Health Check 接口规范，对齐
 * `@lark-apaas/coding-preset-vite-react` 的 healthMiddlewarePlugin）：
 *   - HTTP connection refused / timeout → dev server 没起来 → 外壳重启沙箱
 *   - 200 + { ready: true }             → 应用已就绪
 *   - 200 + { ready: false }            → 还在启动
 *
 * 不归本接口管：
 *   - compile error / runtime error / 资源加载失败 → 浏览器侧自己上报
 */
export declare const HEALTH_ENDPOINT = "/dev/health";
/**
 * dev server 底层 http(s) server 的最小结构（http.Server / https.Server 均满足）
 */
export interface ListenableServer {
    listening: boolean;
    once(event: 'listening', listener: () => void): unknown;
}
interface HealthCheckMiddlewareOptions {
    /**
     * dev server 的 http server；不传视为已就绪。
     *
     * 外部假设：@rspack/dev-server（webpack-dev-server v5 系排序）在
     * setupMiddlewares 回调时 createServer() 已执行，devServer.server 可用且未
     * listening。若宿主 dev-server 实现排序不同导致拿不到 server，则退化为
     * ready 恒 true——请求只有 listen 后才进得来，协议语义仍成立。
     */
    httpServer?: ListenableServer | null;
}
export declare function registerHealthCheckMiddleware(serverApp: any, options?: HealthCheckMiddlewareOptions): void;
export {};