JSON-RPC lite

Parse and Serialize JSON-RPC2 messages in node.js or browser.

Inspired by https://github.com/soggie/jsonrpc-serializer

A implementation of JSON-RPC 2.0 specifications

Install

1npm install jsonrpc-lite

API

1const jsonrpc = require('jsonrpc-lite')

jsonrpc.request(id, method[, params])

Creates a JSON-RPC 2.0 request object, return JsonRpc object.

• id: {String|Integer}
• method: {String}
• params: {Object|Array}, optional

1const requestObj = jsonrpc.request('123', 'update', {list: [1, 2, 3]})
2// {
3//   jsonrpc: '2.0',
4//   id: '123',
5//   method: 'update',
6//   params: {list: [1, 2, 3]}
7// }

jsonrpc.notification(method[, params])

Creates a JSON-RPC 2.0 notification object, return JsonRpc object.

• method: {String}
• params: {Object|Array}, optional

1const notificationObj = jsonrpc.notification('update', {list: [1, 2, 3]})
2// {
3//   jsonrpc: '2.0',
4//   method: 'update',
5//   params: {list: [1, 2, 3]}
6// }

jsonrpc.success(id, result)

Creates a JSON-RPC 2.0 success response object, return JsonRpc object.

• id: {String|Integer}
• result: {Mixed}

1const successObj = jsonrpc.success('123', 'OK')
2// {
3//   jsonrpc: '2.0',
4//   id: '123',
5//   result: 'OK',
6// }

jsonrpc.error(id, error)

Creates a JSON-RPC 2.0 error response object, return JsonRpc object.

• id: {String|Integer}
• error: {JsonRpcError}

1const errorObj = jsonrpc.error('123', new jsonrpc.JsonRpcError('some error', 99))
2// {
3//   jsonrpc: '2.0',
4//   id: '123',
5//   error: {code: 99, 'message': 'some error'},
6// }

jsonrpc.parse(message)

Takes a JSON-RPC 2.0 payload (string) and tries to parse it into a JSON. If successful, determine what object is it (response, notification, success, error, or invalid), and return it's type and properly formatted object.

• message: {String}

return an array, or an object of this format:

single parsed request:

1{
2  type: 'request',
3  payload: {
4    jsonrpc: '2.0',
5    id: 123,
6    method: 'update',
7    params: {}
8  }
9}

batch parsed result:

1[{
2  type: 'request',
3  payload: {
4    jsonrpc: '2.0',
5    id: '123',
6    method: 'update',
7    params: [1, 2, 3]
8  }
9}, {
10  type: 'notification',
11  payload: {
12    jsonrpc: '2.0',
13    method: 'update',
14    params: {_id: 'xxx'}
15  }
16}, {
17  type: 'success',
18  payload: {
19    jsonrpc: '2.0',
20    id: '123',
21    result: 'OK'
22  }
23}, {
24  type: 'error',
25  payload: {
26    jsonrpc: '2.0',
27    id: '123',
28    error: [jsonrpc.JsonRpcError object]
29  }
30}, {
31  type: 'invalid',
32  payload: [jsonrpc.JsonRpcError object]
33}]

jsonrpc.parseObject(message)

Takes a JSON-RPC 2.0 payload (Object) and tries to parse it into a JSON. If successful, determine what object is it (response, notification, success, error, or invalid), and return it's type and properly formatted object.

• message: {Object}

return an JsonRpcParsed object with type and payload.

Class: jsonrpc.JsonRpc()

Class: jsonrpc.JsonRpcError(message, code[, data])

Create a JsonRpcError instance.

• message: {String}
• code: {Integer}
• data: {Mixed} optional

1const error = new jsonrpc.JsonRpcError('some error', 999)

Class Method: jsonrpc.JsonRpcError.invalidRequest([data])

Class Method: jsonrpc.JsonRpcError.methodNotFound([data])

Class Method: jsonrpc.JsonRpcError.invalidParams([data])

Class Method: jsonrpc.JsonRpcError.internalError([data])

Class Method: jsonrpc.JsonRpcError.parseError([data])