node package manager

Socket.IO bindings for CompoundJS


npm install co-socket --save

then add co-socket to config/autoload.js


Add routes to config/routes.js

map.socket('some-event', 'controller#action');

When client emit event some-event, then action action of controller controller will gain control. Data passed to the event will be available as params variable. Calling send will call the callback to the current socket.

Available methods in any controller

action('some-action', function () {
    socket().emit('event', {some: 'data'}); // send 'event' to all clients in current session
    socket(anotherSessionID).emit('hello'); // send 'hello' to another user
                                            // identifyed by anotherSessionID

    var clients = socketClients();          // list of current session clients
    clients.forEach(function (client) {
        client.join('room');                // current session clients join a room

    // List of clients in another session
    var anotherSessionClients = socketClients(anotherSessionID);

Any controller action (both socket and non-socket) can emit some event with any client.

Responding to the current request

Server side:


action('join', function () {
    send({ foo: 'bar' });

Client side:

socket.emit('join', {}, function (data) {
    console.log(; // bar

Inner structure

All connections automatically join a room named after the compound sessionID. If you want to communicate with another user you can specify their sessionID as param for both socket or socketClients method.