Adding version stuff

Author: GavinMendelGleason

lib/woqlClient.js

@@ -1475,6 +1475,67 @@ WOQLClient.prototype.getDiff = function (before, after) {
   ).then((response) => response);
 };
 
+
+/**
+ * Get the patch of difference between two documents.
+ * @param {string} id - The object id to be diffed
+ * @param {string} beforeVersion - The version from which to compare the object
+ * @param {object} after - The updated state of JSON document
+ * @returns {Promise}  A promise that returns the call response object, or an Error if rejected.
+ * @example
+ *  const diff = await client.getVersionObjectDiff(
+ *      "Person/Jane",
+ *      "branch:a73ssscfx0kke7z76083cgswszdxy6l",
+ *      { "@id": "Person/Jane", "@type": "Person", name: "Janine" }
+ *  );
+ */
+WOQLClient.prototype.getVersionObjectDiff = function (id, beforeVersion, after) {
+  if (typeof id !== 'string' ||  typeof beforeVersion !== 'string' || typeof after !== 'object') {
+    const errmsg = '"id", "beforeVersion" or "after" parameter error - you must specify a valid after json document and valid id and version';
+
+    return Promise.reject(
+      new Error(ErrorMessage.getInvalidParameterMessage(CONST.GET_DIFF, errmsg)),
+    );
+  }
+
+  const payload = { document_id : id, before_data_version : beforeVersion, after: after};
+  return this.dispatch(
+    CONST.POST,
+    this.branchBase('diff'),
+    payload,
+  ).then((response) => response);
+};
+
+/**
+ * Get the patch of difference between two documents.
+ * @param {string} id - The object id to be diffed
+ * @param {string} beforeVersion - The version from which to compare the object
+ * @param {object} afterVersion - The version to which to compare the object
+ * @returns {Promise}  A promise that returns the call response object, or an Error if rejected.
+ * @example
+ *  const diff = await client.getVersionDiff(
+ *      "Person/Jane",
+ *      "branch:a73ssscfx0kke7z76083cgswszdxy6l",
+ *      "branch:73rqpooz65kbsheuno5dsayh71x7wf4"
+ *  );
+ */
+WOQLClient.prototype.getVersionDiff = function (id, beforeVersion, afterVersion) {
+  if (typeof id !== 'string' ||  typeof beforeVersion !== 'string' || typeof afterVersion !== 'string') {
+    const errmsg = '"id", "beforeVersion" or "after" parameter error - you must specify a valid after json document and valid id and version';
+
+    return Promise.reject(
+      new Error(ErrorMessage.getInvalidParameterMessage(CONST.GET_DIFF, errmsg)),
+    );
+  }
+
+  const payload = { document_id : id, before_data_version : beforeVersion, after_data_version: afterVersion};
+  return this.dispatch(
+    CONST.POST,
+    this.branchBase('diff'),
+    payload,
+  ).then((response) => response);
+};
+
 /**
  * Patch the difference between two documents.
  * @param {object} before - The current state of JSON document