angelia.io

WebSockets Server and Client API for node.js and the browser, (with rooms support in development).

The goal of this project is to provide a developer friendly API that just works™.

Installation

Install on node.js/browser npm install angelia.io

If you fancy for Client side a regular JavaScript file, then use https://github.com/titoBouzout/angelia.io/blob/master/client/index.js and include it as a regular script tag.

Simple Example

// server.js (node.js)
import Server from 'angelia.io/server';

class FancyChat {
    async typing(socket, data, callback) {
        console.log('Im', data ? ' typing' : ' not typing')
    }
    async theMessage(socket, data, callback) {
        console.log('the message is', data, socket)
        socket.emit('gotIt', 'thanks')
        callback('yes Im sure')
    }
}

Server.on(FancyChat);

class Connection {
    async connect(socket, request) {
        console.log('socket connected', socket)
    }
    async disconnect(socket, code, message) {
        console.log('socket disconnected', code, message, socket);
    }
}
Server.on(Connection);

Server.listen({
    port: 3001,
});

// index.js (browser)
import Client from 'angelia.io/client';

const socket = new Client('ws://localhost:3001');

socket.emit('typing', true)

setTimeout(() => {
    socket.emit('typing', false)
    socket.emit('theMessage', 'hi there!', (data) =>{
        console.log('you sure?', data)
    })
}, 10000)

socket.on('gotIt', (message) => {
    console.log('Server got it yey', message)
})

Server Documentation (Node.js)

A call to Server.listen starts the server. Server is a singleton and can only have running 1 server.

// server.js (node.js)
import Server from 'angelia.io/server'

Server.listen({
    hostname: 'localhost',
    port: 3001,
    maxMessageSize: 5,
    cert: '/path/to/cert/fullchain.pem',
    key: '/path/to/key/privkey.pem',
})

Server Options

Server Object

The server object can be accessed from everywhere

// server.js (node.js)
import Server from 'angelia.io/server'

class _ {
    connect(socket, request) {
        console.log(this.server, 'also', socket.server)
    }
}
Server.on(_)

Server.listen({
    port: 3001,
})

List of Server Object Properties

Socket Object

The socket object is given to you by a listener

// server.js (node.js)
import Server from 'angelia.io/server'

class _ {
    connect(socket, request) {
        console.log(socket, request)
    }
}
Server.on(_)

Server.listen({
    port: 3001,
})

List of Socket Object Properties

Listeners

To listen for a client message/event you may do the familiar way Server.on('connect', (socket) => {console.log('socket connected!', socket)})

However, to ease organization and development you may listen to an event by creating a class with any name, and give to methods the name of the things you want to listen to. You then add your class to the listeners as Server.on(MyClass); and you are done.

On user defined listeners, the listener receives three things as sent by the client: socket, data and a callback; Example class FancyChat { async typing(socket, data, callback) {console.log(socket, data);}}.

Syntax For Listeners

Listeners have the following alternative syntax if you feel like

Predefined Server Events

There's a bunch of handy predefined events dispatched whenever you add listeners for them.

// server.js (node.js)
import Server from 'angelia.io/server';

class _ {
    async listen() {
        console.log('Server started listening on port ' + this.server.port);
    }
    async connect(socket, request) {
        console.log('a socket connected!', socket)
    }
    ...
}

Server.on(_);

Server.listen({
    port: 3001,
});

List of Predefined Server Events

Client API (Browser)

Client Options

Configurable options used by the constructor

const socket = new Client({
    url: 'ws://localhost:3001',
    params: function () {
        return { fast: 'data', test: 'a space' }
    },
})

You may also do like this if you don't need any option

const socket = new Client('ws://localhost:3001')

Client API

The client API is similar to regular event handling

List of Predefined Client Events

As in socket.on('connect', () => console.log('connect happened!'))

Authors

• Tito Bouzout https://github.com/titoBouzout
• Anthony K. https://github.com/boredofnames

URLs

• https://github.com/titoBouzout/angelia.io
• https://www.npmjs.com/package/angelia.io