@constructor-io/constructorio-node 5.7.0 → 5.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-node",
-  "version": "5.7.0",
+  "version": "5.8.0",
   "description": "Constructor.io Node.js client",
   "main": "src/constructorio.js",
   "types": "src/types/constructorio.d.ts",
@@ -53,13 +53,13 @@
     "sinon": "^7.5.0",
     "sinon-chai": "^3.7.0",
     "tsd": "^0.25.0",
-    "uuid": "^8.3.2"
+    "uuid": "^14.0.0"
   },
   "dependencies": {
     "form-data": "^4.0.0",
     "node-abort-controller": "^3.0.0",
     "node-fetch": "^3.3.2",
-    "qs": "6.14.2"
+    "qs": "6.15.2"
   },
   "tsd": {
     "directory": "src/types/tests"

package/src/modules/autocomplete.js

@@ -16,6 +16,7 @@ function createAutocompleteUrl(query, parameters, userParameters, options) {
     userId,
     segments,
     testCells,
+    originReferrer,
   } = userParameters;
   let queryParams = { c: version };
 
@@ -45,6 +46,11 @@ function createAutocompleteUrl(query, parameters, userParameters, options) {
     queryParams.ui = String(userId);
   }
 
+  // Pull origin referrer from userParameters
+  if (originReferrer && typeof originReferrer === 'string') {
+    queryParams.origin_referrer = originReferrer;
+  }
+
   if (parameters) {
     const {
       numResults,
@@ -155,6 +161,7 @@ class Autocomplete {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request

package/src/modules/browse.js

@@ -16,6 +16,7 @@ function createQueryParams(parameters, userParameters, options) {
     userId,
     segments,
     testCells,
+    originReferrer,
   } = userParameters;
   let queryParams = { c: version };
 
@@ -130,6 +131,11 @@ function createQueryParams(parameters, userParameters, options) {
     queryParams.ui = String(userId);
   }
 
+  // Pull origin referrer from userParameters
+  if (originReferrer && typeof originReferrer === 'string') {
+    queryParams.origin_referrer = originReferrer;
+  }
+
   queryParams._dt = Date.now();
   queryParams = helpers.cleanParams(queryParams);
 
@@ -265,6 +271,7 @@ class Browse {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request
@@ -350,6 +357,7 @@ class Browse {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request
@@ -417,6 +425,7 @@ class Browse {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request
@@ -480,6 +489,7 @@ class Browse {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request
@@ -540,6 +550,7 @@ class Browse {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request

package/src/modules/quizzes.js

@@ -15,6 +15,7 @@ function createQuizUrl(quizId, parameters, userParameters, options, path) {
     clientId,
     userId,
     segments,
+    originReferrer,
   } = userParameters;
   const serviceUrl = 'https://quizzes.cnstrc.com';
   let queryParams = { c: version };
@@ -34,6 +35,11 @@ function createQuizUrl(quizId, parameters, userParameters, options, path) {
     queryParams.ui = String(userId);
   }
 
+  // Pull origin referrer from userParameters
+  if (originReferrer && typeof originReferrer === 'string') {
+    queryParams.origin_referrer = originReferrer;
+  }
+
   // Validate quiz id is provided
   if (!quizId || typeof quizId !== 'string') {
     throw new Error('quizId is a required parameter of type string');
@@ -124,6 +130,7 @@ class Quizzes {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request
@@ -207,6 +214,7 @@ class Quizzes {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request

package/src/modules/recommendations.js

@@ -15,6 +15,7 @@ function createRecommendationsUrl(podId, parameters, userParameters, options) {
     clientId,
     userId,
     segments,
+    originReferrer,
   } = userParameters;
   let queryParams = { c: version };
 
@@ -37,6 +38,11 @@ function createRecommendationsUrl(podId, parameters, userParameters, options) {
     queryParams.ui = String(userId);
   }
 
+  // Pull origin referrer from userParameters
+  if (originReferrer && typeof originReferrer === 'string') {
+    queryParams.origin_referrer = originReferrer;
+  }
+
   if (parameters) {
     const {
       numResults,
@@ -147,6 +153,7 @@ class Recommendations {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request

package/src/modules/search.js

@@ -18,6 +18,7 @@ function createSearchUrl(query, parameters, userParameters, options, isVoiceSear
     userId,
     segments,
     testCells,
+    originReferrer,
   } = userParameters;
   let queryParams = { c: version };
 
@@ -47,6 +48,11 @@ function createSearchUrl(query, parameters, userParameters, options, isVoiceSear
     queryParams.ui = String(userId);
   }
 
+  // Pull origin referrer from userParameters
+  if (originReferrer && typeof originReferrer === 'string') {
+    queryParams.origin_referrer = originReferrer;
+  }
+
   if (parameters) {
     const {
       page,
@@ -186,6 +192,7 @@ class Search {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request
@@ -288,6 +295,7 @@ class Search {
    * @param {string} [userParameters.userId] - User ID, utilized to personalize results
    * @param {string[]} [userParameters.segments] - User segments
    * @param {object} [userParameters.testCells] - User test cells
+   * @param {string} [userParameters.originReferrer] - Client page URL (including path)
    * @param {string} [userParameters.userIp] - Origin user IP, from client
    * @param {string} [userParameters.userAgent] - Origin user agent, from client
    * @param {object} [networkParameters] - Parameters relevant to the network request

package/src/types/index.d.ts

@@ -27,6 +27,7 @@ export interface UserParameters {
   userId?: string;
   segments?: string[];
   testCells?: Record<string, any>;
+  originReferrer?: string;
   userIp?: string;
   userAgent?: string;
 }