43 lines
1.5 KiB
TypeScript
43 lines
1.5 KiB
TypeScript
|
// server.mjs 的 TS 声明面（NodeNext 自动拾取）：实现刻意保持纯 JS（零依赖、不进 TS
|
|||
|
|
// 构建链），类型契约在此钉死。行类型是 RouteManifestRoute 的结构超集容忍面——
|
|||
|
|
// @sf/contracts 的 RouteManifest 可直接传入（字段窄化兼容）。
|
|||
|
|
import type { AddressInfo } from 'node:net'
|
|||
|
|
import type { Server } from 'node:http'
|
|||
|
|
|
|||
|
|
export interface PreviewRouteRow {
|
|||
|
|
exact_key: string
|
|||
|
|
query_policy: string
|
|||
|
|
query_key?: string | null
|
|||
|
|
kind: string
|
|||
|
|
target_file?: string
|
|||
|
|
status: number
|
|||
|
|
location?: string
|
|||
|
|
content_type?: string
|
|||
|
|
indexable: boolean
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface PreviewManifestLike {
|
|||
|
|
routes: PreviewRouteRow[]
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface PreviewServerOptions {
|
|||
|
|
/** 构建产物目录（<artifactsRoot>/jobs/<jobId>/dist） */
|
|||
|
|
distDir: string
|
|||
|
|
/** §12.1 route-manifest（已解析对象——预览只读不加载路径） */
|
|||
|
|
routeManifest: PreviewManifestLike
|
|||
|
|
/** 绑定地址；仅 127.0.0.1 / localhost（缺省 127.0.0.1）——外值构造即拒 */
|
|||
|
|
host?: string
|
|||
|
|
/** 监听端口（缺省 4173；0 = 随机可用端口） */
|
|||
|
|
port?: number
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface PreviewServerHandle {
|
|||
|
|
server: Server
|
|||
|
|
/** 开始监听；resolve 值 = server.address()（port=0 时含实际端口） */
|
|||
|
|
start(): Promise<AddressInfo>
|
|||
|
|
/** 关停（destroy 连接后 close——防 keep-alive 套接字吊住） */
|
|||
|
|
stop(): Promise<void>
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export declare function createPreviewServer(options: PreviewServerOptions): PreviewServerHandle
|