@constructor-io/constructorio-client-javascript 2.27.13 → 2.29.2

package/lib/modules/autocomplete.js

@@ -18,7 +18,9 @@ var EventDispatcher = require('../utils/event-dispatcher');
 var _require = require('../utils/helpers'),
     throwHttpErrorFromResponse = _require.throwHttpErrorFromResponse,
     cleanParams = _require.cleanParams,
-    applyNetworkTimeout = _require.applyNetworkTimeout; // Create URL from supplied query (term) and parameters
+    applyNetworkTimeout = _require.applyNetworkTimeout,
+    trimNonBreakingSpaces = _require.trimNonBreakingSpaces,
+    encodeURIComponentRFC3986 = _require.encodeURIComponentRFC3986; // Create URL from supplied query (term) and parameters
 
 
 function createAutocompleteUrl(query, parameters, options) {
@@ -62,7 +64,8 @@ function createAutocompleteUrl(query, parameters, options) {
     var numResults = parameters.numResults,
         resultsPerSection = parameters.resultsPerSection,
         filters = parameters.filters,
-        hiddenFields = parameters.hiddenFields; // Pull results number from parameters
+        hiddenFields = parameters.hiddenFields,
+        variationsMap = parameters.variationsMap; // Pull results number from parameters
 
     if (numResults) {
       queryParams.num_results = numResults;
@@ -89,6 +92,11 @@ function createAutocompleteUrl(query, parameters, options) {
           hidden_fields: hiddenFields
         };
       }
+    } // Pull variations map from parameters
+
+
+    if (variationsMap) {
+      queryParams.variations_map = JSON.stringify(variationsMap);
     }
   }
 
@@ -99,7 +107,7 @@ function createAutocompleteUrl(query, parameters, options) {
   });
   var cleanedQuery = query.replace(/^\//, '|'); // For compatibility with backend API
 
-  return "".concat(serviceUrl, "/autocomplete/").concat(encodeURIComponent(cleanedQuery), "?").concat(queryString);
+  return "".concat(serviceUrl, "/autocomplete/").concat(encodeURIComponentRFC3986(trimNonBreakingSpaces(cleanedQuery)), "?").concat(queryString);
 }
 /**
  * Interface to autocomplete related API calls.
@@ -127,6 +135,7 @@ var Autocomplete = /*#__PURE__*/function () {
    * @param {object} [parameters.filters] - Key / value mapping (dictionary) of filters used to refine results
    * @param {object} [parameters.resultsPerSection] - Number of results to return (value) per section (key)
    * @param {string[]} [parameters.hiddenFields] - Hidden metadata fields to return
+   * @param {object} [parameters.variationsMap] - The variations map object to aggregate variations. Please refer to https://docs.constructor.io/rest_api/variations_mapping for details
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}

package/lib/modules/browse.js

@@ -66,7 +66,8 @@ function createQueryParams(parameters, options) {
         section = parameters.section,
         fmtOptions = parameters.fmtOptions,
         hiddenFields = parameters.hiddenFields,
-        hiddenFacets = parameters.hiddenFacets; // Pull page from parameters
+        hiddenFacets = parameters.hiddenFacets,
+        variationsMap = parameters.variationsMap; // Pull page from parameters
 
     if (!helpers.isNil(page)) {
       queryParams.page = page;
@@ -121,6 +122,11 @@ function createQueryParams(parameters, options) {
           hidden_facets: hiddenFacets
         };
       }
+    } // Pull variations map from parameters
+
+
+    if (variationsMap) {
+      queryParams.variations_map = JSON.stringify(variationsMap);
     }
   }
 
@@ -146,7 +152,7 @@ function createBrowseUrlFromFilter(filterName, filterValue, parameters, options)
   var queryString = qs.stringify(queryParams, {
     indices: false
   });
-  return "".concat(serviceUrl, "/browse/").concat(encodeURIComponent(filterName), "/").concat(encodeURIComponent(filterValue), "?").concat(queryString);
+  return "".concat(serviceUrl, "/browse/").concat(helpers.encodeURIComponentRFC3986(helpers.trimNonBreakingSpaces(filterName)), "/").concat(helpers.encodeURIComponentRFC3986(helpers.trimNonBreakingSpaces(filterValue)), "?").concat(queryString);
 } // Create URL from supplied id's
 
 
@@ -189,14 +195,15 @@ function createBrowseUrlForFacetOptions(facetName, parameters, options) {
     throw new Error('facetName is a required parameter of type string');
   }
 
-  var queryParams = _objectSpread({}, createQueryParams(parameters, options)); // Endpoint does not accept _dt
+  var queryParams = _objectSpread({}, createQueryParams(parameters, options));
 
+  queryParams.facet_name = facetName; // Endpoint does not accept _dt
 
   delete queryParams._dt;
   var queryString = qs.stringify(queryParams, {
     indices: false
   });
-  return "".concat(serviceUrl, "/browse/facet_options?facet_name=").concat(facetName, "&").concat(queryString);
+  return "".concat(serviceUrl, "/browse/facet_options?").concat(queryString);
 }
 /**
  * Interface to browse related API calls
@@ -230,6 +237,7 @@ var Browse = /*#__PURE__*/function () {
    * @param {object} [parameters.fmtOptions] - The format options used to refine result groups
    * @param {string[]} [parameters.hiddenFields] - Hidden metadata fields to return
    * @param {string[]} [parameters.hiddenFacets] - Hidden facets to return
+   * @param {object} [parameters.variationsMap] - The variations map object to aggregate variations. Please refer to https://docs.constructor.io/rest_api/variations_mapping for details
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}
@@ -310,6 +318,7 @@ var Browse = /*#__PURE__*/function () {
      * @param {object} [parameters.fmtOptions] - The format options used to refine result groups
      * @param {string[]} [parameters.hiddenFields] - Hidden metadata fields to return
      * @param {string[]} [parameters.hiddenFacets] - Hidden facets to return
+     * @param {object} [parameters.variationsMap] - The variations map object to aggregate variations. Please refer to https://docs.constructor.io/rest_api/variations_mapping for details
      * @param {object} [networkParameters] - Parameters relevant to the network request
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
      * @returns {Promise}

package/lib/modules/recommendations.js

@@ -52,7 +52,8 @@ function createRecommendationsUrl(podId, parameters, options) {
         itemIds = parameters.itemIds,
         section = parameters.section,
         term = parameters.term,
-        filters = parameters.filters; // Pull num results number from parameters
+        filters = parameters.filters,
+        variationsMap = parameters.variationsMap; // Pull num results number from parameters
 
     if (!helpers.isNil(numResults)) {
       queryParams.num_results = numResults;
@@ -76,6 +77,11 @@ function createRecommendationsUrl(podId, parameters, options) {
 
     if (filters) {
       queryParams.filters = filters;
+    } // Pull variations map from parameters
+
+
+    if (variationsMap) {
+      queryParams.variations_map = JSON.stringify(variationsMap);
     }
   }
 
@@ -83,7 +89,7 @@ function createRecommendationsUrl(podId, parameters, options) {
   var queryString = qs.stringify(queryParams, {
     indices: false
   });
-  return "".concat(serviceUrl, "/recommendations/v1/pods/").concat(encodeURIComponent(podId), "?").concat(queryString);
+  return "".concat(serviceUrl, "/recommendations/v1/pods/").concat(helpers.encodeURIComponentRFC3986(helpers.trimNonBreakingSpaces(podId)), "?").concat(queryString);
 }
 /**
  * Interface to recommendations related API calls
@@ -112,6 +118,7 @@ var Recommendations = /*#__PURE__*/function () {
    * @param {string} [parameters.section] - The section to return results from
    * @param {string} [parameters.term] - The term to use to refine results (strategy specific)
    * @param {object} [parameters.filters] - Key / value mapping of filters used to refine results (strategy specific)
+   * @param {object} [parameters.variationsMap] - The variations map object to aggregate variations. Please refer to https://docs.constructor.io/rest_api/variations_mapping for details
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}

package/lib/modules/search.js

@@ -66,7 +66,8 @@ function createSearchUrl(query, parameters, options) {
         section = parameters.section,
         fmtOptions = parameters.fmtOptions,
         hiddenFields = parameters.hiddenFields,
-        hiddenFacets = parameters.hiddenFacets; // Pull page from parameters
+        hiddenFacets = parameters.hiddenFacets,
+        variationsMap = parameters.variationsMap; // Pull page from parameters
 
     if (!helpers.isNil(page)) {
       queryParams.page = page;
@@ -122,6 +123,11 @@ function createSearchUrl(query, parameters, options) {
           hidden_facets: hiddenFacets
         };
       }
+    } // Pull variations map from parameters
+
+
+    if (variationsMap) {
+      queryParams.variations_map = JSON.stringify(variationsMap);
     }
   }
 
@@ -130,7 +136,7 @@ function createSearchUrl(query, parameters, options) {
   var queryString = qs.stringify(queryParams, {
     indices: false
   });
-  return "".concat(serviceUrl, "/search/").concat(encodeURIComponent(query), "?").concat(queryString);
+  return "".concat(serviceUrl, "/search/").concat(helpers.encodeURIComponentRFC3986(helpers.trimNonBreakingSpaces(query)), "?").concat(queryString);
 }
 /**
  * Interface to search related API calls
@@ -163,6 +169,7 @@ var Search = /*#__PURE__*/function () {
    * @param {object} [parameters.fmtOptions] - The format options used to refine result groups
    * @param {string[]} [parameters.hiddenFields] - Hidden metadata fields to return
    * @param {string[]} [parameters.hiddenFacets] - Hidden facets to return
+   * @param {object} [parameters.variationsMap] - The variations map object to aggregate variations. Please refer to https://docs.constructor.io/rest_api/variations_mapping for details
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}

package/lib/modules/tracker.js

@@ -187,34 +187,43 @@ var Tracker = /*#__PURE__*/function () {
 
       // Ensure parameters are provided (required)
       if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
-        var url = "".concat(this.options.serviceUrl, "/behavior?");
-        var queryParams = {
-          action: 'item_detail_load'
-        };
+        var requestUrlPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/item_detail_load?");
+        var queryParams = {};
+        var bodyParams = {};
         var item_name = parameters.item_name,
             name = parameters.name,
             item_id = parameters.item_id,
             customer_id = parameters.customer_id,
-            variation_id = parameters.variation_id; // Ensure support for both item_name and name as parameters
+            variation_id = parameters.variation_id,
+            url = parameters.url; // Ensure support for both item_name and name as parameters
 
         if (item_name) {
-          queryParams.name = item_name;
+          bodyParams.item_name = item_name;
         } else if (name) {
-          queryParams.name = name;
+          bodyParams.item_name = name;
         } // Ensure support for both item_id and customer_id as parameters
 
 
         if (item_id) {
-          queryParams.customer_id = item_id;
+          bodyParams.item_id = item_id;
         } else if (customer_id) {
-          queryParams.customer_id = customer_id;
+          bodyParams.item_id = customer_id;
         }
 
         if (variation_id) {
-          queryParams.variation_id = variation_id;
+          bodyParams.variation_id = variation_id;
         }
 
-        this.requests.queue("".concat(url).concat(applyParamsAsString(queryParams, this.options)), undefined, undefined, networkParameters);
+        if (url) {
+          bodyParams.url = url;
+        }
+
+        var requestURL = "".concat(requestUrlPath).concat(applyParamsAsString(queryParams, this.options));
+        var requestMethod = 'POST';
+        var requestBody = applyParams(bodyParams, _objectSpread(_objectSpread({}, this.options), {}, {
+          requestMethod: requestMethod
+        }));
+        this.requests.queue(requestURL, requestMethod, requestBody, networkParameters);
         this.requests.send();
         return true;
       }
@@ -259,7 +268,7 @@ var Tracker = /*#__PURE__*/function () {
       if (term && typeof term === 'string') {
         // Ensure parameters are provided (required)
         if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
-          var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.ourEncodeURIComponent(term), "/select?");
+          var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.encodeURIComponentRFC3986(helpers.trimNonBreakingSpaces(term)), "/select?");
           var queryParams = {};
           var original_query = parameters.original_query,
               section = parameters.section,
@@ -332,7 +341,7 @@ var Tracker = /*#__PURE__*/function () {
       if (term && typeof term === 'string') {
         // Ensure parameters are provided (required)
         if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
-          var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.ourEncodeURIComponent(term), "/search?");
+          var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.encodeURIComponentRFC3986(helpers.trimNonBreakingSpaces(term)), "/search?");
           var queryParams = {};
           var original_query = parameters.original_query,
               group_id = parameters.group_id,
@@ -439,6 +448,7 @@ var Tracker = /*#__PURE__*/function () {
      * @param {string} parameters.item_id - Product item unique identifier
      * @param {string} [parameters.variation_id] - Product item variation unique identifier
      * @param {string} [parameters.result_id] - Search result identifier (returned in response from Constructor)
+     * @param {string} [parameters.item_is_convertible] - Whether or not an item is available for a conversion
      * @param {object} [networkParameters] - Parameters relevant to the network request
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
      * @returns {(true|Error)}
@@ -463,14 +473,15 @@ var Tracker = /*#__PURE__*/function () {
       if (term && typeof term === 'string') {
         // Ensure parameters are provided (required)
         if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
-          var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.ourEncodeURIComponent(term), "/click_through?");
+          var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.encodeURIComponentRFC3986(helpers.trimNonBreakingSpaces(term)), "/click_through?");
           var queryParams = {};
           var item_name = parameters.item_name,
               name = parameters.name,
               item_id = parameters.item_id,
               customer_id = parameters.customer_id,
               variation_id = parameters.variation_id,
-              result_id = parameters.result_id; // Ensure support for both item_name and name as parameters
+              result_id = parameters.result_id,
+              item_is_convertible = parameters.item_is_convertible; // Ensure support for both item_name and name as parameters
 
           if (item_name) {
             queryParams.name = item_name;
@@ -493,6 +504,10 @@ var Tracker = /*#__PURE__*/function () {
             queryParams.result_id = result_id;
           }
 
+          if (typeof item_is_convertible === 'boolean') {
+            queryParams.item_is_convertible = item_is_convertible;
+          }
+
           this.requests.queue("".concat(url).concat(applyParamsAsString(queryParams, this.options)), undefined, undefined, networkParameters);
           this.requests.send();
           return true;
@@ -547,7 +562,7 @@ var Tracker = /*#__PURE__*/function () {
 
       // Ensure parameters are provided (required)
       if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
-        var searchTerm = helpers.ourEncodeURIComponent(term) || 'TERM_UNKNOWN';
+        var searchTerm = term || 'TERM_UNKNOWN';
         var requestPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/conversion?");
         var queryParams = {};
         var bodyParams = {};

package/lib/utils/helpers.js

@@ -5,27 +5,20 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
 /* eslint-disable no-param-reassign */
-var qs = require('qs');
-
 var CRC32 = require('crc-32');
 
 var store = require('./store');
 
 var purchaseEventStorageKey = '_constructorio_purchase_order_ids';
 var utils = {
-  ourEncodeURIComponent: function ourEncodeURIComponent(str) {
-    if (str && typeof str === 'string') {
-      var cleanedString = str.replace(/\[/g, '%5B') // Replace [
-      .replace(/\]/g, '%5D') // Replace ]
-      .replace(/&/g, '%26'); // Replace &
-
-      var trimmedCleanedString = cleanedString.trim();
-      var parsedStrObj = qs.parse("s=".concat(trimmedCleanedString));
-      parsedStrObj.s = parsedStrObj.s.replace(/\s/g, ' ');
-      return qs.stringify(parsedStrObj).split('=')[1];
-    }
-
-    return null;
+  trimNonBreakingSpaces: function trimNonBreakingSpaces(string) {
+    return string.replace(/\s/g, ' ').trim();
+  },
+  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent
+  encodeURIComponentRFC3986: function encodeURIComponentRFC3986(string) {
+    return encodeURIComponent(string).replace(/[!'()*]/g, function (c) {
+      return "%".concat(c.charCodeAt(0).toString(16).toUpperCase());
+    });
   },
   cleanParams: function cleanParams(paramsObj) {
     var cleanedParams = {};
@@ -35,7 +28,7 @@ var utils = {
       if (typeof paramValue === 'string') {
         // Replace non-breaking spaces (or any other type of spaces caught by the regex)
         // - with a regular white space
-        cleanedParams[paramKey] = decodeURIComponent(utils.ourEncodeURIComponent(paramValue));
+        cleanedParams[paramKey] = utils.trimNonBreakingSpaces(paramValue);
       } else {
         cleanedParams[paramKey] = paramValue;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-client-javascript",
-  "version": "2.27.13",
+  "version": "2.29.2",
   "description": "Constructor.io JavaScript client",
   "main": "lib/constructorio.js",
   "scripts": {