feat: make sendTrackingEvents updatable (#405)

* feat: make sendTrackingEvents updatable

This may be necessary in case a cookie consent changes and no tracking event should be dispatched anymore. This would allow it to keep the logic therefore in the client and not having to do this check before each call.

* test: add tests for setting the sendTrackingEvents property

Author: jensmeichler

spec/src/constructorio.js

@@ -279,6 +279,34 @@ describe(`ConstructorIO${bundledDescriptionSuffix}`, () => {
       expect(instance.options).to.have.property('testCells').to.deep.equal(newTestCells);
     });
 
+    it('Should update the client options with new sendTrackingEvents value', () => {
+      const instance = new ConstructorIO({
+        apiKey: validApiKey,
+        sendTrackingEvents: true,
+      });
+
+      expect(instance.options).to.have.property('sendTrackingEvents').to.equal(true);
+
+      instance.setClientOptions({
+        sendTrackingEvents: false,
+      });
+
+      expect(instance.options).to.have.property('sendTrackingEvents').to.equal(false);
+    });
+
+    it('Should not update the client options with undefined sendTrackingEvents value', () => {
+      const instance = new ConstructorIO({
+        apiKey: validApiKey,
+        sendTrackingEvents: true,
+      });
+
+      expect(instance.options).to.have.property('sendTrackingEvents').to.equal(true);
+
+      instance.setClientOptions({});
+
+      expect(instance.options).to.have.property('sendTrackingEvents').to.equal(true);
+    });
+
     it('Should update the options for modules with new test cells', () => {
       const oldTestCells = {
         'old-cell-name-1': 'old-cell-value-1',

src/constructorio.js

@@ -158,10 +158,11 @@ class ConstructorIO {
    * @param {object} [options.testCells] - User test cells
    * @param {number} [options.sessionId] - Session ID - Will only be set in DOM-less environments
    * @param {string} [options.userId] - User ID
+   * @param {boolean} [options.sendTrackingEvents] - Indicates if tracking events should be dispatched
    */
   setClientOptions(options) {
     if (Object.keys(options).length) {
-      const { apiKey, segments, testCells, sessionId, userId } = options;
+      const { apiKey, segments, testCells, sessionId, userId, sendTrackingEvents } = options;
 
       if (apiKey) {
         this.options.apiKey = apiKey;
@@ -175,6 +176,10 @@ class ConstructorIO {
         this.options.testCells = testCells;
       }
 
+      if (sendTrackingEvents !== undefined) {
+        this.options.sendTrackingEvents = sendTrackingEvents;
+      }
+
       // Set Session ID in dom-less environments only
       if (sessionId && !helpers.canUseDOM()) {
         this.options.sessionId = sessionId;