rjr 0.12.2 → 0.15.1

data/site/jrw.js

@@ -0,0 +1,297 @@
+/* Json-Rpc over HTTP and Websockets
+ *
+ *  Copyright (C) 2013 Mohammed Morsi <mo@morsi.org>
+ *  Licensed under the Apache License, Version 2.0
+ */
+
+///////////////////////////////////////////////////////
+// Helpers to generate a uuid
+function S4() {
+  return (((1+Math.random())*0x10000)|0).toString(16).substring(1);
+}
+function guid() {
+  return (S4()+S4()+"-"+S4()+"-"+S4()+"-"+S4()+"-"+S4()+S4()+S4());
+}
+
+///////////////////////////////////////////////////////
+// JRMessage
+
+// Encapsulates a json-rpc message
+function JRMessage(){
+  this.id = null;
+  this.rpc_method = null;
+  this.args = null;
+
+  this.data = null;
+  this.json = null;
+
+  this.error = null;
+  this.result = null;
+
+  this.onresponse = null;
+  this.success   = null;
+
+  this.to_json = function(){
+    this.json = $.toJSON(this.data);
+    return this.json;
+  }
+
+  this.handle_response = function(res){
+    res.success = (res.error == undefined);
+    if(this.onresponse)
+      this.onresponse(res);
+  }
+}
+
+// Create new request message to send
+JRMessage.new_request = function(rpc_method, args){
+  var msg = new JRMessage();
+  msg.id = guid();
+  msg.rpc_method = rpc_method;
+  msg.args = args;
+  msg.data = {jsonrpc:  '2.0',
+              method: msg.rpc_method,
+              params: msg.args,
+              id: msg.id};
+  return msg;
+}
+
+// Internal helper to generate request from common args.
+//
+// rpc method, parameter list, and optional response callback
+// will be extracted from the 'args' param in that order.
+//
+// node_id and headers will be set on request message before it
+// is returned
+JRMessage.pretty_request = function(args, node_id, headers){
+  // create request message
+  var rpc_method = args[0];
+  var params = [];
+  var cb = null;
+  for(a = 1; a < args.length; a++){
+      if(a == args.length - 1 && typeof args[a] === 'function')
+        cb = args[a];
+      else
+        params.push(args[a]);
+  }
+  var req = JRMessage.new_request(rpc_method, params);
+  if(node_id) req.data['node_id'] = node_id;
+  for(var header in headers)
+    req.data[header] = headers[header];
+
+  // register callback if last argument is a function
+  if(cb) req.onresponse = cb;
+
+  return req;
+}
+
+// Parse message received in json string
+JRMessage.from_msg = function(dat){
+  var msg = new JRMessage();
+  msg.json = dat;
+  msg.data = $.evalJSON(dat);
+
+  msg.id     = msg.data['id'];
+  msg.rpc_method = msg.data['method'];
+  if(msg.data['params']){
+    msg.params = msg.data['params'];
+    for(p=0;p<msg.params.length;++p){
+      if(JRObject.is_jrobject(msg.params[p]))
+        msg.params[p] = JRObject.from_json(msg.params[p]);
+      else if(JRObject.is_jrobject_array(msg.params[p]))
+        msg.params[p] = JRObject.from_json_array(msg.params[p]);
+    }
+  }
+  msg.error  = msg.data['error'];
+  msg.result = msg.data['result'];
+  if(msg.result && JRObject.is_jrobject(msg.result))
+    msg.result = JRObject.from_json(msg.result);
+  else if(JRObject.is_jrobject_array(msg.result))
+    msg.result = JRObject.from_json_array(msg.result);
+  return msg;
+}
+
+///////////////////////////////////////////////////////
+// JRObject
+
+// Encapsulates an object w/ type
+//  - adaptor for the ruby 'json' library
+function JRObject (type, value, ignore_properties){
+  this.type  = type;
+  this.value = value;
+  this.ignore_properties = (typeof(ignore_properties) != 'undefined') ?
+                            ignore_properties : ["toJSON"];
+  this.toJSON = function(){
+     var data = {};
+     for(p in this.value)
+       if($.inArray(p, this.ignore_properties) == -1)
+         data[p] = value[p];
+     return {json_class: this.type, data: data };
+  };
+};
+
+// Return boolean indicating if json contains encapsulated JRObject
+JRObject.is_jrobject = function(json){
+  return json && json['json_class'] && json['data'];
+};
+
+// Return boolean indicating if json contains array of encapsulated JRObjects
+JRObject.is_jrobject_array = function(json){
+  return json && typeof(json) == "object" && json.length > 0 && JRObject.is_jrobject(json[0]);
+};
+
+// Convert json to JRObject
+JRObject.from_json = function(json){
+  var obj = json['data'];
+  obj.json_class = json['json_class'];
+  for(var p in obj){
+    if(JRObject.is_jrobject(obj[p]))
+      obj[p] = JRObject.from_json(obj[p]);
+    else if(JRObject.is_jrobject_array(obj[p])){
+      obj[p] = JRObject.from_json_array(obj[p]);
+   }
+  }
+  return obj;
+};
+
+// Convert json to array of JRObjects
+JRObject.from_json_array = function(json){
+  var objs = [];
+  for(var i in json)
+    if(JRObject.is_jrobject(json[i]))
+      objs[i] = JRObject.from_json(json[i]);
+  return objs;
+};
+
+///////////////////////////////////////////////////////
+// WSNode
+
+// Main json-rpc client websocket interface
+function WSNode (host, port){
+  var node      = this;
+  this.opened   = false;
+  this.node_id  = null;
+  this.headers  = {};
+  this.messages = {};
+
+  // Open socket connection
+  this.open = function(){
+    node.socket = new WebSocket("ws://" + host + ":" + port);
+
+    node.socket.onclose   = function (){
+      if(node.onclose)
+        node.onclose();
+    };
+
+    node.socket.onmessage = function (evnt){
+      var msg = JRMessage.from_msg(evnt.data);
+
+      // match response w/ outstanding request
+      if(msg.id){
+        var req = node.messages[msg.id];
+        delete node.messages[msg.id];
+        req.handle_response(msg)
+
+        // if err msg, run node.onerror
+        if(msg.error)
+          if(node.onerror)
+            node.onerror(msg)
+
+      }else{
+        // relying on clients to handle notifications via message_received
+        // TODO add notification (and request?) handler support here
+        //node.invoke_method(msg.rpc_method, msg.params)
+        if(node.message_received)
+          node.message_received(msg);
+
+      }
+    };
+
+    node.socket.onerror = function(e){
+      if(node.onerror)
+        node.onerror(e);
+    }
+
+    node.socket.onopen = function (){
+      // send queued messages
+      for(var m in node.messages)
+        node.socket.send(node.messages[m].to_json());
+
+      node.opened = true;
+
+      // invoke client callback
+      if(node.onopen)
+        node.onopen();
+    };
+  };
+
+  // Close socket connection
+  this.close = function(){
+    this.socket.close();
+  };
+
+  // Invoke request on socket, may be invoked before or after socket is opened.
+  //
+  // Pass in the rpc method, arguments to invoke method with, and optional callback
+  // to be invoked upon received response.
+  this.invoke = function(){
+    var req = JRMessage.pretty_request(arguments, this.node_id, this.headers);
+
+    // store requests for later retrieval
+    this.messages[req.id] = req;
+
+    if(node.opened)
+      this.socket.send(req.to_json());
+
+    return req;
+  };
+};
+
+///////////////////////////////////////////////////////
+// WebNode
+
+// Main json-rpc www interface
+function WebNode (uri){
+  var node      = this;
+  this.node_id  = null;
+  this.headers  = {};
+
+  // Invoke request via http
+  //
+  // Pass in the rpc method, arguments to invoke method with, and optional callback
+  // to be invoked upon received response.
+  this.invoke = function(){
+    var req = JRMessage.pretty_request(arguments, this.node_id, this.headers);
+
+    $.ajax({type: 'POST',
+            url: uri,
+            data: req.to_json(),
+            dataType: 'text', // using text so we can parse json ourselves
+
+            success: function(data){
+              var msg = JRMessage.from_msg(data);
+              // js web client doesn't support notifications
+              //if(node.message_received)
+                //node.message_received(msg);
+
+              req.handle_response(msg)
+
+              // if err msg, run node.onerror
+              if(msg.error)
+                if(node.onerror)
+                  node.onerror(msg);
+            },
+
+            error: function(jqXHR, textStatus, errorThrown){
+              var err = { 'error' : {'code' : jqXHR.status,
+                                     'message' : textStatus,
+                                     'class' : errorThrown } };
+              if(node.onerror)
+                node.onerror(err);
+
+              req.handle_response(err)
+            }});
+
+    return req;
+  };
+};

data/site/json.js

@@ -0,0 +1,199 @@
+/**
+ * jQuery JSON plugin 2.4.0
+ *
+ * @author Brantley Harris, 2009-2011
+ * @author Timo Tijhof, 2011-2012
+ * @source This plugin is heavily influenced by MochiKit's serializeJSON, which is
+ *         copyrighted 2005 by Bob Ippolito.
+ * @source Brantley Harris wrote this plugin. It is based somewhat on the JSON.org
+ *         website's http://www.json.org/json2.js, which proclaims:
+ *         "NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.", a sentiment that
+ *         I uphold.
+ * @license MIT License <http://www.opensource.org/licenses/mit-license.php>
+ */
+(function ($) {
+	'use strict';
+
+	var escape = /["\\\x00-\x1f\x7f-\x9f]/g,
+		meta = {
+			'\b': '\\b',
+			'\t': '\\t',
+			'\n': '\\n',
+			'\f': '\\f',
+			'\r': '\\r',
+			'"' : '\\"',
+			'\\': '\\\\'
+		},
+		hasOwn = Object.prototype.hasOwnProperty;
+
+	/**
+	 * jQuery.toJSON
+	 * Converts the given argument into a JSON representation.
+	 *
+	 * @param o {Mixed} The json-serializable *thing* to be converted
+	 *
+	 * If an object has a toJSON prototype, that will be used to get the representation.
+	 * Non-integer/string keys are skipped in the object, as are keys that point to a
+	 * function.
+	 *
+	 */
+	$.toJSON = typeof JSON === 'object' && JSON.stringify ? JSON.stringify : function (o) {
+		if (o === null) {
+			return 'null';
+		}
+
+		var pairs, k, name, val,
+			type = $.type(o);
+
+		if (type === 'undefined') {
+			return undefined;
+		}
+
+		// Also covers instantiated Number and Boolean objects,
+		// which are typeof 'object' but thanks to $.type, we
+		// catch them here. I don't know whether it is right
+		// or wrong that instantiated primitives are not
+		// exported to JSON as an {"object":..}.
+		// We choose this path because that's what the browsers did.
+		if (type === 'number' || type === 'boolean') {
+			return String(o);
+		}
+		if (type === 'string') {
+			return $.quoteString(o);
+		}
+		if (typeof o.toJSON === 'function') {
+			return $.toJSON(o.toJSON());
+		}
+		if (type === 'date') {
+			var month = o.getUTCMonth() + 1,
+				day = o.getUTCDate(),
+				year = o.getUTCFullYear(),
+				hours = o.getUTCHours(),
+				minutes = o.getUTCMinutes(),
+				seconds = o.getUTCSeconds(),
+				milli = o.getUTCMilliseconds();
+
+			if (month < 10) {
+				month = '0' + month;
+			}
+			if (day < 10) {
+				day = '0' + day;
+			}
+			if (hours < 10) {
+				hours = '0' + hours;
+			}
+			if (minutes < 10) {
+				minutes = '0' + minutes;
+			}
+			if (seconds < 10) {
+				seconds = '0' + seconds;
+			}
+			if (milli < 100) {
+				milli = '0' + milli;
+			}
+			if (milli < 10) {
+				milli = '0' + milli;
+			}
+			return '"' + year + '-' + month + '-' + day + 'T' +
+				hours + ':' + minutes + ':' + seconds +
+				'.' + milli + 'Z"';
+		}
+
+		pairs = [];
+
+		if ($.isArray(o)) {
+			for (k = 0; k < o.length; k++) {
+				pairs.push($.toJSON(o[k]) || 'null');
+			}
+			return '[' + pairs.join(',') + ']';
+		}
+
+		// Any other object (plain object, RegExp, ..)
+		// Need to do typeof instead of $.type, because we also
+		// want to catch non-plain objects.
+		if (typeof o === 'object') {
+			for (k in o) {
+				// Only include own properties,
+				// Filter out inherited prototypes
+				if (hasOwn.call(o, k)) {
+					// Keys must be numerical or string. Skip others
+					type = typeof k;
+					if (type === 'number') {
+						name = '"' + k + '"';
+					} else if (type === 'string') {
+						name = $.quoteString(k);
+					} else {
+						continue;
+					}
+					type = typeof o[k];
+
+					// Invalid values like these return undefined
+					// from toJSON, however those object members
+					// shouldn't be included in the JSON string at all.
+					if (type !== 'function' && type !== 'undefined') {
+						val = $.toJSON(o[k]);
+						pairs.push(name + ':' + val);
+					}
+				}
+			}
+			return '{' + pairs.join(',') + '}';
+		}
+	};
+
+	/**
+	 * jQuery.evalJSON
+	 * Evaluates a given json string.
+	 *
+	 * @param str {String}
+	 */
+	$.evalJSON = typeof JSON === 'object' && JSON.parse ? JSON.parse : function (str) {
+		/*jshint evil: true */
+		return eval('(' + str + ')');
+	};
+
+	/**
+	 * jQuery.secureEvalJSON
+	 * Evals JSON in a way that is *more* secure.
+	 *
+	 * @param str {String}
+	 */
+	$.secureEvalJSON = typeof JSON === 'object' && JSON.parse ? JSON.parse : function (str) {
+		var filtered =
+			str
+			.replace(/\\["\\\/bfnrtu]/g, '@')
+			.replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']')
+			.replace(/(?:^|:|,)(?:\s*\[)+/g, '');
+
+		if (/^[\],:{}\s]*$/.test(filtered)) {
+			/*jshint evil: true */
+			return eval('(' + str + ')');
+		}
+		throw new SyntaxError('Error parsing JSON, source is not valid.');
+	};
+
+	/**
+	 * jQuery.quoteString
+	 * Returns a string-repr of a string, escaping quotes intelligently.
+	 * Mostly a support function for toJSON.
+	 * Examples:
+	 * >>> jQuery.quoteString('apple')
+	 * "apple"
+	 *
+	 * >>> jQuery.quoteString('"Where are we going?", she asked.')
+	 * "\"Where are we going?\", she asked."
+	 */
+	$.quoteString = function (str) {
+		if (str.match(escape)) {
+			return '"' + str.replace(escape, function (a) {
+				var c = meta[a];
+				if (typeof c === 'string') {
+					return c;
+				}
+				c = a.charCodeAt();
+				return '\\u00' + Math.floor(c / 16).toString(16) + (c % 16).toString(16);
+			}) + '"';
+		}
+		return '"' + str + '"';
+	};
+
+}(jQuery));