tyo-mq


TYO-MQ is a distributed messaging (pub/sub) service with socket.io.


At the moment the message queuing is not implemented yet, which means all messages are sent instantly without confirmation of message delivery or recieving. So message subcriber(s) will need to be online in order to recieve the message.

Installation

npm install tyo-mq

Creating a messaging server

``javascript
var MessageServer = require("tyo-mq").Server;

var mq = new MessageServer();
mq.start();
`

Creating a message producer

`javascript
var Factory = require('tyo-mq').Factory,
producer;

var mq = new Factory();

mq.createProducer('testevent')
.then(function (p) {
producer = p;

// produce a default event with data {data: 'test'}
producer.produce('test text from default event');

// produce a different kind of event
producer.produce('event2', {data: 'test text from event2'})
});
`

Creating a message subscriber

`javascript
var Factory = require('tyo-mq').Factory,
consumer;

var mq = new Factory();

mq.createConsumer()
.then(function (c) {
consumer = c;
consumer.on('connect', function () {
console.log('consumer\'s own connect listenr');
});

// subscribe 'event2'
consumer.subscribe('event2', (data) => {
console.log(data);
});

// subscribe 'testevent'
consumer.subscribe('testevent', (data) => {
console.log(data);
});
});
`

Demo

$3

`javascript


Needs to set up the library (module) path


export NODE_PATH=npm config get prefix/lib/node_modules/
node -e 'require("tyo-mq/server")'
`

$3

`javascript
export NODE_PATH=npm config get prefix/lib/node_modules/
node -e 'require("tyo-mq/test")'
`

Browserify

This package supports being browserified.
In order to browserify, please install two more extra packages:
`
npm install utf-8-validate bufferutil
`

Afterward,
`
browserify web/web.js -o web/client/tyo-mq-client.js
``

TODO list

* implement the message queuing
* message queuing if intended subscriber is down, resend message when it is up
* message delivery for one or some intended subscribers only

Maintainer

Eric Tang @ TYO LAB