@constructor-io/constructorio-node 3.6.1 → 3.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-node",
-  "version": "3.6.1",
+  "version": "3.8.0",
   "description": "Constructor.io Node.js client",
   "main": "src/constructorio.js",
   "scripts": {

package/src/constructorio.js

@@ -7,6 +7,7 @@ const Autocomplete = require('./modules/autocomplete');
 const Recommendations = require('./modules/recommendations');
 const Tracker = require('./modules/tracker');
 const Catalog = require('./modules/catalog');
+const Tasks = require('./modules/tasks');
 const { version: packageVersion } = require('../package.json');
 
 /**
@@ -28,6 +29,7 @@ class ConstructorIO {
    * @property {object} recommendations - Interface to {@link module:recommendations}
    * @property {object} tracker - Interface to {@link module:tracker}
    * @property {object} catalog - Interface to {@link module:catalog}
+   * @property {object} tasks - Interface to {@link module:tasks}
    * @returns {class}
    */
   constructor(options = {}) {
@@ -62,6 +64,7 @@ class ConstructorIO {
     this.recommendations = new Recommendations(this.options);
     this.tracker = new Tracker(this.options);
     this.catalog = new Catalog(this.options);
+    this.tasks = new Tasks(this.options);
   }
 }
 

package/src/modules/tasks.js

@@ -0,0 +1,141 @@
+/* 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');
+
+// Create URL from supplied path and options
+function createTaskUrl(path, options, additionalQueryParams = {}, apiVersion = 'v1') {
+  const {
+    apiKey,
+    serviceUrl,
+  } = options;
+  let queryParams = {
+    ...additionalQueryParams,
+  };
+
+  // Validate path is provided
+  if (!path || typeof path !== 'string') {
+    throw new Error('path is a required parameter of type string');
+  }
+
+  queryParams.key = apiKey;
+  queryParams = helpers.cleanParams(queryParams);
+
+  const queryString = qs.stringify(queryParams, { indices: false });
+
+  return `${serviceUrl}/${encodeURIComponent(apiVersion)}/${encodeURIComponent(path)}?${queryString}`;
+}
+
+/**
+ * Interface to task related API calls
+ *
+ * @module tasks
+ * @inner
+ * @returns {object}
+ */
+class Tasks {
+  constructor(options) {
+    this.options = options || {};
+  }
+
+  /**
+   * Retrieve all tasks from index
+   *
+   * @function getAllTasks
+   * @param {object} parameters - Additional parameters for task details
+   * @param {number} [parameters.num_results_per_page = 20] - The number of tasks to return - maximum value 100
+   * @param {number} [parameters.page = 1] - The page of results to return
+   * @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/tasks/#retrieve-all-tasks
+   */
+  getAllTasks(parameters = {}, networkParameters = {}) {
+    const queryParams = {};
+    let requestUrl;
+    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const controller = new AbortController();
+    const { signal } = controller;
+
+    if (parameters) {
+      const { num_results_per_page: numResultsPerPage, page } = parameters;
+
+      // Pull number of results per page from parameters
+      if (numResultsPerPage) {
+        queryParams.num_results_per_page = numResultsPerPage;
+      }
+
+      // Pull page from parameters
+      if (page) {
+        queryParams.page = page;
+      }
+    }
+
+    try {
+      requestUrl = createTaskUrl('tasks', this.options, queryParams);
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    }).then((json) => json);
+  }
+
+  /**
+   * Retrieve task given a specific id
+   *
+   * @function getTask
+   * @param {object} parameters - Additional parameters for task details
+   * @param {string} parameters.id - The ID of the task to be retrieved
+   * @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/tasks/#retrieve-by-specific-task-id
+   */
+  getTask(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const fetch = (this.options && this.options.fetch) || nodeFetch;
+    const controller = new AbortController();
+    const { signal } = controller;
+
+    try {
+      requestUrl = createTaskUrl(`tasks/${parameters.id}`, this.options);
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    }).then((json) => json);
+  }
+}
+
+module.exports = Tasks;

package/src/modules/tracker.js

@@ -477,6 +477,7 @@ class Tracker {
         const url = `${this.options.serviceUrl}/behavior?`;
         const queryParams = { action: 'search-results', term };
         const { num_results, customer_ids, item_ids } = parameters;
+        let customerIDs;
 
         if (!helpers.isNil(num_results)) {
           queryParams.num_results = num_results;
@@ -484,9 +485,13 @@ class Tracker {
 
         // Ensure support for both item_ids and customer_ids as parameters
         if (item_ids && Array.isArray(item_ids)) {
-          queryParams.customer_ids = item_ids.join(',');
+          customerIDs = item_ids;
         } else if (customer_ids && Array.isArray(customer_ids)) {
-          queryParams.customer_ids = customer_ids.join(',');
+          customerIDs = customer_ids;
+        }
+
+        if (customerIDs && Array.isArray(customerIDs) && customerIDs.length) {
+          queryParams.customer_ids = customerIDs.slice(0, 100).join(',');
         }
 
         const requestUrl = `${url}${applyParamsAsString(queryParams, userParameters, this.options)}`;
@@ -777,7 +782,7 @@ class Tracker {
       }
 
       if (items && Array.isArray(items)) {
-        bodyParams.items = items;
+        bodyParams.items = items.slice(0, 100);
       }
 
       if (revenue) {
@@ -1156,7 +1161,7 @@ class Tracker {
       }
 
       if (items && Array.isArray(items)) {
-        bodyParams.items = items;
+        bodyParams.items = items.slice(0, 100);
       }
 
       const requestUrl = `${requestPath}${applyParamsAsString({}, userParameters, this.options)}`;

package/src/utils/helpers.js

@@ -58,7 +58,9 @@ const utils = {
   // Abort network request based on supplied timeout interval (in milliseconds)
   // - method call parameter takes precedence over global options parameter
   applyNetworkTimeout: (options = {}, networkParameters = {}, controller = undefined) => {
-    const timeout = options.networkParameters.timeout || networkParameters.timeout;
+    const optionsTimeout = options && options.networkParameters && options.networkParameters.timeout;
+    const networkParametersTimeout = networkParameters && networkParameters.timeout;
+    const timeout = optionsTimeout || networkParametersTimeout;
 
     if (typeof timeout === 'number') {
       setTimeout(() => controller.abort(), timeout);