xmppify 0.0.12

data/app/assets/javascripts/xmpp/strophejs-plugins/ping/README.markdown

@@ -0,0 +1,28 @@
+# Strophe.ping.js
+
+Strophe.ping.js is a plugin to provide XMPP Ping
+( [ XEP-0199 ]( http://xmpp.org/extensions/xep-0199.html ) ).
+
+## Usage
+
+After you connected sucessfully to the XMPP server you can send a ping to a XMPP
+client or server:
+
+    connection.ping.ping( "serviceJID@server.org", success, error, timeout );
+
+You can also add a ping handler to receive pings:
+
+    connection.ping.addPingHandler( handler );
+
+Within your ping handler function you surely want to reply with a pong iq:
+
+    handler = function( ping ){
+      ...
+      connection.ping.pong( ping );
+      ...
+	  return true;
+    }
+
+## ToDo
+
+- write specs

data/app/assets/javascripts/xmpp/strophejs-plugins/ping/strophe.ping.js

@@ -0,0 +1,68 @@
+/*
+ * This plugin is distributed under the terms of the MIT licence.
+ * Please see the LICENCE file for details.
+ *
+ * Copyright (c) Markus Kohlhase, 2010
+ * Refactored by Pavel Lang, 2011
+ */
+
+/**
+ * File: strophe.ping.js
+ * A Strophe plugin for XMPP Ping ( http://xmpp.org/extensions/xep-0199.html )
+ */
+
+Strophe.addConnectionPlugin('ping', {
+	_c: null,
+
+	// called by the Strophe.Connection constructor
+	init: function(conn)
+	{
+		this._c = conn;
+		Strophe.addNamespace('PING', "urn:xmpp:ping");
+	},
+
+	/**
+	 * Function: ping
+	 *
+	 * Parameters:
+	 * (String) to - The JID you want to ping
+	 * (Function) success - Callback function on success
+	 * (Function) error - Callback function on error
+	 * (Integer) timeout - Timeout in milliseconds
+	 */
+	ping: function(jid, success, error, timeout)
+	{
+		var id = this._c.getUniqueId('ping');
+		var iq = $iq({type: 'get', to: jid, id: id}).c(
+				'ping', {xmlns: Strophe.NS.PING});
+		this._c.sendIQ(iq, success, error, timeout);
+	},
+
+	/**
+	 * Function: pong
+	 *
+	 * Parameters:
+	 * (Object) ping - The ping stanza from the server 
+	 */
+	pong: function(ping)
+	{
+		var from = ping.getAttribute('from');
+		var id = ping.getAttribute('id');
+		var iq = $iq({type: 'result', to: from,	id: id});
+		this._c.sendIQ(iq);
+	},
+
+	/**
+	 * Function: addPingHandler
+	 *
+	 * Parameters:
+	 * (Function) handler - Ping handler
+	 *
+	 * Returns:
+	 * A reference to the handler that can be used to remove it.
+	 */
+	addPingHandler: function(handler)
+	{
+		return this._c.addHandler(handler, Strophe.NS.PING, "iq", "get");
+	}
+});

data/app/assets/javascripts/xmpp/strophejs-plugins/private/README.markdown

@@ -0,0 +1,16 @@
+# Strophe.private.js
+
+Strophe.private.js is a plugin for the XMPP library [Strophe.js](http://code.stanziq.com/strophe) 
+to provide XMPP Private XML Storage ( XEP-0049 ).
+
+Strophe.private.js is licensed under the MIT license.
+
+## Usage
+
+After you connected successfully to the XMPP server you can save your data:
+
+    connection.private.set( myTagName, myNamespace, myData, success, error );
+
+Receive your data by specifing the tag name and the namespace:
+
+    conncection.private.get( myTagName, myNamespace, success, error );

data/app/assets/javascripts/xmpp/strophejs-plugins/private/strophe.private.js

@@ -0,0 +1,192 @@
+/**
+ * This plugin is distributed under the terms of the MIT licence.
+ * Please see the LICENCE file for details.
+ * Copyright (c) Markus Kohlhase, 2011
+ */
+
+/**
+* File: strophe.private.js
+* A Strophe plugin for XMPP Private XML Storage ( http://xmpp.org/extensions/xep-0049.html )
+*/
+
+Strophe.addConnectionPlugin('private',
+{
+  _connection: null,
+
+  // called by the Strophe.Connection constructor
+
+  init: function( conn ){
+
+    this._connection = conn;
+    Strophe.addNamespace( 'PRIVATE', "jabber:iq:private" );
+  },
+
+  /**
+   * Function: set
+   *
+   * Parameters:
+   * (String) tag - the tag name
+   * (String) ns  - the namespace
+   * (XML) data   - the data you want to save
+   * (Function) success - Callback function on success
+   * (Function) error - Callback function on error
+   */
+
+  set: function( tag, ns, data, success, error ){
+
+    var id = this._connection.getUniqueId('saveXML');
+
+    var iq = $iq({ type:'set', id: id })
+      .c('query', { xmlns: Strophe.NS.PRIVATE } )
+      .c( tag, { xmlns: ns } );
+
+      var d = this._transformData( data );
+
+      if( d ){
+        iq.cnode( d );
+      };
+
+    this._connection.sendIQ( iq, success, error );
+
+  },
+
+  /**
+   * Function: get
+   *
+   * Parameters:
+   * (String) tag - the tag name
+   * (String) ns  - the namespace
+   * (Function) success - Callback function on success
+   * (Function) error - Callback function on error
+   */
+
+  get: function( tag, ns, success, error ){
+
+    var id = this._connection.getUniqueId('loadXML');
+
+    var iq = $iq({ type:'get', id: id })
+      .c('query', { xmlns: Strophe.NS.PRIVATE } )
+      .c(tag, { xmlns: ns } );
+
+    this._connection.sendIQ( iq, function( iq ){
+
+      var data = iq;
+
+      for( var i=0; i<3; i++ ){
+        data = data.childNodes[0];
+        if( !data ){
+          break;
+        }
+      }
+
+      success( data, iq );
+
+    }, error );
+
+  },
+
+  /**
+   * PrivateFunction: _transformData
+   */
+  _transformData: function( c ){
+
+    switch( typeof( c ) ){
+
+      case "number":
+      case "boolean": return Strophe.xmlTextNode( c + '' );
+
+      case "string":
+
+        var dom = this._textToXml( c );
+
+        if( dom !== null ){
+          return dom
+        } else {
+          return Strophe.xmlTextNode( c + '' );
+        }
+
+      case "object":
+
+      if( this._isNode(c) || this._isElement(c) ){
+        return c;
+      }
+    }
+    return null;
+  },
+
+   /**
+   * PrivateFunction: _textToXml
+   *
+   * Parameters:
+   * (String) text  - XML String
+   *
+   * Returns:
+   * (Object) dom - DOM Object
+   */
+
+  _textToXml: function( text ){
+
+    var doc = null;
+
+    if( window.DOMParser ){
+      var parser = new DOMParser();
+      doc = parser.parseFromString( text, 'text/xml');
+    } else if( window.ActiveXObject ){
+      doc = new ActiveXObject("MSXML2.DOMDocument");
+      doc.async = false;
+      doc.loadXML(text);
+    } else{
+      throw{
+        type: 'Parse error',
+        message: "No DOM parser object found."
+      };
+    }
+
+    var error = doc.getElementsByTagName("parsererror");
+
+    if( error.length > 0 ){
+      return null;
+    }
+
+    var node = document.importNode( doc.documentElement, true );
+    return node;
+  },
+    /**
+   * PrivateFunction: _isNode
+   *
+   * Parameters:
+   * ( Object ) obj - The object to test
+   *
+   * Returns:
+   * True if it is a DOM node
+   */
+
+  _isNode: function( obj ){
+
+      if( typeof( Node ) === "object" ){
+        return ( obj instanceof Node );
+      }else{
+        return ( typeof( obj ) === "object" && typeof( obj.nodeType ) === "number" && typeof( obj.nodeName ) === "string");
+      }
+  },
+
+  /**
+   * PrivateFunction: _isElement
+   *
+   * Parameters:
+   * ( Object ) obj - The object to test
+   *
+   * Returns:
+   * True if it is a DOM element.
+   */
+
+  _isElement: function( obj ){
+
+    if( typeof( HTMLElement ) === "object"){
+      return ( obj instanceof HTMLElement ); //DOM2
+    } else{
+      return ( typeof( obj ) === "object" && obj.nodeType === 1 && typeof( obj.nodeName ) === "string" );
+    }
+  }
+
+});