@pendo/agent 2.326.0 → 2.327.0

package/dist/pendo.module.js

@@ -2707,11 +2707,11 @@ var underscoreExports = underscore.exports;
 var _ = /*@__PURE__*/getDefaultExportFromCjs(underscoreExports);
 
 /**
- * Utility function to check if passed value exists. Returns false for `null` and `undefined`.
+ * Utility function to check if the passed value exists. Returns false for `null` and `undefined`.
  *
  * @access public
  * @category Utility
- * @param {any} value argument to type check
+ * @param {any} arg value to type check
  * @returns {Boolean}
  * @example
  * pendo.doesExist(null) => false
@@ -2964,7 +2964,7 @@ var ConfigReader = (function () {
          *
          * @access public
          * @category Config/Core
-         * @name forceLeader
+         * @name forcedLeader
          * @default false
          * @type {boolean}
          */
@@ -3151,7 +3151,7 @@ var ConfigReader = (function () {
          * An array of exact strings that can still be included in event data if text capture is disabled
          * (`excludeAllText`). This will not override any allow list specified by your application settings but will apply if none is provided.
          * These are not selectors but are equality checks (the string 'Bug' will allow links that have 'Bug' as the
-         * text to be captured but not ones like 'Bug Report')
+         * text to be captured but not ones like 'Bug Report').
          *
          * @access public
          * @category Config/Analytics
@@ -3249,7 +3249,7 @@ var ConfigReader = (function () {
         /**
          * By default, the web SDK will also attempt to intercept calls to `stopPropagation` and
          * `stopImmediatePropagation` for click, focus, submit, and change events in order to ensure that Pendo can
-         * still probably recognize these events. In the case of this causing duplicate events or other issues, this
+         * still properly recognize these events. In the case of this causing duplicate events or other issues, this
          * functionality can be disabled.
          *
          * @access public
@@ -3312,7 +3312,7 @@ var ConfigReader = (function () {
          */
         addOption('cacheGuides', [SNIPPET_SRC, PENDO_CONFIG_SRC], false);
         /**
-         * How often to clear the guides cache (in milliseconds)
+         * How often to clear the guides cache (in milliseconds).
          *
          * @access public
          * @category Config/Guides
@@ -3346,7 +3346,7 @@ var ConfigReader = (function () {
         addOption('disableGlobalCSS', [SNIPPET_SRC, PENDO_CONFIG_SRC], false);
         /**
          * Building block guides use an inline style tag for various pseudo styles (e.g. hover, carets, animations).
-         * These can be turned off using this flag for application's with more restrictive CSP settings but will
+         * These can be turned off using this flag for applications with more restrictive CSP settings but will
          * require custom effort to reach style parity.
          *
          * @access public
@@ -3372,7 +3372,7 @@ var ConfigReader = (function () {
          * cookies, localStorage, click tracking, and metadata. Only displays guides
          * that have been configured explicitly to show to this visitor.
          *
-         * @access public
+         * @access private
          * @category Config/Guides
          * @name doNotTrackGuides
          * @default false
@@ -3380,7 +3380,7 @@ var ConfigReader = (function () {
          */
         addOption('doNotTrackGuides', [SNIPPET_SRC, PENDO_CONFIG_SRC]);
         /**
-         * If `true`, the web SDK will listen for `alt+shift+8` on the keyboard and try to launch the designer (). The
+         * If `true`, the web SDK will listen for `alt+shift+8` on the keyboard and try to launch the designer. The
          * keyboard shortcut requires the guide launch modal of Engage to be open in another tab showing the shortcut.
          *
          * @access public
@@ -3458,7 +3458,7 @@ var ConfigReader = (function () {
          */
         addOption('guides.disabled', [SNIPPET_SRC], false, undefined, ['disableGuides']);
         /**
-         * If 'true', guides with slow selectors will be removed from guide display processing.
+         * If `true`, guides with slow selectors will be removed from guide display processing.
          * This will improve application performance, but slow guides will not be shown to users.
          *
          * @access public
@@ -3514,7 +3514,7 @@ var ConfigReader = (function () {
          */
         addOption('inlineStyleNonce', [SNIPPET_SRC]);
         /**
-         * Formerly `leaderKey` Specify a preferred publicAppId to lead the multi-application iframe installation to make decisions about automatic
+         * 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
@@ -3544,7 +3544,7 @@ var ConfigReader = (function () {
         addOption('storage.allowKeys', [SNIPPET_SRC], '*');
         // Feedback
         /**
-         * If Feedback is setup for your subscription, this option can be used to selectively disable Feedback.
+         * If Feedback is set up for your subscription, this option can be used to selectively disable Feedback.
          *
          * @access public
          * @category Config/Core
@@ -3557,8 +3557,8 @@ var ConfigReader = (function () {
         addOption('feedbackSettings', [PENDO_CONFIG_SRC], {});
         addOption('pendoFeedback', [PENDO_CONFIG_SRC], false);
         /**
-         * If set, the web SDK will use this as the suffix when writing last step advanced key into the visitors cookie.
-         * This supports cross app guides by having a shared accessible location for different apps on the same effective level domain.
+         * If set, the web SDK will use this as the suffix when writing the last step advanced key into the visitor's cookie.
+         * This supports cross-app guides by having a shared accessible location for different apps on the same effective level domain.
          *
          * @access public
          * @category Config/Core
@@ -3979,12 +3979,12 @@ let SERVER = '';
 let ASSET_HOST = '';
 let ASSET_PATH = '';
 let DESIGNER_SERVER = '';
-let VERSION = '2.326.0_';
-let PACKAGE_VERSION = '2.326.0';
+let VERSION = '2.327.0_';
+let PACKAGE_VERSION = '2.327.0';
 let LOADER = 'xhr';
 /* eslint-enable web-sdk-eslint-rules/no-gulp-env-references */
 /**
- * Returns current version of the Pendo Web SDK as a string. Also directly accessible at `pendo.VERSION`.
+ * Returns the current version of the Pendo Web SDK as a string. Also directly accessible at `pendo.VERSION`.
  *
  * @access public
  * @category Core
@@ -5925,7 +5925,7 @@ const ACCOUNT_ID_KEY = 'accountId';
  *
  * @access public
  * @category Identity
- * @param {string} prefix string to prepend to the unique id
+ * @param {string} [prefix] string to prepend to the unique id
  * @returns {string}
  * @example
  * pendo.generate_unique_id('user-') => 'user-RaPiWJ5M53Y'
@@ -6042,7 +6042,7 @@ function findVisitorId() {
 }
 /**
  * Returns the id for the visitor currently being applied to any events being sent to Pendo.
- * Will always be set either by host application or as an anonymous generated ID.
+ * Will always be set either by the host application or as an anonymous generated ID.
  *
  * @access public
  * @alias getVisitorId
@@ -6072,8 +6072,8 @@ function get_visitor_id_public() {
     return get_visitor_id() || generate_anonymous_visitor_id();
 }
 /**
- * Sets visitor id for the web SDK. Requires a valid visitor id string. This will not change
- * or clear existing visitor metadata set.
+ * Sets the visitor id for the web SDK. Requires a valid visitor id string. This will not change
+ * or clear existing visitor metadata.
  *
  * @access public
  * @category Identity
@@ -6115,8 +6115,8 @@ var get_account_id = function () {
     return pendo$1.accountId;
 };
 /**
- * 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
+ * Sets the 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.
  *
  * @access public
@@ -6167,7 +6167,7 @@ function clearAccount() {
     }
 }
 /**
- * Removes current visitor id and account id. Triggers an identify event and reloads
+ * Removes the current visitor id and account id. Triggers an identify event and reloads
  * with a new anonymous visitor.
  *
  * @access public
@@ -8902,16 +8902,17 @@ var SizzleProxy = wrapSizzle(Sizzle);
  * pendo.dom('h1')[0].remove()
  * @example
  * pendo.dom('.left').css({ 'text-align': 'center' })
- */ /**
-* Creates new DOM elements from HTML text.
-*
-* @param {string} htmlString  HTML syntax used to produce new DOM elements
-* @returns {DomQuery} array with the matching elements
-* @access public
-* @category DOM
-* @example
-* pendo.dom('<div><span>this should create an unattached DOM node</span></div>');
-*/
+ */
+/**
+ * Creates new DOM elements from HTML text.
+ *
+ * @param {string} htmlString  HTML syntax used to produce new DOM elements
+ * @returns {DomQuery} array with the newly created elements
+ * @access public
+ * @category DOM
+ * @example
+ * pendo.dom('<div><span>this should create an unattached DOM node</span></div>');
+ */
 function dom(selection, context) {
     var self = this;
     var nodes;
@@ -9673,7 +9674,7 @@ var objectToQueryString = function (obj) {
     }, '');
 };
 /**
- * URL getter that will return the URL that will be used by the web SDK to describe all data events
+ * URL getter that returns the URL 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).
  *
@@ -10108,7 +10109,7 @@ var locked = false;
  * @category Events
  * @example
  * $ pendo.stopSendingEvents()
- * > Pendo Web SDK locked.  No more events will be written.
+ * > Pendo Web SDK locked. No more events will be written.
  */
 var lockEvents = function () {
     var fireEvent = isUnlocked();
@@ -10125,7 +10126,7 @@ var lockEvents = function () {
  * @category Events
  * @example
  * $ pendo.startSendingEvents()
- * > Pendo Web SDK unlocked.  Events will be written.
+ * > Pendo Web SDK unlocked. Events will be written.
  */
 var unlockEvents = function () {
     var fireEvent = !isUnlocked();
@@ -10155,8 +10156,8 @@ var isUnlocked = function () {
  * Check if the Element has this classname.
  *
  * @alias hasClass
- * @param {element} elem The Element to test for the classname
- * @param {String} class The classname to look for on the element
+ * @param {element} ele The Element to test for the classname
+ * @param {String} cls The classname to look for on the element
  * @returns {Boolean}
  * @access public
  * @category DOM
@@ -10196,7 +10197,7 @@ var _addClass = function (ele, cls) {
     }
 };
 /**
- * Remove a classname from an Elements classlist.
+ * Remove a classname from an Element's classlist.
  *
  * @alias removeClass
  * @param {element} ele The Element from which the class will be removed
@@ -10219,7 +10220,7 @@ var _removeClass = function (ele, cls) {
     }
 };
 /**
- * Sets the classname from an Element.
+ * Sets the classname for an Element.
  *
  * @alias setClass
  * @param {element} ele The Element that will get the new classlist.
@@ -11031,8 +11032,8 @@ DomQuery.$ = {
         return newDom;
     },
     /**
-     * Iterate over each element in the DomQuery list and call the provide callback function passing in the
-     * the element as the argument.
+     * Iterate over each element in the DomQuery list and call the provided callback function passing in the
+     * element as the argument.
      *
      * @function each
      * @param {function} callback The callback to be called for each element in the list
@@ -11054,7 +11055,7 @@ DomQuery.$ = {
      * Iterate over each element in the DomQuery list and create and append the Elements represented by the HTML string provided.
      *
      * @function html
-     * @param {String} htmlString String representing html to be created as dom Elements for each of the Elements in the list.
+     * @param {String} content String representing html to be created as dom Elements for each of the Elements in the list.
      * @returns {DomQuery}
      * @category DOMQuery
      * @access public
@@ -11075,7 +11076,7 @@ DomQuery.$ = {
      * Iterate over each element in the DomQuery list and add the text provided as innerText on the element.
      *
      * @function text
-     * @param {String} content String to be added as innerText
+     * @param {String} content String to be added as innerText.
      * @returns {DomQuery}
      * @access public
      * @category DOMQuery
@@ -11140,7 +11141,7 @@ DomQuery.$ = {
         });
     },
     /**
-     * Iterate over each element and checks for each class name. Returns true if all elements have each classname.
+     * Iterate over each element and check for each class name. Returns true if all elements have each classname.
      *
      * @function hasClass
      * @param {String} classNames Space separated string of classnames.
@@ -11163,7 +11164,7 @@ DomQuery.$ = {
         return allElemsHaveClass;
     },
     /**
-     * Iterate over each element and toggle each class name on or off depending on the
+     * Iterate over each element and toggle each class name on or off depending on
      * the current state of the element.
      *
      * @function toggleClass
@@ -11191,7 +11192,7 @@ DomQuery.$ = {
      * Iterate over each element and apply the styles object.
      *
      * @function css
-     * @param {Object} styles Object containing style attributes names and values
+     * @param {Object} styles Object containing style attribute names and values.
      * @returns {DomQuery}
      * @access public
      * @category DOMQuery
@@ -11245,7 +11246,7 @@ DomQuery.$ = {
         return self;
     },
     /**
-     * Add all elements in the list as top most child nodes of the first element found for the given selector.
+     * Add all elements in the list as topmost child nodes of the first element found for the given selector.
      *
      * @function prependTo
      * @param {String} selector CSS selector to identify the target parent element
@@ -11260,10 +11261,10 @@ DomQuery.$ = {
         return this;
     },
     /**
-     * Add all children from the selector as top most children of the first element in this list
+     * Add all children from the selector as topmost children of the first element in this list.
      *
      * @function prepend
-     * @param {String} selector CSS selector to identify top most child element(s)
+     * @param {String} selector CSS selector to identify topmost child element(s)
      * @returns {DomQuery}
      * @access public
      * @category DOMQuery
@@ -11287,7 +11288,7 @@ DomQuery.$ = {
         return self;
     },
     /**
-     * Return the parent node of the first element in this list
+     * Return the parent node of the first element in this list.
      *
      * @function getParent
      * @returns {element}
@@ -11304,7 +11305,7 @@ DomQuery.$ = {
     },
     /**
      * For the first element in this list, insert the first element from the selector before it
-     * in parent element's child nodes list.
+     * in the parent element's child nodes list.
      *
      * @function insertBefore
      * @param {String} selector CSS selector for the element to be inserted before this element
@@ -11343,7 +11344,7 @@ DomQuery.$ = {
         return this;
     },
     /**
-     * Iterate over each element and set the attribute name to the specified value
+     * Iterate over each element and set the attribute name to the specified value.
      *
      * @function attr
      * @param {String} attrName Name of attribute to set
@@ -11404,10 +11405,10 @@ DomQuery.$ = {
         return dom(this[index]);
     },
     /**
-     * Set the height or unset the height for the first element in the list
+     * Set the height or unset the height for the first element in the list.
      *
      * @function height
-     * @param {Number} height The new height to set. Undefined will remove the height allow it to auto determined.
+     * @param {Number} height The new height to set. Undefined will remove the height and allow it to be auto determined.
      * @returns {DomQuery}
      * @access public
      * @category DOMQuery
@@ -11428,10 +11429,10 @@ DomQuery.$ = {
         }
     },
     /**
-     * Set the width or unset the width for the first element in the list
+     * Set the width or unset the width for the first element in the list.
      *
      * @function width
-     * @param {Number} width The new width to set. Undefined will remove the width allow it to auto determined.
+     * @param {Number} width The new width to set. Undefined will remove the width and allow it to be auto determined.
      * @returns {DomQuery}
      * @access public
      * @category DOMQuery
@@ -11452,7 +11453,7 @@ DomQuery.$ = {
         }
     },
     /**
-     * For each element in the list, call the element's focus method if it exists
+     * For each element in the list, call the element's focus method if it exists.
      *
      * @function focus
      * @returns {DomQuery}
@@ -12203,12 +12204,14 @@ function callLater(callback, n) {
  *
  * @access public
  * @category Events
- * @param {boolean} force a "full" flush, i.e. ALL `pendo.buffers.silos`
+ * @param {Object} [options] - Options passed through to each queue's flush method
+ * @param {boolean} [options.unload] - signals the page is unloading; drains the send queue using sendBeacon or sync XHR for reliable last-chance delivery
+ * @param {boolean} [options.hidden] - signals the page is being hidden; drains the send queue immediately rather than waiting for the next timer tick
  * @returns {void}
  * @example
  * pendo.flushNow()
  */
-function flushNow(force, options) {
+function flushNow(options) {
     try {
         _.each(queues, function (queue) {
             if (queue.flush) {
@@ -12221,14 +12224,14 @@ function flushNow(force, options) {
     }
 }
 /*
- * Queue a curried {flushNow} with `force:true` for {n} ticks of the event
- * loop, deferring CPU-intensive compression until the main thread is free.
+ * Queue {flushNow} for {n} ticks of the event loop, deferring CPU-intensive
+ * compression until the main thread is free.
  */
 function flushLater(n) {
-    return callLater(_.partial(flushNow, true), n);
+    return callLater(flushNow, n);
 }
 /**
- * Force a full flush, i.e. `flushNow(true)`, on {n} ticks
+ * Force a full flush on {n} ticks
  *
  * @access private
  * @param {number} n ticks to call {flushNow} on
@@ -12492,7 +12495,7 @@ class LocalStorageEventBuffer {
     }
     read(storage) {
         /**
-        * If enabled, Pendo will write pending events to local storage before unloading the page
+        * If enabled, Pendo will write pending events to localStorage before unloading the page
         * rather than attempting to send them. The events will be sent the next time the page is loaded.
         *
         * @name _pendo_unsentEvents
@@ -13408,6 +13411,7 @@ var makeSafe = function (method, noLogging) {
  * @function
  * @category URL
  * @param {string} [url] if not provided, defaults to the current URL from the browser
+ * @returns {boolean | undefined} true if the URL changed and a load event was sent, otherwise undefined
  * @example
  * pendo.pageLoad()
  */
@@ -13447,7 +13451,7 @@ pageLoad.reset = function () {
 
 /**
  * Returns the normalized URL sent from the backend. This won't always
- * match the desired output from the customer's url customizations if using location API.
+ * match the desired output from the customer's URL customizations if using the location API.
  *
  * @access public
  * @category URL
@@ -13574,13 +13578,13 @@ function createChannelMatcher(options = {}) {
 }
 /**
  * Returns an array of all guides available on the current page to the current user.
- * If multiple frames on a pages, `pendo.getActiveGuides()` will return the list of eligible
+ * If there are multiple frames on a page, `pendo.getActiveGuides()` will return the list of eligible
  * guides across all frames. If no frames, this will be the same as `pendo.guides`.
  *
  * @access public
  * @category Guides
- * @param {object} options - Options for filtering guides
- * @param {string} options.channel - Channel to filter guides by
+ * @param {object} [options] - Options for filtering guides
+ * @param {string} [options.channel] - Channel to filter guides by
  * @returns {Guide[]}
  * @example
  * pendo.getActiveGuides() => [{ Pendo Guide Object }, ...]
@@ -13642,7 +13646,7 @@ function findGuideBy(field, value) {
  *
  * @access public
  * @category Guides
- * @param {string} id id of the guide as a string
+ * @param {string} guideId id of the guide as a string
  * @returns {Guide | null} JSON guide object or null if no guide found
  * @example
  * pendo.findGuideById('guide_id')
@@ -18239,7 +18243,7 @@ var updateVisitorOptions = function (options = {}) {
     };
 };
 /**
- * Updates metadata object for the Pendo Web SDK. Can include visitor and/or account updates, along
+ * Updates the 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.
@@ -18257,11 +18261,11 @@ var updateOptions = makeSafe(function (options) {
 });
 /**
  * This function accepts either a string for just the visitor id or it accepts an Object that will contain at least
- * a visitor object with at least an id field.  It may also contain other visitor related Key/Value pairs in the
- * visitor object. Also, in the options object may be an account object that will contain at least an id field. It may
- * also contain other account related Key/Value pairs. This will potentially send an identify event and a metadata event.
+ * a visitor object with at least an id field. It may also contain other visitor-related Key/Value pairs in the
+ * visitor object. Also, the options object may contain an account object that will contain at least an id field. It may
+ * also contain other account-related Key/Value pairs. This will potentially send an identify event and a metadata event.
  *
- * Identifying a visitor will send an event to Pendo and begin loading eligible guides to the identified user. To remove
+ * Identifying a visitor will send an event to Pendo and begin loading eligible guides for the identified user. To remove
  * visitor identity use `pendo.clearSession()`.
  *
  * @access public
@@ -20677,7 +20681,7 @@ var clearLoopTimer = function () {
     store.dispatch('guideUpdate/stopScheduledUpdate');
 };
 /**
- * Clear any showing guides and prevent any loaded guides from rendering.
+ * Clears any showing guides and prevents any loaded guides from rendering.
  * Loaded guides remain in memory, so calling startGuides will work just fine
  * after a stopGuides call.
  *
@@ -20700,7 +20704,7 @@ var stopGuides = function () {
 };
 /**
  * Starts the process that loops over all currently loaded guides and
- * determines what to show. Checks multistep guide continuation,
+ * determines what to show. Checks multi-step guide continuation,
  * auto-display guides, launcher guides, and badges.
  *
  * @access public
@@ -21968,12 +21972,12 @@ function interceptPreventDefault(EventConstructor, eventList) {
  *
  * @access public
  * @category Events
- * @param {HTMLElement} element DOM element to attach listener
+ * @param {HTMLElement} element DOM element to attach listener to
  * @param {string} evt type of DOM event
  * @param {Function} fn callback function
  * @param {Boolean} useCapture use capture phase instead of bubble
  * @example
- * pendo.attachEvent(pendo.dom("h1")[0], 'click', helloWorld = () => { console.log(Hello World") });"
+ * pendo.attachEvent(pendo.dom("h1")[0], 'click', helloWorld = () => { console.log("Hello World") });
  */
 function attachEvent(element, evt, fn, useCapture) {
     if (!(element && evt && fn)) {
@@ -21989,12 +21993,12 @@ function attachEvent(element, evt, fn, useCapture) {
     });
 }
 /**
- * Pendo Web SDK's version of detaching event listeners. Callback must be a named function, cannot remove
- * anonymous functions.
+ * Pendo Web SDK's version of detaching event listeners. The callback must be a named function; anonymous
+ * functions cannot be removed.
  *
  * @access public
  * @category Events
- * @param {HTMLElement} element DOM element to attach listener
+ * @param {HTMLElement} element DOM element to detach listener from
  * @param {string} evt type of DOM event
  * @param {Function} fn callback function
  * @param {Boolean} useCapture use capture phase instead of bubble
@@ -23303,7 +23307,7 @@ var controlGuideLogMessage = 'Guide was not shown because this visitor is in a c
 /**
  * @constant defaultCssUrl {String}
  *
- * Readonly Property that provides the default CSS Url based on the customer's Apps configuration with Pendo.
+ * Readonly property that provides the default CSS URL based on the customer's Apps configuration with Pendo.
  *
  * @access public
  * @category Guides
@@ -23398,7 +23402,7 @@ var getStepIdFromElement = function (element) {
  * In most cases, `pendo.stopGuides()` is preferred since it will stop the loop and guides will not redisplay until `pendo.startGuides()` is called.
  *
  * Manually hide any active Guides. An argument of an Object containing the property stayHidden set to true needs to be
- * provided in order for the guides hidden to stay hidden.
+ * provided in order for the hidden guides to stay hidden.
  *
  * @param {Object} - Optional JS Object containing boolean property `stayHidden`
  * @access public
@@ -23481,7 +23485,7 @@ function shouldAffectThrottling(guide, seenReason) {
  * Hides the current guide and invokes the `guideDismissed` event. Dismissed guides will not
  * be re-displayed by default unless they have a recurrence setting or can be reactivated
  * with an element. They can always be redisplayed via onGuideAdvanced or onGuidePrevious.
-
+ *
  * @access public
  * @category Guides
  * @example
@@ -23545,7 +23549,7 @@ var onGuideDismissed = function (evt, step) {
 };
 /**
  * Snoozes the current guide. If another guide is eligible to be shown automatically, it will show after snooze.
- * Guide will redisplay after one day by default, or a custom `snoozeDuration` can be set in milliseconds as the third argument.
+ * The guide will redisplay after one day by default, or a custom `snoozeDuration` can be set in milliseconds as the third argument.
  *
  * @access public
  * @category Guides
@@ -23660,7 +23664,7 @@ var goToStep = function (evt) {
 };
 /**
  * Proceeds to the next step in a multi-step guide and sends a `guideAdvanced` event.
- * Can advanced multiple steps or beyond a specific step by passing optional parameters.
+ * Can advance multiple steps or beyond a specific step by passing optional parameters.
  * Lastly, sends a `guideSeen` event for the resulting displayed step.
  *
  * @access public
@@ -24222,7 +24226,7 @@ var getNextStepInMultistep = function (lastSeen, urlToCheck) {
 };
 /**
  * Returns the normalized URL sent from the backend with the guides payload. This won't always
- * match the desired output from the customer's url customizations if using location API.
+ * match the desired output from the customer's URL customizations if using the location API.
  *
  * @access public
  * @alias getCurrentUrl
@@ -24234,6 +24238,7 @@ var getNextStepInMultistep = function (lastSeen, urlToCheck) {
  * pendo.normalizedUrl
  * @example
  * pendo.getCurrentUrl()
+ */
 /**
  * Activates the Guide for the given name, if loaded. If it is not in the payload,
  * this function will return false.
@@ -24241,7 +24246,7 @@ var getNextStepInMultistep = function (lastSeen, urlToCheck) {
  * @access public
  * @category Guides
  * @param {string} name name of the guide to display
- * @param {string} reason optional reason for the display
+ * @param {string} [reason] optional reason for the display
  * @example
  * pendo.showGuideByName('guide_name')
  */
@@ -24263,7 +24268,7 @@ var showGuideByName = function (name, reason) {
  * @access public
  * @category Guides
  * @param {string} id id of the guide to display
- * @param {string} reason optional reason for the display
+ * @param {string} [reason] optional reason for the display
  * @example
  * pendo.showGuideById('guide_id')
  */
@@ -24290,7 +24295,7 @@ var resetPendoUI = function () {
 *
 * @access public
 * @name doNotProcess
-* @type {string}
+* @type {boolean}
 * @category Events
 * @example
 * pendo.doNotProcess => true
@@ -24515,8 +24520,8 @@ function shouldLoadGuides(visitorId, callback) {
     return true;
 }
 /**
- * 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
+ * Manually load guides for the 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 choose 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.
  *
@@ -24818,7 +24823,7 @@ function securityPolicyViolationFn(evt) {
 }
 let guideCache;
 /**
- * Resets and starts guide loop
+ * Resets and starts the guide loop.
  *
  * @access public
  * @category Guides
@@ -24924,7 +24929,7 @@ var initGuides = function (observer) {
     */
     agentStorage.registry.addLocal(THROTTLING_STATE.SNOOZED);
     /**
-    * Used to determine if guides have been blocked, by the user, adblocker, or a failed guide request.
+    * Used to determine if guides have been blocked by the user, an ad blocker, or a failed guide request.
     * This will prevent additional guide requests and display attempts, to optimize page performance and
     * user experience in cases where guides cannot be loaded.
     *
@@ -24950,7 +24955,7 @@ var initGuides = function (observer) {
     };
 };
 /**
- * Returns true or false if the client has disabled guides in the snippet or via a command
+ * Returns true or false depending on whether the client has disabled guides in the snippet or via a command.
  *
  * @access public
  * @category Guides
@@ -24962,7 +24967,7 @@ var areGuidesDisabled = function () {
     return ConfigReader.get('guides.disabled', false) || !pendoCore;
 };
 /**
- * Returns true or false if the client has delayed guides in the snippet or via a command
+ * Returns true or false depending on whether the client has delayed guides in the snippet or via a command.
  *
  * @access public
  * @category Guides
@@ -26418,7 +26423,7 @@ function insertOriginContentHash(originalHash, url, extensionStr, sha256Hash) {
 }
 
 /**
-* Formerly `apiKey`. Public app ID that is associated with the current Pendo installation as a string.
+* Formerly `apiKey`. The public app ID associated with the current Pendo installation as a string.
 *
 * @access public
 * @name publicAppId
@@ -26428,7 +26433,7 @@ function insertOriginContentHash(originalHash, url, extensionStr, sha256Hash) {
 * pendo.publicAppId => 'PUBLIC_APP_ID'
 */
 /**
-* Formerly `additionalApiKeys`. Array of additional app IDs that are set in the config. If no primary app ID is set,
+* Formerly `additionalApiKeys`. An 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
@@ -27197,7 +27202,7 @@ var P2AutoLaunch = (function () {
 function launchDesignerOrPreview(options) {
     /**
     * Application state while viewing a guide in preview mode. Used while preview mode is active
-    * to track step, status, etc, and cleared when preview mode is exited.
+    * to track step, status, etc., and cleared when preview mode is exited.
     *
     * @name pendo-preview
     * @category Cookies/localStorage
@@ -27207,7 +27212,7 @@ function launchDesignerOrPreview(options) {
     agentStorage.registry.addLocal(pendoPreview$1);
     /**
     * Application state while previewing a guide from the designer. Used while designer preview is active
-    * to track step, status, etc, and cleared when designer preview is exited.
+    * to track step, status, etc., and cleared when designer preview is exited.
     *
     * @name current-guide-preview
     * @category Cookies/localStorage
@@ -28762,7 +28767,7 @@ var ResourceCenterActivity = (function () {
 })();
 
 /**
- * Returns boolean representing whether the Pendo Web SDK is fully loaded and has an API key.
+ * Returns a boolean representing whether the Pendo Web SDK is fully loaded and has an API key.
  *
  * @access public
  * @category Core
@@ -28977,7 +28982,7 @@ const initializeImmediately = 'initializeImmediately';
  * @function
  * @category Core
  * @name initialize
- * @param {object} options identity metadata and configuration to initialize web SDK
+ * @param {object} options identity metadata and configuration to initialize the 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({
@@ -29080,7 +29085,7 @@ function initialize(options) {
         teardownFns.push(() => observer.teardown());
         if (pendoCore) {
             /**
-            * Current visitor id for pendo installation, either anonymous or identified. Used to determine
+            * Current visitor id for the Pendo installation, either anonymous or identified. Used to determine
             * a visitor's guide experience, settings, and associated data.
             *
             * @name _pendo_visitorId
@@ -29090,7 +29095,7 @@ function initialize(options) {
             */
             agentStorage.registry.addLocal(VISITOR_ID_KEY);
             /**
-            * Often an anonymous visitor id that is replaced by a logged in user.
+            * Often an anonymous visitor id that is replaced by a logged-in user.
             *
             * @name _pendo_oldVisitorId
             * @category Cookies/localStorage
@@ -29099,7 +29104,7 @@ function initialize(options) {
             */
             agentStorage.registry.addLocal(OLD_VISITOR_ID_KEY);
             /**
-            * The current account id for pendo installation provided in the `pendo.initialize()` call.
+            * The current account id for the Pendo installation provided in the `pendo.initialize()` call.
             *
             * @name _pendo_accountId
             * @category Cookies/localStorage
@@ -29135,12 +29140,12 @@ function initialize(options) {
             teardownFns.push(performanceMonitor.initialize());
         }
         const flushOnAppHidden = () => {
-            flushNow(true, { hidden: true });
+            flushNow({ hidden: true });
         };
         Events.appHidden.on(flushOnAppHidden);
         teardownFns.push(() => Events.appHidden.off(flushOnAppHidden));
         const flushOnAppUnloaded = () => {
-            flushNow(true, { unload: true });
+            flushNow({ unload: true });
             if (localStorageUnloadEnabled) {
                 localStorageEventBuffer.write(agentStorage);
             }
@@ -29756,13 +29761,20 @@ var BuildingBlockGuides = (function () {
             detachEvent(targetElement, 'focus', targetElementFocusCallback);
         });
     }
+    function getTargetElementForStep(step) {
+        if (step.element && step.element !== getBody()) {
+            return step.element;
+        }
+        return null;
+    }
     function trapFocusStep(step, guideContainer) {
-        var elem = guideContainer.find('#pendo-guide-container');
-        trapFocus(elem);
+        var guideContainerElement = guideContainer.find('#pendo-guide-container');
+        var targetElement = _.get(step, 'attributes.blockOutUI.enabled') && getTargetElementForStep(step);
+        trapFocus(guideContainerElement, targetElement);
     }
     function getSelectedPollElementForFocus(focusableChildren, bumperElement) {
         let elementToFocus;
-        if (bumperElement.getAttribute('type') === 'radio') {
+        if (bumperElement.getAttribute('type') === 'radio' && bumperElement.getAttribute('data-pendo-poll-id')) {
             const pollId = bumperElement.getAttribute('data-pendo-poll-id');
             elementToFocus = _.find(focusableChildren, function (child) {
                 const childPollId = child.getAttribute('data-pendo-poll-id');
@@ -29771,8 +29783,42 @@ var BuildingBlockGuides = (function () {
         }
         return elementToFocus || bumperElement;
     }
-    function trapFocus(domElem) {
-        var containerNode = domElem[0];
+    function collectTargetFocusables(targetElement) {
+        if (!targetElement)
+            return [];
+        var focusables = _.toArray(targetElement.querySelectorAll(FOCUSABLE_SELECTORS));
+        if (targetElement.matches(FOCUSABLE_SELECTORS)) {
+            focusables.unshift(targetElement);
+        }
+        return focusables;
+    }
+    function createTargetBumper(className) {
+        var bumper = document.createElement('div');
+        bumper.setAttribute('tabIndex', 0);
+        bumper.setAttribute('class', className);
+        bumper.setAttribute('aria-hidden', 'true');
+        bumper.style.cssText = 'position:absolute !important;width:0 !important;height:0 !important;overflow:hidden !important;outline:none !important;border:none !important;padding:0 !important;margin:0 !important;';
+        return bumper;
+    }
+    function insertTargetBumpers(targetElement) {
+        if (!targetElement || !targetElement.parentNode)
+            return null;
+        var before = createTargetBumper('pendo-before-target-focus-bumper');
+        var after = createTargetBumper('pendo-after-target-focus-bumper');
+        targetElement.parentNode.insertBefore(before, targetElement);
+        targetElement.parentNode.insertBefore(after, targetElement.nextSibling);
+        return { before, after };
+    }
+    function removeTargetBumpers(targetBumpers) {
+        if (!targetBumpers)
+            return;
+        _.each([targetBumpers.before, targetBumpers.after], function (bumper) {
+            if (bumper && bumper.parentNode)
+                bumper.parentNode.removeChild(bumper);
+        });
+    }
+    function trapFocus(guideContainerElement, targetElement) {
+        var containerNode = guideContainerElement[0];
         if (!containerNode) {
             return;
         }
@@ -29792,43 +29838,75 @@ var BuildingBlockGuides = (function () {
             // some quirks
             'iframe'
         ].join(', ');
-        var focusableChildren = _.toArray(domElem.find(selectors));
+        var focusableChildren = _.toArray(guideContainerElement.find(selectors));
         if (!focusableChildren.length) {
             return;
         }
         var firstFocusableEl = focusableChildren[0];
         var lastFocusableEl = focusableChildren[focusableChildren.length - 1];
         // insert bumpers after the above selectors run for content
-        var bumpers = insertTrapFocusBumpers(domElem);
+        var bumpers = insertTrapFocusBumpers(guideContainerElement);
         var startFocusBumper = bumpers[0];
         var endFocusBumper = bumpers[1];
+        var targetFocusables = collectTargetFocusables(targetElement);
+        var firstTargetFocusable = targetFocusables[0];
+        var lastTargetFocusable = targetFocusables[targetFocusables.length - 1];
+        // Insert bumpers as siblings of the target so we can catch focus crossings even when focus moves through a
+        // cross-origin iframe inside the target (our keydown listener can't see events inside the iframe, but it can
+        // see focus landing on a bumper in the parent document afterwards).
+        var targetBumpers = targetFocusables.length ? insertTargetBumpers(targetElement) : null;
+        var beforeTargetBumper = targetBumpers && targetBumpers.before;
+        var afterTargetBumper = targetBumpers && targetBumpers.after;
+        var targetRoot = targetElement && dom.getRootNode(targetElement);
+        var wrapForward = firstTargetFocusable || firstFocusableEl;
+        var wrapBackward = lastTargetFocusable || lastFocusableEl;
         var trapFocusCallback = function (e) {
-            const isTabPressed = isTabEvent(e);
-            var isShiftPressed = e.shiftKey;
-            if (!isTabPressed) {
+            if (!isTabEvent(e)) {
                 return;
             }
+            const isShiftPressed = e.shiftKey;
+            const isKeydown = e.type === 'keydown';
             // Check if focus is on the body (clicked on the backdrop), the guide container (starts there when guide opens), or on the focus bumpers
             const activeElement = dom.getRootNode(containerNode).activeElement;
             const containerActive = activeElement === containerNode;
             const bodyActive = document.activeElement === document.body; // if the guide is in a shadow root but you click on the backdrop, the active element is the body of the main document
-            // shift + tab
+            const startBumperActive = activeElement === startFocusBumper;
+            const endBumperActive = activeElement === endFocusBumper;
+            const targetActiveElement = targetRoot && targetRoot.activeElement;
+            const beforeTargetBumperActive = !!beforeTargetBumper && targetActiveElement === beforeTargetBumper;
+            const afterTargetBumperActive = !!afterTargetBumper && targetActiveElement === afterTargetBumper;
+            const onLastTargetFocusable = isKeydown && !!lastTargetFocusable && targetActiveElement === lastTargetFocusable;
+            const onFirstTargetFocusable = isKeydown && !!firstTargetFocusable && targetActiveElement === firstTargetFocusable;
+            let elementToFocus;
             if (isShiftPressed) {
-                const startBumperActive = activeElement === startFocusBumper;
-                if (startBumperActive || containerActive || bodyActive) {
-                    let elementToFocus = getSelectedPollElementForFocus(focusableChildren, lastFocusableEl);
-                    elementToFocus.focus();
-                    e.preventDefault();
-                }
-                // tab
+                if (onFirstTargetFocusable)
+                    elementToFocus = lastFocusableEl;
+                else if (beforeTargetBumperActive)
+                    elementToFocus = lastFocusableEl;
+                else if (afterTargetBumperActive)
+                    elementToFocus = lastTargetFocusable;
+                else if (startBumperActive || containerActive || bodyActive)
+                    elementToFocus = wrapBackward;
             }
             else {
-                const endBumperActive = activeElement === endFocusBumper;
-                if (containerActive || endBumperActive || bodyActive) {
-                    let elementToFocus = getSelectedPollElementForFocus(focusableChildren, firstFocusableEl);
-                    elementToFocus.focus();
-                    e.preventDefault();
-                }
+                if (onLastTargetFocusable)
+                    elementToFocus = firstFocusableEl;
+                else if (afterTargetBumperActive)
+                    elementToFocus = firstFocusableEl;
+                else if (beforeTargetBumperActive)
+                    elementToFocus = firstTargetFocusable;
+                else if (endBumperActive)
+                    elementToFocus = wrapForward;
+                else if (containerActive || bodyActive)
+                    elementToFocus = firstFocusableEl;
+            }
+            if (elementToFocus) {
+                const resolved = getSelectedPollElementForFocus(focusableChildren, elementToFocus);
+                resolved.focus();
+                if (dom.getRootNode(resolved).activeElement !== resolved) {
+                    (isShiftPressed ? lastFocusableEl : firstFocusableEl).focus();
+                }
+                e.preventDefault();
             }
         };
         // attaching to both events helps some edge cases such as breakout by long-pressing the tab
@@ -29837,6 +29915,7 @@ var BuildingBlockGuides = (function () {
         Events.one('unmounted', () => {
             detachEvent(document, 'keyup', trapFocusCallback);
             detachEvent(document, 'keydown', trapFocusCallback);
+            removeTargetBumpers(targetBumpers);
         });
     }
     // bumpers are divs with a tabindex to allow them to be focused, but which should immediately
@@ -30056,7 +30135,7 @@ var shouldWeLog = function (contexts) {
     return (!!logOverride || !!isDebuggingEnabled());
 };
 /**
- * Logs an output to the console as the [Pendo Web SDK].
+ * Logs output to the console as the [Pendo Web SDK].
  *
  * @access public
  * @category Debugging
@@ -30174,12 +30253,12 @@ function collectEventHelper({ type, name, props, eventProperties }) {
     collectEvent(type, correctedProps, url, name, correctedEventProperties);
 }
 /**
- * Method to manually track events. Requires a non-empty name string to collect event.
+ * Method to manually track events. Requires a non-empty name string to collect the event.
  *
  * @access public
  * @category Events
  * @param {string} name name of the collected event
- * @param {Object} [props] optional properties object to collect with to the event
+ * @param {Object} [props] optional properties object to collect with the event
  * @param {Object} [eventProperties] optional key-value map stored on the event as top-level event properties
  * @example
  * pendo.track('scroll')
@@ -30196,7 +30275,7 @@ const privacyFilterCache = new Map();
  *
  * @access public
  * @category Events
- * @param {string} type type of the collected agentic event ['prompt', 'agent_response', 'user_reaction']
+ * @param {string} type type of the collected agentic event (e.g. 'prompt', 'agent_response', 'user_reaction')
  * @param {Object} props event-specific properties object
  * @param {Object} [eventProperties] optional key-value map stored on the event as top-level event properties (same as pendo.track)
  * @example
@@ -30272,7 +30351,7 @@ function getCachedRegex(filterPattern) {
 }
 
 /**
- * Checks visitor and account metadata in the current Pendo installation. Either logs to console
+ * Checks visitor and account metadata in the current Pendo installation. Either logs to the console
  * or returns an array with the results of validation.
  *
  * @access public
@@ -30534,7 +30613,7 @@ var validateBuiltInGlobals = function (skipLogging) {
     }
 };
 /**
- * Checks current URL of the browser for customized or sanitized strings by the application.
+ * Checks the current URL of the browser for strings customized or sanitized by the application.
  *
  * @access public
  * @category Validation
@@ -30623,6 +30702,7 @@ const validatePluginsAndExtensions = (skipLogging) => {
  *
  * @access public
  * @category Validation
+ * @param {boolean} [skipLogging] does not log output to console if true, returning the environment object instead
  * @example
  * pendo.validateEnvironment()
  */
@@ -31111,7 +31191,7 @@ const DEFAULT_GUIDE_SEEN_TIMEOUT_LENGTH = 10000;
  * @constant guideSeenTimeoutLength {number}
  *
  * Readonly number that indicates how long a guide will try to show before sending an error.
- * Defaults to 10 seconds.
+ * Defaults to 10 seconds (10000 ms).
  *
  * @access public
  * @category Guides
@@ -31229,9 +31309,7 @@ function exportPublicApi(pendo) {
     pendo.VERSION = VERSION;
     pendo.LOADER = LOADER;
     // cache.js
-    pendo.flushNow = exportPendoCoreOnly(function forceFlushNow(options) {
-        return flushNow(true, options);
-    });
+    pendo.flushNow = exportPendoCoreOnly(flushNow);
     pendo.teardown = makeSafe(teardown);
     // guides.js
     pendo.initGuides = exportPendoCoreOnly(initGuides);
@@ -31374,7 +31452,7 @@ function exportPublicApi(pendo) {
     pendo.receiveDomStructureJson = exportPendoCoreOnly(ContentLoader.receiveDomStructureJson);
     pendo.addExtension = addExtension;
     /**
-     * Retrieve a configuration value from the web sdk's config. Available configuration keys can be
+     * Retrieve a configuration value from the web SDK's config. Available configuration keys can be
      * found in the [configuration section](/config).
      *
      * @access public
@@ -31624,7 +31702,7 @@ function Guide() {
         return true;
     };
     /**
-     * Returns a Boolean value to indicate if the Guide can Show at this time.
+     * Returns a Boolean value to indicate if the Guide can show at this time.
      *
      * @access public
      * @category Guides
@@ -31657,13 +31735,13 @@ function Guide() {
         return promise;
     };
     /**
-      * Attempt to show the Guide. The Guide will still honor any constraints like
-      * requiring a DOM element to be present if it was configured for that.
-      *
-      * @access public
-      * @category Guides
-      * @returns {void}
-      */
+     * Attempt to show the Guide. The Guide will still honor any constraints like
+     * requiring a DOM element to be present if it was configured for that.
+     *
+     * @access public
+     * @category Guides
+     * @returns {void}
+     */
     this.show = function (reason) {
         var guide = this;
         return joinShowPromises(_.map(guide.steps, function (step) {
@@ -31677,7 +31755,7 @@ function Guide() {
      *
      * @access public
      * @category Guides
-     * @returns {Boolean}
+     * @returns {void}
      * @example
      * guide.hide({stayHidden: true});
      */
@@ -32774,7 +32852,7 @@ function GuideStep(guide) {
         removeStyleElementsForIdFromHead(this.id);
     };
     /**
-     * Attemps to show the step.
+     * Attempts to show the step.
      *
      * @access public
      * @category Guides
@@ -32955,7 +33033,7 @@ function GuideStep(guide) {
     /**
      * Hides the Step if shown. Use an argument of an Object containing a
      * key of `stayHidden` set to `true` to make sure to keep the Step hidden
-     * if the Guide it belongs to is designated as Automatically shown.
+     * if the Guide it belongs to is designated as automatically shown.
      *
      * @access public
      * @category Guides
@@ -33006,7 +33084,7 @@ function GuideStep(guide) {
      *
      * @access public
      * @category Guides
-     * @returns {boolean}
+     * @returns {void}
      */
     this.dismiss = function () {
         if (this.seenState === 'dismissed' && !this.isRendered())
@@ -33032,9 +33110,9 @@ function GuideStep(guide) {
      * Allows for an eventListener to be created that will automatically get cleaned up when this
      * Step is torn down.
      *
-     * @param element {Element} - The DOM element to attach the listener.
+     * @param element {Element} - The DOM element to attach the listener to.
      * @param type {String}     - The type of event: 'click', 'mousedown', 'keypress', etc...
-     * @param fn {function}     - A function that will be called when an event occurs of the specified type.
+     * @param fn {function}     - A function that will be called when an event of the specified type occurs.
      *
      * @access public
      * @category Guides
@@ -33192,7 +33270,7 @@ class CloneDetection {
             return;
         /**
          * Randomly generated ID used to detect when sessionStorage has been cloned
-         * from another browser window.
+         * from another browser tab.
          *
          * @name pendo_cd
          * @category Cookies/sessionStorage
@@ -33309,7 +33387,7 @@ var FramesModule = (function () {
             if (state.initialized)
                 return;
             /**
-             * Randomly generated string that identifies a browser window.
+             * Randomly generated string that identifies a browser tab.
              *
              * @name pendo_tabId
              * @category Cookies/sessionStorage
@@ -33318,7 +33396,7 @@ var FramesModule = (function () {
              */
             agentStorage.registry.addSession(TAB_ID);
             /**
-             * When a browser window is cloned the `pendo_tabId` is copied to the new window.
+             * When a browser tab is cloned, the `pendo_tabId` is copied to the new tab.
              * The Pendo Web SDK detects this, creates a new `pendo_tabId`, and stores the old
              * `pendo_tabId` in `pendo_parentTabId`.
              *
@@ -35397,7 +35475,7 @@ function addDebuggingFunctions() {
     pendo$1.debugging = debugging;
 }
 /**
- * Loads Pendo Debugger and extends the global pendo object with additional functionality
+ * Loads the Pendo Debugger and extends the global `pendo` object with additional functionality
  * for debugging purposes.
  *
  * @access public
@@ -35424,7 +35502,7 @@ function enableDebugging(andChain) {
     return 'debugging enabled';
 }
 /**
- * Removes Pendo Debugger extension.
+ * Removes the Pendo Debugger extension.
  *
  * @access public
  * @category Debugging
@@ -35503,7 +35581,7 @@ const DebuggerLauncher = (function () {
         }
         globalPendo = pendo;
         /**
-         * Returns a string indicating debugging status. Pass an optional value of true to get result as a boolean.
+         * Returns a string indicating debugging status. Pass an optional value of true to get the result as a boolean.
          *
          * @access public
          * @category Debugging
@@ -36081,7 +36159,7 @@ const EmbeddedGuides = (function () {
     }
 })();
 /**
- * Returns a list of embedded guides eligible to the active visitor on the active page
+ * Returns a list of embedded guides eligible for the active visitor on the active page.
  *
  * @access public
  * @category Guides
@@ -36093,7 +36171,7 @@ function getEmbeddedGuides() {
     return EmbeddedGuides.activeEmbeddedGuides;
 }
 /**
- * Returns a list of embedded guides that are rendered on the page
+ * Returns a list of embedded guides that are rendered on the page.
  *
  * @access public
  * @category Guides
@@ -39031,7 +39109,7 @@ var doesLauncherHaveGuides = function () {
     return dom('._pendo-launcher-item_').length > 0;
 };
 /**
- * Closes Pendo Guide Center (launcher) if open on page.
+ * Closes the Pendo Guide Center (launcher) if open on the page.
  *
  * @access public
  * @category Classic Guides
@@ -39049,7 +39127,7 @@ var collapseLauncherList = function () {
     }
 };
 /**
- * Opens Pendo Guide Center (launcher) if present on page.
+ * Opens the Pendo Guide Center (launcher) if present on the page.
  *
  * @access public
  * @category Classic Guides
@@ -39162,7 +39240,7 @@ var initLauncherPlugin = function (pendo, PluginAPI) {
     PluginAPI.GuideLoop.addUpdatePhase(launcherProc);
     registerLoadGuideJobs(loadLauncherContentHandler);
     /**
-    * Written when the classic guide center is closed. Legacy guide center only, not used for resource center.
+    * Written when the classic guide center is closed. Legacy guide center only; not used for the resource center.
     *
     * @name _pendo_launcher-closed
     * @category Cookies/localStorage
@@ -39367,7 +39445,7 @@ var PromoteMetadata = (function () {
         promotedAgentMetadata = PluginAPI.ConfigReader.get(PROMOTED_AGENT_METADATA);
         schemaGroup = {};
         /**
-        * Stores the historical metadata fields for the current visitor, when enabled in an application.
+        * Stores the historical metadata fields for the current visitor when enabled in an application.
         * This is turned on by an admin in Pendo's Data Mappings and used to track metadata changes over time.
         *
         * @name _pendo___sg__
@@ -39972,6 +40050,299 @@ class DOMPrompt {
     }
 }
 
+const ASSISTANT_MESSAGE = 'assistantMessage';
+const CONVERSATION_ID_URL_PATTERN = 'conversationIdUrlPattern';
+const MESSAGE_ID_ATTR = 'messageIdAttr';
+const MODEL_USED_ATTR = 'modelUsedAttr';
+const REACTION_ACTIVE = 'reactionActive';
+const STREAMING_ACTIVE = 'streamingActive';
+const STREAMING_ACTIVE_ATTR = 'streamingActiveAttr';
+const THUMB_DOWN = 'thumbDown';
+const THUMB_UP = 'thumbUp';
+const TURN_CONTAINER = 'turnContainer';
+const TURN_ATTR = 'turnAttr';
+const USER_MESSAGE = 'userMessage';
+const REQUIRED_SELECTORS = [
+    ASSISTANT_MESSAGE,
+    CONVERSATION_ID_URL_PATTERN,
+    MESSAGE_ID_ATTR,
+    STREAMING_ACTIVE,
+    TURN_CONTAINER,
+    TURN_ATTR,
+    USER_MESSAGE
+];
+const STREAMING_END_SETTLE_MS = 500;
+class DOMConversation {
+    // Returns the list of required selector types that are missing or empty
+    // in the given cssSelectors config. An empty array means the config is
+    // valid for instantiation.
+    static validateConfig(cssSelectors) {
+        if (!Array.isArray(cssSelectors)) {
+            return REQUIRED_SELECTORS.slice();
+        }
+        const present = new Set();
+        for (const cfg of cssSelectors) {
+            if (!cfg || !cfg.type || !cfg.cssSelector)
+                continue;
+            if (cfg.type === CONVERSATION_ID_URL_PATTERN) {
+                try {
+                    RegExp(cfg.cssSelector);
+                }
+                catch (e) {
+                    continue;
+                }
+            }
+            present.add(cfg.type);
+        }
+        return REQUIRED_SELECTORS.filter((r) => !present.has(r));
+    }
+    static supportedPreset(preset) {
+        return preset === 'chatgpt-full';
+    }
+    constructor(pendo, PluginAPI, id, privacyFilters, cssSelectors) {
+        this.selectors = {};
+        this.listeners = [];
+        this.isActive = true;
+        this.observers = [];
+        this.wasStreaming = false;
+        this.streamingEndTimer = null;
+        this.requestNode = null;
+        this.conversationIdRegex = null;
+        this.lastReturnedMessageId = null;
+        this.dom = pendo.dom;
+        this._ = pendo._;
+        this.api = PluginAPI;
+        this.Sizzle = pendo.Sizzle;
+        this.id = id;
+        this.setFilters(privacyFilters);
+        if (!this._.isArray(cssSelectors)) {
+            this.api.log.error(`cssSelectors must be an array, received: ${typeof cssSelectors}`);
+            cssSelectors = [];
+        }
+        this._.each(cssSelectors, (cfg) => {
+            if (cfg && cfg.type) {
+                this.selectors[cfg.type] = cfg.cssSelector;
+            }
+        });
+        this.conversationIdRegex = new RegExp(this.selectors[CONVERSATION_ID_URL_PATTERN]);
+        this.root = document.body;
+        this.setupReactionListener();
+        this.setupStreamingObserver();
+    }
+    setupReactionListener() {
+        if (!this.findSelector(THUMB_UP) && !this.findSelector(THUMB_DOWN))
+            return;
+        this.reactionClickHandler = this.handleReactionClick.bind(this);
+        this.root.addEventListener('click', this.reactionClickHandler, true);
+    }
+    handleReactionClick(evt) {
+        const target = evt.target;
+        if (!target || target.nodeType !== 1)
+            return;
+        const upSelector = this.findSelector(THUMB_UP);
+        const downSelector = this.findSelector(THUMB_DOWN);
+        const thumb = this.dom(target).closest(`${upSelector}, ${downSelector}`);
+        if (!thumb.length)
+            return;
+        const isUp = this.Sizzle.matchesSelector(thumb[0], upSelector);
+        const activeSelector = this.findSelector(REACTION_ACTIVE);
+        const wasPressed = activeSelector && this.Sizzle.matchesSelector(thumb[0], activeSelector);
+        const direction = isUp ? 'positive' : 'negative';
+        const content = wasPressed ? 'unreact' : direction;
+        const assistantNode = thumb.closest(this.findSelector(TURN_CONTAINER))
+            .find(this.findSelector(ASSISTANT_MESSAGE));
+        this.emit('user_reaction', {
+            agentId: this.id,
+            messageId: this.getMessageId(assistantNode),
+            content,
+            privacyFilterApplied: false
+        });
+    }
+    // observe the streaming indicator
+    setupStreamingObserver() {
+        this.wasStreaming = this.select(STREAMING_ACTIVE).length > 0;
+        this.stopStreamingEndTimer();
+        const MutationObserver = getZoneSafeMethod('MutationObserver');
+        const observer = new MutationObserver(this.handleMutation.bind(this));
+        const attrName = this.findSelector(STREAMING_ACTIVE_ATTR);
+        observer.observe(this.root, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            attributeFilter: attrName ? [attrName] : undefined
+        });
+        this.observers.push(observer);
+    }
+    // look for changes in the state of the streaming indicator.
+    // streaming started -> a prompt has been submitted
+    // streaming ended -> got a response
+    // we don't send the prompt immediately when it's submitted because it might not have a
+    // conversation id yet.
+    // we don't send the agent_response immediately when the streaming indicator is cleared
+    // because it clears slightly before the final text chunk is committed to the DOM so the
+    // end-handling is deferred by a short settle window
+    handleMutation() {
+        const isStreaming = this.select(STREAMING_ACTIVE).length > 0;
+        if (isStreaming === this.wasStreaming)
+            return;
+        if (isStreaming) { // started streaming
+            if (!this.streamingEndTimer) {
+                this.onSubmissionStart();
+            }
+            else {
+                // stream restarted during the settle window (multi-phase response).
+                // treat as a continuation of the prior request, not a new submission.
+                // we'll handle it next time streaming stops
+                this.stopStreamingEndTimer();
+            }
+        }
+        else { // finished streaming
+            this.startStreamingEndTimer();
+        }
+        this.wasStreaming = isStreaming;
+    }
+    onSubmissionStart() {
+        this.requestNode = this.findLastRequestNode();
+        if (this.requestNode) {
+            this.handleUserMessage(this.requestNode);
+        }
+    }
+    onSubmissionEnd() {
+        this.streamingEndTimer = null;
+        let requestNode = this.requestNode;
+        this.requestNode = null;
+        if (!requestNode) {
+            // onSubmissionStart didn't send, send it now
+            requestNode = this.findLastRequestNode();
+            if (!requestNode)
+                return;
+            this.handleUserMessage(requestNode);
+        }
+        const requestTurn = this.findTurnNumber(requestNode);
+        if (requestTurn === null)
+            return;
+        const assistantNodes = this.select(ASSISTANT_MESSAGE);
+        const toEmit = [];
+        for (let i = assistantNodes.length - 1; i >= 0; i--) {
+            const n = this.findTurnNumber(this.dom(assistantNodes[i]));
+            if (n === null)
+                continue;
+            if (n <= requestTurn)
+                break;
+            toEmit.push(assistantNodes[i]);
+        }
+        // emit in chronological order (reverse of collection order)
+        for (let i = toEmit.length - 1; i >= 0; i--) {
+            this.handleAssistantMessage(this.dom(toEmit[i]));
+        }
+    }
+    extractContent(node) {
+        const rawContent = node.text().trim();
+        const content = this.applyPrivacyFilter(rawContent);
+        return { content, privacyFilterApplied: content !== rawContent };
+    }
+    getMessageId(node) {
+        return node.attr(this.findSelector(MESSAGE_ID_ATTR));
+    }
+    handleUserMessage(node) {
+        this.emit('prompt', Object.assign({ agentId: this.id, messageId: this.getMessageId(node) }, this.extractContent(node)));
+    }
+    handleAssistantMessage(node) {
+        const modelUsedAttr = this.findSelector(MODEL_USED_ATTR);
+        const modelUsed = modelUsedAttr && node.attr(modelUsedAttr);
+        this.emit('agent_response', Object.assign({ agentId: this.id, messageId: this.getMessageId(node), agentModelsUsed: modelUsed ? [modelUsed] : [] }, this.extractContent(node)));
+    }
+    findLastRequestNode() {
+        if (!this.getConversationId())
+            return null;
+        const node = this._.last(this.select(USER_MESSAGE));
+        if (!node)
+            return null;
+        const $node = this.dom(node);
+        const messageId = this.getMessageId($node);
+        if (!messageId)
+            return null;
+        if (messageId === this.lastReturnedMessageId)
+            return null;
+        this.lastReturnedMessageId = messageId;
+        return $node;
+    }
+    findTurnNumber(node) {
+        const turnSelector = this.findSelector(TURN_CONTAINER);
+        const turnAttr = this.findSelector(TURN_ATTR);
+        const turn = node.closest(turnSelector).attr(turnAttr);
+        if (!turn)
+            return null;
+        const seqMatch = String(turn).match(/\d+/);
+        return seqMatch ? parseInt(seqMatch[0], 10) : null;
+    }
+    findSelector(type) {
+        return this.selectors[type];
+    }
+    select(type) {
+        return this.dom(this.findSelector(type), this.root);
+    }
+    getConversationId() {
+        const m = location.href.match(this.conversationIdRegex);
+        if (!m)
+            return null;
+        return m[1] !== undefined ? m[1] : m[0];
+    }
+    setFilters(candidateFilter) {
+        if (!candidateFilter) {
+            this.privacyFilters = null;
+            return null;
+        }
+        try {
+            this.privacyFilters = new RegExp(candidateFilter, 'gmi');
+        }
+        catch (e) {
+            this.privacyFilters = null;
+            this.api.log.error(e);
+        }
+        return this.privacyFilters;
+    }
+    applyPrivacyFilter(candidateValue, filters = null) {
+        const filtersToUse = filters || this.privacyFilters;
+        if (!filtersToUse || !this._.isRegExp(filtersToUse))
+            return candidateValue;
+        return candidateValue.replace(filtersToUse, 'redacted');
+    }
+    onSubmit(callback) {
+        this.listeners.push(callback);
+    }
+    emit(eventType, eventPayload) {
+        eventPayload.conversationId = this.getConversationId();
+        this._.each(this.listeners, (cb) => cb(eventType, eventPayload));
+    }
+    startStreamingEndTimer() {
+        this.stopStreamingEndTimer();
+        this.streamingEndTimer = setTimeout$1(this.onSubmissionEnd.bind(this), STREAMING_END_SETTLE_MS);
+    }
+    stopStreamingEndTimer() {
+        if (!this.streamingEndTimer)
+            return;
+        clearTimeout(this.streamingEndTimer);
+        this.streamingEndTimer = null;
+    }
+    suspend() {
+        this.isActive = false;
+    }
+    resume() {
+        this.isActive = true;
+    }
+    teardown() {
+        this._.each(this.observers, (o) => o && o.disconnect && o.disconnect());
+        this.observers = [];
+        if (this.reactionClickHandler && this.root) {
+            this.root.removeEventListener('click', this.reactionClickHandler, true);
+            this.reactionClickHandler = null;
+        }
+        this.stopStreamingEndTimer();
+        this.listeners = [];
+    }
+}
+
 /*
  * Prompt Analytics Plugin
  *
@@ -40136,18 +40507,31 @@ class PromptPlugin {
         }
     }
     observePrompt(config) {
-        const { id, cssSelectors, privacyFilters } = config;
+        const { id, cssSelectors, privacyFilters, preset } = config;
         // Check if agent already exists
         const existingPrompt = this._.find(this.prompts, prompt => prompt.id === id);
         if (existingPrompt) {
             return;
         }
+        if (DOMConversation.supportedPreset(preset)) {
+            const missing = DOMConversation.validateConfig(cssSelectors);
+            if (missing.length) {
+                this.api.log.error('aiAgent config missing required selectors', { agentId: id, missing });
+                return;
+            }
+            const conversation = new DOMConversation(this.pendo, this.api, id, privacyFilters, cssSelectors);
+            conversation.onSubmit((eventType, payload) => {
+                this.sendConversationEvent(eventType, payload);
+            });
+            this.prompts.push(conversation);
+            return;
+        }
         let inputCssSelectors, submitCssSelectors;
         inputCssSelectors = this.parseCssSelector('input', cssSelectors);
         submitCssSelectors = this.parseCssSelector('submit', cssSelectors);
         const prompt = new DOMPrompt(this.pendo, this.api, id, privacyFilters, inputCssSelectors, submitCssSelectors);
         prompt.onSubmit((promptPayload) => {
-            this.sendEvent(promptPayload);
+            this.sendPromptEvent(promptPayload);
         });
         this.prompts.push(prompt);
     }
@@ -40156,7 +40540,7 @@ class PromptPlugin {
         const selectors = this._.map(filtered, cfg => cfg.cssSelector);
         return selectors;
     }
-    sendEvent(promptEvent) {
+    sendPromptEvent(promptEvent) {
         // Block event if the prompt is suspended
         const prompt = this._.find(this.prompts, p => p.id === promptEvent.agentId);
         if (prompt && !prompt.isActive) {
@@ -40168,6 +40552,15 @@ class PromptPlugin {
         }, promptEvent);
         this.api.analytics.collectEvent('prompt', event, undefined, 'agentic');
     }
+    sendConversationEvent(eventType, eventPayload) {
+        // Block event if the prompt is suspended
+        const conv = this._.find(this.prompts, p => p.id === eventPayload.agentId);
+        if (conv && !conv.isActive) {
+            return;
+        }
+        eventPayload = this._.extend({ agentType: 'conversation' }, eventPayload);
+        this.api.analytics.collectEvent(eventType, eventPayload, undefined, 'agentic');
+    }
     teardown() {
         this._.each(this.prompts, (prompt) => prompt.teardown());
         if (this.agentsCache) {
@@ -40235,7 +40628,7 @@ class SessionManager {
         this.suffix = this.api.ConfigReader.get('identityStorageSuffix');
         /**
          * Randomly generated string that identifies a session. This is similar to `pendo_tabId`,
-         * but identifies the entire browser, rather than individual tabs.
+         * but identifies the entire browser session rather than individual tabs.
          *
          * @name sessionId
          * @category Cookies/localStorage
@@ -49467,7 +49860,7 @@ class SessionRecorder {
         // https://github.com/pendo-io/pendo-browser-extension/blob/master/src/common/agent-loader.js
         cf.addOption(RECORDING_CONFIG_ON_RECORDING_STOP, [cf.sources.SNIPPET_SRC, cf.sources.PENDO_CONFIG_SRC], undefined);
         /**
-         * Used when self hosting the replay web worker. Specifies the URL that points to the self hosted web worker.
+         * Used when self-hosting the replay web worker. Specifies the URL that points to the self-hosted web worker.
          *
          * @access public
          * @category Config/Replay
@@ -49575,7 +49968,7 @@ class SessionRecorder {
             this.subscriptions.push(this.api.attachEvent(this.api.Events, 'ready', bind(this.ready, this)));
         }
         /**
-         * Randomly generated string that identifies a session. This is the same as `pendo_sessionId`, but
+         * Randomly generated string that identifies a session. This is similar to `pendo_sessionId`, but
          * meant specifically for session recording.
          *
          * @name pendo_srId
@@ -49740,6 +50133,7 @@ class SessionRecorder {
      * Used to start collecting replay data.
      *
      * @function start
+     * @alias recording.start
      * @category Replay
      * @access public
      * @example
@@ -52090,6 +52484,7 @@ function NetworkCapture() {
          * Use RegExp for flexible or partial matching.
          *
          * Example: `['https://example.com', new RegExp('https://test\\.com\\/.*'), /.*\\.domain\\.com/]`
+         *
          * @access public
          * @category Config/Network Logs
          * @name networkLogs.excludeRequestUrls