Fix EZP-21963: create separate "promise-based" build

Gruntfile.js

@@ -1,14 +1,9 @@
 module.exports = function(grunt) {
 
-    var qPath = {
-            "q": "../node_modules/q/q"
-        },
-        testPaths = {
-            "q": "../node_modules/q/q",
+    var testPaths = {
             "jasmineCAPIMatchers": "../test/jasmine/CAPIMatchers"
         },
         coveragePaths = {
-            "q": "../node_modules/q/q",
             "jasmineCAPIMatchers": "../../../test/jasmine/CAPIMatchers"
         };
 
@@ -17,44 +12,67 @@ module.exports = function(grunt) {
             dist: {
                 options: {
                     almond: true,
-                    name : 'PromiseCAPI',
+                    name : 'CAPI',
                     optimize: "none",
                     baseUrl: "src/",
-                    paths: qPath,
                     out: "dist/CAPI.js",
                     wrap: {
                         startFile: 'wrap/wrap.start.js',
                         endFile: 'wrap/wrap.end.js'
                     }
                 }
             },
-            distmin: {
+            distMin: {
                 options: {
                     almond: true,
-                    name : 'PromiseCAPI',
+                    name : 'CAPI',
                     optimize: "uglify",
                     baseUrl: "src/",
-                    paths: qPath,
                     out: "dist/CAPI-min.js",
                     wrap: {
                         startFile: 'wrap/wrap.start.js',
                         endFile: 'wrap/wrap.end.js'
                     }
                 }
             },
-            testBundle: {
+            distPromise: {
                 options: {
                     almond: true,
                     name : 'PromiseCAPI',
                     optimize: "none",
                     baseUrl: "src/",
-                    paths: qPath,
+                    out: "dist/PromiseCAPI.js",
+                    wrap: {
+                        startFile: 'wrap/wrap.start.js',
+                        endFile: 'wrap/wrap.promise.end.js'
+                    }
+                }
+            },
+            testBundle: {
+                options: {
+                    almond: true,
+                    name : 'CAPI',
+                    optimize: "none",
+                    baseUrl: "src/",
                     out: "test/manual/jsRestClientBundle/Resources/public/js/CAPI.js",
                     wrap: {
                         startFile: 'wrap/wrap.start.js',
                         endFile: 'wrap/wrap.end.js'
                     }
                 }
+            },
+            testBundlePromise: {
+                options: {
+                    almond: true,
+                    name : 'PromiseCAPI',
+                    optimize: "none",
+                    baseUrl: "src/",
+                    out: "test/manual/jsRestClientBundle/Resources/public/js/PromiseCAPI.js",
+                    wrap: {
+                        startFile: 'wrap/wrap.start.js',
+                        endFile: 'wrap/wrap.promise.end.js'
+                    }
+                }
             }
         },
         jshint: {

README.md

@@ -61,7 +61,17 @@ The library can be built with:
 $ grunt build
 ```
 
-This command will (re)generate the files `dist/CAPI.js` and `dist/CAPI-min.js`.
+ This command will (re)generate the files `dist/CAPI.js`, `dist/CAPI-min.js` and `dist/PromiseCAPI.js`.
+First 2 files are full and minified versions of the regular client library wich doesn't have any dependencies and
+is intended for general use.
+
+ The `PromiseCAPI.js` is a promise-based version of the library
+which has a dependency on the Q library. While using this version a developer himself is responsible for inclusion of Q library into the project.
+It can be done by using preferred dependency management system or by simply downloading and including Q library file into scripts.
+For example see the source file from manual testing bundle: `test/manual/jsRestClientBundle/Resources/views/promise.test.html.twig`.
+
+More info on Q and promises: https://github.com/kriskowal/q.
+
 
 ### Tests
 
@@ -114,4 +124,8 @@ using following instruction:
 After these steps you may access `/js-rest-client-test/` path where you will find
 testing html page.  Most of requests can be configured a little bit before
 executing them by changing input values.  See details of tests implementation in
-Resources/public/js/cookbook-*.js files.
+`Resources/public/js/cookbook-*.js` files.
+
+To test promise-based version of the CAPI you can use `/js-rest-client-promise-test/` path.
+This setup includes Q library as a downloaded file. See details of (rather basic) tests implementation
+in `Resources/public/js/cookbook-PromiseCAPI.js`.