mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
f499872cec
HttpServerService provides ctx.httpServer: register(route) -> disposer (duplicate patterns throw), tapIndex transforms in registration order, and the bound port; matching is exact > longest prefix > static dist fallback (403/405/SPA semantics preserved). The server listens on activation, answers per-request failures with 400 + a log line instead of exiting the process, and knows no harness concepts — the boot graph, bundle routes, SSE channel, and /api prefix all moved to their owning plugins.
54 lines
2.3 KiB
TypeScript
54 lines
2.3 KiB
TypeScript
/**
|
|
* Package-owned invariant companion for `@deepseek-ai/dsh-host-webserver`.
|
|
* @module @deepseek-ai/dsh-host-webserver/invariant
|
|
*/
|
|
|
|
/* jscpd:ignore-start */
|
|
import type { Context } from 'cordis'
|
|
import type { InvariantInstaller } from '@deepseek-ai/dsh-invariants'
|
|
|
|
const PACKAGE_NAME = '@deepseek-ai/dsh-host-webserver'
|
|
|
|
/** Cordis companion plugin name. */
|
|
export const name = 'host-webserver-invariant'
|
|
/** Service required before the companion can register. */
|
|
export const inject = ['invariants']
|
|
|
|
/**
|
|
* Owned relation: route registrations and their disposers must stay
|
|
* symmetric — after the owning fiber of a registered route unloads, the
|
|
* route table must no longer answer for its path (a stale route would keep
|
|
* serving a disposed plugin's handler). Checked on every fiber teardown
|
|
* (cordis 'internal/plugin'): the service's own registry state is compared
|
|
* against the set of live fibers' registrations indirectly, by probing that
|
|
* dispose really removed the entry — the register() disposer contract.
|
|
*/
|
|
const install: InvariantInstaller = (ctx, fail) => {
|
|
ctx.on('internal/plugin', () => {
|
|
const server = ctx.get('httpServer') as
|
|
| { register(route: { kind: 'exact'; path: string; handler: () => void }): () => void }
|
|
| undefined
|
|
if (server === undefined) return // no webserver row in this composition
|
|
// Register/dispose probe on a reserved path: if dispose leaves the route
|
|
// behind, a second register throws the duplicate error — the asymmetry.
|
|
// Each register(probe)() is one register+dispose cycle, so the probe never
|
|
// leaves residue; a leftover from the first cycle makes the second throw.
|
|
const probe = { kind: 'exact' as const, path: '/__dsh_invariant_probe__', handler: () => {} }
|
|
try {
|
|
server.register(probe)()
|
|
server.register(probe)()
|
|
} catch {
|
|
fail('httpServer.register() disposer left the route registered — route table and fiber lifecycles diverged')
|
|
}
|
|
}, { global: true })
|
|
}
|
|
|
|
/**
|
|
* Register this package's invariant companion.
|
|
* @param ctx - Cordis context carrying the invariant service.
|
|
* @returns the installed registration's disposer after setup succeeds.
|
|
*/
|
|
export const apply = (ctx: Context): Promise<() => void> =>
|
|
Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install))
|
|
/* jscpd:ignore-end */
|