imccyu
ec601ca13d
Machine-produced by `pnpm run rescope-vendor --apply` plus the regeneration it prints: `pnpm install` for the lockfile, `pnpm run gen-third-party-notices`, `verify-translation-pairing --write` for the touched bilingual pairs, `gen-doc-graphs`, and one typert snapshot whose ids embed character offsets. `pnpm run rescope-vendor --check` verifies the result. Renames nine vendored packages (cordis, cosmokit, schemastery and the six @cordisjs plugins) and every reference that resolves them: manifest names and dependency keys, module specifiers including declare-module merges, cordis.yml plugin names, tsconfig paths, every Markdown fence, and `docs/` prose. Directory names, upstream versions, and dependency ranges are unchanged, so vendor/README.md still reads as an upstream snapshot; its manifest table gains an upstream-name column so THIRD_PARTY_NOTICES keeps MIT attribution pointed at each fork's origin. The tutorial tier follows the rename end to end: its yaml fences named plugins the Loader can no longer resolve, its `ts ignore-check` fences disagreed with the compiled fences beside them, and its prose quoted both. The contracts that told readers to keep upstream names — the root convention and the vendoring cookbook's tree comment and manifest invariant — now say to rescope instead. Two rules read `@deepseek-ai/` as "another workspace plugin": the client bundle purity gate now names the vendored libraries a browser bundle inlines, and the files where a bare `cordis` is an agent-preset id keep that product data.
60 lines
2.6 KiB
TypeScript
60 lines
2.6 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 '@deepseek-ai/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: HTTP and upgrade 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
|
|
registerUpgrade(route: { 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)()
|
|
const upgradeProbe = { path: '/__dsh_invariant_upgrade_probe__', handler: () => {} }
|
|
server.registerUpgrade(upgradeProbe)()
|
|
server.registerUpgrade(upgradeProbe)()
|
|
} catch {
|
|
fail('httpServer route disposer left a route registered — route tables 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 */
|