Merge pull request #223 from kuzzleio/5.0.0-proposal

Release 5.0.0

Author: scottinet

package.json

@@ -1,6 +1,6 @@
 {
   "name": "kuzzle-sdk",
-  "version": "4.0.1",
+  "version": "5.0.0",
   "description": "Official Javascript SDK for Kuzzle",
   "author": "The Kuzzle Team <support@kuzzle.io>",
   "repository": {

src/Collection.js

@@ -102,8 +102,8 @@ Collection.prototype.count = function (filters, options, cb) {
 
   query = this.kuzzle.addHeaders({body: filters}, this.headers);
 
-  this.kuzzle.query(this.buildQueryArgs('document', 'count'), query, options, function (error, result) {
-    cb(error, result && result.result.count);
+  this.kuzzle.query(this.buildQueryArgs('document', 'count'), query, options, function (err, res) {
+    cb(err, err ? undefined : res.result.count);
   });
 };
 
@@ -249,6 +249,30 @@ Collection.prototype.deleteDocument = function (arg, options, cb) {
   return this;
 };
 
+/**
+ * Returns a boolean indicating whether or not a document with provided ID exists.
+ *
+ * @param {string} documentId - Unique document identifier
+ * @param {object} options [options] - Optional parameters
+ * @param {responseCallback} cb - Handles the query response
+ */
+Collection.prototype.documentExists = function (documentId, options, cb) {
+  var
+    data = {_id: documentId},
+    self = this;
+
+  if (!cb && typeof options === 'function') {
+    cb = options;
+    options = null;
+  }
+
+  self.kuzzle.callbackRequired('Collection.documentExists', cb);
+
+  self.kuzzle.query(this.buildQueryArgs('document', 'exists'), data, options, function (err, res) {
+    cb(err, err ? undefined : res.result);
+  });
+};
+
 /**
  * Retrieve a single stored document using its unique document ID.
  *

src/Document.js

@@ -113,9 +113,12 @@ Document.prototype.serialize = function () {
     data._id = this.id;
   }
 
+  if (this.version) {
+    data._version = this.version;
+  }
+
   data.body = this.content;
   data.meta = this.meta;
-  data._version = this.version;
   data = this.kuzzle.addHeaders(data, this.headers);
 
   return data;
@@ -158,6 +161,30 @@ Document.prototype.delete = function (options, cb) {
   });
 };
 
+/**
+ * Checks if this document exists in Kuzzle.
+ *
+ * @param {object} [options] - Optional parameters
+ * @param {responseCallback} [cb] - Handles the query response
+ * @returns {*} this
+ */
+Document.prototype.exists = function (options, cb) {
+  var self = this;
+
+  if (!cb && typeof options === 'function') {
+    cb = options;
+    options = null;
+  }
+
+  if (!self.id) {
+    throw new Error('Document.exists: cannot check if the document exists if no id has been provided');
+  }
+
+  this.kuzzle.query(this.dataCollection.buildQueryArgs('document', 'exists'), this.serialize(), options, cb && function (err, res) {
+    cb(err, err ? undefined : res.result);
+  });
+};
+
 /**
  * Replaces the current content with the last version of this document stored in Kuzzle.
  *