Publish Vulpes Preview 15 sources for desktop, Android and Tundra

Share Gaia assets and adapters, keep private profiles and development documents local, and update both public READMEs.

gaia/apps/calendar/js/common/promise.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Utilities for converting async functions which use
+ *     node-style callbacks to also cater promises callers.
+ */
+define(function(require, exports) {
+'use strict';
+
+function denodeify(fn) {
+  // This is our new, denodeified function. You can interact with it using
+  // node-style callbacks or promises.
+  return function() {
+    // Original arguments to fn.
+    var args = Array.slice(arguments);
+    if (args.length === fn.length) {
+      // If consumer is trying to interact with node-style callback, let them.
+      // If they were going for the promise, then the function would expect
+      // one more arg than was provided (the callback arg).
+      return fn.apply(this, args);
+    }
+
+    // We need the defer style promise api here since we don't want to
+    // accidentily step on functions that return things like DOMRequests...
+    var deferred = defer();
+    args.push(function(err, result) {
+      if (err) {
+        return deferred.reject(err);
+      }
+
+      // we resolve with a single value (array) in case of multiple arguments
+      if (arguments.length > 2) {
+        result = Array.prototype.slice.call(arguments, 1);
+      }
+      deferred.resolve(result);
+    });
+
+    // Return the promise <=> the function doesn't return an object.
+    var returnValue = fn.apply(this, args);
+    return typeof returnValue === 'object' ? returnValue : deferred.promise;
+  };
+}
+exports.denodeify = denodeify;
+
+function denodeifyAll(object, methods) {
+  methods.forEach((method) => {
+    object[method] = exports.denodeify(object[method]);
+  });
+}
+exports.denodeifyAll = denodeifyAll;
+
+function defer() {
+  var deferred = {};
+  var promise = new Promise((resolve, reject) => {
+    deferred.resolve = resolve;
+    deferred.reject = reject;
+  });
+
+  deferred.promise = promise;
+  return deferred;
+}
+
+});