Interface KeysProxy

Per-domain proxy for keys.* envelopes.

Shape: dispatch routes napplet→shell requests into the runtime; emit pushes shell→napplet envelopes through the iframe's Window.

interface KeysProxy {
dispatch(windowId: string, envelope: NappletMessage): void;
emit(windowId: string, envelope: NappletMessage): void;
}

Index

Methods

Methods

dispatch

dispatch(windowId: string, envelope: NappletMessage): void
Route a napplet-originated keys.* envelope (e.g. keys.forward, keys.registerAction) into the runtime.
Parameters
- windowId: string
  The source napplet's windowId
- envelope: NappletMessage
  The NIP-5D NappletMessage envelope
Returns void
- Defined in packages/shell/src/keys-proxy.ts:59

emit

emit(windowId: string, envelope: NappletMessage): void
Push a shell-initiated keys-domain envelope (e.g. keys.action, keys.bindings) into a napplet iframe.

Paired with keys-forwarder.ts: the forwarder targets the DOM keydown → keys.forward path; this emit covers the complementary host-initiated pushes (binding updates, action triggers).

No-op when the originRegistry cannot resolve the windowId (unknown or unregistered napplet). Never throws.
Parameters
- windowId: string
  The target napplet's windowId
- envelope: NappletMessage
  The NIP-5D NappletMessage envelope to deliver
Returns void
- Defined in packages/shell/src/keys-proxy.ts:74