Add ability to specify a lead search query in a string instead of a l…

…ist of itemized search keywords

README.md

@@ -35,3 +35,26 @@ closeio.lead.create({name: "Spider Man"})
   console.log(err);
 });
 ```
+
+**Searching for Leads**
+
+The `lead.search` method accepts either a string or a dictionary of search keywords as valid parameters.
+
+To use a string to specify your search query, pass a `query` parameter to the `lead.search` method:
+
+```javascript
+closeio.lead.search({query: 'name:"Bruce Wayne" email_address:bruce@wayneenterprises.com'})
+.then(function(search_results){
+  console.log(search_results.total_results);
+});
+```
+
+To use a dictionary of search keywords to specify your search query, structure your parameters as follows:
+```javascript
+closeio.lead.search({name: "Bruce Wayne", email_address: 'bruce@wayneenterprises.com'})
+.then(function(search_results){
+  console.log(search_results.total_results);
+});
+```
+
+**Note**: The `query` parameter will override any other search keywords present in your dictionary.

lib/close.io.js

@@ -21,14 +21,17 @@ var Closeio = function(apiKey) {
         parameters._fields = options.fields;
         delete options.fields;
       }
-
-      var option_keys = Object.keys(options);
-      if (option_keys.length > 0) {
-        parameters.query = '';
-        option_keys.forEach(function(option) {
-          var option_wrapper = (!/^".*"$/.test(option) && / +/.test(option)) ? '"' : '';
-          parameters.query += option_wrapper + option + option_wrapper + ':' + options[option] + ' ';
-        });
+      if ('query' in options) {
+        parameters.query = options.query;
+      } else {
+        var option_keys = Object.keys(options);
+        if (option_keys.length > 0) {
+          parameters.query = '';
+          option_keys.forEach(function(option) {
+            var option_wrapper = (!/^".*"$/.test(option) && / +/.test(option)) ? '"' : '';
+            parameters.query += option_wrapper + option + option_wrapper + ':' + options[option] + ' ';
+          });
+        }
       }
 
       return closeio._get('/lead/', parameters);

package.json

@@ -1,7 +1,7 @@
 {
   "name": "close.io",
   "preferGlobal": "false",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "author": "John Wehr <johnwehr@gmail.com>",
   "description": "",
   "contributors": [

test/close.io.js

@@ -125,7 +125,15 @@ describe('Close.io API', function () {
         });
     });
 
-
+    it('should search a lead by query', function () {
+      var lead_id;
+      return closeio.lead.search({ query: 'name:"John Wehr"'})
+        .then(function (data) {
+          // console.log(data)
+          assert(data.data.length > 0);
+        });
+    });
+
     after(function () {
       return closeio.lead.delete(lead_id)
     })