@mparticle/web-rokt-kit 1.4.0 → 1.5.0

package/README.md

@@ -1 +1,26 @@
-# mparticle-javascript-integration-rokt
+# mParticle Rokt Kit Integration
+
+# Usage
+JS kits are automatically included with your mParticle.js file when loading mParticle via the [snippet](https://docs.mparticle.com/developers/sdk/web/getting-started/#add-the-sdk-snippet).
+
+If loading mParticle via [npm](https://docs.mparticle.com/developers/sdk/web/self-hosting/), you will have to manually include the Rokt kit via npm.
+
+```
+npm i @mparticle/web-rokt-kit
+```
+
+# License
+
+Copyright 2025 mParticle, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/Rokt-Kit.common.js

@@ -17,8 +17,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 //  See the License for the specific language governing permissions and
 //  limitations under the License.
 
-var roktLauncherScript = 'https://apps.rokt.com/wsdk/integrations/launcher.js';
-
 var name = 'Rokt';
 var moduleId = 181;
 
@@ -34,6 +32,20 @@ var constructor = function () {
     self.filteredUser = {};
     self.userAttributes = {};
 
+    /**
+     * Generates the Rokt launcher script URL with optional domain override
+     * @param {string} domain - The CNAME domain to use for overriding the launcher url
+     * @returns {string} The complete launcher script URL
+     */
+    function generateLauncherScript(_domain) {
+        // Override domain if a customer is using a CNAME
+        // If a customer is using a CNAME, a domain will be passed. If not, we use the default domain.
+        var domain = typeof _domain !== 'undefined' ? _domain : 'apps.rokt.com';
+        var protocol = 'https://';
+        var launcherPath = '/wsdk/integrations/launcher.js';
+
+        return [protocol, domain, launcherPath].join('');
+    }
     /**
      * 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
@@ -59,17 +71,17 @@ var constructor = function () {
         var accountId = settings.accountId;
         self.userAttributes = filteredUserAttributes;
         self.onboardingExpProvider = settings.onboardingExpProvider;
-
-        var managerOptions = window.mParticle.Rokt.managerOptions || {};
-        var sandbox = managerOptions.sandbox || false;
-
+        var domain = window.mParticle.Rokt.domain;
         var launcherOptions = window.mParticle.Rokt.launcherOptions || {};
         launcherOptions.integrationName = generateIntegrationName(
             launcherOptions.integrationName
         );
 
         if (testMode) {
-            attachLauncher(accountId, sandbox, launcherOptions);
+            self.testHelpers = {
+                generateLauncherScript: generateLauncherScript,
+            };
+            attachLauncher(accountId, launcherOptions);
             return;
         }
 
@@ -77,7 +89,7 @@ var constructor = function () {
             var target = document.head || document.body;
             var script = document.createElement('script');
             script.type = 'text/javascript';
-            script.src = roktLauncherScript;
+            script.src = generateLauncherScript(domain);
             script.async = true;
             script.crossOrigin = 'anonymous';
             script.fetchPriority = 'high';
@@ -90,7 +102,7 @@ var constructor = function () {
                     typeof window.Rokt.createLauncher === 'function' &&
                     window.Rokt.currentLauncher === undefined
                 ) {
-                    attachLauncher(accountId, sandbox, launcherOptions);
+                    attachLauncher(accountId, launcherOptions);
                 } else {
                     console.error(
                         'Rokt object is not available after script load.'
@@ -180,11 +192,10 @@ var constructor = function () {
         delete self.userAttributes[key];
     }
 
-    function attachLauncher(accountId, sandbox, launcherOptions) {
+    function attachLauncher(accountId, launcherOptions) {
         var options = mergeObjects(
             {
                 accountId: accountId,
-                sandbox: sandbox,
             },
             launcherOptions || {}
         );
@@ -288,7 +299,7 @@ var constructor = function () {
 
 function generateIntegrationName(customIntegrationName) {
     var coreSdkVersion = window.mParticle.getVersion();
-    var kitVersion = "1.4.0";
+    var kitVersion = "1.5.0";
     var name = 'mParticle_' + 'wsdkv_' + coreSdkVersion + '_kitv_' + kitVersion;
 
     if (customIntegrationName) {

package/dist/Rokt-Kit.iife.js

@@ -16,8 +16,6 @@ var RoktKit = (function (exports) {
     //  See the License for the specific language governing permissions and
     //  limitations under the License.
 
-    var roktLauncherScript = 'https://apps.rokt.com/wsdk/integrations/launcher.js';
-
     var name = 'Rokt';
     var moduleId = 181;
 
@@ -33,6 +31,20 @@ var RoktKit = (function (exports) {
         self.filteredUser = {};
         self.userAttributes = {};
 
+        /**
+         * Generates the Rokt launcher script URL with optional domain override
+         * @param {string} domain - The CNAME domain to use for overriding the launcher url
+         * @returns {string} The complete launcher script URL
+         */
+        function generateLauncherScript(_domain) {
+            // Override domain if a customer is using a CNAME
+            // If a customer is using a CNAME, a domain will be passed. If not, we use the default domain.
+            var domain = typeof _domain !== 'undefined' ? _domain : 'apps.rokt.com';
+            var protocol = 'https://';
+            var launcherPath = '/wsdk/integrations/launcher.js';
+
+            return [protocol, domain, launcherPath].join('');
+        }
         /**
          * 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
@@ -58,17 +70,17 @@ var RoktKit = (function (exports) {
             var accountId = settings.accountId;
             self.userAttributes = filteredUserAttributes;
             self.onboardingExpProvider = settings.onboardingExpProvider;
-
-            var managerOptions = window.mParticle.Rokt.managerOptions || {};
-            var sandbox = managerOptions.sandbox || false;
-
+            var domain = window.mParticle.Rokt.domain;
             var launcherOptions = window.mParticle.Rokt.launcherOptions || {};
             launcherOptions.integrationName = generateIntegrationName(
                 launcherOptions.integrationName
             );
 
             if (testMode) {
-                attachLauncher(accountId, sandbox, launcherOptions);
+                self.testHelpers = {
+                    generateLauncherScript: generateLauncherScript,
+                };
+                attachLauncher(accountId, launcherOptions);
                 return;
             }
 
@@ -76,7 +88,7 @@ var RoktKit = (function (exports) {
                 var target = document.head || document.body;
                 var script = document.createElement('script');
                 script.type = 'text/javascript';
-                script.src = roktLauncherScript;
+                script.src = generateLauncherScript(domain);
                 script.async = true;
                 script.crossOrigin = 'anonymous';
                 script.fetchPriority = 'high';
@@ -89,7 +101,7 @@ var RoktKit = (function (exports) {
                         typeof window.Rokt.createLauncher === 'function' &&
                         window.Rokt.currentLauncher === undefined
                     ) {
-                        attachLauncher(accountId, sandbox, launcherOptions);
+                        attachLauncher(accountId, launcherOptions);
                     } else {
                         console.error(
                             'Rokt object is not available after script load.'
@@ -179,11 +191,10 @@ var RoktKit = (function (exports) {
             delete self.userAttributes[key];
         }
 
-        function attachLauncher(accountId, sandbox, launcherOptions) {
+        function attachLauncher(accountId, launcherOptions) {
             var options = mergeObjects(
                 {
                     accountId: accountId,
-                    sandbox: sandbox,
                 },
                 launcherOptions || {}
             );
@@ -287,7 +298,7 @@ var RoktKit = (function (exports) {
 
     function generateIntegrationName(customIntegrationName) {
         var coreSdkVersion = window.mParticle.getVersion();
-        var kitVersion = "1.4.0";
+        var kitVersion = "1.5.0";
         var name = 'mParticle_' + 'wsdkv_' + coreSdkVersion + '_kitv_' + kitVersion;
 
         if (customIntegrationName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mparticle/web-rokt-kit",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "mParticle integration kit for Rokt",
   "main": "dist/Rokt-Kit.common.js",
   "files": [