Tianyi Cui
a2d0f7f411
Apply the accepted pre-release package, service, type, directory, and role renames as one repository-wide change.
67 lines
2.6 KiB
TypeScript
67 lines
2.6 KiB
TypeScript
/** Test-owned Remote face: `$on` subscriptions driven by the internal forwarded-event plumbing. */
|
|
import type { Context } from '@deepseek-ai/cordis'
|
|
|
|
/**
|
|
* Remote service test double for the forwarded-event path. Feature specs need
|
|
* `ctx.remote.$on` to exist (their plugins inject `remote`) and need forwarded
|
|
* host events to reach those subscribers, but not the generated namespaces or
|
|
* the wire — so this double implements subscription and dispatch only.
|
|
*
|
|
* Dispatch is driven the same way production drives it: `client/runtime` owns the
|
|
* host frame sink and hands each decoded `host/remote-event` frame to
|
|
* `$dispatch`. A spec therefore exercises its refresh chains by calling
|
|
* `$dispatch(name, args)` on this double.
|
|
*
|
|
* `$mount` rejects: a spec that reaches a generated namespace through this
|
|
* double has outgrown it and needs the real Client Remote service.
|
|
*
|
|
* One deliberate asymmetry with production: a throwing listener propagates out
|
|
* of the emit instead of being contained and logged, so a spec cannot lean on
|
|
* this double for the containment guarantee `$on` documents — assert that
|
|
* against the real service.
|
|
*/
|
|
export class TestRemote {
|
|
private readonly subscriptions = new Map<string, Set<(...args: never[]) => void>>()
|
|
|
|
/**
|
|
* Register the double as `ctx.remote`.
|
|
* @param ctx - the spec's root Context.
|
|
*/
|
|
constructor(ctx: Context) {
|
|
ctx.provide('remote', this)
|
|
}
|
|
|
|
/**
|
|
* Deliver one forwarded host event to its subscribers, standing in for the
|
|
* carrier that owns the frame sink.
|
|
* @param event - forwarded host event name.
|
|
* @param args - the Host argument list, verbatim.
|
|
*/
|
|
$dispatch(event: string, args: readonly unknown[]): void {
|
|
const listeners = this.subscriptions.get(event)
|
|
if (listeners === undefined) return
|
|
for (const listener of [...listeners]) listener(...args as never[])
|
|
}
|
|
|
|
/**
|
|
* Subscribe to one forwarded host event.
|
|
* @param event - forwarded host event name.
|
|
* @param listener - receives the Host argument list verbatim.
|
|
* @returns disposer removing this subscription.
|
|
*/
|
|
$on(event: string, listener: (...args: never[]) => void): () => void {
|
|
const listeners = this.subscriptions.get(event) ?? new Set()
|
|
this.subscriptions.set(event, listeners)
|
|
listeners.add(listener)
|
|
return () => { listeners.delete(listener) }
|
|
}
|
|
|
|
/**
|
|
* Generated-namespace mount, unsupported by this double.
|
|
* @returns never; always rejects.
|
|
*/
|
|
$mount(): Promise<() => Promise<void>> {
|
|
return Promise.reject(new Error('TestRemote: $mount needs the real Client Remote service'))
|
|
}
|
|
}
|