[CSL 3342] Add parameters to getRecommendationsPod

spec/src/modules/recommendations.js

@@ -675,6 +675,38 @@ describe('ConstructorIO - Recommendations', () => {
       });
     });
 
+    it('Should add the section query param when section parameter is provided', (done) => {
+      const { recommendations } = new ConstructorIO({
+        ...validOptions,
+        fetch: fetchSpy,
+      });
+      const parameters = { section: 'Products' };
+
+      recommendations.getRecommendationPods(null, parameters).then(() => {
+        const url = helpers.extractUrlFromFetch(fetchSpy);
+        const queryParam = '&section=Products';
+
+        expect(url).to.contain(queryParam);
+        done();
+      });
+    });
+
+    it('Should not add the section query param if it is not provided', (done) => {
+      const { recommendations } = new ConstructorIO({
+        ...validOptions,
+        fetch: fetchSpy,
+      });
+      const parameters = {};
+
+      recommendations.getRecommendationPods(null, parameters).then(() => {
+        const url = helpers.extractUrlFromFetch(fetchSpy);
+        const queryParam = '&section=Products';
+
+        expect(url).not.to.contain(queryParam);
+        done();
+      });
+    });
+
     it('Should be rejected when invalid apiKey is provided', () => {
       const { recommendations } = new ConstructorIO({ ...validOptions, apiKey: 'fyzs7tfF8L161VoAXQ8u' });
 

src/modules/recommendations.js

@@ -201,11 +201,13 @@ class Recommendations {
    * @function getRecommendationPods
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @param {object} [parameters] - Additional parameters to refine results
+   * @param {string} [parameters.section] - The section to return results from
    * @returns {Promise}
    * @example
    * constructorio.recommendations.getRecommendationPods();
    */
-  getRecommendationPods(networkParameters = {}) {
+  getRecommendationPods(networkParameters = {}, parameters = {}) {
     const {
       apiKey,
       serviceUrl,
@@ -214,7 +216,10 @@ class Recommendations {
     const controller = new AbortController();
     const { signal } = controller;
     const headers = {};
-    const requestUrl = `${serviceUrl}/v1/recommendation_pods?key=${apiKey}`;
+    const { section } = parameters;
+    const rawQueryParams = section ? qs.stringify({ section }) : '';
+    const queryParams = rawQueryParams ? `&${rawQueryParams}` : '';
+    const requestUrl = `${serviceUrl}/v1/recommendation_pods?key=${apiKey}${queryParams}`.trim();
 
     Object.assign(headers, helpers.combineCustomHeaders(this.options, networkParameters));