courier.js v0.4.0

#Courier.js

Simple pub-sub for JavaScript.

##Using it

var courier = new Courier();

// subscribing to a message
courier.receive("new-message", function(msg){
  // do something with the message
  ...
});

// sending a new message
// the first parameter is the message identifier
// the second parameter can be anything
// and will just be forwarded to the receiver
courier.send("new-message", {
  your: "message"
});

// to avoid an exeception while sending messages
// not yet defined receivers set throwOnMissing: false
courier.send("new-message", {
  your: "delegation"
}, {throwOnMissing: false});

// you can also subscribe and send with Regular expressions

courier.send(/[Aa]\s(regex)?\ssender/, {
  your: "message"
});

courier.receive(/[Aa]\s(regex)?\sreceiver/, function(msg){
  ...
});

###Unsubscribe

Courier allows you to unsubscribe to any message with the given receiver returned function, like so:

var unsubscribe = courier.receive("one-time-receiver", function(msg){
  // do something and unsubscribe
  unsubscribe() // this will notofy courier to remove this hook
});