@pendo/agent 2.306.1 → 2.308.0

package/dist/pendo.module.js

@@ -2789,19 +2789,21 @@ var ConfigReader = (function () {
     function initializeOptions() {
         // Core
         /**
-         * When included, all analytics events will be sent to each of the api keys in the list (guide events are
-         * only sent to the primary api key). This will only function if there are no `additionalApiKeys` set on
+         * Formerly `additionalApiKeys`. When included, all analytics events will be sent to each of the public app IDs in the list (guide events are
+         * only sent to the primary public app ID). This will only function if there are no `additionalPublicAppIds` set on
          * the configuration included in the downloaded Agent.
          *
          * @access public
          * @category Config/Core
-         * @name additionalApiKeys
+         * @name additionalPublicAppIds
          * @default []
          * @type {string[]}
          */
+        addOption('additionalPublicAppIds', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('additionalApiKeys', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('allowedOriginServers');
         addOption('allowedOriginServerHashes');
+        addOption('allowMixedApplicationFrames', [SNIPPET_SRC, PENDO_CONFIG_SRC], true);
         addOption('allowMixedApiKeyFrames', [SNIPPET_SRC, PENDO_CONFIG_SRC], true);
         /**
          * A function that returns either an array of strings or an object to decorate the url for events.
@@ -2815,15 +2817,16 @@ var ConfigReader = (function () {
          */
         addOption('annotateUrl', [SNIPPET_SRC]);
         /**
-         * A primary api key to send data to from the Agent. This will only function if there is no `apiKey` set
+         * Formerly `apiKey`. A primary public app ID to send data to from the Agent. This will only function if there is no `publicAppId` set
          * on the configuration included in the downloaded Agent.
          *
          * @access public
          * @category Config/Core
-         * @name apiKey
+         * @name publicAppId
          * @default undefined
          * @type {string}
          */
+        addOption('publicAppId', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('apiKey', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('assetHost', [SNIPPET_SRC, PENDO_CONFIG_SRC]);
         /**
@@ -3461,18 +3464,19 @@ var ConfigReader = (function () {
          */
         addOption('inlineStyleNonce', [SNIPPET_SRC]);
         /**
-         * Specify a preferred apiKey to lead the multi-apiKey iframe installations to make decisions about automatic
-         * guide display. In installations with more than 2 apiKeys, the leaderKey can be specified as a priority
-         * list (e.g. `leaderKey: ['key1', 'key2', ...]`). Either all frames must agree on the leaderKey setting,
-         * or only one frame should specify the leaderKey. If neither of these conditions are met, the default leader
+         * Formerly `leaderKey` Specify a preferred publicAppId to lead the multi-application iframe installation to make decisions about automatic
+         * guide display. In installations with more than 2 publicAppIds, the leaderApplication can be specified as a priority
+         * list (e.g. `leaderApplication: ['key1', 'key2', ...]`). Either all frames must agree on the leaderApplication setting,
+         * or only one frame should specify the leaderApplication. If neither of these conditions are met, the default leader
          * determination logic (top frame or earliest to join) will be used.
          *
          * @access public
          * @category Config/Guides
-         * @name leaderKey
+         * @name leaderApplication
          * @default []
          * @type {string[]}
          */
+        addOption('leaderApplication', [SNIPPET_SRC, PENDO_CONFIG_SRC], []);
         addOption('leaderKey', [SNIPPET_SRC, PENDO_CONFIG_SRC], []);
         /**
          * If `true`, custom code blocks in building block guides will not be allowed to run. Also, classic guides
@@ -3533,6 +3537,8 @@ var ConfigReader = (function () {
         addOption('designerAgentPluginsLoader', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('guideContentLoader', [PENDO_CONFIG_SRC]);
         addOption('trainingPartner');
+        addOption('oemAccountId', [SNIPPET_SRC]);
+        addOption('whiteLabelSettings', [PENDO_CONFIG_SRC]);
         // Frustration
         addOption('errorClickLogging', [PENDO_CONFIG_SRC], false);
         // Embedded Guides
@@ -3541,6 +3547,7 @@ var ConfigReader = (function () {
         addOption('formValidation', [PENDO_CONFIG_SRC], false);
         // Performance Metrics
         addOption('performanceMetricsEnabled', [SNIPPET_SRC, PENDO_CONFIG_SRC], true);
+        addOption('performanceMetricsSampleRate', [SNIPPET_SRC, PENDO_CONFIG_SRC], 0);
     }
     initializeOptions();
     var sourceGetters = {};
@@ -3905,16 +3912,16 @@ let SERVER = '';
 let ASSET_HOST = '';
 let ASSET_PATH = '';
 let DESIGNER_SERVER = '';
-let VERSION = '2.306.1_';
-let PACKAGE_VERSION = '2.306.1';
+let VERSION = '2.308.0_';
+let PACKAGE_VERSION = '2.308.0';
 let LOADER = 'xhr';
 /* eslint-enable agent-eslint-rules/no-gulp-env-references */
 /**
- * Returns current version of the Agent as a string. Also directly accessible at `pendo.VERSION`.
+ * Returns current version of the Pendo Web SDK as a string. Also directly accessible at `pendo.VERSION`.
  *
  * @access public
- * @category Agent
- * @returns {string} agent version
+ * @category Core
+ * @returns {string} web SDK version
  * @example
  * pendo.getVersion() => '2.150.0'
  */
@@ -5935,7 +5942,7 @@ function get_visitor_id_public() {
     return get_visitor_id() || generate_anonymous_visitor_id();
 }
 /**
- * Sets visitor id for the agent. Requires a valid visitor id string. This will not change
+ * Sets visitor id for the web SDK. Requires a valid visitor id string. This will not change
  * or clear existing visitor metadata set.
  *
  * @access public
@@ -5978,7 +5985,7 @@ var get_account_id = function () {
     return pendo$1.accountId;
 };
 /**
- * Sets account id for the agent without changing existing metadata. However,
+ * Sets account id for the web SDK without changing existing metadata. However,
  * An invalid account id or an explicit `null` value will clear the current account id
  * and account metadata.
  *
@@ -9552,7 +9559,7 @@ var objectToQueryString = function (obj) {
     }, '');
 };
 /**
- * URL getter that will return the URL that will be used by the Agent to describe all data events
+ * URL getter that will return the URL that will be used by the web SDK to describe all data events
  * collected for this app and for Guide requests. This URL can differ from the browser's URL based on
  * customizations made by the host application. The URL customizations can be learned about [here](https://agent.pendo.io/advanced/location).
  *
@@ -9624,6 +9631,23 @@ function treatAsAdoptPartner() {
     // but the agent mechanisms should function identically (at least for now)
     return ConfigReader.get('trainingPartner', false) || adoptAnalyticsForwarding;
 }
+/**
+ * Adds account ID parameters for adopt partner requests
+ * Note: Caller should check treatAsAdoptPartner() before calling this function
+ * @param {Object} params - Object to add parameters to (queryString, params, etc.)
+ * @param {string} accountId - Account ID to use for 'acc' parameter
+ * @param {string} [oemAccountId] - Optional OEM account ID, should take priority over accountId
+ * @returns {Object} The params object with account parameters added
+ */
+function addAccountIdParams(params, accountId, oemAccountId) {
+    if (oemAccountId) {
+        params.acc = base64EncodeString(oemAccountId);
+    }
+    else if (accountId && accountId !== 'ACCOUNT-UNIQUE-ID') {
+        params.acc = base64EncodeString(accountId);
+    }
+    return params;
+}
 
 // other node types can be read about here:
 // https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeType
@@ -9723,6 +9747,11 @@ function getAbsolutePosition(element, parentElement, _win) {
     var terminalParent = isOffsetParent(parentElement) ? parentElement : getOffsetParent(parentElement, _win);
     var parentRect = terminalParent ? getScreenPosition(terminalParent) : { top: 0, left: 0 };
     var elemRect = getScreenPosition(element);
+    const invertedMatrix2d = calculateInverseTransformMatrix2d(terminalParent);
+    if (invertedMatrix2d) {
+        parentRect = applyMatrix2dRect(invertedMatrix2d, parentRect);
+        elemRect = applyMatrix2dRect(invertedMatrix2d, elemRect);
+    }
     var elementPosition = {
         top: elemRect.top - parentRect.top,
         left: elemRect.left - parentRect.left,
@@ -9769,6 +9798,59 @@ function getScreenPosition(element) {
         height: rect.height || Math.abs(rect.bottom - rect.top)
     };
 }
+function calculateInverseTransformMatrix2d(element) {
+    if (!element)
+        return;
+    const computedStyle = getComputedStyle_safe(element);
+    const matrix2d = parseCssMatrix(computedStyle.transform);
+    if (matrix2d && /^0px\s+0px/.test(computedStyle.transformOrigin)) {
+        // only consider 2D tranforms that have a computed origin of top left
+        return invertMatrix2d(matrix2d);
+    }
+}
+function parseCssMatrix(cssMatrix) {
+    if (!/^matrix\(/.test(cssMatrix))
+        return;
+    return cssMatrix.split(/\(|,|\)/).slice(1, -1).map((v) => parseFloat(v));
+}
+function invertMatrix2d([a, b, c, d, e, f]) {
+    const determinant = a * d - b * c;
+    // Matrix is not invertible if determinant is 0
+    if (determinant === 0) {
+        return null;
+    }
+    // Invert the 2D matrix
+    // | a c e |
+    // | b d f |
+    // | 0 0 1 |
+    return [
+        d / determinant,
+        -b / determinant,
+        -c / determinant,
+        a / determinant,
+        (c * f - d * e) / determinant,
+        (b * e - a * f) / determinant
+    ];
+}
+function applyMatrix2d([a, b, c, d, e, f], [x, y]) {
+    return [
+        a * x + c * y + e,
+        b * x + d * y + f
+    ];
+}
+function applyMatrix2dRect(matrix2d, rect) {
+    const topLeft = applyMatrix2d(matrix2d, [rect.left, rect.top]);
+    const bottomRight = applyMatrix2d(matrix2d, [rect.right, rect.bottom]);
+    const transformedRect = {
+        top: topLeft[1],
+        left: topLeft[0],
+        bottom: bottomRight[1],
+        right: bottomRight[0]
+    };
+    transformedRect.width = transformedRect.right - transformedRect.left;
+    transformedRect.height = transformedRect.bottom - transformedRect.top;
+    return transformedRect;
+}
 
 function getPendoCore() {
     var pendoCoreValue = ConfigReader.get('pendoCore');
@@ -9846,7 +9928,7 @@ function writeErrorPOST(msg) {
  */
 function writeMetricsPOST(payload) {
     try {
-        const url = `${HOST}/data/agentmetrics/${pendo$1.apiKey}`;
+        const url = buildBaseDataUrl('metrics', pendo$1.apiKey, { v: VERSION });
         log.debug(`Sending ${JSON.stringify(payload)} to ${url} using ${fetchKeepalive.supported() ? 'fetch' : 'xhr'}`);
         if (fetchKeepalive.supported()) {
             fetch(url, {
@@ -9912,14 +9994,14 @@ var locked = false;
  * @category Events
  * @example
  * $ pendo.stopSendingEvents()
- * > Pendo Agent locked.  No more events will be written.
+ * > Pendo Web SDK locked.  No more events will be written.
  */
 var lockEvents = function () {
     var fireEvent = isUnlocked();
     locked = true;
     if (fireEvent)
         Events['transmit:locked'].trigger();
-    return 'Pendo Agent locked.  No more events will be written.';
+    return 'Pendo Web SDK locked.  No more events will be written.';
 };
 /**
  * Starts event collection and transmission.
@@ -9929,14 +10011,14 @@ var lockEvents = function () {
  * @category Events
  * @example
  * $ pendo.startSendingEvents()
- * > Pendo Agent unlocked.  Events will be written.
+ * > Pendo Web SDK unlocked.  Events will be written.
  */
 var unlockEvents = function () {
     var fireEvent = !isUnlocked();
     locked = false;
     if (fireEvent)
         Events['transmit:unlocked'].trigger();
-    return 'Pendo Agent unlocked.  Events will be written.';
+    return 'Pendo Web SDK unlocked.  Events will be written.';
 };
 /**
  * Returns true if event collection is currently enabled.
@@ -10796,7 +10878,7 @@ function scrollIntoView(element) {
  * @class DomQuery
  * @type {Element[]}
  * @classdesc
- * Sort of like a diet, caffeine-free jQuery. Wrapper for Sizzle library with additional methods for the Pendo Agent.
+ * Sort of like a diet, caffeine-free jQuery. Wrapper for Sizzle library with additional methods for the Pendo Web SDK.
  * Use pendo.Sizzle for customer-defined selectors. Augmented Element[] used to query and alter DOM nodes.
  *
  * @access public
@@ -12399,8 +12481,11 @@ class PerformanceMonitor {
         this._markPerformance(INITIALIZE);
         this._setDebugging();
         Events.debuggerLaunched.on(this._setDebuggingBound);
+        const shouldSend = Math.random() * 100 < ConfigReader.get('performanceMetricsSampleRate');
+        this._setSending(shouldSend);
+        // interval always runs to periodically free memory used by performance api
         this.interval = setInterval(() => {
-            this.send();
+            this.send(); // includes call to _clearMarksAndMeasures()
         }, PERFORMANCE_SEND_INTERVAL);
         return () => {
             this.teardown();
@@ -12437,12 +12522,14 @@ class PerformanceMonitor {
                 return acc;
             const entries = performance.getEntriesByName(name);
             const value = instrument(entries);
-            acc.push({
-                name,
-                type,
-                value,
-                timestamp: Date.now()
-            });
+            if (value > 0) {
+                acc.push({
+                    name,
+                    type,
+                    value,
+                    timestamp: Date.now()
+                });
+            }
             return acc;
         }, []);
         this._clearMarksAndMeasures();
@@ -12783,11 +12870,11 @@ function addSiloParams(options) {
     };
 }
 function addAccountIdParamIfAdoptPartner(silo, next) {
-    var isAdoptPartner = treatAsAdoptPartner();
-    var firstEvent = _.first(silo);
-    var accountId = _.get(firstEvent, 'account_id');
-    if (isAdoptPartner && accountId) {
-        silo.params = _.extend({}, silo.params, { acc: base64EncodeString(accountId) });
+    if (treatAsAdoptPartner()) {
+        var firstEvent = _.first(silo);
+        var accountId = _.get(firstEvent, 'account_id');
+        var oemAccountId = _.get(firstEvent, 'oem_account_id');
+        addAccountIdParams(silo.params || (silo.params = {}), accountId, oemAccountId);
     }
     next(silo);
 }
@@ -13617,7 +13704,7 @@ var DEBOUNCE_INTERVAL_CHANGE = 5000;
 var handle_change_event = _.debounce(handle_event, DEBOUNCE_INTERVAL_CHANGE, true);
 /*
  * Wires up the page for all the different event driven
- * functions that the pendo agent cares about.
+ * functions that the web SDK cares about.
  *
  * input: eventlist (Array<string>) names of events
  */
@@ -13852,7 +13939,7 @@ function interceptPreventDefault(EventConstructor, eventList) {
     };
 }
 /**
- * Pendo agent’s version of attaching event listeners.
+ * Pendo Web SDK's version of attaching event listeners.
  *
  * @access public
  * @category Events
@@ -13877,7 +13964,7 @@ function attachEvent(element, evt, fn, useCapture) {
     });
 }
 /**
- * Pendo agent’s version of detaching event listeners. Callback must be a named function, cannot remove
+ * Pendo Web SDK's version of detaching event listeners. Callback must be a named function, cannot remove
  * anonymous functions.
  *
  * @access public
@@ -13920,7 +14007,12 @@ var whenLoadedCall = function (callback, win) {
         callback();
     }
     else {
-        return attachEventInternal(win, 'load', callback);
+        return attachEventInternal(win, 'load', function () {
+            // some apps fire "fake" load events APP-139170 (https://github.com/rtCamp/rt-optimizer/blob/main/rt-scripts-optimizer.php#L173)
+            if (document.readyState === 'complete') {
+                callback();
+            }
+        });
     }
     return _.noop;
 };
@@ -15495,29 +15587,55 @@ function addInlineStyles(config, id, styles, element = document.head) {
     return styleTag;
 }
 
-function syncColorMode(step, rerender = false) {
+const DARK_MODE_ATTR = 'data-pendo-dark-mode';
+/**
+ * Applies data-pendo-dark-mode attribute for CSS pseudo-styles. Requires step.guideElement.
+ */
+function applyDarkModeAttr(step) {
+    if (!step.guideElement)
+        return;
+    const guideContainer = dom('#pendo-guide-container', step.guideElement)[0];
+    if (!guideContainer)
+        return;
+    if (step.isDarkMode) {
+        guideContainer.setAttribute(DARK_MODE_ATTR, '');
+    }
+    else {
+        guideContainer.removeAttribute(DARK_MODE_ATTR);
+    }
+}
+/**
+ * Sets step.isDarkMode based on selector. Call before buildNodeFromJSON.
+ */
+function detectColorMode(step) {
     const darkModeSelector = _.get(step, 'attributes.darkMode.selector', '');
     if (!darkModeSelector)
         return;
-    // Determine the target dark mode state
     let targetDarkMode;
     if (pendo$1.designerEnabled && _.has(step, 'attributes.darkMode.override')) {
-        // In designer mode, use the override value
         targetDarkMode = step.attributes.darkMode.override;
     }
     else {
-        // In client mode, detect based on selector
         try {
             targetDarkMode = pendo$1.Sizzle(darkModeSelector).length > 0;
         }
         catch (e) {
-            // Invalid selector - default to light mode
             targetDarkMode = false;
         }
     }
-    // Update and rerender if the state changed
-    if (step.isDarkMode !== targetDarkMode) {
-        step.isDarkMode = targetDarkMode;
+    step.isDarkMode = targetDarkMode;
+}
+/**
+ * Syncs color mode for live updates. Detects, applies attribute, and optionally rerenders.
+ */
+function syncColorMode(step, rerender = false) {
+    const darkModeSelector = _.get(step, 'attributes.darkMode.selector', '');
+    if (!darkModeSelector)
+        return;
+    const previousMode = step.isDarkMode;
+    detectColorMode(step);
+    if (previousMode !== step.isDarkMode) {
+        applyDarkModeAttr(step);
         if (rerender) {
             step.hide();
             step.show(step.seenReason);
@@ -16603,7 +16721,6 @@ var BuildingBlockTooltips = (function () {
         var caretDimensions = {
             height: parseInt(containerDomJson.props['data-caret-height'], 10) || 0,
             width: parseInt(containerDomJson.props['data-caret-width'], 10) || 0,
-            backgroundColor: containerDomJson.props.style['background-color'],
             offset: TOOLTIP_CONSTANTS.DEFAULT_CARET_OFFSET,
             borderWidth: 0
         };
@@ -16623,6 +16740,16 @@ var BuildingBlockTooltips = (function () {
             caretDimensions.borderColor = guideBorderArray[2];
             caretDimensions.borderWidth = parseInt(guideBorderArray[0], 10) || 0;
         }
+        const lightStyle = _.get(containerDomJson, 'props.style');
+        const darkModeStyle = _.get(containerDomJson, 'darkModeProps.style');
+        const backgroundColor = _.get(lightStyle, 'background-color');
+        const darkModeBackgroundColor = _.get(darkModeStyle, 'background-color');
+        if (step && step.isDarkMode && darkModeBackgroundColor) {
+            caretDimensions.backgroundColor = darkModeBackgroundColor;
+        }
+        else if (backgroundColor) {
+            caretDimensions.backgroundColor = backgroundColor;
+        }
         const tooltipSizes = {
             width: guideContainer.offsetWidth,
             height: guideContainer.offsetHeight,
@@ -18293,11 +18420,12 @@ function buildNodeFromJSON(json, step, guides) {
         }
         let css = json.css;
         if (json.forDarkMode) {
-            const darkModeSelector = _.get(step, 'attributes.darkMode.selector', '');
+            // Use data attribute on pendo-guide-container as the selector prefix
+            // syncColorMode toggles this attribute, making dark mode styles apply/not apply
             css = _.map(css, function (rule) {
                 return {
                     styles: rule.styles,
-                    selector: `${darkModeSelector} ${rule.selector}`
+                    selector: `[data-pendo-dark-mode] ${rule.selector}`
                 };
             });
         }
@@ -18650,7 +18778,7 @@ var updateVisitorOptions = function (options = {}) {
     };
 };
 /**
- * Updates metadata object for the Pendo agent. Can include visitor and/or account updates, along
+ * Updates metadata object for the Pendo Web SDK. Can include visitor and/or account updates, along
  * with customer-defined metadata values. Changes to identity information will potentially fire
  * identity and metadata events, in turn evaluating guide eligibility for the new user and displaying
  * any matching guides automatically.
@@ -18658,7 +18786,7 @@ var updateVisitorOptions = function (options = {}) {
  * @access public
  * @function
  * @category Identity
- * @param {object} options new metadata to set in the agent
+ * @param {object} options new metadata to set in the web SDK
  * @example
  * pendo.updateOptions( { visitor: { "role":"admin" } , account: { "industry":"retail" } });
  */
@@ -18719,11 +18847,11 @@ var isMetadataBlocked = function () {
 };
 function getMetadata() { return store.getters['metadata/metadata'](); }
 /**
- * Returns all metadata being passed through the agent.
+ * Returns all metadata being passed through the web SDK.
  *
  * @access public
  * @category Identity
- * @returns {JSON} metadata available to the agent
+ * @returns {JSON} metadata available to the web SDK
  * @example
  * pendo.getSerializedMetadata()
  */
@@ -19123,7 +19251,7 @@ var BuildingBlockResourceCenter = (function () {
             renderNativeIntegration(integrationProvider);
         var step = module.steps[0];
         if (step.isDarkMode === undefined) {
-            syncColorMode(step);
+            detectColorMode(step);
         }
         var domJsonToRender = updatePseudoStyleSelectors(step.domJson);
         domJsonToRender.props['data-pendo-guide-id'] = module.id;
@@ -19157,6 +19285,8 @@ var BuildingBlockResourceCenter = (function () {
         }
         step.guideElement = dom(resourceCenterContainer);
         step.elements.push(step.guideElement[0]);
+        // Apply data-pendo-dark-mode attribute for CSS pseudo-styles
+        applyDarkModeAttr(step);
         // At this point, the RC is in a state where both the module/homeView currently shown and the
         // module/homeView we are transitioning to are in the DOM. guideContainer is the module/homeView
         // we are transitioning to so we send that to adjustResourceCenterWidth so it's width can be
@@ -22395,6 +22525,17 @@ function createPreviewBar() {
         }
         var script = document.createElement('script');
         script.src = getPreviewModeAssetUrl();
+        script.onload = function () {
+            var whiteLabelSettings = ConfigReader.get('whiteLabelSettings');
+            if (whiteLabelSettings && frame.contentWindow) {
+                frame.contentWindow.postMessage({
+                    mutation: 'preview/setWhiteLabelSettings',
+                    payload: {
+                        whiteLabelSettings
+                    }
+                }, location.origin);
+            }
+        };
         frame.contentDocument.body.appendChild(script);
         frame.contentWindow.ignoreIframeMonitor = true;
     };
@@ -22578,6 +22719,15 @@ function updatePreview(document, activeGuides, lastGuideStepSeen) {
             hostname: SERVER
         }
     }, location.origin);
+    var whiteLabelSettings = ConfigReader.get('whiteLabelSettings');
+    if (whiteLabelSettings) {
+        previewFrame.contentWindow.postMessage({
+            mutation: 'preview/setWhiteLabelSettings',
+            payload: {
+                whiteLabelSettings
+            }
+        }, location.origin);
+    }
     previewFrame.contentWindow.postMessage({
         mutation: 'preview/setGuidePages',
         payload: {
@@ -22928,43 +23078,44 @@ function insertOriginContentHash(originalHash, url, extensionStr, sha256Hash) {
 }
 
 /**
-* API key that is associated with the current Pendo installation as a string.
+* Formerly `apiKey`. Public app ID that is associated with the current Pendo installation as a string.
 *
 * @access public
-* @name apiKey
+* @name publicAppId
 * @type {string}
-* @category Agent
+* @category Core
 * @example
-* pendo.apiKey => 'API_KEY'
+* pendo.publicAppId => 'PUBLIC_APP_ID'
 */
 /**
-* Array of additional API keys that are set in the config. If no primary API key is set,
-* the first in this array will be assigned to `pendo.apiKey`.
+* Formerly `additionalApiKeys`. Array of additional app IDs that are set in the config. If no primary app ID is set,
+* the first in this array will be assigned to `pendo.publicAppId`.
 *
 * @access public
-* @name additionalApiKeys
+* @name additionalPublicAppIds
 * @type {string[]}
-* @category Agent
+* @category Core
 * @example
-* pendo.additionalApiKeys => ['FIRST_API_KEY', 'SECOND_API_KEY']
+* pendo.additionalPublicAppIds => ['FIRST_PUBLIC_APP_ID', 'SECOND_PUBLIC_APP_ID']
 */
 const Keys = (function () {
     let _apiKey = null;
     let _additionalApiKeys = [];
     const setApiKey = (key) => {
         key += '';
-        pendo$1.apiKey = key;
+        pendo$1.apiKey = pendo$1.publicAppId = key;
         _apiKey = key;
     };
     const discoverApiKey = (apiKey) => {
-        apiKey = ConfigReader.get('apiKey', apiKey);
+        apiKey = ConfigReader.get('publicAppId') || ConfigReader.get('apiKey', apiKey);
         if (apiKey) {
             setApiKey(apiKey);
         }
         return _apiKey;
     };
     const discoverAdditionalApiKeys = (additionalApiKeys) => {
-        additionalApiKeys = ConfigReader.get('additionalApiKeys', additionalApiKeys);
+        additionalApiKeys = ConfigReader.get('additionalPublicAppIds') ||
+            ConfigReader.get('additionalApiKeys', additionalApiKeys);
         _additionalApiKeys = _.reduce(additionalApiKeys, (arr, key) => {
             if (key) {
                 arr.push(key + '');
@@ -22972,7 +23123,7 @@ const Keys = (function () {
             return arr;
         }, []);
         _additionalApiKeys = [].concat(additionalApiKeys);
-        pendo$1.additionalApiKeys = _additionalApiKeys;
+        pendo$1.additionalApiKeys = pendo$1.additionalPublicAppIds = _additionalApiKeys;
         return _additionalApiKeys;
     };
     return {
@@ -25765,7 +25916,6 @@ function isGuideRequestPending() {
 }
 var mostRecentGuideRequest;
 var loadGuideJs = function (apiKey, params) {
-    var isAdoptPartner = treatAsAdoptPartner();
     var guideRequestId = _.uniqueId();
     var deferred = q.defer();
     mostRecentGuideRequest = {
@@ -25793,8 +25943,8 @@ var loadGuideJs = function (apiKey, params) {
             v: VERSION,
             ct: (new Date()).getTime()
         };
-        if (isAdoptPartner && params.accountId && params.accountId !== 'ACCOUNT-UNIQUE-ID') {
-            queryString.acc = base64EncodeString(params.accountId);
+        if (treatAsAdoptPartner()) {
+            addAccountIdParams(queryString, params.accountId, ConfigReader.get('oemAccountId'));
         }
         if (isDebuggingEnabled()) {
             // Include debug info from server
@@ -25942,7 +26092,7 @@ function shouldLoadGuides(visitorId, callback) {
     return true;
 }
 /**
- * Manually load guides for current visitor and URL. This is typically handled automatically by the Agent
+ * Manually load guides for current visitor and URL. This is typically handled automatically by the web SDK
  * whenever the host Application changes its URL. In rare circumstances, a host Application may chose to
  * force the load of Guides programmatically. One reason may be in order to get any guides designed for a visitor
  * immediately after using a specific part of the Application that doesn't cause a URL change.
@@ -27332,7 +27482,7 @@ var EventRouter = function () {
             step.response(_.compact(responses));
         }
         else {
-            log.info('[Agent] Error! Trying to submit a poll response but step does not have response function!');
+            log.info('[Pendo Web SDK] Error! Trying to submit a poll response but step does not have response function!');
         }
         if (actionType !== actionKeys.submitPollAndGoToStep) {
             step.advance();
@@ -27857,7 +28007,8 @@ var initialized$1 = false;
 const PluginAPI = {
     agent: {
         getJwtInfoCopy: JWT.get,
-        treatAsAdoptPartner
+        treatAsAdoptPartner,
+        addAccountIdParams
     },
     agentStorage,
     analytics: {
@@ -28190,14 +28341,14 @@ var ResourceCenterActivity = (function () {
 })();
 
 /**
- * Returns boolean representing whether the Agent is fully loaded and has an API key.
+ * Returns boolean representing whether the Pendo Web SDK is fully loaded and has an API key.
  *
  * @access public
- * @category Agent
+ * @category Core
  * @returns {boolean}
  * @example
  * if (pendo.isReady()) {
- * // runs if agent has fully loaded
+ * // runs if web SDK has fully loaded
  * }
  */
 const isReady = (pendoObj) => {
@@ -28391,14 +28542,14 @@ function registerEventHandlers({ events = [] }) {
 let initializeCounter = 0;
 const initializeImmediately = 'initializeImmediately';
 /**
- * Initializes the Pendo agent in a browser window. This function only needs to be called once per page load. Any subsequent calls, without first having called `teardown`, will be ignored.
- * Once the agent has been initialized, any updates to identity or metadata should be done using `identify` or `updateOptions`.
+ * Initializes the Pendo Web SDK in a browser window. This function only needs to be called once per page load. Any subsequent calls, without first having called `teardown`, will be ignored.
+ * Once the web SDK has been initialized, any updates to identity or metadata should be done using `identify` or `updateOptions`.
  *
  * @access public
  * @function
- * @category Agent
+ * @category Core
  * @name initialize
- * @param {object} options identity metadata and configuration to initialize agent
+ * @param {object} options identity metadata and configuration to initialize web SDK
  * @see {@link https://support.pendo.io/hc/en-us/articles/360046272771-Developer-s-guide-to-installing-Pendo#what-installation-involves-0-2 | Pendo Installation}
  * @example
  * pendo.initialize({
@@ -28434,7 +28585,7 @@ const initialize = makeSafe(function (options) {
             log.info([
                 'pendo.initialize only needs to be called once',
                 isSfdcLightning() ? ' per namespace' : '',
-                '. Use pendo.updateOptions to update metadata after the agent has initialized.'
+                '. Use pendo.updateOptions to update metadata after the web SDK has initialized.'
             ].join(''));
         }
         return;
@@ -28656,12 +28807,12 @@ function startup(callQueue, autoInitialize, whenLoadedCall) {
     }
 }
 /**
- * Shuts down the agent and cleans up all timers and listeners. Upon completion
- * the agent will be able to be re-initialized when needed or cleaned up from
+ * Shuts down the web SDK and cleans up all timers and listeners. Upon completion
+ * the web SDK will be able to be re-initialized when needed or cleaned up from
  * the window. This will halt all guides and data collection.
  *
  * @access public
- * @category Agent
+ * @category Core
  * @returns {void}
  * @example
  * window.pendo.teardown();
@@ -28831,8 +28982,9 @@ var BuildingBlockGuides = (function () {
     function renderGuideFromJSON(json, step, guides, options) {
         options = options || {};
         var guide = step.getGuide();
+        // Set step.isDarkMode before build (used for inline styles, SVGs, dark mode props)
         if (step.isDarkMode === undefined) {
-            syncColorMode(step);
+            detectColorMode(step);
         }
         var containerJSON = findGuideContainerJSON(json);
         var isResourceCenter = _.get(guide, 'attributes.resourceCenter');
@@ -28848,6 +29000,8 @@ var BuildingBlockGuides = (function () {
         var modifiableJSON = unwrapFirefoxObject(json);
         var guideToAppend = BuildingBlockGuides.buildNodeFromJSON(modifiableJSON, step, guides);
         step.guideElement = guideToAppend;
+        // Apply data-pendo-dark-mode attribute to guide container for CSS pseudo-styles
+        applyDarkModeAttr(step);
         var guideContainer = guideToAppend.find('#' + step.containerId);
         var verticalAlignmentAttr = 'data-vertical-alignment';
         var relativeToElement = guideContainer.attr(verticalAlignmentAttr) === 'Relative to Element';
@@ -29389,7 +29543,7 @@ var getDefaultActiveContexts = function () {
     return ac.split(',');
 };
 /**
- * Enable [Agent] console logging for debugging purposes.
+ * Enable console logging for debugging purposes.
  *
  * @access public
  * @category Debugging
@@ -29408,7 +29562,7 @@ var enableLogging = function () {
     return 'logging enabled';
 };
 /**
- * Disable [Agent] console logging for debugging purposes.
+ * Disable console logging for debugging purposes.
  *
  * @access public
  * @category Debugging
@@ -29429,7 +29583,7 @@ function initLogging() {
     log.addEventListener('log', writeLog);
     /**
     * Stores console logging status, set with `pendo.enableLogging()` or `pendo.disableLogging()`.
-    * Logs will appear with `[Agent]` prefixed in the browser console.
+    * Logs will appear with `[Pendo Web SDK]` prefixed in the browser console.
     *
     * @name _pendo_log-enabled
     * @category Cookies/localStorage
@@ -29467,13 +29621,13 @@ var shouldWeLog = function (contexts) {
     return (!!logOverride || !!isDebuggingEnabled());
 };
 /**
- * Logs an output to the console as the [Agent].
+ * Logs an output to the console as the [Pendo Web SDK].
  *
  * @access public
  * @category Debugging
  * @example
  * pendo.log('hello world!')
- * // [Agent] hello world!
+ * // [Pendo Web SDK] hello world!
  */
 var logPublic = function (msg, ...contexts) {
     log.info(msg, { contexts });
@@ -29530,7 +29684,7 @@ var setActiveContexts = function (contexts) {
 var doConsoleLog = function (msg, prefix) {
     if (!canWeLog())
         return;
-    prefix = prefix || '[Agent] ';
+    prefix = prefix || '[Pendo Web SDK] ';
     if (msg && msg.length) {
         var msgStart = msg.length > 1000 ? msg.length - 1000 : 0;
         if (msgStart) {
@@ -29710,8 +29864,8 @@ var validateInstall = function validateInstall(skipLogging) {
     }
     if (!skipLogging)
         console.group('Pendo Install Validation');
-    if (!pendo$1.apiKey) {
-        handleLogging('error', 'No Pendo API key configured. Make sure to call pendo.initialize() with a valid Pendo API key.', 'apiKey');
+    if (!pendo$1.apiKey && !pendo$1.publicAppId) {
+        handleLogging('error', 'No Pendo public app ID configured. Make sure to call pendo.initialize() with a valid Pendo public app ID.', 'publicAppId');
     }
     var visitorId = get_visitor_id();
     if (isAnonymousVisitor(visitorId)) {
@@ -32684,7 +32838,7 @@ var FramesModule = (function () {
             agentStorage.registry.addSession(TAB_ID);
             /**
              * When a browser window is cloned the `pendo_tabId` is copied to the new window.
-             * The Pendo agent detects this, creates a new `pendo_tabId`, and stores the old
+             * The Pendo Web SDK detects this, creates a new `pendo_tabId`, and stores the old
              * `pendo_tabId` in `pendo_parentTabId`.
              *
              * @name pendo_parentTabId
@@ -36145,7 +36299,7 @@ function LauncherBadge(config) {
             element.src = replaceWithContentHost(config.launcherBadgeUrl);
         }
         element.onerror = function (e) {
-            log.info('[Agent] Error! Unable to load guide center image ' + config.launcherBadgeUrl);
+            log.info('[Pendo Web SDK] Error! Unable to load guide center image ' + config.launcherBadgeUrl);
             log.critical('ERROR in when attempting to render guide center badge image', { imgSrc: config.launcherBadgeUrl });
         };
         if (isBrowserInQuirksmode()) {
@@ -37645,6 +37799,43 @@ const EventProperties = (function () {
     }
 })();
 
+/**
+ * OEM Account ID Plugin
+ *
+ * This plugin reads the oemAccountId from configuration and sets it onto every
+ * captured event if the oemAccountId is defined.
+ */
+const OemAccountId = (function () {
+    let pluginAPI;
+    let oemAccountId;
+    let eventCapturedHandler;
+    return {
+        name: 'OemAccountId',
+        initialize,
+        teardown
+    };
+    function initialize(_, PluginAPI) {
+        pluginAPI = PluginAPI;
+        oemAccountId = pluginAPI.ConfigReader.get('oemAccountId');
+        if (oemAccountId) {
+            eventCapturedHandler = function (event) {
+                setOemAccountId(event);
+            };
+            pluginAPI.Events.on('eventCaptured', eventCapturedHandler);
+        }
+    }
+    function teardown() {
+        if (eventCapturedHandler) {
+            pluginAPI.Events.off('eventCaptured', eventCapturedHandler);
+        }
+    }
+    function setOemAccountId(event) {
+        if (oemAccountId && event && event.data && event.data[0]) {
+            event.data[0].oem_account_id = oemAccountId;
+        }
+    }
+})();
+
 var debugging;
 function debuggerExports() {
     return {
@@ -38390,6 +38581,12 @@ const EmbeddedGuides = (function () {
     function processEmbeddedGuides() {
         _.forEach(embeddedGuides, function (guide) {
             guide.process();
+            if (guide.isShownInThisFrame()) {
+                const activeStep = guide.getActiveStep();
+                if (activeStep) {
+                    syncColorMode(activeStep, true);
+                }
+            }
         });
     }
     function hideAllEmbeddedGuides() {
@@ -38674,8 +38871,8 @@ class SegmentFlags {
             v: this.pendo.VERSION,
             ct: (new Date()).getTime()
         };
-        if (this.api.agent.treatAsAdoptPartner() && params.accountId && params.accountId !== 'ACCOUNT-UNIQUE-ID') {
-            queryString.acc = this.api.util.base64EncodeString(params.accountId);
+        if (this.api.agent.treatAsAdoptPartner()) {
+            this.api.agent.addAccountIdParams(queryString, params.accountId, this.api.ConfigReader.get('oemAccountId'));
         }
         const endpoint = this.pendo.LOADER === 'script' ? 'segmentflag.js' : 'segmentflag.json';
         let url = this.api.transmit.buildBaseDataUrl(endpoint, this.pendo.apiKey, queryString);
@@ -40051,6 +40248,7 @@ function registerBuiltInPlugins() {
     registerPlugin(Branding);
     registerPlugin(ActionAutomation);
     registerPlugin(EventProperties);
+    registerPlugin(OemAccountId);
     registerPlugin(StepTimeoutMonitor);
     registerPlugin(DebuggerLauncher);
     registerPlugin(FrustrationEvent);
@@ -47707,6 +47905,7 @@ function record(options = {}) {
     recordDOM = true,
     recordCanvas = false,
     recordCrossOriginIframes = false,
+    emitFromIframe = false,
     recordAfter = options.recordAfter === "DOMContentLoaded" ? options.recordAfter : "load",
     userTriggeredOnInput = false,
     collectFonts = false,
@@ -47717,7 +47916,7 @@ function record(options = {}) {
     errorHandler: errorHandler2
   } = options;
   registerErrorHandler(errorHandler2);
-  const inEmittingFrame = recordCrossOriginIframes ? window.parent === window : true;
+  const inEmittingFrame = emitFromIframe ? true : recordCrossOriginIframes ? window.parent === window : true;
   let passEmitsToParent = false;
   if (!inEmittingFrame) {
     try {
@@ -53376,6 +53575,7 @@ const RECORDING_CONFIG_WORKERURL = 'recording.workerUrl';
 const RECORDING_CONFIG_ON_RECORDING_START = 'recording.onRecordingStart';
 const RECORDING_CONFIG_ON_RECORDING_STOP = 'recording.onRecordingStop';
 const RECORDING_CONFIG_WORKER_OVERRIDE = 'recording.workerOverride';
+const RECORDING_CONFIG_TREAT_IFRAME_AS_ROOT = 'recording.treatIframeAsRoot';
 const RESOURCE_CACHING = 'resourceCaching';
 const ONE_DAY_IN_MILLISECONDS = 24 * 60 * 60 * 1000;
 const THIRTY_MINUTES = 1000 * 60 * 30;
@@ -53470,6 +53670,22 @@ class SessionRecorder {
          * @type {object}
          */
         cf.addOption(RECORDING_CONFIG_WORKER_OVERRIDE, [cf.sources.PENDO_CONFIG_SRC], undefined);
+        /**
+         * Option to treat this iframe as the root recording frame.
+         *
+         * When set to true, this iframe will emit its own recording events and create its own
+         * recording session, acting as a root recording frame.
+         *
+         * When set to false or undefined (default), recording events from this iframe will be passed up
+         * to the parent frame for handling.
+         *
+         * @access public
+         * @category Config/Replay
+         * @name recording.treatIframeAsRoot
+         * @default undefined
+         * @type {boolean}
+         */
+        cf.addOption(RECORDING_CONFIG_TREAT_IFRAME_AS_ROOT, [cf.sources.SNIPPET_SRC], undefined);
         cf.addOption(RESOURCE_CACHING, [cf.sources.PENDO_CONFIG_SRC], undefined);
     }
     initialize(pendo, PluginAPI) {
@@ -53692,7 +53908,8 @@ class SessionRecorder {
             // we need to concat hidden selectors to re-use block selector logic
             blockSelector: blockedSelectors.concat(hiddenSelectors).join(','),
             hideSelector: hiddenSelectors.join(','),
-            recordCrossOriginIframes: recordingOptions.recordCrossOriginIframes != null ? recordingOptions.recordCrossOriginIframes : true
+            recordCrossOriginIframes: recordingOptions.recordCrossOriginIframes != null ? recordingOptions.recordCrossOriginIframes : true,
+            emitFromIframe: !!this.api.ConfigReader.get(RECORDING_CONFIG_TREAT_IFRAME_AS_ROOT)
         };
         return config;
     }
@@ -55987,19 +56204,21 @@ var ConfigReader = (function () {
     function initializeOptions() {
         // Core
         /**
-         * When included, all analytics events will be sent to each of the api keys in the list (guide events are
-         * only sent to the primary api key). This will only function if there are no `additionalApiKeys` set on
+         * Formerly `additionalApiKeys`. When included, all analytics events will be sent to each of the public app IDs in the list (guide events are
+         * only sent to the primary public app ID). This will only function if there are no `additionalPublicAppIds` set on
          * the configuration included in the downloaded Agent.
          *
          * @access public
          * @category Config/Core
-         * @name additionalApiKeys
+         * @name additionalPublicAppIds
          * @default []
          * @type {string[]}
          */
+        addOption('additionalPublicAppIds', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('additionalApiKeys', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('allowedOriginServers');
         addOption('allowedOriginServerHashes');
+        addOption('allowMixedApplicationFrames', [SNIPPET_SRC, PENDO_CONFIG_SRC], true);
         addOption('allowMixedApiKeyFrames', [SNIPPET_SRC, PENDO_CONFIG_SRC], true);
         /**
          * A function that returns either an array of strings or an object to decorate the url for events.
@@ -56013,15 +56232,16 @@ var ConfigReader = (function () {
          */
         addOption('annotateUrl', [SNIPPET_SRC]);
         /**
-         * A primary api key to send data to from the Agent. This will only function if there is no `apiKey` set
+         * Formerly `apiKey`. A primary public app ID to send data to from the Agent. This will only function if there is no `publicAppId` set
          * on the configuration included in the downloaded Agent.
          *
          * @access public
          * @category Config/Core
-         * @name apiKey
+         * @name publicAppId
          * @default undefined
          * @type {string}
          */
+        addOption('publicAppId', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('apiKey', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('assetHost', [SNIPPET_SRC, PENDO_CONFIG_SRC]);
         /**
@@ -56659,18 +56879,19 @@ var ConfigReader = (function () {
          */
         addOption('inlineStyleNonce', [SNIPPET_SRC]);
         /**
-         * Specify a preferred apiKey to lead the multi-apiKey iframe installations to make decisions about automatic
-         * guide display. In installations with more than 2 apiKeys, the leaderKey can be specified as a priority
-         * list (e.g. `leaderKey: ['key1', 'key2', ...]`). Either all frames must agree on the leaderKey setting,
-         * or only one frame should specify the leaderKey. If neither of these conditions are met, the default leader
+         * Formerly `leaderKey` Specify a preferred publicAppId to lead the multi-application iframe installation to make decisions about automatic
+         * guide display. In installations with more than 2 publicAppIds, the leaderApplication can be specified as a priority
+         * list (e.g. `leaderApplication: ['key1', 'key2', ...]`). Either all frames must agree on the leaderApplication setting,
+         * or only one frame should specify the leaderApplication. If neither of these conditions are met, the default leader
          * determination logic (top frame or earliest to join) will be used.
          *
          * @access public
          * @category Config/Guides
-         * @name leaderKey
+         * @name leaderApplication
          * @default []
          * @type {string[]}
          */
+        addOption('leaderApplication', [SNIPPET_SRC, PENDO_CONFIG_SRC], []);
         addOption('leaderKey', [SNIPPET_SRC, PENDO_CONFIG_SRC], []);
         /**
          * If `true`, custom code blocks in building block guides will not be allowed to run. Also, classic guides
@@ -56731,6 +56952,8 @@ var ConfigReader = (function () {
         addOption('designerAgentPluginsLoader', [PENDO_CONFIG_SRC, SNIPPET_SRC]);
         addOption('guideContentLoader', [PENDO_CONFIG_SRC]);
         addOption('trainingPartner');
+        addOption('oemAccountId', [SNIPPET_SRC]);
+        addOption('whiteLabelSettings', [PENDO_CONFIG_SRC]);
         // Frustration
         addOption('errorClickLogging', [PENDO_CONFIG_SRC], false);
         // Embedded Guides
@@ -56739,6 +56962,7 @@ var ConfigReader = (function () {
         addOption('formValidation', [PENDO_CONFIG_SRC], false);
         // Performance Metrics
         addOption('performanceMetricsEnabled', [SNIPPET_SRC, PENDO_CONFIG_SRC], true);
+        addOption('performanceMetricsSampleRate', [SNIPPET_SRC, PENDO_CONFIG_SRC], 0);
     }
     initializeOptions();
     var sourceGetters = {};
@@ -57534,10 +57758,8 @@ class DevlogTransport {
     }
     buildGetUrl(baseUrl, jzb) {
         const params = {};
-        const isAdoptPartner = this.pluginAPI.agent.treatAsAdoptPartner();
-        const accountId = this.pendo.get_account_id();
-        if (isAdoptPartner && accountId && accountId !== 'ACCOUNT-UNIQUE-ID') {
-            params.acc = this.pluginAPI.util.base64EncodeString(accountId);
+        if (this.pluginAPI.agent.treatAsAdoptPartner()) {
+            this.pluginAPI.agent.addAccountIdParams(params, this.pendo.get_account_id(), this.pluginAPI.ConfigReader.get('oemAccountId'));
         }
         const jwtOptions = this.pluginAPI.agent.getJwtInfoCopy();
         if (!this.pendo._.isEmpty(jwtOptions)) {
@@ -57583,10 +57805,8 @@ class DevlogTransport {
             events: jzb,
             browser_time: this.pluginAPI.util.getNow()
         };
-        const isAdoptPartner = this.pluginAPI.agent.treatAsAdoptPartner();
-        const accountId = this.pendo.get_account_id();
-        if (isAdoptPartner && accountId && accountId !== 'ACCOUNT-UNIQUE-ID') {
-            bodyPayload.acc = this.pluginAPI.util.base64EncodeString(accountId);
+        if (this.pluginAPI.agent.treatAsAdoptPartner()) {
+            this.pluginAPI.agent.addAccountIdParams(bodyPayload, this.pendo.get_account_id(), this.pluginAPI.ConfigReader.get('oemAccountId'));
         }
         const body = JSON.stringify(this.pendo._.extend(bodyPayload, jwtOptions));
         return this.post(url, {