Import packages/plugin/src/owner-peer.ts
This commit is contained in:
parent
e42eaec3b0
commit
6f493acba6
|
|
@ -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
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue