Import packages/plugin/src/owner-peer.ts

This commit is contained in:
QQ 2026-11-14 14:56:36 +08:00
parent e42eaec3b0
commit 6f493acba6
1 changed files with 73 additions and 0 deletions

View File

@ -0,0 +1,73 @@
/**
* Owner Peer resolution for the Remote Host carrier.
*
* Harness 0.2.2 dereferences the calling Peer for every local Gateway stream
* (`peer.signal`, `peer.principal`, `peer.interactions`) and rejects forwarded
* event opens without a live Peer. The plugin therefore always attaches one to
* its local carrier, preferring the official `Peer` export and falling back to
* the Connection Host service when a build's module shape no longer exposes it.
*/
/** Structural owner Peer used by the switch and per-connection bridges. */
export interface OwnerPeerLike {
dispose?(): unknown
}
/** Official Connection Host face that can mint in-process owner Peers. */
export interface OwnerPeerServiceLike {
createPeer?(options: { principal: { kind: 'owner' }; interactions?: 'answer' | 'none' }): OwnerPeerLike
}
/** One official `Peer` constructor, or a compatible predecessor export. */
export type OwnerPeerConstructor = new (ctx: unknown, options: {
principal: { kind: 'owner' }
interactions?: 'answer' | 'none'
}) => OwnerPeerLike
/**
* Select the official `Peer` export of the installed Connection package.
* @param connectionExports - module namespace of `@deepseek-ai/dsh-client-connection`.
* @returns the constructor, or undefined when this build exposes neither name.
*/
export function ownerPeerConstructor(
connectionExports: Record<string, unknown>,
): OwnerPeerConstructor | undefined {
const candidate = typeof connectionExports.Peer === 'function'
? connectionExports.Peer
: connectionExports.OperatorPeer
return typeof candidate === 'function' ? candidate as OwnerPeerConstructor : undefined
}
/**
* Create a factory that mints owner Peers for the calling plugin.
*
* A factory is returned even when neither mechanism is available; it then
* resolves `undefined` and the local carrier reports an actionable peerless
* failure instead of a `TypeError` from the official Gateway.
* @param ctx - plugin Context that owns Peer-backed effects.
* @param constructor - official Peer constructor when exported by this build.
* @param connection - official Connection Host service, when composed.
* @returns the owner Peer factory.
*/
export function createOwnerPeerFactory(
ctx: unknown,
constructor: OwnerPeerConstructor | undefined,
connection: OwnerPeerServiceLike | undefined,
): () => OwnerPeerLike | undefined {
return () => {
if (constructor !== undefined) {
try {
return new constructor(ctx, { principal: { kind: 'owner' }, interactions: 'answer' })
} catch {
// Fall through to the Connection Host service below.
}
}
const createPeer = connection?.createPeer
if (typeof createPeer !== 'function') return undefined
try {
return createPeer.call(connection, { principal: { kind: 'owner' }, interactions: 'answer' })
} catch {
return undefined
}
}
}