Nexus Uplink Server (Simple) ============================
Last updated 4 years ago by elie.rotenberg .
MIT · Repository · Bugs · Original npm · Tarball
$ cnpm install nexus-uplink-simple-server 
SYNC missed versions from official npm registry.

Nexus Uplink Server (Simple)

Nexus Uplink is an dead-simple, lightweight protocol on top of which Flux over the Wire can be implemented.

On the client side, a Nexus Uplink Client can react to stores updates, and dispatch actions. On the server side, a Nexus Uplink Server can react to actions dispatchs, and update stores.


  • actions are transported via POST requests (url pathname is the action identifier, JSON-encoded body is the payload)
  • updates are transported via Websocket (or Engine.IO fallback) (as diff objects)

This package is a simple (but efficient) implementation of the Nexus Uplink server-side protocol. Also see the isomorphic client implementation of the Nexus Uplink client-side protocol.


On the server:

var server = new UplinkSimpleServer({
  pid: _.guid('pid'),
  // stores, rooms and actions are url patterns whitelists
  stores: ['/ping'],
  rooms: [],
  actions: ['/ping'],
  // pass an express or express-like app
  app: express().use(cors())

var pingCounter = 0;

// setup action handlers
server.actions.on('/ping', function(payload) {
  // guid is a cryptosecure unique user id, automatically maintained
  var guid = payload.guid;
  var remoteDate = payload.localDate;
  var localDate =;
  console.log('client ' + guid + ' pinged.');
  console.log('latency is ' + (localDate - remoteDate) + '.');
  server.update({ path: '/ping', value: { counter: pingCounter }});

On the client:

var client = new Uplink({ url: 'http://localhost' });

// subscribe to remote updates
client.subscribeTo('/ping', function(ping) {
  console.log('ping updated', ping.counter);

// fire-and-forget dispatch actions
setInterval(function() {
  client.dispatch('/ping', { localDate: });
}, 1000);


npm install nexus-uplink-simple-server --save

Maintainers (1)
Today 0
This Week 94
This Month 94
Last Day 94
Last Week 0
Last Month 94
Dependencies (9)
Dev Dependencies (9)
Dependents (1)

Copyright 2014 - 2016 © |