/** Node half: registers the /api prefix route bridging to the api gateway. */ import { EventEmitter, once } from 'node:events' import { createServer, request as httpRequest } from 'node:http' import { PassThrough, Readable } from 'node:stream' import { Context } from 'cordis' import { describe, expect, it } from 'vitest' import type { AddressInfo } from 'node:net' import type { IncomingMessage, ServerResponse } from 'node:http' import type { ApiProxy } from '@deepseek-ai/dsh-host-apiproxy/api' import type { HttpServerService, WebRoute, WebUpgradeRoute } from '@deepseek-ai/dsh-host-webserver' import { API_PATH, apply, HOST_EVENTS_PATH, inject, MUX_EVENTS_PATH } from '../src/index.ts' /** Structural httpServer fake recording both route registries. */ function fakeHttpServer( routes: WebRoute[], upgrades: WebUpgradeRoute[], ): Pick { return { register(route) { routes.push(route) return () => { routes.splice(routes.indexOf(route), 1) } }, registerUpgrade(route) { upgrades.push(route) return () => { upgrades.splice(upgrades.indexOf(route), 1) } }, tapIndex: () => () => {}, port: 0, } } /** Bodyless GET carrying the given headers (enough for the trust fence + bridge). */ function fakeRequest(headers: Record, url = `${API_PATH}/session.list`): IncomingMessage { const request = Readable.from([]) as unknown as IncomingMessage Object.assign(request, { url, method: 'GET', headers }) return request } /** Response recorder compatible with both the fence's short-circuit and the bridge. */ function fakeResponse(): { response: ServerResponse; state: { status?: number; body?: unknown } } { const state: { status?: number; body?: unknown } = {} const response = Object.assign(new EventEmitter(), { writableEnded: false, writeHead(value: number) { state.status = value; return this }, write() { return true }, end(this: { writableEnded: boolean }, value?: unknown) { if (value !== undefined) state.body = value this.writableEnded = true return this }, }) as unknown as ServerResponse return { response, state } } async function mounted(config?: { trustedHosts?: string[] }): Promise<{ routes: WebRoute[] upgrades: WebUpgradeRoute[] dispose: () => Promise }> { const ctx = new Context() const routes: WebRoute[] = [] const upgrades: WebUpgradeRoute[] = [] ctx.provide('httpServer', fakeHttpServer(routes, upgrades) as HttpServerService) ctx.provide('apiProxy', {} as unknown as ApiProxy) const fiber = ctx.plugin({ inject: [...inject], apply }, config) await fiber.await() return { routes, upgrades, dispose: () => fiber.dispose() } } describe('connection node half', () => { it('fails the load on a trustedHosts entry that is not a bare authority', async () => { const routes: WebRoute[] = [] const upgrades: WebUpgradeRoute[] = [] const ctx = new Context() ctx.provide('httpServer', fakeHttpServer(routes, upgrades) as HttpServerService) ctx.provide('apiProxy', {} as unknown as ApiProxy) const fiber = ctx.plugin({ inject: [...inject], apply }, { trustedHosts: ['harness.internal/path'] }) await expect(fiber).rejects.toThrow(/not a bare host\[:port\] authority/) expect(routes).toHaveLength(0) expect(upgrades).toHaveLength(0) }) it('registers one HTTP route plus one upgrade route per downlink and removes all three with the fiber', async () => { const { routes, upgrades, dispose } = await mounted() expect(routes).toHaveLength(1) expect(routes[0]).toMatchObject({ kind: 'prefix', path: API_PATH }) expect(upgrades.map(route => route.path)).toEqual([MUX_EVENTS_PATH, HOST_EVENTS_PATH]) await dispose() expect(routes).toHaveLength(0) expect(upgrades).toHaveLength(0) }) it('requires WebSocket upgrade for network GETs to either event path', async () => { const { routes, dispose } = await mounted() for (const path of [MUX_EVENTS_PATH, HOST_EVENTS_PATH]) { const { response, state } = fakeResponse() await routes[0]!.handler(fakeRequest({ host: '127.0.0.1:3080' }, path), response) expect(state.status).toBe(426) expect(state.body).toBe('upgrade required') } await dispose() }) it('rejects an untrusted WebSocket upgrade before protocol negotiation', async () => { const { upgrades, dispose } = await mounted() const socket = new PassThrough() const chunks: Buffer[] = [] socket.on('data', (chunk: Buffer) => { chunks.push(chunk) }) const ended = once(socket, 'end') await upgrades[0]!.handler(fakeRequest({ host: 'harness.example', origin: 'http://harness.example', 'sec-fetch-site': 'same-origin', }, MUX_EVENTS_PATH), socket, Buffer.alloc(0)) await ended expect(Buffer.concat(chunks).toString()).toContain('HTTP/1.1 403 Forbidden') await dispose() }) it('refuses an untrusted Host on any /api path before the bridge runs', async () => { const { routes, dispose } = await mounted() const { response, state } = fakeResponse() await routes[0]!.handler(fakeRequest({ host: 'harness.example', origin: 'http://harness.example', 'sec-fetch-site': 'same-origin', }), response) expect(state.status).toBe(403) expect(state.body).toBe('forbidden') await dispose() }) it('pins privileged methods to loopback even for a declared trusted authority', async () => { const { routes, dispose } = await mounted({ trustedHosts: ['harness.example'] }) // The privileged set: native dialogs plus the whole settings/credential // configuration plane, reads included. The same declared authority reaches // ordinary reads (carrier-level 404 from the empty proxy proves the fence // passed), but each privileged method stays loopback-only and 403s. for (const method of [ 'host.pickDirectory', 'host.openPath', 'settings.describe', 'settings.openDocument', 'settings.update', 'settings.replace', 'settings.mutate', 'credentials.describe', 'credentials.set', 'credentials.unset', ]) { const denied = fakeResponse() await routes[0]!.handler( fakeRequest({ host: 'harness.example' }, `${API_PATH}/${method}`), denied.response, ) expect(denied.state.status).toBe(403) expect(denied.state.body).toBe('forbidden') } const read = fakeResponse() await routes[0]!.handler(fakeRequest({ host: 'harness.example' }), read.response) expect(read.state.status).not.toBe(403) await dispose() }) it('passes loopback and declared-authority requests through to the bridge', async () => { const { routes, dispose } = await mounted({ trustedHosts: ['harness.example:3080', '192.168.1.5'] }) // Loopback, no browser markers (curl shape): the fence passes; the carrier // answers 404 for a GET unary path — proof the bridge ran. const loopback = fakeResponse() await routes[0]!.handler(fakeRequest({ host: '127.0.0.1:3080' }), loopback.response) expect(loopback.state.status).toBe(404) // LAN authority declared as a port-less IP literal — the shape the CLI // derives for `--host 0.0.0.0` — passes markerless curl on any port. const lan = fakeResponse() await routes[0]!.handler(fakeRequest({ host: '192.168.1.5:3080' }), lan.response) expect(lan.state.status).toBe(404) // Declared public authority, same-origin browser shape. const declared = fakeResponse() await routes[0]!.handler(fakeRequest({ host: 'harness.example:3080', origin: 'http://harness.example:3080', 'sec-fetch-site': 'same-origin', }), declared.response) expect(declared.state.status).toBe(404) await dispose() }) }) describe('connection node half over a real HTTP server', () => { /** Serve the registered prefix route from a real server and return its port. */ async function serve(routes: WebRoute[]): Promise<{ port: number; close: () => Promise }> { const server = createServer((request, response) => { void routes[0]!.handler(request, response) }) await new Promise(resolve => server.listen(0, '127.0.0.1', resolve)) const address = server.address() as AddressInfo return { port: address.port, close: () => new Promise((resolve, reject) => { server.close((error) => { if (error === undefined || error === null) resolve() else reject(error) }) }), } } /** One real request; `host` spoofs the authority the way a LAN client's browser would send it. */ function call(port: number, method: string, host: string): Promise { return new Promise((resolve, reject) => { const request = httpRequest( { host: '127.0.0.1', port, path: `${API_PATH}/${method}`, method: 'GET', headers: { host } }, (response) => { response.resume() response.on('end', () => { resolve(response.statusCode ?? 0) }) }, ) request.on('error', reject) request.end() }) } it('answers a declared LAN authority with 403 on every configuration method, over real HTTP', async () => { // The fence's input is a real IncomingMessage parsed by Node from the // wire, not a hand-assembled object: the Host header a LAN browser sends // is exactly what decides loopback-only here, so the boundary is asserted // against the parse the server actually performs. const { routes, dispose } = await mounted({ trustedHosts: ['harness.example'] }) const { port, close } = await serve(routes) try { // Reads are as privileged as writes: describe returns the exposed // configuration, and credentials.describe probes arbitrary env-var names. for (const method of [ 'settings.describe', 'settings.openDocument', 'settings.update', 'settings.replace', 'settings.mutate', 'credentials.describe', 'credentials.set', 'credentials.unset', 'host.pickDirectory', 'host.openPath', ]) { expect([method, await call(port, method, 'harness.example')]).toEqual([method, 403]) } // The model catalog stays reachable for the same authority: a LAN // client's model picker needs it, and it carries no key or endpoint // state (404 is the empty proxy's carrier answer — the fence passed). for (const method of ['llm.providers', 'llm.models']) { expect([method, await call(port, method, 'harness.example')]).toEqual([method, 404]) } // Loopback reaches everything, configuration included. expect(await call(port, 'settings.describe', `127.0.0.1:${String(port)}`)).toBe(404) } finally { await close() await dispose() } }) })