Rust-like JSON-RPC for TypeScript
npm install @hazae41/jsonrpcRust-like JSON-RPC for TypeScript
``bash`
npm install @hazae41/jsonrpc
`bash`
deno install jsr:@hazae41/jsonrpc
- Specification compliantUsage
$3
tsx
import { RpcCounter, RpcResponse } from "@hazae41/jsonrpc"/**
* Assign an incremental id to a request
*/
const counter = new RpcCounter()
const request = counter.prepare({ method: "hello_world", params: ["hello"] })
/**
* JSON-stringify and send the request using your preferred transport
*/
const body = JSON.stringify(request)
const headers = { "Content-Type": "application/json" }
const res = await fetch("https://example.com", { method: "POST", body, headers })
/**
* JSON-parse the response and unwrap it
*/
const response = RpcResponse.from(await res.json()) // RpcOk | RpcErr
const data = response.unwrap() // string
console.log(data) // "world"
`$3
tsx
import { RpcRequestInit, RpcRequestPreinit, RpcResponse, RpcMethodNotFoundError, RpcInvalidParamsError } from "@hazae41/jsonrpc"/**
* Handle JSON requests and return a JSON response
*/
function onMessage(message: string): string {
const request = JSON.parse(message) as RpcRequestInit
const response = RpcResponse.rewrap(request.id, onRequest(request))
return JSON.stringify(response)
}
/**
* Route requests and return a result
*/
function onRequest(request: RpcRequestPreinit): Result {
if (request.method === "hello_world")
return onHelloWorld(request)
return new Err(new RpcMethodNotFoundError())
}
/**
* Handle "hello_world" requests
*/
function onHelloWorld(request: RpcRequestPreinit): Result {
const [hello] = (request as RpcRequestPreinit<[string]>).params
if (hello === "hello")
return new Ok("world")
return new Err(new RpcInvalidParamsError())
}
``