RPC for Pear
npm install pear-rpc
const RPC = require('pear-rpc')
import RPC from 'pear-rpc'
Accepts a transport stream and creates an instance that can handle both incoming Remote Procedure Calls (RPCs) and generates corresponding instance methods for outgoing RPCs.
Options
-
stream
<Duplex>
- the transport stream -
methods
<Array... String|{ name: <String>, stream: <Boolean(false)>, send: <Boolean(false)> }>
- an index of method descriptions. The order of methods (and their settings) must be consistent across all RPC instances using the same method set. The index of a method in the array is that methods uint identifier.['myMethod']
and[{name: 'myMethod'}]
are equivalent. Generated methods default to being request-based (stream:false
andsend:false
). Settingsend: true
will generate a fire-and-forget method. Settingstream: true
will generate a method that returns a [Streamx][https://github.com/mafintosh/streamx] stream response. For more complex cases, theapi
option can be used to wrap define the instance method. -
api
{ [name]: (method) => (params) => <Stream|Promise|Any> }
- Define outgoing methods on the RPC instance. Property names on theapi
object matching names in themethods
array will be used to generate instance methods if provided. A tiny-buffer-rpcmethod
object will be passed. Call any/all ofmethod.request
method.send
ormethod.createRequestStream
and make any other calls or alterations as needed. -
handlers
-{ [name]: (params) => <Stream|Promise|Any> }
- Handle incoming calls. Property names on thehandlers
object matching names in themethods
array passed the incomingparams
object. It is up to the handler to return the correct response for that method.
Apache-2.0