@constructor-io/constructorio-node 4.2.0 → 4.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-node",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Constructor.io Node.js client",
   "main": "src/constructorio.js",
   "scripts": {
@@ -54,6 +54,6 @@
     "form-data": "^4.0.0",
     "node-abort-controller": "^3.0.0",
     "node-fetch": "^2.6.2",
-    "qs": "6.7.2"
+    "qs": "6.9.7"
   }
 }

package/src/constructorio.js

@@ -1,4 +1,5 @@
 /* eslint-disable camelcase, no-unneeded-ternary, max-len */
+const nodeFetch = require('node-fetch').default;
 
 // Modules
 const Search = require('./modules/search');
@@ -55,7 +56,7 @@ class ConstructorIO {
       securityToken: securityToken || '',
       version: version || global.CLIENT_VERSION || `cio-node-${packageVersion}`,
       serviceUrl: (serviceUrl && serviceUrl.replace(/\/$/, '')) || 'https://ac.cnstrc.com',
-      fetch,
+      fetch: fetch || nodeFetch,
       networkParameters: networkParameters || {},
     };
 

package/src/modules/autocomplete.js

@@ -1,6 +1,5 @@
 /* eslint-disable object-curly-newline, no-underscore-dangle */
 const qs = require('qs');
-const nodeFetch = require('node-fetch').default;
 const { AbortController } = require('node-abort-controller');
 const helpers = require('../utils/helpers');
 
@@ -142,7 +141,7 @@ class Autocomplete {
    */
   getAutocompleteResults(query, parameters = {}, userParameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = {};

package/src/modules/browse.js

@@ -1,7 +1,6 @@
 /* eslint-disable max-len */
 /* eslint-disable object-curly-newline, no-underscore-dangle, max-params */
 const qs = require('qs');
-const nodeFetch = require('node-fetch').default;
 const { AbortController } = require('node-abort-controller');
 const helpers = require('../utils/helpers');
 
@@ -272,7 +271,7 @@ class Browse {
    */
   getBrowseResults(filterName, filterValue, parameters = {}, userParameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = createHeaders(this.options, userParameters, networkParameters);
@@ -356,7 +355,7 @@ class Browse {
    */
   getBrowseResultsForItemIds(itemIds, parameters = {}, userParameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = createHeaders(this.options, userParameters, networkParameters);
@@ -427,7 +426,7 @@ class Browse {
    * });
    */
   getBrowseGroups(parameters = {}, userParameters = {}, networkParameters = {}) {
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = createHeaders(this.options, userParameters, networkParameters);
@@ -487,7 +486,7 @@ class Browse {
    */
   getBrowseFacets(parameters = {}, userParameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = createHeaders(this.options, userParameters, networkParameters);
@@ -542,7 +541,7 @@ class Browse {
    */
   getBrowseFacetOptions(facetName, parameters = {}, userParameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = createHeaders(this.options, userParameters, networkParameters);

package/src/modules/catalog.js

@@ -1,7 +1,6 @@
 /* eslint-disable camelcase */
 /* eslint-disable object-curly-newline, no-underscore-dangle, max-len */
 const qs = require('qs');
-const nodeFetch = require('node-fetch').default;
 const { AbortController } = require('node-abort-controller');
 const FormData = require('form-data');
 const fs = require('fs');
@@ -34,14 +33,14 @@ function createCatalogUrl(path, options, additionalQueryParams = {}, apiVersion
 // Convert a read stream to buffer
 function convertToBuffer(stream) {
   return new Promise((resolve, reject) => {
-    let buffer = '';
+    const chunks = [];
 
     stream.on('data', (chunk) => {
-      buffer += chunk;
+      chunks.push(chunk);
     });
 
     stream.on('end', () => {
-      resolve(buffer);
+      resolve(Buffer.concat(chunks));
     });
 
     stream.on('error', (err) => {
@@ -118,6 +117,37 @@ async function createQueryParamsAndFormData(parameters) {
   return { queryParams, formData };
 }
 
+async function addTarArchiveToFormData(parameters, formData, operation, apiKey) {
+  try {
+    const { section } = parameters;
+    let { tarArchive } = parameters;
+
+    // Convert tarArchive to buffer if passed as stream
+    if (tarArchive instanceof fs.ReadStream || tarArchive instanceof Duplex) {
+      tarArchive = await convertToBuffer(tarArchive);
+    }
+
+    // Pull tarArchive from parameters
+    if (tarArchive && formData && operation && apiKey && section) {
+      // Convert timestamp to YYYY-MM-DD-HH-MM-SS format
+      const formattedDateTime = new Date()
+        .toISOString()
+        .replace('T', '-')
+        .replace(/:/g, '-')
+        .slice(0, 19);
+      const filename = `${apiKey}_${section}_${operation}_${formattedDateTime}.tar.gz`;
+
+      formData.append(filename, tarArchive, {
+        filename,
+      });
+    }
+  } catch (error) {
+    throw new Error(error);
+  }
+
+  return formData;
+}
+
 /**
  * Interface to catalog related API calls
  *
@@ -162,7 +192,7 @@ class Catalog {
    */
   createOrReplaceItems(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { items, section, force, notificationEmail } = parameters;
@@ -244,7 +274,7 @@ class Catalog {
    */
   updateItems(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { items, section, force, notificationEmail } = parameters;
@@ -316,7 +346,7 @@ class Catalog {
    */
   deleteItems(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { items, section, force, notificationEmail } = parameters;
@@ -394,7 +424,7 @@ class Catalog {
    */
   retrieveItems(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { ids, section, numResultsPerPage, page } = parameters;
@@ -476,7 +506,7 @@ class Catalog {
    */
   createOrReplaceVariations(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, force, notificationEmail, variations } = parameters;
@@ -559,7 +589,7 @@ class Catalog {
    */
   updateVariations(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, force, notificationEmail, variations } = parameters;
@@ -632,7 +662,7 @@ class Catalog {
    */
   deleteVariations(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, force, notificationEmail, variations } = parameters;
@@ -712,7 +742,7 @@ class Catalog {
   retrieveVariations(parameters = {}, networkParameters = {}) {
     let queryParams = {};
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { ids, itemId, section, numResultsPerPage, page } = parameters;
@@ -785,7 +815,7 @@ class Catalog {
    */
   addItemGroup(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { id, ...rest } = parameters;
@@ -843,7 +873,7 @@ class Catalog {
    */
   addItemGroups(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -890,7 +920,7 @@ class Catalog {
    */
   getItemGroup(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -932,7 +962,7 @@ class Catalog {
    */
   getItemGroups(networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -988,7 +1018,7 @@ class Catalog {
    */
   addOrUpdateItemGroups(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1043,7 +1073,7 @@ class Catalog {
    */
   modifyItemGroup(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { id, ...rest } = parameters;
@@ -1087,7 +1117,7 @@ class Catalog {
    */
   removeItemGroups(networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1135,7 +1165,7 @@ class Catalog {
    */
   addOneWaySynonym(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { phrase, ...rest } = parameters;
@@ -1189,7 +1219,7 @@ class Catalog {
    */
   modifyOneWaySynonym(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { phrase, ...rest } = parameters;
@@ -1239,7 +1269,7 @@ class Catalog {
     const { phrase } = parameters;
     const queryParams = {};
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1288,7 +1318,7 @@ class Catalog {
   getOneWaySynonyms(parameters = {}, networkParameters = {}) {
     const queryParams = {};
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1349,7 +1379,7 @@ class Catalog {
   removeOneWaySynonym(parameters = {}, networkParameters = {}) {
     const { phrase } = parameters;
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1391,7 +1421,7 @@ class Catalog {
    */
   removeOneWaySynonyms(networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1437,7 +1467,7 @@ class Catalog {
    */
   addSynonymGroup(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1486,7 +1516,7 @@ class Catalog {
    */
   modifySynonymGroup(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { id, ...rest } = parameters;
@@ -1534,7 +1564,7 @@ class Catalog {
    */
   getSynonymGroup(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1583,7 +1613,7 @@ class Catalog {
     const queryParams = {};
     const { phrase } = parameters;
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1640,7 +1670,7 @@ class Catalog {
    */
   removeSynonymGroup(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { id } = parameters;
@@ -1680,7 +1710,7 @@ class Catalog {
    */
   removeSynonymGroups(networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1738,7 +1768,7 @@ class Catalog {
    */
   addRedirectRule(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1800,7 +1830,7 @@ class Catalog {
    */
   updateRedirectRule(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { id, ...rest } = parameters;
@@ -1860,7 +1890,7 @@ class Catalog {
    */
   modifyRedirectRule(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { id, ...rest } = parameters;
@@ -1908,7 +1938,7 @@ class Catalog {
    */
   getRedirectRule(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -1958,7 +1988,7 @@ class Catalog {
   getRedirectRules(parameters = {}, networkParameters = {}) {
     const queryParams = {};
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -2025,7 +2055,7 @@ class Catalog {
    */
   removeRedirectRule(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -2077,7 +2107,7 @@ class Catalog {
    */
   async replaceCatalog(parameters = {}, networkParameters = {}) {
     try {
-      const fetch = (this.options && this.options.fetch) || nodeFetch;
+      const { fetch } = this.options;
       const controller = new AbortController();
       const { signal } = controller;
       const { queryParams, formData } = await createQueryParamsAndFormData(parameters);
@@ -2129,7 +2159,7 @@ class Catalog {
    */
   async updateCatalog(parameters = {}, networkParameters = {}) {
     try {
-      const fetch = (this.options && this.options.fetch) || nodeFetch;
+      const { fetch } = this.options;
       const controller = new AbortController();
       const { signal } = controller;
       const { queryParams, formData } = await createQueryParamsAndFormData(parameters);
@@ -2181,7 +2211,7 @@ class Catalog {
    */
   async patchCatalog(parameters = {}, networkParameters = {}) {
     try {
-      const fetch = (this.options && this.options.fetch) || nodeFetch;
+      const { fetch } = this.options;
       const controller = new AbortController();
       const { signal } = controller;
       const { queryParams, formData } = await createQueryParamsAndFormData(parameters);
@@ -2207,6 +2237,155 @@ class Catalog {
     }
   }
 
+  /**
+   * Send full catalog tar archive to replace the current catalog
+   *
+   * @function replaceCatalogUsingTarArchive
+   * @param {object} parameters - Additional parameters for catalog details
+   * @param {string} parameters.section - The section to update
+   * @param {string} [parameters.notification_email] - An email address to receive an email notification if the task fails
+   * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
+   * @param {file} [parameters.tarArchive] - The tar file that includes csv files
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise}
+   * @see https://docs.constructor.io/rest_api/full_catalog
+   * @example
+   * constructorio.catalog.replaceCatalogUsingTarArchive({
+   *     section: 'Products',
+   *     notification_email: 'notifications@example.com',
+   *     tarArchive: tarArchiveBufferOrStream,
+   * });
+   */
+  async replaceCatalogUsingTarArchive(parameters = {}, networkParameters = {}) {
+    try {
+      const { fetch } = this.options;
+      const apiKey = this.options && this.options.apiKey;
+      const controller = new AbortController();
+      const { signal } = controller;
+      const { queryParams, formData } = await createQueryParamsAndFormData(parameters);
+      const formDataWithTarArchive = await addTarArchiveToFormData(parameters, formData, 'sync', apiKey);
+      const requestUrl = createCatalogUrl('catalog', this.options, queryParams);
+      // Handle network timeout if specified
+      helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+      const response = await fetch(requestUrl, {
+        method: 'PUT',
+        body: formDataWithTarArchive,
+        headers: helpers.createAuthHeader(this.options),
+        signal,
+      });
+
+      if (response.ok) {
+        return Promise.resolve(response.json());
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
+
+  /**
+   * Send delta catalog tar archive to update the current catalog
+   *
+   * @function updateCatalogUsingTarArchive
+   * @param {object} parameters - Additional parameters for catalog details
+   * @param {string} parameters.section - The section to update
+   * @param {string} [parameters.notification_email] - An email address to receive an email notification if the task fails
+   * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
+   * @param {file} [parameters.tarArchive] - The tar file that includes csv files
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise}
+   * @see https://docs.constructor.io/rest_api/full_catalog
+   * @example
+   * constructorio.catalog.updateCatalogUsingTarArchive({
+   *     section: 'Products',
+   *     notification_email: 'notifications@example.com',
+   *     tarArchive: tarArchiveBufferOrStream,
+   * });
+   */
+  async updateCatalogUsingTarArchive(parameters = {}, networkParameters = {}) {
+    try {
+      const { fetch } = this.options;
+      const apiKey = this.options && this.options.apiKey;
+      const controller = new AbortController();
+      const { signal } = controller;
+      const { queryParams, formData } = await createQueryParamsAndFormData(parameters);
+      const formDataWithTarArchive = await addTarArchiveToFormData(parameters, formData, 'delta', apiKey);
+      const requestUrl = createCatalogUrl('catalog', this.options, queryParams);
+
+      // Handle network timeout if specified
+      helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+      const response = await fetch(requestUrl, {
+        method: 'PATCH',
+        body: formDataWithTarArchive,
+        headers: helpers.createAuthHeader(this.options),
+        signal,
+      });
+
+      if (response.ok) {
+        return Promise.resolve(response.json());
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
+
+  /**
+   * Send patch delta tar archive to patch the current catalog
+   *
+   * @function patchCatalogUsingTarArchive
+   * @param {object} parameters - Additional parameters for catalog details
+   * @param {string} parameters.section - The section to update
+   * @param {string} [parameters.notification_email] - An email address to receive an email notification if the task fails
+   * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
+   * @param {file} [parameters.tarArchive] - The tar file that includes csv files
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise}
+   * @see https://docs.constructor.io/rest_api/full_catalog
+   * @example
+   * constructorio.catalog.patchCatalogUsingTarArchive({
+   *     section: 'Products',
+   *     notification_email: 'notifications@example.com',
+   *     tarArchive: tarArchiveBufferOrStream,
+   * });
+   */
+  async patchCatalogUsingTarArchive(parameters = {}, networkParameters = {}) {
+    try {
+      const { fetch } = this.options;
+      const apiKey = this.options && this.options.apiKey;
+      const controller = new AbortController();
+      const { signal } = controller;
+      const { queryParams, formData } = await createQueryParamsAndFormData(parameters);
+      const formDataWithTarArchive = await addTarArchiveToFormData(parameters, formData, 'delta', apiKey);
+      const requestUrl = createCatalogUrl('catalog', this.options, { ...queryParams, patch_delta: true });
+
+      // Handle network timeout if specified
+      helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+      const response = await fetch(requestUrl, {
+        method: 'PATCH',
+        body: formDataWithTarArchive,
+        headers: helpers.createAuthHeader(this.options),
+        signal,
+      });
+
+      if (response.ok) {
+        return Promise.resolve(response.json());
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
+
   /**
    * Create a facet configuration
    *
@@ -2245,7 +2424,7 @@ class Catalog {
    */
   addFacetConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, ...rest } = parameters;
@@ -2261,7 +2440,6 @@ class Catalog {
 
     // Handle network timeout if specified
     helpers.applyNetworkTimeout(this.options, networkParameters, controller);
-
     return fetch(requestUrl, {
       method: 'POST',
       body: JSON.stringify(rest),
@@ -2299,7 +2477,7 @@ class Catalog {
    */
   getFacetConfigurations(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const additionalQueryParams = {
@@ -2349,7 +2527,7 @@ class Catalog {
    */
   getFacetConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, name } = parameters;
@@ -2412,7 +2590,7 @@ class Catalog {
    */
   modifyFacetConfigurations(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, facetConfigurations } = parameters;
@@ -2486,7 +2664,7 @@ class Catalog {
    */
   replaceFacetConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, name, ...rest } = parameters;
@@ -2558,7 +2736,7 @@ class Catalog {
    */
   modifyFacetConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, name, ...rest } = parameters;
@@ -2612,7 +2790,7 @@ class Catalog {
    */
   removeFacetConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { section, name } = parameters;
@@ -2670,7 +2848,7 @@ class Catalog {
    */
   addFacetOptionConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { facetGroupName, section, ...rest } = parameters;
@@ -2735,7 +2913,7 @@ class Catalog {
    */
   addOrModifyFacetOptionConfigurations(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { facetGroupName, section, facetOptionConfigurations } = parameters;
@@ -2791,7 +2969,7 @@ class Catalog {
    */
   getFacetOptionConfigurations(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { facetGroupName, section } = parameters;
@@ -2844,7 +3022,7 @@ class Catalog {
    */
   getFacetOptionConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { facetGroupName, value, section } = parameters;
@@ -2903,7 +3081,7 @@ class Catalog {
    */
   replaceFacetOptionConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { facetGroupName, section, value, ...rest } = parameters;
@@ -2963,7 +3141,7 @@ class Catalog {
    */
   modifyFacetOptionConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { facetGroupName, section, value, ...rest } = parameters;
@@ -3017,7 +3195,7 @@ class Catalog {
    */
   removeFacetOptionConfiguration(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const { facetGroupName, value } = parameters;

package/src/modules/quizzes.js

@@ -1,6 +1,5 @@
 /* eslint-disable object-curly-newline, no-underscore-dangle */
 const qs = require('qs');
-const nodeFetch = require('node-fetch').default;
 const helpers = require('../utils/helpers');
 
 // Create URL from supplied quizId and parameters
@@ -115,7 +114,7 @@ class Quizzes {
   getQuizNextQuestion(quizId, parameters, userParameters = {}, networkParameters = {}) {
     const headers = {};
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 
@@ -191,7 +190,7 @@ class Quizzes {
   getQuizResults(quizId, parameters, userParameters = {}, networkParameters = {}) {
     let requestUrl;
     const headers = {};
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
 

package/src/modules/recommendations.js

@@ -1,6 +1,5 @@
 /* eslint-disable object-curly-newline, no-param-reassign */
 const qs = require('qs');
-const nodeFetch = require('node-fetch').default;
 const { AbortController } = require('node-abort-controller');
 const helpers = require('../utils/helpers');
 
@@ -129,7 +128,7 @@ class Recommendations {
    */
   getRecommendations(podId, parameters = {}, userParameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = {};
@@ -205,7 +204,7 @@ class Recommendations {
       apiKey,
       serviceUrl,
     } = this.options;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = {};

package/src/modules/search.js

@@ -1,7 +1,6 @@
 /* eslint-disable max-len */
 /* eslint-disable object-curly-newline, no-underscore-dangle */
 const qs = require('qs');
-const nodeFetch = require('node-fetch').default;
 const { AbortController } = require('node-abort-controller');
 const helpers = require('../utils/helpers');
 
@@ -191,7 +190,7 @@ class Search {
 
   getSearchResults(query, parameters = {}, userParameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = {};

package/src/modules/tasks.js

@@ -1,6 +1,5 @@
 /* eslint-disable object-curly-newline, no-underscore-dangle, max-len */
 const qs = require('qs');
-const nodeFetch = require('node-fetch').default;
 const { AbortController } = require('node-abort-controller');
 const helpers = require('../utils/helpers');
 
@@ -58,7 +57,7 @@ class Tasks {
   getAllTasks(parameters = {}, networkParameters = {}) {
     const queryParams = {};
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = {
@@ -134,7 +133,7 @@ class Tasks {
    */
   getTask(parameters = {}, networkParameters = {}) {
     let requestUrl;
-    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const { fetch } = this.options;
     const controller = new AbortController();
     const { signal } = controller;
     const headers = {

package/src/modules/tracker.js

@@ -1,6 +1,5 @@
 /* eslint-disable camelcase, no-underscore-dangle, no-unneeded-ternary, brace-style */
 const qs = require('qs');
-const nodeFetch = require('node-fetch').default;
 const { AbortController } = require('node-abort-controller');
 const EventEmitter = require('events');
 const helpers = require('../utils/helpers');
@@ -79,7 +78,7 @@ function applyParamsAsString(parameters, userParameters, options) {
 // Send request to server
 function send(url, userParameters, networkParameters, method = 'GET', body = {}) { // eslint-disable-line max-params
   let request;
-  const fetch = (this.options && this.options.fetch) || nodeFetch;
+  const { fetch } = this.options;
   const controller = new AbortController();
   const { signal } = controller;
   const headers = {};
@@ -273,6 +272,7 @@ class Tracker {
    * @param {object} parameters - Additional parameters to be sent with request
    * @param {string} parameters.item_name - Product item name
    * @param {string} parameters.item_id - Product item unique identifier
+   * @param {string} parameters.url - Current page URL
    * @param {string} [parameters.variation_id] - Product item variation unique identifier
    * @param {object} userParameters - Parameters relevant to the user request
    * @param {number} userParameters.sessionId - Session ID, utilized to personalize results
@@ -294,41 +294,57 @@ class Tracker {
    *     {
    *         item_name: 'Red T-Shirt',
    *         item_id: 'KMH876',
+   *         url: 'https://constructor.io/product/KMH876',
    *     },
    * );
    */
   trackItemDetailLoad(parameters, userParameters, networkParameters = {}) {
     // Ensure parameters are provided (required)
     if (parameters && typeof parameters === 'object' && !Array.isArray(parameters)) {
-      const url = `${this.options.serviceUrl}/behavior?`;
-      const queryParams = { action: 'item_detail_load' };
-      const { item_name, name, item_id, customer_id, variation_id } = parameters;
+      const requestPath = `${this.options.serviceUrl}/v2/behavioral_action/item_detail_load?`;
+      const bodyParams = {};
+      const {
+        item_name,
+        name,
+        item_id,
+        customer_id,
+        variation_id,
+        url,
+      } = parameters;
 
       // 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;
+      }
+
+      if (url) {
+        bodyParams.url = url;
       }
 
-      const requestUrl = `${url}${applyParamsAsString(queryParams, userParameters, this.options)}`;
+      const requestUrl = `${requestPath}${applyParamsAsString({}, userParameters, this.options)}`;
+      const requestMethod = 'POST';
+      const requestBody = applyParams(bodyParams, userParameters, { ...this.options, requestMethod });
 
       send.call(
         this,
         requestUrl,
         userParameters,
         networkParameters,
+        requestMethod,
+        requestBody,
       );
 
       return true;