mqemitter

What is mqemitter?

The 'mqemitter' npm package is a simple message queue emitter that allows you to publish and subscribe to messages. It is designed to be lightweight and easy to use, making it suitable for applications that require basic message queuing and event handling.

What are mqemitter's main functionalities?

Publishing Messages

This feature allows you to publish messages to a specific topic. The code sample demonstrates how to create an instance of MQEmitter and publish a message with a topic and payload.

const MQEmitter = require('mqemitter');
const emitter = MQEmitter();

emitter.emit({ topic: 'myTopic', payload: 'Hello, World!' }, (err) => {
  if (err) {
    console.error('Error publishing message:', err);
  } else {
    console.log('Message published successfully');
  }
});

Subscribing to Messages

This feature allows you to subscribe to messages on a specific topic. The code sample shows how to set up a subscription to a topic and handle incoming messages.

const MQEmitter = require('mqemitter');
const emitter = MQEmitter();

emitter.on('myTopic', (message, cb) => {
  console.log('Received message:', message.payload);
  cb();
});

Unsubscribing from Messages

This feature allows you to unsubscribe from messages on a specific topic. The code sample demonstrates how to remove a previously set up subscription.

const MQEmitter = require('mqemitter');
const emitter = MQEmitter();

const handler = (message, cb) => {
  console.log('Received message:', message.payload);
  cb();
};

emitter.on('myTopic', handler);

// Later, to unsubscribe
emitter.removeListener('myTopic', handler);

Other packages similar to mqemitter

eventemitter3

EventEmitter3 is a high-performance event emitter for Node.js and the browser. It provides a similar publish/subscribe pattern but is more general-purpose and not specifically designed for message queuing.

redis

Redis is an in-memory data structure store that can be used as a message broker. It supports publish/subscribe messaging and offers more advanced features like persistence, clustering, and data structures.

mqtt

MQTT.js is a client library for the MQTT protocol, which is a lightweight messaging protocol designed for IoT. It provides more advanced features for message queuing and is suitable for applications requiring reliable message delivery.

README

mqemitter  

An Opinionated Message Queue with an emitter-style API, but with callbacks.

• Installation
• Basic Example
• API
• Wildcards
• Licence & copyright

Do you need a multi process MQEmitter? Check out mqemitter-redis.

Installation

$ npm install mqemitter --save

Basic Example

var mq = require('mqemitter')
  , emitter = mq({ concurrency: 5 })
  , message

emitter.on('hello world', function(message, cb) {
  // call callback when you are done
  // do not pass any errors, the emitter cannot handle it.
  cb()
})

// topic is mandatory
message = { topic: 'hello world', payload: 'or any other fields' }
emitter.emit(message, function() {
  // emitter will never return an error
})

API

• MQEmitter
• emitter#emit()
• emitter#on()
• emitter#removeListener()
• emitter#close()
• emitter#closed

---

MQEmitter(opts)

MQEmitter is the class and function exposed by this module. It can be created by MQEmitter() or using new MQEmitter().

An MQEmitter accepts the following options:

• concurrency: the maximum number of concurrent messages that can be on concurrent delivery.
• wildcardOne: the char that will match one level wildcards.
• wildcardSome: that char that will match multiple level wildcards.
• separator: the separator for the different levels.

For more information on wildcards, see this explanation or Qlobber.

---

emitter.emit(message, callback())

Emit the given message, which must have a topic property, which can contain wildcards as defined on creation.

---

emitter.on(topic, callback(message, done), [onDone(err)])

Add the given callback to the passed topic. Topic can contain wildcards, as defined on creation. The callback, accept two parameters, the passed message and a done callback.

The callback must never error and done must not be called with an err object.

onDone will be called when the event subscribe is done correctly.

---

emitter.removeListener(topic, callback(message, done), [removeDone(err)])

The inverse of on.

---

emitter.close(callback())

Close the given emitter. After, all writes will return an error.

Wildcards

MQEmitter supports the use of wildcards: every topic is splitted according to separator (default /).

The wildcard character + matches exactly one word:

var mq = require('mqemitter')
  , emitter = mq()

emitter.on('hello/+/world', function(message, cb) {
  // this will print { topic: 'hello/my/world', 'something': 'more' }
  console.log(message)
  cb()
})

emitter.on('hello/+', function(message, cb) {
  // this will not be called
  console.log(message)
  cb()
})

emitter.emit({ topic: 'hello/my/world', something: 'more' })

The wildcard character # matches zero or more words:

var mq = require('mqemitter')
  , emitter = mq()

emitter.on('hello/#', function(message, cb) {
  // this will print { topic: 'hello/my/world', 'something': 'more' }
  console.log(message)
  cb()
})

emitter.on('#', function(message, cb) {
  // this will print { topic: 'hello/my/world', 'something': 'more' }
  console.log(message)
  cb()
})

emitter.on('hello/my/world/#', function(message, cb) {
  // this will print { topic: 'hello/my/world', 'something': 'more' }
  console.log(message)
  cb()
})

emitter.emit({ topic: 'hello/my/world', something: 'more' })

Of course, you can mix # and + in the same subscription.

LICENSE

Copyright (c) 2014, Matteo Collina [e-mail]

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.