@mparticle/web-rokt-kit 1.2.1 → 1.3.1

package/dist/Rokt-Kit.common.js

@@ -34,19 +34,49 @@ var constructor = function () {
     self.filteredUser = {};
     self.userAttributes = {};
 
+    /**
+     * Passes attributes to the Rokt Web SDK for client-side hashing
+     * @see https://docs.rokt.com/developers/integration-guides/web/library/integration-launcher#hash-attributes
+     * @param {Object} attributes - The attributes to be hashed
+     * @returns {Promise<Object|null>} A Promise resolving to the
+     * hashed attributes from the launcher, or `null` if the kit is not initialized
+     */
+    function hashAttributes(attributes) {
+        if (!isInitialized()) {
+            console.error('Rokt Kit: Not initialized');
+            return null;
+        }
+        return self.launcher.hashAttributes(attributes);
+    }
+
     function initForwarder(
         settings,
         _service,
         testMode,
         _trackerId,
-        filteredUserAttributes
+        filteredUserAttributes,
+        filteredUserIdentities,
+        appVersion,
+        appName,
+        customFlags
     ) {
         var accountId = settings.accountId;
         self.userAttributes = filteredUserAttributes;
         self.onboardingExpProvider = settings.onboardingExpProvider;
 
+        var integrationName =
+            customFlags && customFlags['Rokt.integrationName'];
+        var noFunctional = customFlags && customFlags['Rokt.noFunctional'];
+        var noTargeting = customFlags && customFlags['Rokt.noTargeting'];
+
+        var launcherOptions = {
+            integrationName: generateIntegrationName(integrationName),
+            noFunctional: noFunctional,
+            noTargeting: noTargeting,
+        };
+
         if (testMode) {
-            attachLauncher(accountId);
+            attachLauncher(accountId, launcherOptions);
             return;
         }
 
@@ -67,7 +97,7 @@ var constructor = function () {
                     typeof window.Rokt.createLauncher === 'function' &&
                     window.Rokt.currentLauncher === undefined
                 ) {
-                    attachLauncher(accountId);
+                    attachLauncher(accountId, launcherOptions);
                 } else {
                     console.error(
                         'Rokt object is not available after script load.'
@@ -85,12 +115,15 @@ var constructor = function () {
         }
     }
 
+    /**
+     * Selects placements for Rokt Web SDK with merged attributes, filters, and experimentation options
+     * @see https://docs.rokt.com/developers/integration-guides/web/library/select-placements-options/
+     * @param {Object} options - The options object for selecting placements containing:
+     * - identifier {string}: The placement identifier
+     * - attributes {Object}: Optional attributes to merge with existing attributes
+     * @returns {Promise<void>} A Promise resolving to the Rokt launcher's selectPlacements method with processed attributes
+     */
     function selectPlacements(options) {
-        // https://docs.rokt.com/developers/integration-guides/web/library/select-placements-options/
-        // options should contain:
-        // - identifier
-        // - attributes
-
         var attributes = (options && options.attributes) || {};
         var placementAttributes = mergeObjects(self.userAttributes, attributes);
 
@@ -154,16 +187,13 @@ var constructor = function () {
         delete self.userAttributes[key];
     }
 
-    function attachLauncher(accountId) {
-        window.Rokt.createLauncher({
-            accountId: accountId,
-            integrationName:
-                'mParticle_' +
-                'wsdkv_' +
-                window.mParticle.getVersion() +
-                '_kitv_' +
-                "1.2.1",
-        })
+    function attachLauncher(accountId, launcherOptions) {
+        var options = mergeObjects(
+            { accountId: accountId },
+            launcherOptions || {}
+        );
+
+        window.Rokt.createLauncher(options)
             .then(function (launcher) {
                 // Assign the launcher to a global variable for later access
                 window.Rokt.currentLauncher = launcher;
@@ -196,9 +226,6 @@ var constructor = function () {
             });
     }
 
-    // Called by the mParticle Rokt Manager
-    this.selectPlacements = selectPlacements;
-
     // mParticle Kit Callback Methods
     function fetchOptimizely() {
         var forwarders = window.mParticle
@@ -240,12 +267,40 @@ var constructor = function () {
         }
         return {};
     }
+
+    // Called by the mParticle Rokt Manager
+    this.selectPlacements = selectPlacements;
+    this.hashAttributes = hashAttributes;
+
+    // Kit Callback Methods
     this.init = initForwarder;
     this.setUserAttribute = setUserAttribute;
     this.onUserIdentified = onUserIdentified;
     this.removeUserAttribute = removeUserAttribute;
+
+    /**
+     * Checks if the kit is properly initialized and ready for use.
+     * Both conditions must be true:
+     * 1. self.isInitialized - Set after successful initialization of the kit
+     * 2. self.launcher - The Rokt launcher instance must be available
+     * @returns {boolean} Whether the kit is fully initialized
+     */
+    function isInitialized() {
+        return !!(self.isInitialized && self.launcher);
+    }
 };
 
+function generateIntegrationName(customIntegrationName) {
+    var coreSdkVersion = window.mParticle.getVersion();
+    var kitVersion = "1.3.1";
+    var name = 'mParticle_' + 'wsdkv_' + coreSdkVersion + '_kitv_' + kitVersion;
+
+    if (customIntegrationName) {
+        name += '_' + customIntegrationName;
+    }
+    return name;
+}
+
 function getId() {
     return moduleId;
 }

package/dist/Rokt-Kit.iife.js

@@ -33,19 +33,49 @@ var RoktKit = (function (exports) {
         self.filteredUser = {};
         self.userAttributes = {};
 
+        /**
+         * Passes attributes to the Rokt Web SDK for client-side hashing
+         * @see https://docs.rokt.com/developers/integration-guides/web/library/integration-launcher#hash-attributes
+         * @param {Object} attributes - The attributes to be hashed
+         * @returns {Promise<Object|null>} A Promise resolving to the
+         * hashed attributes from the launcher, or `null` if the kit is not initialized
+         */
+        function hashAttributes(attributes) {
+            if (!isInitialized()) {
+                console.error('Rokt Kit: Not initialized');
+                return null;
+            }
+            return self.launcher.hashAttributes(attributes);
+        }
+
         function initForwarder(
             settings,
             _service,
             testMode,
             _trackerId,
-            filteredUserAttributes
+            filteredUserAttributes,
+            filteredUserIdentities,
+            appVersion,
+            appName,
+            customFlags
         ) {
             var accountId = settings.accountId;
             self.userAttributes = filteredUserAttributes;
             self.onboardingExpProvider = settings.onboardingExpProvider;
 
+            var integrationName =
+                customFlags && customFlags['Rokt.integrationName'];
+            var noFunctional = customFlags && customFlags['Rokt.noFunctional'];
+            var noTargeting = customFlags && customFlags['Rokt.noTargeting'];
+
+            var launcherOptions = {
+                integrationName: generateIntegrationName(integrationName),
+                noFunctional: noFunctional,
+                noTargeting: noTargeting,
+            };
+
             if (testMode) {
-                attachLauncher(accountId);
+                attachLauncher(accountId, launcherOptions);
                 return;
             }
 
@@ -66,7 +96,7 @@ var RoktKit = (function (exports) {
                         typeof window.Rokt.createLauncher === 'function' &&
                         window.Rokt.currentLauncher === undefined
                     ) {
-                        attachLauncher(accountId);
+                        attachLauncher(accountId, launcherOptions);
                     } else {
                         console.error(
                             'Rokt object is not available after script load.'
@@ -84,12 +114,15 @@ var RoktKit = (function (exports) {
             }
         }
 
+        /**
+         * Selects placements for Rokt Web SDK with merged attributes, filters, and experimentation options
+         * @see https://docs.rokt.com/developers/integration-guides/web/library/select-placements-options/
+         * @param {Object} options - The options object for selecting placements containing:
+         * - identifier {string}: The placement identifier
+         * - attributes {Object}: Optional attributes to merge with existing attributes
+         * @returns {Promise<void>} A Promise resolving to the Rokt launcher's selectPlacements method with processed attributes
+         */
         function selectPlacements(options) {
-            // https://docs.rokt.com/developers/integration-guides/web/library/select-placements-options/
-            // options should contain:
-            // - identifier
-            // - attributes
-
             var attributes = (options && options.attributes) || {};
             var placementAttributes = mergeObjects(self.userAttributes, attributes);
 
@@ -153,16 +186,13 @@ var RoktKit = (function (exports) {
             delete self.userAttributes[key];
         }
 
-        function attachLauncher(accountId) {
-            window.Rokt.createLauncher({
-                accountId: accountId,
-                integrationName:
-                    'mParticle_' +
-                    'wsdkv_' +
-                    window.mParticle.getVersion() +
-                    '_kitv_' +
-                    "1.2.1",
-            })
+        function attachLauncher(accountId, launcherOptions) {
+            var options = mergeObjects(
+                { accountId: accountId },
+                launcherOptions || {}
+            );
+
+            window.Rokt.createLauncher(options)
                 .then(function (launcher) {
                     // Assign the launcher to a global variable for later access
                     window.Rokt.currentLauncher = launcher;
@@ -195,9 +225,6 @@ var RoktKit = (function (exports) {
                 });
         }
 
-        // Called by the mParticle Rokt Manager
-        this.selectPlacements = selectPlacements;
-
         // mParticle Kit Callback Methods
         function fetchOptimizely() {
             var forwarders = window.mParticle
@@ -239,12 +266,40 @@ var RoktKit = (function (exports) {
             }
             return {};
         }
+
+        // Called by the mParticle Rokt Manager
+        this.selectPlacements = selectPlacements;
+        this.hashAttributes = hashAttributes;
+
+        // Kit Callback Methods
         this.init = initForwarder;
         this.setUserAttribute = setUserAttribute;
         this.onUserIdentified = onUserIdentified;
         this.removeUserAttribute = removeUserAttribute;
+
+        /**
+         * Checks if the kit is properly initialized and ready for use.
+         * Both conditions must be true:
+         * 1. self.isInitialized - Set after successful initialization of the kit
+         * 2. self.launcher - The Rokt launcher instance must be available
+         * @returns {boolean} Whether the kit is fully initialized
+         */
+        function isInitialized() {
+            return !!(self.isInitialized && self.launcher);
+        }
     };
 
+    function generateIntegrationName(customIntegrationName) {
+        var coreSdkVersion = window.mParticle.getVersion();
+        var kitVersion = "1.3.1";
+        var name = 'mParticle_' + 'wsdkv_' + coreSdkVersion + '_kitv_' + kitVersion;
+
+        if (customIntegrationName) {
+            name += '_' + customIntegrationName;
+        }
+        return name;
+    }
+
     function getId() {
         return moduleId;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mparticle/web-rokt-kit",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "mParticle integration kit for Rokt",
   "main": "dist/Rokt-Kit.common.js",
   "files": [
@@ -14,7 +14,7 @@
     "lint": "eslint src/ test/src/",
     "lint:fix": "eslint src/ test/src/ --fix",
     "watch": "rollup --config rollup.config.js -w",
-    "watch:test": "rollup --config rollup.test.config.js -w",
+    "watch:tests": "rollup --config rollup.test.config.js -w",
     "test": "npm run build && npm run build:test && karma start test/karma.config.js",
     "test:debug": "npm run build && npm run build:test && DEBUG=true karma start test/karma.config.js"
   },