multi-rpc
TypeScript icon, indicating that this package has built-in type declarations

2.5.0 • Public • Published

multi-rpc

NPM

Build Status FOSSA Status

Multi-RPC is a JSON RPC 2 client/server implementation designed with multiple transports and serialization methods in mind. It works both in Node and the browser.

Out of the box it supports serialization with JSON and MessagePack over TCP, HTTP and WebSocket. Writing new serializers and transports is pretty straightforward.

A server can listen on multiple transports which allows for listening using multiple protcols or on multiple interfaces.

Connections via persistent transports like WebSocket or TCP are kept alive and the server can send notifications to clients (a feature which is not offically in the standard).

Example

(async () => {
    const { 
        Server, 
        Client,
        JSONSerializer,
        TCPTransport
    } = require('multi-rpc');

    const serializer = new JSONSerializer();

    const serverTransport = new TCPTransport(serializer, 1234);
    const clientTransport = new TCPTransport(serializer, 1234);

    const server = new Server(serverTransport);
    const client = new Client(clientTransport);

    server.methods.foo = (arg1, arg2, arg3) => {
        console.log(arg1, arg2, arg3);
        return arg1 + arg2 + arg3;
    };

    await server.listen();

    const result1 = await client.invoke("foo", [1,2,3]);
    const result2 = await client.invoke("foo", {
        arg1: 1,
        arg2: 2,
        arg3: 3
    });

    console.log(result1 + result2);

    process.exit();
})();

More examples are available in the wiki.

Projects layout

The Multi-RPC package is comprised of several modules which can be installed individually.

Name Description Browser compatible
multi-rpc-browser Excludes server-side transports
multi-rpc-common Common classes used throughout the project.
multi-rpc-core Server/Client implementation
multi-rpc-http-client-side-transport A HTTP client-side transport
multi-rpc-http-transport A HTTP transport with client/server functionality
multi-rpc-json-serializer A JSON serializer
multi-rpc-msgpack-serializer A MSGPack Serializer
multi-rpc-tcp-transport A TCP transport with client/server functionality
multi-rpc-websocket-client-side-transport A WebSocket client-side transport
multi-rpc-websocket-transport A WebSocket transport with client/server functionality

Tests & Documentation

For mocha tests and documention refer to the individual package (e.g. multi-rpc-common).

Building

Multi-RPC is written in TypeScript. To compile JavaScript run npm run build.

Package Sidebar

Install

npm i multi-rpc

Weekly Downloads

5

Version

2.5.0

License

Apache-2.0

Unpacked Size

30.1 kB

Total Files

8

Last publish

Collaborators

  • znetstar