@constructor-io/constructorio-client-javascript 2.29.7 → 2.29.8

package/lib/modules/browse.js

@@ -12,9 +12,7 @@ function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (O
 
 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 max-len */
-
-/* eslint-disable object-curly-newline, no-underscore-dangle */
+/* eslint-disable object-curly-newline, no-underscore-dangle, max-len, complexity */
 var qs = require('qs');
 
 var fetchPonyfill = require('fetch-ponyfill');
@@ -59,6 +57,7 @@ function createQueryParams(parameters, options) {
 
   if (parameters) {
     var page = parameters.page,
+        offset = parameters.offset,
         resultsPerPage = parameters.resultsPerPage,
         filters = parameters.filters,
         sortBy = parameters.sortBy,
@@ -67,10 +66,17 @@ function createQueryParams(parameters, options) {
         fmtOptions = parameters.fmtOptions,
         hiddenFields = parameters.hiddenFields,
         hiddenFacets = parameters.hiddenFacets,
-        variationsMap = parameters.variationsMap; // Pull page from parameters
+        variationsMap = parameters.variationsMap,
+        qsParam = parameters.qsParam,
+        preFilterExpression = parameters.preFilterExpression; // Pull page from parameters
 
     if (!helpers.isNil(page)) {
       queryParams.page = page;
+    } // Pull offset from parameters
+
+
+    if (!helpers.isNil(offset)) {
+      queryParams.offset = offset;
     } // Pull results per page from parameters
 
 
@@ -127,6 +133,16 @@ function createQueryParams(parameters, options) {
 
     if (variationsMap) {
       queryParams.variations_map = JSON.stringify(variationsMap);
+    } // Pull pre_filter_expression from parameters
+
+
+    if (preFilterExpression) {
+      queryParams.pre_filter_expression = JSON.stringify(preFilterExpression);
+    } // pull qs param from parameters
+
+
+    if (qsParam) {
+      queryParams.qs = JSON.stringify(qsParam);
     }
   }
 
@@ -228,16 +244,19 @@ var Browse = /*#__PURE__*/function () {
    * @param {string} filterName - Filter name to display results from
    * @param {string} filterValue - Filter value to display results from
    * @param {object} [parameters] - Additional parameters to refine result set
-   * @param {number} [parameters.page] - The page number of the results
+   * @param {number} [parameters.page] - The page number of the results (Can't be used together with offset)
+   * @param {number} [parameters.offset] - The number of results to skip from the beginning (Can't be used together with page)
    * @param {number} [parameters.resultsPerPage] - The number of results per page to return
    * @param {object} [parameters.filters] - Key / value mapping (dictionary) of filters used to refine results
    * @param {string} [parameters.sortBy='relevance'] - The sort method for results
    * @param {string} [parameters.sortOrder='descending'] - The sort order for results
    * @param {string} [parameters.section='Products'] - The section name for results
-   * @param {object} [parameters.fmtOptions] - The format options used to refine result groups
+   * @param {object} [parameters.fmtOptions] - The format options used to refine result groups. Please refer to https://docs.constructor.io/rest_api/browse/queries/ for details
+   * @param {object} [parameters.preFilterExpression] - Faceting expression to scope browse results. Please refer to https://docs.constructor.io/rest_api/collections#add-items-dynamically
    * @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} [parameters.qs] - Parameters listed above can be serialized into a JSON object and parsed through this parameter. Please refer to https://docs.constructor.io/rest_api/browse/queries/
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}
@@ -309,13 +328,14 @@ var Browse = /*#__PURE__*/function () {
      * @function getBrowseResultsForItemIds
      * @param {string[]} itemIds - Item id's of results to fetch
      * @param {object} [parameters] - Additional parameters to refine result set
-     * @param {number} [parameters.page] - The page number of the results
+     * @param {number} [parameters.page] - The page number of the results (Can't be used together with offset)
+     * @param {number} [parameters.offset] - The number of results to skip from the beginning (Can't be used together with page)
      * @param {number} [parameters.resultsPerPage] - The number of results per page to return
      * @param {object} [parameters.filters] - Filters used to refine results
      * @param {string} [parameters.sortBy='relevance'] - The sort method for results
      * @param {string} [parameters.sortOrder='descending'] - The sort order for results
      * @param {string} [parameters.section='Products'] - The section name for results
-     * @param {object} [parameters.fmtOptions] - The format options used to refine result groups
+     * @param {object} [parameters.fmtOptions] - The format options used to refine result groups. Please refer to https://docs.constructor.io/rest_api/browse/queries/ for details
      * @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
@@ -388,7 +408,7 @@ var Browse = /*#__PURE__*/function () {
      * @function getBrowseGroups
      * @param {object} [parameters.filters] - Filters used to refine results
      * @param {string} [parameters.section='Products'] - The section name for results
-     * @param {object} [parameters.fmtOptions] - The format options used to refine result groups
+     * @param {object} [parameters.fmtOptions] - The format options used to refine result groups. Please refer to https://docs.constructor.io/rest_api/browse/groups/ for details
      * @param {object} [networkParameters] - Parameters relevant to the network request
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
      * @returns {Promise}
@@ -452,9 +472,10 @@ var Browse = /*#__PURE__*/function () {
      *
      * @function getBrowseFacets
      * @param {object} [parameters] - Additional parameters to refine result set
-     * @param {number} [parameters.page] - The page number of the results
+     * @param {number} [parameters.page] - The page number of the results (Can't be used together with offset)
+     * @param {number} [parameters.offset] - The number of results to skip from the beginning (Can't be used together with page)
      * @param {string} [parameters.section='Products'] - The section name for results
-     * @param {boolean} [parameters.fmtOptions.show_hidden_facets] - Include facets configured as hidden
+     * @param {object} [parameters.fmtOptions] - The format options used to refine result groups. Please refer to https://docs.constructor.io/rest_api/browse/facets/ for details
      * @param {number} [parameters.resultsPerPage] - The number of results per page to return
      * @param {object} [networkParameters] - Parameters relevant to the network request
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
@@ -518,8 +539,7 @@ var Browse = /*#__PURE__*/function () {
      * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
      * @param {object} [parameters] - Additional parameters to refine result set
      * @param {string} [parameters.section='Products'] - The section name for results
-     * @param {object} [parameters.fmtOptions] - The format options used to refine result groups
-     * @param {boolean} [parameters.fmtOptions.show_hidden_facets] - Include facets configured as hidden
+     * @param {object} [parameters.fmtOptions] - The format options used to refine result groups. Please refer to https://docs.constructor.io/rest_api/browse/facet_options/ for details
      * @param {}
      * @returns {Promise}
      * @see https://docs.constructor.io/rest_api/browse/facet_options/

package/package.json

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