Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/naderio/rerpc
an opinionated take on RPC system intended for usage with or without dedicated client library, HTTP request or Socket.IO event.
https://github.com/naderio/rerpc
expressjs http nodejs rpc socket-io
Last synced: about 2 months ago
JSON representation
an opinionated take on RPC system intended for usage with or without dedicated client library, HTTP request or Socket.IO event.
- Host: GitHub
- URL: https://github.com/naderio/rerpc
- Owner: naderio
- License: unlicense
- Created: 2017-10-15T14:30:41.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-01-27T11:40:23.000Z (almost 7 years ago)
- Last Synced: 2024-11-09T16:08:28.506Z (about 2 months ago)
- Topics: expressjs, http, nodejs, rpc, socket-io
- Language: JavaScript
- Homepage:
- Size: 39.1 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
reRPC
=====
`reRPC` is a simplified and flexible RPC system with unified model for client-to-server and server-to-server communication on top of HTTP and/or Socket.IO.
It provides an unified approach to define both a HTTP path and a Socket.IO event handlers as a single async function that can be invoked with a dedicated library.
## Status
[](https://github.com/naderio/rerpc/blob/master/LICENSE.md)
[](https://www.npmjs.com/package/rerpc)
[](https://www.npmjs.com/package/rerpc)
[](https://david-dm.org/naderio/rerpc)
[](https://david-dm.org/naderio/rerpc)
[](https://david-dm.org/naderio/rerpc)
[](https://travis-ci.org/naderio/rerpc)
[](https://www.npmjs.com/package/rerpc)
This library is production-ready.
Please refer to [releases/changelog](https://github.com/naderio/rerpc/releases) and [roadmap](https://github.com/naderio/rerpc/issues/1) for more information.
## Description
`reRPC` enable you to do the following:
- define an async Node.js function (`lib.doSomething = async (payload) => { ... ; return result; };`)
- call the defined function from client by mean of:
- client library (`result = await lib.doSomething(payload);`)
- HTTP request (`POST /rerpc/doSomething` with payload as JSON in body)
- Socket.IO event (`socketio.emit('/rerpc', 'doSomething', payload, (result) => { ... });`)
`reRPC` exposes defined functions by attaching itself to:
- `/rerpc` route on an [Express](https://expressjs.com/) app or route instance
- `/rerpc` event on a [Socket.IO](https://socket.io/) instance
## Goals
- enable writing a function once and call it with dedicated library, HTTP request and/or Socket.IO event
- simplify function invocation interface by mean of `async/await` and ES2015 `Proxy`
- stay simple:
- do not create and manage transport connection, even in frontend
- no middleware, authentication, ...
- delegate customisation code to transport (Express and/or Socket.IO)
- stay flexible:
- enable function to access transport layer
- enable function context augmentation
- enable [payload processing customisation](doc/payload-processing.md)
- enable [error handling customisation](doc/error-handling.md)
- enable [prefix customisation](doc/prefix.md)
## Requirements
`reRPC` makes use of a number of ES2015+ features, most notably `async/await` and `Proxy`. Therefore:
- Node v8+
- Transpiler for browser code
## Usage
Refer to [`doc` folder](./doc) for more documentation.
### Server
```javascript
const express = require('express');
const app = express();
app.use(express.json());
const http = require('http').Server(app);
app.io = require('socket.io')(http);
http.listen(5000);
// initiate
const rerpc = require('rerpc')({});
// define function
async function greet({ name }) {
return `Hello ${name}!`;
}
// register function
rerpc.register({ greet });
// attach to Express app our route, creates '/rerpc' route
rerpc.attachToExpress(app);
// attach to Socket.IO instance, creates '/rerpc' event
app.io.on('connect', soc => rerpc.attachToSocketIO(soc));
```
### Client
#### Using dedicated library
```javascript
const rerpc = require('rerpc/client')({
transport: 'http',
transportHandler: 'http://localhost:5000',
});
// or
const socketio = require('socket.io-client')('http://localhost:5000/');
const rerpc = require('rerpc/client')({
transport: 'socket.io',
transportHandler: socketio,
});
// then
try {
const result = await rerpc.fn.greet({ name: 'World' });
console.log(result); // => "Hello World!"
} catch(error) {
console.error(error);
}
```
#### Using `CURL`
```bash
curl -X POST 'http://localhost:5000/rerpc/greet' -H 'Content-Type: application/json' -d '{"name": "World"}'
# => { "$result": "Hello World!" } OR {" $error": { ... } }
```
#### Using `fetch`
```javascript
const response = await fetch('http://localhost:5000/rerpc/greet', {
method: 'post',
headers: new Headers({ 'Content-Type': 'application/json' }),
body: JSON.stringify({ name: 'World' }),
});
const result = await response.json();
console.log(result); // => { "$result": "Hello World!" } OR { "$error:" { ... } }
```
#### Using Socket.IO
```javascript
const socketio = require('socket.io-client')('http://localhost:5000/');
socketio.emit('/rerpc', 'greet', { name: 'World' }, (result => {
console.log(result); // => { "$result": "Hello World!" } OR { "$error:" { ... } }
});
```
## Code Samples
Refer to [`samples` folder](./samples) for more examples.