JSPM

  • Created
  • Published
  • Downloads 996
  • Score
    100M100P100Q6978F
  • License MIT

Modern XMPP in the browser, with a JSON API

Package Exports

  • stanza.io

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (stanza.io) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Stanza.io

Modern XMPP in the browser, with a JSON API.


What is this?

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.

Installing

$ npm install stanza.io

Getting Started

  1. Find or install a server which supports XMPP over WebSocket (Prosody recommended).
  2. Clone this repo with git clone https://github.com/legastero/stanza.io.git
  3. Run npm install in the new stanza.io directory.
  4. Run npm run build to create dist/stanzaio.browser.js.
  5. Open demo.html in your browser.
  6. Enter your connection info, click connect.
  7. Use the JS console to play with the XMPP client (var client).

Echo Client Demo

var XMPP = require('stanza.io');

var client = XMPP.createClient({
    jid: 'echobot@example.com',
    password: 'hunter2',

    // If you have a .well-known/host-meta.json file for your
    // domain, the connection transport config can be skipped.

    transport: 'websocket',
    wsURL: 'wss://example.com:5281/xmpp-websocket'
    // (or `boshURL` if using 'bosh' as the transport)
});

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();

Documentation

Discussion

MUC Room: discuss@stanza.io / Logs

License

MIT

Created By

If you like this, follow @lancestout on twitter.