@jashkasoft/nestjs-rpc v0.0.1

NestJS JSON RPC package

Implemented JSON RPC specification

How to use:

• import module RpcModule, example

        RpcModule.forRoot({
            path: '/rpc', // path to RPC
        })

• every request to RPC is POST method and response status = 200

• create rpc handler

import { IRpcHandler, RpcHandler } from '../src/rpc/rpc-explorer';
import { RpcId, RpcPayload, RpcVersion, RpcMethod } from '../src/rpc/decorators';

@RpcHandler({
    method: 'test',
})
export class TestHandler implements IRpcHandler<Payload> {
    public async invoke(
        @RpcPayload() payload: Payload,
        @RpcVersion() version: string,
        @RpcId() id: number | string,
        @RpcMethod() method: string
    ) {
        return payload;
    }
}

• add TestHandler to providers array

How to use
Example simple request to handler:
request --> curl -X POST "http://localhost:3002/rpc" -H "accept: application/json" -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "example", "params": 2}'
response <-- {"jsonrpc":"2.0","result":2,"id":null}

Batch requests
request --> curl -X POST "http://localhost:3002/rpc" -H "accept: application/json" -H "Content-Type: application/json" -d '[{"jsonrpc": "2.0", "method": "example", "params": 2}, { "jsonrpc": "2.0", "method": "test" }]'
response <-- [{"jsonrpc":"2.0","result":2,"id":null}]

Fields description

However, you don't have an access to the native response object in Exception filters, Interceptors and Guards (as in the HTTP app).
Because RPCModule in rpc batch request collect responses from handlers and if you using response you override headers or send response in some handlers. Maybe, you can receive errors, for example headers already sent.