@constructor-io/constructorio-client-javascript 2.21.0 → 2.25.2

package/lib/modules/tracker.js

@@ -1,18 +1,18 @@
 "use strict";
 
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
 
 /* eslint-disable object-curly-newline, no-underscore-dangle, camelcase, no-unneeded-ternary */
 var qs = require('qs');
@@ -106,8 +106,7 @@ function applyParamsAsString(parameters, options) {
 
 var Tracker = /*#__PURE__*/function () {
   function Tracker(options) {
-    _classCallCheck(this, Tracker);
-
+    (0, _classCallCheck2["default"])(this, Tracker);
     this.options = options || {};
     this.eventemitter = new EventEmitter();
     this.requests = new RequestQueue(options, this.eventemitter);
@@ -124,7 +123,7 @@ var Tracker = /*#__PURE__*/function () {
    */
 
 
-  _createClass(Tracker, [{
+  (0, _createClass2["default"])(Tracker, [{
     key: "trackSessionStart",
     value: function trackSessionStart() {
       var networkParameters = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
@@ -176,13 +175,16 @@ var Tracker = /*#__PURE__*/function () {
      * @returns {(true|Error)}
      * @description User selected (clicked, or navigated to via keyboard) a result that appeared within autocomplete
      * @example
-     * constructorio.tracker.trackAutocompleteSelect('T-Shirt', {
-     *   original_query: 'Shirt',
-     *   section: 'Products',
-     *   tr: 'click',
-     *   group_id: '88JU230',
-     *   display_name: 'apparel',
-     * });
+     * constructorio.tracker.trackAutocompleteSelect(
+     *     'T-Shirt',
+     *      {
+     *          original_query: 'Shirt',
+     *          section: 'Products',
+     *          tr: 'click',
+     *          group_id: '88JU230',
+     *          display_name: 'apparel',
+     *      },
+     * );
      */
 
   }, {
@@ -193,7 +195,7 @@ var Tracker = /*#__PURE__*/function () {
       // Ensure term is provided (required)
       if (term && typeof term === 'string') {
         // Ensure parameters are provided (required)
-        if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+        if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
           var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.ourEncodeURIComponent(term), "/select?");
           var queryParams = {};
           var original_query = parameters.original_query,
@@ -248,11 +250,14 @@ var Tracker = /*#__PURE__*/function () {
      * @returns {(true|Error)}
      * @description User submitted a search (pressing enter within input element, or clicking submit element)
      * @example
-     * constructorio.tracker.trackSearchSubmit('T-Shirt', {
-     *   original_query: 'Shirt',
-     *   group_id: '88JU230',
-     *   display_name: 'apparel',
-     * });
+     * constructorio.tracker.trackSearchSubmit(
+     *     'T-Shirt',
+     *     {
+     *         original_query: 'Shirt',
+     *         group_id: '88JU230',
+     *         display_name: 'apparel',
+     *     },
+     * );
      */
 
   }, {
@@ -263,7 +268,7 @@ var Tracker = /*#__PURE__*/function () {
       // Ensure term is provided (required)
       if (term && typeof term === 'string') {
         // Ensure parameters are provided (required)
-        if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+        if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
           var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.ourEncodeURIComponent(term), "/search?");
           var queryParams = {};
           var original_query = parameters.original_query,
@@ -300,16 +305,19 @@ var Tracker = /*#__PURE__*/function () {
      * @param {string} term - Search results query term
      * @param {object} parameters - Additional parameters to be sent with request
      * @param {number} parameters.num_results - Number of search results in total
-     * @param {array} [parameters.item_ids] - List of product item unique identifiers in search results listing
+     * @param {string[]} [parameters.item_ids] - List of product item unique identifiers in search results listing
      * @param {object} [networkParameters] - Parameters relevant to the network request
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
      * @returns {(true|Error)}
      * @description User viewed a search product listing page
      * @example
-     * constructorio.tracker.trackSearchResultsLoaded('T-Shirt', {
-     *   num_results: 167,
-     *   item_ids: ['KMH876', 'KMH140', 'KMH437'],
-     * });
+     * constructorio.tracker.trackSearchResultsLoaded(
+     *     'T-Shirt',
+     *     {
+     *         num_results: 167,
+     *         item_ids: ['KMH876', 'KMH140', 'KMH437'],
+     *     },
+     * );
      */
 
   }, {
@@ -320,7 +328,7 @@ var Tracker = /*#__PURE__*/function () {
       // Ensure term is provided (required)
       if (term && typeof term === 'string') {
         // Ensure parameters are provided (required)
-        if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+        if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
           var url = "".concat(this.options.serviceUrl, "/behavior?");
           var queryParams = {
             action: 'search-results',
@@ -329,16 +337,21 @@ var Tracker = /*#__PURE__*/function () {
           var num_results = parameters.num_results,
               customer_ids = parameters.customer_ids,
               item_ids = parameters.item_ids;
+          var customerIDs;
 
           if (!helpers.isNil(num_results)) {
             queryParams.num_results = num_results;
           } // Ensure support for both item_ids and customer_ids as parameters
 
 
-          if (item_ids && Array.isArray(item_ids)) {
-            queryParams.customer_ids = item_ids.join(',');
-          } else if (customer_ids && Array.isArray(customer_ids)) {
-            queryParams.customer_ids = customer_ids.join(',');
+          if (item_ids && Array.isArray(item_ids) && item_ids.length) {
+            customerIDs = item_ids;
+          } else if (customer_ids && Array.isArray(customer_ids) && customer_ids.length) {
+            customerIDs = customer_ids;
+          }
+
+          if (customerIDs && customerIDs.length) {
+            queryParams.customer_ids = customerIDs.slice(0, 100).join(',');
           }
 
           this.requests.queue("".concat(url).concat(applyParamsAsString(queryParams, this.options)), undefined, undefined, networkParameters);
@@ -368,11 +381,14 @@ var Tracker = /*#__PURE__*/function () {
      * @returns {(true|Error)}
      * @description User clicked a result that appeared within a search product listing page
      * @example
-     * constructorio.tracker.trackSearchResultClick('T-Shirt', {
-     *   item_name: 'Red T-Shirt',
-     *   item_id: 'KMH876',
-     *   result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
-     * });
+     * constructorio.tracker.trackSearchResultClick(
+     *     'T-Shirt',
+     *     {
+     *         item_name: 'Red T-Shirt',
+     *         item_id: 'KMH876',
+     *         result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
+     *     },
+     * );
      */
 
   }, {
@@ -383,7 +399,7 @@ var Tracker = /*#__PURE__*/function () {
       // Ensure term is provided (required)
       if (term && typeof term === 'string') {
         // Ensure parameters are provided (required)
-        if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+        if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
           var url = "".concat(this.options.serviceUrl, "/autocomplete/").concat(helpers.ourEncodeURIComponent(term), "/click_through?");
           var queryParams = {};
           var item_name = parameters.item_name,
@@ -430,10 +446,10 @@ var Tracker = /*#__PURE__*/function () {
      * Send conversion event to API
      *
      * @function trackConversion
-     * @param {string} term - Search results query term
+     * @param {string} [term] - Search results query term that led to conversion event
      * @param {object} parameters - Additional parameters to be sent with request
      * @param {string} parameters.item_id - Product item unique identifier
-     * @param {string} parameters.revenue - Revenue (price) of product item
+     * @param {number} [parameters.revenue] - Sale price if available, otherwise the regular (retail) price of item
      * @param {string} [parameters.item_name] - Product item name
      * @param {string} [parameters.variation_id] - Product item variation unique identifier
      * @param {string} [parameters.type='add_to_cart'] - Conversion type
@@ -445,16 +461,20 @@ var Tracker = /*#__PURE__*/function () {
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
      * @returns {(true|Error)}
      * @description User performed an action indicating interest in an item (add to cart, add to wishlist, etc.)
+     * @see https://docs.constructor.io/rest_api/behavioral_logging/conversions
      * @example
-     * constructorio.tracker.trackConversion('T-Shirt', {
-     *   item_id: 'KMH876',
-     *   revenue: 12.00,
-     *   item_name: 'Red T-Shirt',
-     *   variation_id: 'KMH879-7632',
-     *   type: 'like',
-     *   result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
-     *   section: 'Products',
-     * });
+     * constructorio.tracker.trackConversion(
+     *     'T-Shirt',
+     *     {
+     *         item_id: 'KMH876',
+     *         revenue: 12.00,
+     *         item_name: 'Red T-Shirt',
+     *         variation_id: 'KMH879-7632',
+     *         type: 'like',
+     *         result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
+     *         section: 'Products',
+     *     },
+     * );
      */
 
   }, {
@@ -463,7 +483,7 @@ var Tracker = /*#__PURE__*/function () {
       var networkParameters = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
 
       // Ensure parameters are provided (required)
-      if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+      if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
         var searchTerm = helpers.ourEncodeURIComponent(term) || 'TERM_UNKNOWN';
         var requestPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/conversion?");
         var queryParams = {};
@@ -540,8 +560,8 @@ var Tracker = /*#__PURE__*/function () {
      *
      * @function trackPurchase
      * @param {object} parameters - Additional parameters to be sent with request
-     * @param {array} parameters.items - List of product item objects
-     * @param {number} parameters.revenue - Revenue
+     * @param {object[]} parameters.items - List of product item objects
+     * @param {number} parameters.revenue - The subtotal (not including taxes, shipping, etc.) of the entire order
      * @param {string} [parameters.order_id] - Unique order identifier
      * @param {string} [parameters.section] - Index section
      * @param {object} [networkParameters] - Parameters relevant to the network request
@@ -549,12 +569,14 @@ var Tracker = /*#__PURE__*/function () {
      * @returns {(true|Error)}
      * @description User completed an order (usually fired on order confirmation page)
      * @example
-     * constructorio.tracker.trackPurchase({
-     *   items: [{ item_id: 'KMH876' }, { item_id: 'KMH140' }],
-     *   revenue: 12.00,
-     *   order_id: 'OUNXBG2HMA',
-     *   section: 'Products',
-     * });
+     * constructorio.tracker.trackPurchase(
+     *     {
+     *         items: [{ item_id: 'KMH876' }, { item_id: 'KMH140' }],
+     *         revenue: 12.00,
+     *         order_id: 'OUNXBG2HMA',
+     *         section: 'Products',
+     *     },
+     * );
      */
 
   }, {
@@ -563,7 +585,7 @@ var Tracker = /*#__PURE__*/function () {
       var networkParameters = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
 
       // Ensure parameters are provided (required)
-      if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+      if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
         var requestPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/purchase?");
         var queryParams = {};
         var bodyParams = {};
@@ -627,14 +649,16 @@ var Tracker = /*#__PURE__*/function () {
      * @returns {(true|Error)}
      * @description User viewed a set of recommendations
      * @example
-     * constructorio.tracker.trackRecommendationView({
-     *   result_count: 22,
-     *   result_page: 2,
-     *   result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
-     *   url: 'https://demo.constructor.io/sandbox/farmstand',
-     *   pod_id: '019927c2-f955-4020',
-     *   num_results_viewed: 3,
-     * });
+     * constructorio.tracker.trackRecommendationView(
+     *     {
+     *         result_count: 22,
+     *         result_page: 2,
+     *         result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
+     *         url: 'https://demo.constructor.io/sandbox/farmstand',
+     *         pod_id: '019927c2-f955-4020',
+     *         num_results_viewed: 3,
+     *     },
+     * );
      */
 
   }, {
@@ -643,7 +667,7 @@ var Tracker = /*#__PURE__*/function () {
       var networkParameters = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
 
       // Ensure parameters are provided (required)
-      if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+      if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
         var requestPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/recommendation_result_view?");
         var bodyParams = {};
         var result_count = parameters.result_count,
@@ -717,17 +741,19 @@ var Tracker = /*#__PURE__*/function () {
      * @returns {(true|Error)}
      * @description User clicked an item that appeared within a list of recommended results
      * @example
-     * constructorio.tracker.trackRecommendationClick({
-     *   variation_id: 'KMH879-7632',
-     *   result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
-     *   result_count: 22,
-     *   result_page: 2,
-     *   result_position_on_page: 2,
-     *   num_results_per_page: 12,
-     *   pod_id: '019927c2-f955-4020',
-     *   strategy_id: 'complimentary',
-     *   item_id: 'KMH876',
-     * });
+     * constructorio.tracker.trackRecommendationClick(
+     *     {
+     *         variation_id: 'KMH879-7632',
+     *         result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
+     *         result_count: 22,
+     *         result_page: 2,
+     *         result_position_on_page: 2,
+     *         num_results_per_page: 12,
+     *         pod_id: '019927c2-f955-4020',
+     *         strategy_id: 'complimentary',
+     *         item_id: 'KMH876',
+     *     },
+     * );
      */
 
   }, {
@@ -736,7 +762,7 @@ var Tracker = /*#__PURE__*/function () {
       var networkParameters = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
 
       // Ensure parameters are provided (required)
-      if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+      if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
         var requestPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/recommendation_result_click?");
         var bodyParams = {};
         var variation_id = parameters.variation_id,
@@ -817,27 +843,29 @@ var Tracker = /*#__PURE__*/function () {
      * @param {number} [parameters.result_count] - Number of results displayed
      * @param {number} [parameters.result_page] - Page number of results
      * @param {string} [parameters.result_id] - Browse result identifier (returned in response from Constructor)
-     * @param {string} [parameters.selected_filters] -  Selected filters
+     * @param {string} [parameters.selected_filters] - Selected filters
      * @param {string} [parameters.sort_order] - Sort order ('ascending' or 'descending')
      * @param {string} [parameters.sort_by] - Sorting method
-     * @param {array} [parameters.items] - List of product item objects
+     * @param {object[]} [parameters.items] - List of product item objects
      * @param {object} [networkParameters] - Parameters relevant to the network request
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
      * @returns {(true|Error)}
      * @description User viewed a browse product listing page
      * @example
-     * constructorio.tracker.trackBrowseResultsLoaded({
-     *   result_count: 22,
-     *   result_page: 2,
-     *   result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
-     *   selected_filters: [ 'brand', 'color' ],
-     *   sort_order: 'ascending',
-     *   sort_by: 'price',
-     *   items: [{ item_id: 'KMH876' }, { item_id: 'KMH140' }],
-     *   url: 'https://demo.constructor.io/sandbox/farmstand',
-     *   filter_name: 'brand',
-     *   filter_value: 'XYZ',
-     * });
+     * constructorio.tracker.trackBrowseResultsLoaded(
+     *     {
+     *         result_count: 22,
+     *         result_page: 2,
+     *         result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
+     *         selected_filters: { brand: ['foo'], color: ['black'] },
+     *         sort_order: 'ascending',
+     *         sort_by: 'price',
+     *         items: [{ item_id: 'KMH876' }, { item_id: 'KMH140' }],
+     *         url: 'https://demo.constructor.io/sandbox/farmstand',
+     *         filter_name: 'brand',
+     *         filter_value: 'XYZ',
+     *     },
+     * );
      */
 
   }, {
@@ -846,7 +874,7 @@ var Tracker = /*#__PURE__*/function () {
       var networkParameters = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
 
       // Ensure parameters are provided (required)
-      if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+      if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
         var requestPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/browse_result_load?");
         var bodyParams = {};
         var section = parameters.section,
@@ -904,7 +932,7 @@ var Tracker = /*#__PURE__*/function () {
         }
 
         if (items && Array.isArray(items)) {
-          bodyParams.items = items;
+          bodyParams.items = items.slice(0, 100);
         }
 
         var requestURL = "".concat(requestPath).concat(applyParamsAsString({}, this.options));
@@ -935,24 +963,26 @@ var Tracker = /*#__PURE__*/function () {
      * @param {number} [parameters.result_page] - Page number of results
      * @param {number} [parameters.result_position_on_page] - Position of clicked item
      * @param {number} [parameters.num_results_per_page] - Number of results shown
-     * @param {string} [parameters.selected_filters] -  Selected filters
+     * @param {object} [parameters.selected_filters] - Selected filters
      * @param {object} [networkParameters] - Parameters relevant to the network request
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
      * @returns {(true|Error)}
      * @description User clicked a result that appeared within a browse product listing page
      * @example
-     * constructorio.tracker.trackBrowseResultClick({
-     *   variation_id: 'KMH879-7632',
-     *   result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
-     *   result_count: 22,
-     *   result_page: 2,
-     *   result_position_on_page: 2,
-     *   num_results_per_page: 12,
-     *   selected_filters: [ 'brand', 'color' ],
-     *   filter_name: 'brand',
-     *   filter_value: 'XYZ',
-     *   item_id: 'KMH876',
-     * });
+     * constructorio.tracker.trackBrowseResultClick(
+     *     {
+     *         variation_id: 'KMH879-7632',
+     *         result_id: '019927c2-f955-4020-8b8d-6b21b93cb5a2',
+     *         result_count: 22,
+     *         result_page: 2,
+     *         result_position_on_page: 2,
+     *         num_results_per_page: 12,
+     *         selected_filters: { brand: ['foo'], color: ['black'] },
+     *         filter_name: 'brand',
+     *         filter_value: 'XYZ',
+     *         item_id: 'KMH876',
+     *     },
+     * );
      */
 
   }, {
@@ -961,7 +991,7 @@ var Tracker = /*#__PURE__*/function () {
       var networkParameters = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
 
       // Ensure parameters are provided (required)
-      if (parameters && _typeof(parameters) === 'object' && !Array.isArray(parameters)) {
+      if (parameters && (0, _typeof2["default"])(parameters) === 'object' && !Array.isArray(parameters)) {
         var requestPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/browse_result_click?");
         var bodyParams = {};
         var section = parameters.section,
@@ -1049,11 +1079,13 @@ var Tracker = /*#__PURE__*/function () {
      * @returns {(true|Error)}
      * @description User clicked a result that appeared outside of the scope of search / browse / recommendations
      * @example
-     * constructorio.tracker.trackGenericResultClick({
-     *   item_id: 'KMH876',
-     *   item_name: 'Red T-Shirt',
-     *   variation_id: 'KMH879-7632',
-     * });
+     * constructorio.tracker.trackGenericResultClick(
+     *     {
+     *         item_id: 'KMH876',
+     *         item_name: 'Red T-Shirt',
+     *         variation_id: 'KMH879-7632',
+     *     },
+     * );
      */
 
   }, {
@@ -1062,7 +1094,7 @@ var Tracker = /*#__PURE__*/function () {
       var networkParameters = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
 
       // Ensure required parameters are provided
-      if (_typeof(parameters) === 'object' && !!parameters.item_id) {
+      if ((0, _typeof2["default"])(parameters) === 'object' && !!parameters.item_id) {
         var requestPath = "".concat(this.options.serviceUrl, "/v2/behavioral_action/result_click?");
         var bodyParams = {};
         var item_id = parameters.item_id,
@@ -1102,7 +1134,7 @@ var Tracker = /*#__PURE__*/function () {
      * @returns {(true|Error)}
      * @example
      * constructorio.tracker.on('error', (data) => {
-     *   // Handle tracking error
+     *     // Handle tracking error
      * });
      */
 
@@ -1121,8 +1153,9 @@ var Tracker = /*#__PURE__*/function () {
       return true;
     }
   }]);
-
   return Tracker;
-}();
+}(); // Exposed for testing
+
 
+Tracker.RequestQueue = RequestQueue;
 module.exports = Tracker;

package/lib/utils/event-dispatcher.js

@@ -1,10 +1,10 @@
 "use strict";
 
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 
 /* eslint-disable no-unneeded-ternary */
 var helpers = require('../utils/helpers');
@@ -13,8 +13,7 @@ var EventDispatcher = /*#__PURE__*/function () {
   function EventDispatcher(options) {
     var _this = this;
 
-    _classCallCheck(this, EventDispatcher);
-
+    (0, _classCallCheck2["default"])(this, EventDispatcher);
     this.events = [];
     this.enabled = options && options.enabled === false ? false : true; // Defaults to 'true'
 
@@ -50,7 +49,7 @@ var EventDispatcher = /*#__PURE__*/function () {
   } // Push event data to queue
 
 
-  _createClass(EventDispatcher, [{
+  (0, _createClass2["default"])(EventDispatcher, [{
     key: "queue",
     value: function queue(name, data) {
       this.events.push({
@@ -75,7 +74,6 @@ var EventDispatcher = /*#__PURE__*/function () {
       }
     }
   }]);
-
   return EventDispatcher;
 }();
 

package/lib/utils/helpers.js

@@ -1,6 +1,8 @@
 "use strict";
 
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
 /* eslint-disable no-param-reassign */
 var qs = require('qs');
@@ -12,8 +14,13 @@ var store = require('./store');
 var purchaseEventStorageKey = '_constructorio_purchase_order_ids';
 var utils = {
   ourEncodeURIComponent: function ourEncodeURIComponent(str) {
-    if (str) {
-      var parsedStrObj = qs.parse("s=".concat(encodeURIComponent(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];
     }
@@ -99,8 +106,12 @@ var utils = {
     return null;
   },
   hasOrderIdRecord: function hasOrderIdRecord(orderId) {
-    var purchaseEventStorage = JSON.parse(store.session.get(purchaseEventStorageKey));
     var orderIdHash = CRC32.str(orderId.toString());
+    var purchaseEventStorage = store.session.get(purchaseEventStorageKey);
+
+    if (typeof purchaseEventStorage === 'string') {
+      purchaseEventStorage = JSON.parse(purchaseEventStorage);
+    }
 
     if (purchaseEventStorage && purchaseEventStorage[orderIdHash]) {
       return true;
@@ -109,8 +120,12 @@ var utils = {
     return null;
   },
   addOrderIdRecord: function addOrderIdRecord(orderId) {
-    var purchaseEventStorage = JSON.parse(store.session.get(purchaseEventStorageKey));
     var orderIdHash = CRC32.str(orderId.toString());
+    var purchaseEventStorage = store.session.get(purchaseEventStorageKey);
+
+    if (typeof purchaseEventStorage === 'string') {
+      purchaseEventStorage = JSON.parse(purchaseEventStorage);
+    }
 
     if (purchaseEventStorage) {
       // If the order already exists, do nothing
@@ -121,7 +136,7 @@ var utils = {
       purchaseEventStorage[orderIdHash] = true;
     } else {
       // Create a new object map for the order ids
-      purchaseEventStorage = _defineProperty({}, orderIdHash, true);
+      purchaseEventStorage = (0, _defineProperty2["default"])({}, orderIdHash, true);
     } // Push the order id map into session storage