npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

xmpp-ftw

v2.0.0

Published

XMPP-FTW (For the Web/Win) ::: Powerful XMPP, simple JSON

Downloads

240

Readme

XMPP-FTW (For The Web/Win)

The goal of this project is to make XMPP really simple to use for developers. This module takes away all of the XML and works by hooking to events which are passed between client and server using a transport in JSON. In the example code we use socket.io, but there is no reason this can not be replaced with engine.io, or implement your own transport and pass in as a connection.

Try it out...

The code is now up and running at http://xmpp-ftw.org so you can try it out. Be aware that this setup is only for trying xmpp-ftw out and may be slow as we need to go client ↔ heroku (east coast US) ↔ your XMPP server and back each time.

  • http://xmpp-ftw.org/manual -- XMPP-FTW manual
  • http://xmpp-ftw.org/demo -- Awesome demo tool, generated from manual
  • http://xmpp-ftw.org/chat -- Old chat client, no longer updated

The version running on the website matches 'master' branch here and auto-deploys with commits.

Also check out the xmpp-ftw-demo repository which is what http://xmpp-ftw.org is running.

Blog posts/Talks

  • http://blog.superfeedr.com/easy-xmpp-ftw/
  • XMPP-FTW XMPP and JSON for the Web
  • http://www.evilprofessor.co.uk/615-xmpp-ftw-now-supports-superfeedr/
  • XMPP-FTW now supports SuperFeedr
  • http://www.evilprofessor.co.uk/573-talking-at-the-first-xmppuk-event-march-2013/
  • Talking at the first XMPPUK event (March 2013)
  • http://www.evilprofessor.co.uk/562-new-demo-system-for-xmpp-ftw/
  • How the demo client works
  • http://www.evilprofessor.co.uk/579-xmpp-for-the-web-xmpp-ftw/
  • Introduction to XMPP-FTW

Badges!

Build Status

Dependency Status

Coverage Status

Known Vulnerabilities

Instructions

  • npm i xmpp-ftw
  • Create your socket.io connection manually and then pass this socket into the constructor
io.sockets.on('connection', function(socket) {
     new require('xmpp-ftw').Xmpp(socket);       
});
  • All events are prefixed with 'xmpp.'

Logging

Logging is handled using a Winston like interface but by default does not record any logging (uses a null logger). Developers can inject any logging platform they wish provided it uses the same interface as Winston. In order to inject a logger simply call setLogger on the main XMPP-FTW object after instantiation.

Methods used in XMPP-FTW projects are:

  • log()
  • warn()
  • info()
  • error()

Server-side

If you want to run xmpp-ftw server side (e.g. to write a bot) then this should be a good starting point:

var xmppFtw = require('xmpp-ftw')
var Emitter = require('events').EventEmitter

var Socket = function() {
    this.server = new Emitter()
    this.client = new Emitter()
    var self = this
    this.server.send = function(event, data, rsm, callback) {
        self.client.emit(event, data, rsm, callback)
    }
    this.client.send = function(event, data, callback) {
        self.server.emit(event, data, callback)
    }
}
Socket.prototype.on = function(event, data, rsm) {
    this.server.on(event, data, rsm)
}
Socket.prototype.send = function(event, data, callback) {
    this.server.send(event, data, callback)
}
Socket.prototype.removeAllListeners = function(event) {
    this.server.removeAllListeners(event)
}

var socket = new Socket()
var client = new xmppFtw.Xmpp(socket)
socket.client.on('xmpp.connection', function (data) {
    console.log('Connected', data)
})
socket.client.on('xmpp.error', function (error) {
    console.log('error', error)
})
socket.client.on('xmpp.error.client', function (error) {
    console.log('client error', error)
})
socket.client.send('xmpp.login', { login: 'detiails', here: true })
socket.client.send(
    'xmpp.chat.message',
    {
        to: '[email protected]',
        content: 'Hello world'
    },
    function (error, data) { console.log(error, data) }
)

License

License is Apache 2.0, please let me know if this doesn't suit.

See also...

  • Strophe http://strophe.im/
  • Stanza.io https://github.com/legastero/stanza.io