Mercurial > eldonilo > lightstring
view lightstring.js @ 12:9fbd0e3678b5
add comments, jsdoc syntax + move the parser and the serializer to the Lightstring namespace so they don't get recreated at every new Lightstring.Connection
author | Sonny Piers <sonny.piers@gmail.com> |
---|---|
date | Sun, 15 Jan 2012 03:47:28 +0100 |
parents | 24bc40461b2c |
children | 9aeb0750b9d1 |
line wrap: on
line source
'use strict'; /** Copyright (c) 2011, Sonny Piers <sonny at fastmail dot net> Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ /** * @namespace No code from lightstring should be callable outside this namespace/scope. */ var Lightstring = { /** * @namespace Holds XMPP namespaces. * */ NS: {}, /** * @namespace Holds XMPP stanza builders. * */ stanza: {}, /** * @private */ parser: new DOMParser(), /** * @private */ serializer: new XMLSerializer(), /** * @function Transforms a XML string to a DOM object. * @param {String} aString XML string * @returns {Object} Domified XML. */ xml2dom: function(aString) { return this.parser.parseFromString(aString, 'text/xml').documentElement; }, /** * @function Transforms a DOM object to a XML string. * @param {Object} aString DOM object * @returns {String} Stringified DOM. */ dom2xml: function(aElement) { return this.serializer.serializeToString(aElement); }, }; /** * @constructor Creates a new Lightstring connection * @param {String} [aService] The Websocket service URL. * @memberOf Lightstring */ Lightstring.Connection = function (aService) { if(aService) this.service = aService; this.handlers = {}; this.iqid = 1024; this.getNewId = function() { this.iqid++; return 'sendiq:'+this.iqid; }; /** * @function Create and open a websocket then go though the XMPP authentification process. * @param {String} [aJid] The JID (Jabber id) to use. * @param {String} [aPassword] The associated password. */ this.connect = function(aJid, aPassword) { this.emit('connecting'); if(aJid) this.jid = aJid; if(this.jid) { this.domain = this.jid.split('@')[1]; this.node = this.jid.split('@')[0]; this.resource = this.jid.split('/')[1]; } if(aPassword) this.password = aPassword; if(!this.jid) throw "Lightstring: Connection.jid is undefined."; if(!this.password) throw "Lightstring: Connection.password is undefined."; if(!this.service) throw "Lightstring: Connection.service is undefined."; //"Bug 695635 - tracking bug: unprefix WebSockets" https://bugzil.la/695635 try { this.socket = new WebSocket(this.service, 'xmpp'); } catch(error) { this.socket = new MozWebSocket(this.service, 'xmpp'); } var that = this; this.socket.addEventListener('open', function() { if(this.protocol !== 'xmpp') throw "Lightstring: The server located at "+that.service+" is not XMPP aware."; //FIXME no ending "/" - node-xmpp-bosh bug var stream = "<stream:stream to='"+that.domain+"'\ xmlns='jabber:client'\ xmlns:stream='http://etherx.jabber.org/streams'\ version='1.0'/>"; that.socket.send(stream) that.emit('XMLOutput', stream); }); this.socket.addEventListener('error', function(e) { that.emit('error', e.data); }); this.socket.addEventListener('close', function(e) { that.emit('disconnected', e.data); }); this.socket.addEventListener('message', function(e) { that.emit('XMLInput', e.data); var elm = Lightstring.xml2dom(e.data); that.emit('DOMInput', elm); that.emit(elm.tagName, elm); if(elm.tagName === 'iq') that.emit(elm.getAttribute('id'), elm); }); }; /** * @function Send a message. * @param {String|Object} aStanza The message to send. * @param {Function} [aCallback] A callback that will be called when the answer will answer. */ this.send = function(aStanza, aCallback) { if(typeof aStanza === 'string') { var str = aStanza; var elm = Lightstring.xml2dom(str); } else if(aStanza instanceof Element) { var elm = aStanza; var str = this.dom2xml(elm); } else { that.emit('error', 'Unsupported data type.'); } if(elm.tagName === 'iq') { var id = elm.getAttribute('id'); if(!id) { elm.setAttribute('id', this.getNewId()) str = Lightstring.dom2xml(elm) } if(aCallback) this.on(elm.getAttribute('id'), aCallback); } else if(aCallback) { that.emit('warning', 'Callback can\'t be called with non-iq stanza.'); } this.socket.send(str); this.emit('XMLOutput', str); this.emit('DOMOutput', elm); }; /** * @function Close the XMPP stream and the socket. */ this.disconnect = function() { this.emit('disconnecting'); this.send('</stream:stream>'); this.socket.close(); }; /** * @function Emit an event. * @param {String} aName The event name. * @param {Function|Array|Object} [aData] Data about the event. */ this.emit = function(aName, aData) { var handlers = this.handlers[aName]; if(!handlers) return; //FIXME Better idea than passing the context as argument? for(var i=0; i<handlers.length; i++) handlers[i](aData, this); if(aName.match('sendiq:')) delete this.handlers[aName]; }; /** * @function Register an event handler. * @param {String} aName The event name. * @param {Function} aCallback The callback to call when the event is emitted. */ this.on = function(aName, callback) { if(!this.handlers[aName]) this.handlers[aName] = []; this.handlers[aName].push(callback); }; //FIXME do this! //~ this.once = function(name, callback) { //~ if(!this.handlers[name]) //~ this.handlers[name] = []; //~ this.handlers[name].push(callback); //~ }; this.on('stream:features', function(stanza, that) { var nodes = stanza.querySelectorAll('mechanism'); //SASL/Auth features if(nodes.length > 0) { that.emit('mechanisms', stanza); var mechanisms = {}; for(var i=0; i<nodes.length; i++) mechanisms[nodes[i].textContent] = true; //FIXME support SCRAM-SHA1 && allow specify method preferences if('DIGEST-MD5' in mechanisms) that.send( "<auth xmlns='urn:ietf:params:xml:ns:xmpp-sasl'\ mechanism='DIGEST-MD5'/>" ); else if('PLAIN' in mechanisms) { var token = btoa( that.jid + "\u0000" + that.jid.node + "\u0000" + that.password ); that.send( "<auth xmlns='urn:ietf:params:xml:ns:xmpp-sasl'\ mechanism='PLAIN'>"+token+"</auth>" ); } } //XMPP features else { that.emit('features', stanza); //Bind http://xmpp.org/rfcs/rfc3920.html#bind that.send( "<iq type='set' xmlns='jabber:client'>\ <bind xmlns='urn:ietf:params:xml:ns:xmpp-bind'/>\ </iq>", function() { //Session http://xmpp.org/rfcs/rfc3921.html#session that.send( "<iq type='set' xmlns='jabber:client'>\ <session xmlns='urn:ietf:params:xml:ns:xmpp-session'/>\ </iq>", function() { that.emit('connected'); } ); }); } }); this.on('success', function(stanza, that) { that.send( "<stream:stream to='"+that.domain+"'\ xmlns='jabber:client'\ xmlns:stream='http://etherx.jabber.org/streams'\ version='1.0' />" ); }); this.on('failure', function(stanza, that) { that.emit('conn-error', stanza.firstChild.tagName); }); this.on('challenge', function(stanza, that) { //FIXME this is mostly Strophe code function _quote(str) { return '"' + str.replace(/\\/g, "\\\\").replace(/"/g, '\\"') + '"'; }; var challenge = atob(stanza.textContent); var attribMatch = /([a-z]+)=("[^"]+"|[^,"]+)(?:,|$)/; var cnonce = MD5.hexdigest(Math.random() * 1234567890); var realm = ""; var host = null; var nonce = ""; var qop = ""; var matches; while (challenge.match(attribMatch)) { matches = challenge.match(attribMatch); challenge = challenge.replace(matches[0], ""); matches[2] = matches[2].replace(/^"(.+)"$/, "$1"); switch (matches[1]) { case "realm": realm = matches[2]; break; case "nonce": nonce = matches[2]; break; case "qop": qop = matches[2]; break; case "host": host = matches[2]; break; } } var digest_uri = "xmpp/" + that.domain; if (host !== null) { digest_uri = digest_uri + "/" + host; } var A1 = MD5.hash(that.node + ":" + realm + ":" + that.password) + ":" + nonce + ":" + cnonce; var A2 = 'AUTHENTICATE:' + digest_uri; var responseText = ""; responseText += 'username=' + _quote(that.node) + ','; responseText += 'realm=' + _quote(realm) + ','; responseText += 'nonce=' + _quote(nonce) + ','; responseText += 'cnonce=' + _quote(cnonce) + ','; responseText += 'nc="00000001",'; responseText += 'qop="auth",'; responseText += 'digest-uri=' + _quote(digest_uri) + ','; responseText += 'response=' + _quote( MD5.hexdigest(MD5.hexdigest(A1) + ":" + nonce + ":00000001:" + cnonce + ":auth:" + MD5.hexdigest(A2))) + ','; responseText += 'charset="utf-8"'; that.send( "<response xmlns='urn:ietf:params:xml:ns:xmpp-sasl'>" +btoa(responseText)+ "</response>"); }); };