@pendo/agent 2.334.1 → 2.335.1

package/dist/pendo.module.js

@@ -4029,8 +4029,8 @@ let SERVER = '';
 let ASSET_HOST = '';
 let ASSET_PATH = '';
 let DESIGNER_SERVER = '';
-let VERSION = '2.334.1_';
-let PACKAGE_VERSION = '2.334.1';
+let VERSION = '2.335.1_';
+let PACKAGE_VERSION = '2.335.1';
 let LOADER = 'xhr';
 /* eslint-enable web-sdk-eslint-rules/no-gulp-env-references */
 /**
@@ -11704,7 +11704,7 @@ function trimSurrogate(s) {
 class ElementGetter {
     constructor(cssSelector) {
         this.listeners = {}; // callbacks to be called when an event of type occurs
-        this.events = []; // event types this element listens for
+        this.events = []; // [{ type, capture }] events this element listens for
         this.cssSelector = cssSelector;
     }
     get() {
@@ -11719,8 +11719,8 @@ class ElementGetter {
         if (!el) {
             return undefined;
         }
-        _.each(this.events, (evtType) => {
-            el.addEventListener(evtType, (e) => this.onEvent(e));
+        _.each(this.events, ({ type, capture }) => {
+            el.addEventListener(type, (e) => this.onEvent(e), capture);
         });
         this.elRef = new WeakRef(el);
         return el;
@@ -11729,12 +11729,13 @@ class ElementGetter {
         // XXX not sure about size limit
         return getTextValue(this.get(), limit);
     }
-    addEventListener(event, callback) {
+    addEventListener(event, callback, capture = false) {
         const el = this.get();
-        if (this.events.indexOf(event) < 0) {
-            this.events.push(event);
+        const alreadyRegistered = _.find(this.events, (e) => e.type === event && e.capture === capture);
+        if (!alreadyRegistered) {
+            this.events.push({ type: event, capture });
             if (el) {
-                el.addEventListener(event, (e) => this.onEvent(e));
+                el.addEventListener(event, (e) => this.onEvent(e), capture);
             }
         }
         this.listeners[event] = this.listeners[event] || [];
@@ -11746,7 +11747,7 @@ class ElementGetter {
     }
     teardown(el = this.get()) {
         if (el) {
-            _.each(this.events, (evtType) => el.removeEventListener(evtType, this.onEvent));
+            _.each(this.events, ({ type, capture }) => el.removeEventListener(type, this.onEvent, capture));
         }
     }
 }
@@ -13925,6 +13926,27 @@ function calculateScrollAmount(combinedPos, screenDim, tooltipLayoutDir, bodyOve
     }
     return scrollAmt;
 }
+var VALID_UI_ELEMENT_TYPES = ['BUTTON', 'A', 'IMG'];
+var VALID_TRACK_ACTIONS = [
+    'advanceGuide',
+    'previousStep',
+    'dismissGuide',
+    'openLink',
+    'showGuide',
+    'launchGuide',
+    'guideSnoozed',
+    'goToStep',
+    'submitPoll',
+    'submitPollAndGoToStep',
+    'confirmation'
+];
+function normalizeUiElementType(elementType) {
+    var type = _.isString(elementType) ? elementType.toUpperCase() : '';
+    return _.contains(VALID_UI_ELEMENT_TYPES, type) ? type : 'BUTTON';
+}
+function isValidTrackedAction(action) {
+    return _.isObject(action) && _.isString(action.action) && _.contains(VALID_TRACK_ACTIONS, action.action);
+}
 function sizzleAttachPointInterceptor(Sizzle, selection, context, results, seed) {
     var args = _.toArray(arguments).slice(1);
     var resultList = Sizzle.apply(this, args);
@@ -15278,7 +15300,7 @@ var BuildingBlockTemplates = (function () {
     function generateResourceCenterModuleList(templateJson, step, guides, buildNodeFromJSON) {
         var children = templateJson.templateChildren;
         return _.reduce(children, function (acc, childConfig, index) {
-            var homeView = BuildingBlockResourceCenter.findResourceCenterHomeView(guides);
+            var homeView = pendo$1.BuildingBlocks.BuildingBlockResourceCenter.findResourceCenterHomeView(guides);
             var guide = _.find(guides, function (singleGuide) {
                 return singleGuide.id === childConfig.id;
             });
@@ -15463,7 +15485,7 @@ var BuildingBlockTemplates = (function () {
             });
             recursivelyPopulateTemplateChildrenForTaskList(templateJson, children);
         }
-        BuildingBlockResourceCenter.updatePseudoStyleSelectors(templateJson);
+        pendo$1.BuildingBlocks.BuildingBlockResourceCenter.updatePseudoStyleSelectors(templateJson);
         const taskListBlocks = buildNodeFromJSON(templateJson, step, guides);
         return [taskListBlocks];
     }
@@ -15583,7 +15605,7 @@ var BuildingBlockTemplates = (function () {
         });
         if (!allAnnouncementsHaveContent)
             return [];
-        var resourceCenter = BuildingBlockResourceCenter.getResourceCenter();
+        var resourceCenter = pendo$1.BuildingBlocks.BuildingBlockResourceCenter.getResourceCenter();
         var bubbleConfig = _.get(resourceCenter, 'attributes.notificationBubble');
         if (bubbleConfig) {
             delete bubbleConfig.dir;
@@ -15641,7 +15663,7 @@ var BuildingBlockTemplates = (function () {
             var guideTopPadding = parseInt(containerDomJson.props.style['padding-top'], 10);
             miniBubble.props.style.top = guideTopPadding + containerTopPadding + 5 + 'px';
         }
-        if (!BuildingBlockResourceCenter.hasAnnouncementBeenSeen(guide) && miniBubble) {
+        if (!pendo$1.BuildingBlocks.BuildingBlockResourceCenter.hasAnnouncementBeenSeen(guide) && miniBubble) {
             listItem.props.class += ' pendo-unseen-announcement';
             listItem.children.unshift(miniBubble);
         }
@@ -15667,7 +15689,7 @@ var BuildingBlockTemplates = (function () {
             miniBubble = generateUnreadAnnouncementMiniBubble(bubbleConfig);
             miniBubble.props.style.top = '20px';
         }
-        if (!BuildingBlockResourceCenter.hasAnnouncementBeenSeen(guide) && miniBubble) {
+        if (!pendo$1.BuildingBlocks.BuildingBlockResourceCenter.hasAnnouncementBeenSeen(guide) && miniBubble) {
             listItem.props.class += ' pendo-unseen-announcement';
             listItem.children = [miniBubble];
         }
@@ -19829,13 +19851,13 @@ var BuildingBlockResourceCenter = (function () {
         // If a module is currently shown, dismiss that first.
         if (shownModule) {
             var firstModuleStep = _.first(shownModule.steps);
-            onGuideDismissed(firstModuleStep);
+            pendo$1.onGuideDismissed(firstModuleStep);
         }
         // Finally, dismiss the homeView
         var resourceCenterHomeView = _.get(guideToDismiss, 'attributes.resourceCenter.isTopLevel', false)
             ? guideToDismiss : BuildingBlockResourceCenter.findResourceCenterHomeView(getLocalActiveGuides());
         var homeViewFirstStep = resourceCenterHomeView.steps[0];
-        return onGuideDismissed(homeViewFirstStep);
+        return pendo$1.onGuideDismissed(homeViewFirstStep);
     }
     function repositionResourceCenter() {
         var resourceCenterContainer = BuildingBlockResourceCenter.getResourceCenterContainer();
@@ -24508,7 +24530,9 @@ var loadGuideJs = function (apiKey, params) {
         if (treatAsAdoptPartner()) {
             addAccountIdParams(queryString, params.accountId, ConfigReader.get('oemAccountId'));
         }
-        if (isDebuggingEnabled()) {
+        // Also check persisted storage: the store's debuggingEnabled flag is only
+        // committed after leader election, which the first guide request usually beats.
+        if (isDebuggingEnabled() || getDebuggingStorage().enabled === true) {
             // Include debug info from server
             queryString.debug = true;
         }
@@ -25667,10 +25691,13 @@ function connectChannelToStore(channel, store) {
     var closed = false;
     const waitingRequests = [];
     channel.addEventListener('message', function (message) {
+        // connect-channel only routes inbound messages to the store; it never
+        // re-runs the guide loop. Anything that changes what guides display
+        // re-arms the loop from the specific store action that makes the change
+        // (see scheduleGuideUpdate in frames.module). Re-running on every
+        // inbound message instead made two framed guide loops wake each other
+        // forever even when idle (APP-162302).
         messageHandler(message.data);
-        if (store.state.guideUpdate.useObserver) {
-            store.dispatch('guideUpdate/documentChanged');
-        }
     });
     return {
         postMessage,
@@ -33302,6 +33329,59 @@ function GuideStep(guide) {
             return;
         onGuideDismissed(this);
     };
+    /**
+     * Records a `guideActivity` analytics event for this Step. Intended for
+     * code-block guides to report UI interactions (button clicks,
+     * link opens, poll submissions) that the automatic click-capture path cannot
+     * resolve from `domJson`. This only reports analytics;
+     *
+     * Because the details originate from customer-authored guide content, they are
+     * validated before staging: a missing or non-string `elementId` drops the event,
+     * an unrecognized `elementType` falls back to `'BUTTON'`, and malformed action
+     * entries are filtered out (no event when none remain valid).
+     *
+     * @access public
+     * @category Guides
+     * @example
+     * step.trackAction({
+     *     elementId: 'pendo-button-advance-btn',
+     *     elementType: 'BUTTON',
+     *     actions: [{ action: 'advanceGuide' }]
+     * })
+     * @param {Object} details
+     * @param {string} details.elementId DOM id of the interacted element. Required; a missing or
+     *  non-string value drops the event.
+     * @param {string} [details.elementType] Element type/tag. Coerced to one of BUTTON/A/IMG,
+     *  defaulting to 'BUTTON' when missing or unrecognized.
+     * @param {Array<Object>} details.actions Action objects, e.g. `[{ action: 'advanceGuide' }]`. Entries
+     *  whose `action` is not a recognized guideActivity action name are dropped.
+     * @returns {void}
+     */
+    this.trackAction = function (details) {
+        details = details || {};
+        if (!details.elementId || !_.isString(details.elementId))
+            return;
+        var actions = _.isArray(details.actions)
+            ? details.actions
+            : (details.action ? [_.omit(details, 'elementId', 'elementType', 'actions')] : []);
+        actions = _.filter(actions, isValidTrackedAction);
+        actions = _.map(actions, function (action) {
+            if (action.action === 'openLink' && action.url) {
+                return _.extend({}, action, { url: sanitizeUrl(action.url) });
+            }
+            return action;
+        });
+        var eventProps = {
+            type: 'guideActivity',
+            guideId: guide.id,
+            stepId: this.id,
+            ui_element_id: details.elementId,
+            ui_element_type: normalizeUiElementType(details.elementType),
+            ui_element_actions: actions,
+            language: guide.language
+        };
+        stageGuideEvent(createGuideEvent(eventProps));
+    };
     this.isPoweredByEnabled = function () {
         return this.hideCredits !== true;
     };
@@ -33655,6 +33735,7 @@ var FramesModule = (function () {
                 context.commit('setGuidesLoaded');
             }
             updateMasterGuideList(context.state);
+            scheduleGuideUpdate();
         },
         join(context) {
             if (context.state.disabled)
@@ -33898,6 +33979,7 @@ var FramesModule = (function () {
                 stepId: payload.stepId,
                 shown: payload.isShown
             });
+            scheduleGuideUpdate();
         },
         hideGuides(context, guideIdsToHide) {
             guideIdsToHide = _.isArray(guideIdsToHide) ? guideIdsToHide : [];
@@ -33918,6 +34000,7 @@ var FramesModule = (function () {
                 hideGuides();
             }
             context.commit('hideGuides');
+            scheduleGuideUpdate();
         },
         guideStepHiddenInFrame(context, payload) {
             var wasShown = context.getters.isShownInFrame()(context.state.frameId, { id: payload.stepId });
@@ -33944,6 +34027,7 @@ var FramesModule = (function () {
                 stepId: payload.stepId,
                 shown: false
             });
+            scheduleGuideUpdate();
         },
         fixDoubleDisplay(context, payload) {
             _.each(context.state.frames, function (frame, frameId) {
@@ -33967,6 +34051,7 @@ var FramesModule = (function () {
             if (!step)
                 return;
             step.hide();
+            scheduleGuideUpdate();
         },
         changeLastGuideStepSeen(context, lastGuideStepSeen) {
             crossFrameChannel.postMessage({
@@ -34099,6 +34184,7 @@ var FramesModule = (function () {
         },
         receiveFrameVisibility(context, message) {
             context.commit('setFrameVisibility', message);
+            scheduleGuideUpdate();
         },
         addSelectionModeToFrames(context, message) {
             var options = message.options;
@@ -34504,6 +34590,18 @@ var FramesModule = (function () {
         return _.map(guides, cloneGuide);
     }
 })();
+// Nudge the guide loop after a cross-frame change that affects what can
+// display. Guarded on useObserver: when the mutation observer drives the loop
+// it idles while the page is quiet and needs an explicit nudge to react to
+// cross-frame state; when the observer is off the loop already polls on its
+// own. This is called only from the frames actions that actually change
+// display state (not from every inbound message), which is what lets two
+// framed guide loops go fully idle instead of pinging each other (APP-162302).
+function scheduleGuideUpdate() {
+    if (store.state.guideUpdate.useObserver) {
+        store.dispatch('guideUpdate/documentChanged');
+    }
+}
 function updateMasterGuideList(state) {
     var guidesInThisFrame = _.indexBy(_.filter(getActiveGuides(), function (guide) {
         return !guide.isFrameProxy;
@@ -35918,6 +36016,11 @@ function startDebuggingModuleIfEnabled() {
     if (!debugging.enabled || !isLeader())
         return;
     store.commit('debugger/debuggingEnabled', true);
+    if (pendo$1.guides && _.isUndefined(pendo$1.excludedGuides)) {
+        // The current guide payload was requested without debug=true (e.g. debugging
+        // was just enabled), so it lacks exclusion data; re-fetch to include it.
+        forceGuideReload();
+    }
     addDebuggingFunctions();
     if (dom('#pendo-client-debugger').length)
         return;
@@ -36248,10 +36351,19 @@ var DesignerConnect = (function () {
     }
     function launchDesignerListener(data, msg) {
         var token = msg.data.token;
-        if (!token)
+        if (!token) {
+            globalPendo.log('Designer launch request received with no token. Ignoring launch request.');
+            postLaunchError(msg, 'missingToken');
             return;
+        }
         if (token.publicAppId && token.publicAppId !== globalPendo.publicAppId) {
             globalPendo.log(`Designer launch information received was for public app ID ${token.publicAppId}, which does not match the current app ID ${globalPendo.publicAppId}. Ignoring launch request.`);
+            postLaunchError(msg, 'appIdMismatch');
+            return;
+        }
+        if (token.preferredAgentInstallType && token.preferredAgentInstallType !== getInstallType()) {
+            globalPendo.log(`Designer launch information received was for install type ${token.preferredAgentInstallType}, which does not match the current install type ${getInstallType()}. Ignoring launch request.`);
+            postLaunchError(msg, 'installTypeMismatch');
             return;
         }
         tempLaunchToken = token;
@@ -36293,6 +36405,11 @@ var DesignerConnect = (function () {
             pluginAPI.store.dispatch('frames/startPreview');
         }
     }
+    function postLaunchError(msg, reason) {
+        if (msg.source && globalPendo._.isFunction(msg.source.postMessage)) {
+            msg.source.postMessage({ type: 'pendo-designer-launch::error', reason }, msg.origin);
+        }
+    }
     function removeListeners() {
         if (window.removeEventListener) {
             window.removeEventListener('message', messageReceiver, false);
@@ -39128,30 +39245,6 @@ function doSearch(guides, srchTxt) {
         .value();
 }
 
-var lastLauncherHash;
-var launcherProc = function () {
-    const guidesList = getActiveGuides();
-    if (isLeader()) {
-        if (!pendo$1.guideWidget || !pendo$1.guideWidget.enabled)
-            return;
-        // filter list down to launcher based guides
-        var launcherGuides = getLauncherGuideList(guidesList);
-        // add all launcher based guides
-        updateLauncher(launcherGuides, true);
-    }
-    else {
-        hideLauncher();
-        // Check for changes to what should display in the launcher
-        var frameGuides = frameLocalGuides(guidesList);
-        var launchers = getLauncherGuideList(frameGuides);
-        var launcherHash = computeLauncherHash(launchers);
-        if (launcherHash !== lastLauncherHash) {
-            store.dispatch('frames/changeGuideList', frameGuides);
-        }
-        lastLauncherHash = launcherHash;
-    }
-};
-
 var LAUNCHER_DEFAULT_WIDTH = 330;
 var LAUNCHER_DEFAULT_HEIGHT = 310;
 var LAUNCHER_CLOSED = 'launcher-closed';
@@ -39954,6 +40047,29 @@ var debuggerLaunched = function () {
 var loadLauncherContentHandler = function (activeGuides) {
     return loadLauncherContent(upgradeLauncher(pendo$1.guideWidget, activeGuides));
 };
+var lastLauncherHash;
+var launcherProc = function () {
+    const guidesList = getActiveGuides();
+    if (isLeader()) {
+        if (!pendo$1.guideWidget || !pendo$1.guideWidget.enabled)
+            return;
+        // filter list down to launcher based guides
+        var launcherGuides = getLauncherGuideList(guidesList);
+        // add all launcher based guides
+        updateLauncher(launcherGuides, true);
+    }
+    else {
+        hideLauncher();
+        // Check for changes to what should display in the launcher
+        var frameGuides = frameLocalGuides(guidesList);
+        var launchers = getLauncherGuideList(frameGuides);
+        var launcherHash = computeLauncherHash(launchers);
+        if (launcherHash !== lastLauncherHash) {
+            store.dispatch('frames/changeGuideList', frameGuides);
+        }
+        lastLauncherHash = launcherHash;
+    }
+};
 var initLauncherPlugin = function (pendo, PluginAPI) {
     loadLauncherPublicFunctions(pendo);
     PluginAPI.Events.on('guidesLoaded', guidesLoaded);
@@ -40584,7 +40700,7 @@ class DOMPrompt {
         return evt.isComposing !== undefined ? evt.isComposing : isComposingFromState;
     }
     isEnterKey(evt) {
-        return evt.code === 'Enter' || evt.key === 'Enter' || evt.keyCode === 13;
+        return (evt.code === 'Enter' || evt.key === 'Enter' || evt.keyCode === 13) && !evt.shiftKey;
     }
     setupInputListeners() {
         this._.each(this.inputEls, (inputEl) => {
@@ -52348,6 +52464,7 @@ function maskSensitiveFields({ string, contentType, _ }) {
 }
 
 const DEV_LOG_TYPE = 'devlog';
+const DEV_LOG_SEND_INTERVAL = 5000;
 function createDevLogEnvelope(pluginAPI, globalPendo) {
     return {
         browser_time: pluginAPI.util.getNow(),
@@ -52576,7 +52693,7 @@ function ConsoleCapture() {
             if (!sendQueue.failed()) {
                 send();
             }
-        }, pluginAPI.constants.SEND_INTERVAL);
+        }, DEV_LOG_SEND_INTERVAL);
         sendQueue.start();
         pluginAPI.Events.ready.on(readyHandler);
         pluginAPI.Events['recording:unpaused'].on(recordingStarted);
@@ -52864,7 +52981,7 @@ function NetworkCapture() {
             if (!sendQueue.failed()) {
                 send();
             }
-        }, pluginAPI.constants.SEND_INTERVAL);
+        }, DEV_LOG_SEND_INTERVAL);
         sendQueue.start();
         pluginAPI.Events.ready.on(startCapture);
         pluginAPI.Events['recording:unpaused'].on(recordingStarted);
@@ -55214,6 +55331,46 @@ var _ = /*@__PURE__*/getDefaultExportFromCjs(underscoreExports);
 
 var encodeURIComponent = _.isFunction(window.encodeURIComponent) ? window.encodeURIComponent : _.identity;
 
+const WIDGET_SETTINGS_API = '/external/widget/settings';
+class PredictApiService {
+    constructor({ baseUrl, token }) {
+        this.performRequest = (url, options) => __awaiter(this, void 0, void 0, function* () {
+            const response = yield fetch(url, options);
+            const body = response.ok ? yield response.json() : null;
+            return { ok: response.ok, status: response.status, body };
+        });
+        this.getWidgetSettingsById = (id, log) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            if (!id) {
+                log('[predict] no id provided');
+                return null;
+            }
+            try {
+                const { ok, status, body } = yield this.performRequest(`${this.baseUrl}${WIDGET_SETTINGS_API}/${id}`, {
+                    method: 'GET',
+                    headers: { 'Content-Type': 'application/json', 'Authorization': this.token }
+                });
+                if (!ok) {
+                    log(`[predict] error getting widget settings by id: ${status}`);
+                    return null;
+                }
+                const data = body;
+                if ((_a = data === null || data === void 0 ? void 0 : data.errors) === null || _a === void 0 ? void 0 : _a.length) {
+                    log(`[predict] error getting widget settings by id: ${data.errors}`);
+                    return null;
+                }
+                return (_b = data === null || data === void 0 ? void 0 : data.data) !== null && _b !== void 0 ? _b : null;
+            }
+            catch (error) {
+                log(`[predict] error getting widget settings by id: ${error}`);
+                return null;
+            }
+        });
+        this.baseUrl = baseUrl;
+        this.token = token;
+    }
+}
+
 const PREDICT_STEP_REGEX = /\$\$predict\$\$/;
 const DRAG_THRESHOLD = 5;
 const STYLE_ID = 'pendo-predict-plugin-styles';
@@ -55221,6 +55378,7 @@ const GUIDE_BUTTON_IDENTIFIER = 'button:contains("token")';
 const pluginVersion = '1.0.1';
 const PREDICT_SANDBOX_PAGE = 'predict-sandbox.html';
 const getPredictBaseUrl = (designerServer) => designerServer.replace('app', 'predict');
+const getPredictApiBaseUrl = (predictBaseUrl) => predictBaseUrl.replace('predict', 'predict-api');
 const EXTENSION_ORIGIN_REGEX = /^(chrome|moz|safari-web)-extension:\/\//;
 /**
  * When running inside the Pendo Launcher extension, a host page's CSP `frame-src`
@@ -55324,6 +55482,50 @@ const getRecordIdFromUrl = (recordRegex, log = () => { }) => {
     log(`[predict] recordId found: ${recordId}`);
     return recordId;
 };
+const escapeRegexKeyword = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+// Builds the generalized keyword matcher: a simple keyword (single- or
+// multi-segment, e.g. "Company" or "lightning/r/Opportunity") that works
+// whether the id lives in the path or the query string. The keyword is escaped
+// so metacharacters are treated literally, a boundary avoids substring hijacks,
+// and the id ends naturally at any delimiter.
+const buildRecordRegex = (keyword) => new RegExp(`(?:^|[/?&=.#])${escapeRegexKeyword(keyword)}[/.=:_-]([a-zA-Z0-9-]+)`, 'i');
+// Resolves the record id from the current URL using three tiers, returning the
+// first non-null result:
+//   1. recordRegexPattern - an advanced, author-supplied full regex.
+//   2. recordRegexName    - the generalized keyword matcher (path + query).
+//   3. legacy fallback    - the original strict `/name/id` template, so every
+//                           pre-existing config keeps working with no migration.
+const resolveRecordId = (configuration, log = () => { }) => {
+    var _a, _b, _c, _d;
+    const { recordRegexPattern, recordRegexName } = configuration;
+    // Tier 1: advanced full pattern (matched against the full href).
+    if (recordRegexPattern) {
+        try {
+            const advancedId = (_b = (_a = window.location.href.match(new RegExp(recordRegexPattern))) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : null;
+            if (advancedId) {
+                log(`[predict] recordId found via recordRegexPattern: ${advancedId}`);
+                return advancedId;
+            }
+        }
+        catch (error) {
+            log(`[predict] invalid recordRegexPattern, skipping: ${error}`);
+        }
+    }
+    if (!recordRegexName) {
+        return null;
+    }
+    // Tier 2: generalized keyword matcher against path + query + hash only
+    // (host excluded to avoid subdomain false matches).
+    const { pathname, search, hash } = window.location;
+    const keywordId = (_d = (_c = `${pathname}${search}${hash}`.match(buildRecordRegex(recordRegexName))) === null || _c === void 0 ? void 0 : _c[1]) !== null && _d !== void 0 ? _d : null;
+    if (keywordId) {
+        log(`[predict] recordId found via recordRegexName: ${keywordId}`);
+        return keywordId;
+    }
+    // Tier 3: legacy template fallback (preserves pre-existing configs).
+    const legacyRegex = new RegExp(`/${recordRegexName}/([a-zA-Z0-9]+)(?:/|$)`);
+    return getRecordIdFromUrl(legacyRegex, log);
+};
 const safeStringify = (value, fallback) => {
     try {
         return JSON.stringify(value);
@@ -55341,13 +55543,25 @@ const safeParse = (value, fallback, log = () => { }) => {
         return fallback;
     }
 };
+const getAvailableParams = (params) => {
+    // No need to pass the full configuration when widgetId is present
+    if (params.widgetId) {
+        return {
+            widgetId: params.widgetId,
+            pipeVersion: params.pipeVersion,
+            forceAccountId: params.forceAccountId
+        };
+    }
+    return params;
+};
 const buildQueryParams = (params) => {
     const urlParams = new URLSearchParams();
-    const entries = Object.entries(params);
+    const availableParams = getAvailableParams(params);
+    const entries = Object.entries(availableParams);
     urlParams.set('pluginVersion', pluginVersion);
     for (let i = 0; i < entries.length; i++) {
         const [key, value] = entries[i];
-        if (value != null) {
+        if (value !== undefined && value !== null) {
             urlParams.set(key, typeof value === 'object' ? safeStringify(value) : String(value));
         }
     }
@@ -55453,10 +55667,16 @@ const createExplanationIframe = ({ analysisId, recordId, configuration, predictB
 };
 // ----- Floating Modal Creation -----
 const createFloatingModal = ({ recordId, configuration, predictBaseUrl, wrapperBase = '' }) => {
-    var _a;
-    const flatIds = (_a = configuration.analysisIds) === null || _a === void 0 ? void 0 : _a.flat(Infinity);
+    var _a, _b;
+    const flatIds = ((_b = (_a = configuration.analysisIds) === null || _a === void 0 ? void 0 : _a.flat(Infinity)) !== null && _b !== void 0 ? _b : []);
     for (let i = 0; i < flatIds.length; i++) {
-        createExplanationIframe({ analysisId: flatIds[i], recordId, configuration, predictBaseUrl, wrapperBase });
+        createExplanationIframe({
+            analysisId: flatIds[i],
+            recordId,
+            configuration,
+            predictBaseUrl,
+            wrapperBase
+        });
     }
     const container = createElement('div', { id: 'floatingModalContainer', className: 'floating-modal-container' }, document.body);
     const dragHandle = createElement('div', {
@@ -55530,7 +55750,14 @@ const setupMessageListener = ({ token, forceAccountId, cleanup, pendo, predictBa
                     }
                     const visitorId = (_a = pendo === null || pendo === void 0 ? void 0 : pendo.getVisitorId) === null || _a === void 0 ? void 0 : _a.call(pendo);
                     const accountId = forceAccountId !== null && forceAccountId !== void 0 ? forceAccountId : (_b = pendo === null || pendo === void 0 ? void 0 : pendo.getAccountId) === null || _b === void 0 ? void 0 : _b.call(pendo);
-                    (_c = iframe.contentWindow) === null || _c === void 0 ? void 0 : _c.postMessage({ type: 'TOKEN_RECEIVED', token, idToken, extensionAPIKeys, visitorId, accountId }, frameTargetOrigin);
+                    (_c = iframe.contentWindow) === null || _c === void 0 ? void 0 : _c.postMessage({
+                        type: 'TOKEN_RECEIVED',
+                        token,
+                        idToken,
+                        extensionAPIKeys,
+                        visitorId,
+                        accountId
+                    }, frameTargetOrigin);
                 }
             },
             OPEN_EXPLANATION: () => {
@@ -55578,8 +55805,24 @@ const setupMessageListener = ({ token, forceAccountId, cleanup, pendo, predictBa
     window.addEventListener('message', messageHandler);
     return () => window.removeEventListener('message', messageHandler);
 };
-const predictGuidesScript = ({ step, pendo, cleanupArray, cleanup, log, designerServer }) => {
-    var _a;
+const mapAnalysisIds = (analysesHierarchy) => analysesHierarchy === null || analysesHierarchy === void 0 ? void 0 : analysesHierarchy.map(hierarchy => hierarchy.map(item => item.analysisId));
+// Loads the widget's stored settings from the predict API, which override
+// whatever was inlined in the guide button. Any failure logs and returns the inline configuration.
+const fetchWidgetConfiguration = (_a) => __awaiter(void 0, void 0, void 0, function* () {
+    var _b;
+    var { token, predictBaseUrl, log } = _a, inlineConfiguration = __rest(_a, ["token", "predictBaseUrl", "log"]);
+    const predictApiService = new PredictApiService({
+        baseUrl: getPredictApiBaseUrl(predictBaseUrl),
+        token
+    });
+    const widgetSettings = yield predictApiService.getWidgetSettingsById((_b = inlineConfiguration.widgetId) !== null && _b !== void 0 ? _b : '', log);
+    if (!widgetSettings) {
+        return inlineConfiguration;
+    }
+    return Object.assign(Object.assign({}, inlineConfiguration), { analysisIds: mapAnalysisIds(widgetSettings.analysesHierarchy), recordRegexPattern: widgetSettings.recordRegexPattern, recordRegexName: widgetSettings.recordRegexKeyword });
+});
+const predictGuidesScript = ({ step, pendo, cleanupArray, cleanup, log, designerServer }) => __awaiter(void 0, void 0, void 0, function* () {
+    var _c;
     log('[predict] initializing');
     // Before anything else, inject styles so that the guide will be hidden
     const pendoContainerId = step === null || step === void 0 ? void 0 : step.containerId;
@@ -55588,33 +55831,47 @@ const predictGuidesScript = ({ step, pendo, cleanupArray, cleanup, log, designer
         log('[predict] cleanupArray is not empty');
         return;
     }
+    if (!designerServer) {
+        log('[predict] no designerServer found, aborting');
+        return;
+    }
+    const predictBaseUrl = getPredictBaseUrl(designerServer);
     // ----- Extract Configuration -----
-    const guideButton = (_a = step.guideElement.find(GUIDE_BUTTON_IDENTIFIER)) === null || _a === void 0 ? void 0 : _a[0];
+    const guideButton = (_c = step.guideElement.find(GUIDE_BUTTON_IDENTIFIER)) === null || _c === void 0 ? void 0 : _c[0];
     if (!guideButton) {
         log('[predict] no guide button found, aborting');
         return;
     }
-    const _b = safeParse(guideButton.textContent, {}, log), { token } = _b, configuration = __rest(_b, ["token"]);
-    if (!configuration || !token) {
+    const _d = safeParse(guideButton.textContent, {}, log), { token } = _d, inlineConfiguration = __rest(_d, ["token"]);
+    if (!inlineConfiguration || !token) {
         log('[predict] no configuration found, aborting');
         return;
     }
-    const recordRegex = new RegExp(`/${configuration.recordRegexName}/([a-zA-Z0-9]+)(?:/|$)`);
-    const recordId = getRecordIdFromUrl(recordRegex, log);
+    // Widget-backed guides load their settings from the predict API; those
+    // override whatever was inlined in the guide button. Non-widget guides use
+    // the inlined configuration as-is.
+    const configuration = (inlineConfiguration === null || inlineConfiguration === void 0 ? void 0 : inlineConfiguration.widgetId)
+        ? yield fetchWidgetConfiguration(Object.assign(Object.assign({}, inlineConfiguration), { token,
+            predictBaseUrl,
+            log }))
+        : inlineConfiguration;
+    const recordId = resolveRecordId(configuration, log);
     if (!recordId) {
         log('[predict] no recordId found in URL, aborting');
         return;
     }
-    if (!designerServer) {
-        log('[predict] no designerServer found, aborting');
-        return;
-    }
-    const predictBaseUrl = getPredictBaseUrl(designerServer);
     const wrapperBase = getFrameWrapperBase(pendo);
     log(`[predict] predictBaseUrl: ${predictBaseUrl}${wrapperBase ? `, wrapping via ${wrapperBase}` : ''}`);
-    cleanupArray.push(setupMessageListener({ token, forceAccountId: configuration === null || configuration === void 0 ? void 0 : configuration.forceAccountId, cleanup, pendo, predictBaseUrl, wrapperBase }));
+    cleanupArray.push(setupMessageListener({
+        token,
+        forceAccountId: configuration.forceAccountId,
+        cleanup,
+        pendo,
+        predictBaseUrl,
+        wrapperBase
+    }));
     cleanupArray.push(createFloatingModal({ recordId, configuration, predictBaseUrl, wrapperBase }));
-};
+});
 
 const PredictGuides = () => {
     let pluginApiRef = null;
@@ -55649,7 +55906,10 @@ const PredictGuides = () => {
                 var _a, _b;
                 const designerServer = ((_a = pendo === null || pendo === void 0 ? void 0 : pendo.getConfigValue) === null || _a === void 0 ? void 0 : _a.call(pendo, 'designerServer')) ||
                     ((_b = pendo === null || pendo === void 0 ? void 0 : pendo.getConfigValue) === null || _b === void 0 ? void 0 : _b.call(pendo, 'server'));
-                predictGuidesScript({ step, pendo, cleanupArray, cleanup, log, designerServer });
+                Promise$2.resolve(predictGuidesScript({ step, pendo, cleanupArray, cleanup, log, designerServer })).catch((error) => {
+                    log(`[predict] predictGuidesScript crashed, tearing down: ${error}`);
+                    cleanup();
+                });
                 this.on('unmounted', (evt) => {
                     if (evt.reason !== 'hidden')
                         cleanup();