omelo-status-plugin

0.0.3 • Public • Published

omelo-status-plugin

omelo-status-plugin is a plugin for omelo, it can be used in omelo(>=0.6).

omelo-status-plugin provides global status service for omelo, which uses persistent storage to save users information.

##Installation

npm install omelo-status-plugin

##Usage

var status = require('omelo-status-plugin');

app.use(status, {status: {
  host: '127.0.0.1',
  port: 6379
}});

##API

###getSidsByUid(uid, cb) get frontend server id by user id ####Arguments

  • uid - user id
  • cb - callback function

####Return

  • err - error
  • list - array of frontend server ids

###getStatusByUid(uid, cb) ####Arguments

  • uid - user id
  • cb - callback function

####Return

  • err - error
  • status - boolean, true if user is online (at least one session with a frontend) or false otherwise

###getStatusByUids(uids, cb) ####Arguments

  • uids - array of user ids
  • cb - callback function

####Return

  • err - error
  • statuses - object with uid as keys and boolean as value, true if user is online (at least one session with a frontend) or false otherwise

###pushByUids(uids, route, msg, cb) ####Arguments

  • uids - array of user ids
  • route - route string
  • msg - messages would be sent to clients
  • cb - callback function

####Return

  • err - error
  • fails - array of failed to send user ids

##Notice

status plugin use redis as a default persistent storage, you can change it with your own implementation.

var status = require('omelo-status-plugin');
var mysqlStatusManager = require('./mysqlStatusManager');

app.use(status, {status: {
  host: '127.0.0.1',
  port: 6379,
  channelManager: mysqlStatusManager
}});

in >=0.0.3 version add cleanOnStartUp option, when you enable this option, status plugin would clean up the old data with the given prefix string.

app.use(status, {status: {
  host: '127.0.0.1',
  port: 6379,
  cleanOnStartUp: true
}});

Package Sidebar

Install

npm i omelo-status-plugin

Weekly Downloads

0

Version

0.0.3

License

none

Unpacked Size

13.8 kB

Total Files

10

Last publish

Collaborators

  • linyngfly