Modern XMPP in the browser, with a JSON API.

Stanza.io is a library for using modern XMPP in the browser, and it does that by exposing everything as JSON. Unless you insist, you have no need to ever see or touch any XML when using stanza.io.

Starting with v4.0.0, stanza.io is using the protocol specified in the latest XMPP over WebSocket draft by default, which contains backwards incompatible changes.

Servers have started switching to using the latest protocol; notably, Prosody's WebSocket module for prosody-0.10. If your server has not yet been upgraded, you can set transports to ['old-websocket'] in the config:

var oldws = XMPP.createClient({
    ...
    transports: ['old-websocket']
});

$ npm install stanza.io

$ grunt

The bundled and minified files will be in the generated build directory.

1. Find or install a server which supports XMPP over WebSocket (Prosody recommended).
2. Run grunt to build build/stanzaio.bundle.js
3. Open demo.html in your browser
4. Enter your connection info, click connect.
5. Use the JS console to play with the XMPP client (var client).

If you want to see stanza.io in action in a full-featured client, take a look at Otalk.im (and its source).

var XMPP = require('stanza.io'); // if using browserify

var client = XMPP.createClient({
    jid: '[email protected]',
    password: 'hunter2'
});

client.on('session:started', function () {
    client.getRoster();
    client.sendPresence();
});

client.on('chat', function (msg) {
    client.sendMessage({
      to: msg.from,
      body: 'You sent: ' + msg.body
    });
});

client.connect();

• API Reference
• Supported XEPs

MIT

If you like this, follow @lancestout on twitter.