@thoughtspot/visual-embed-sdk 1.52.1 → 1.52.2-beta

package/dist/tsembed.es.js

@@ -1,4 +1,4 @@
-/* @thoughtspot/visual-embed-sdk version 1.52.1 */
+/* @thoughtspot/visual-embed-sdk version 1.52.2-beta */
 'use client';
 function _mergeNamespaces(n, m) {
     m.forEach(function (e) {
@@ -3766,6 +3766,12 @@ var HostEvent;
      * ```js
      * const data = await liveboardEmbed.trigger(HostEvent.GetFilters);
      *     console.log('data', data);
+     * // {
+     * //   liveboardFilters: [ ... ],
+     * //   runtimeFilters: [
+     * //     { columnName: "Region", operator: "IN", values: ["West"] }
+     * //   ]
+     * // }
      * ```
      * @example
      * ```js
@@ -3790,9 +3796,9 @@ var HostEvent;
      *
      * Each filter object must include the following attributes:
      *
-     * `column` - Name of the column to filter on.
+     * `columnName` - Name of the column to filter on.
      *
-     * `oper`  - Filter operator, for example, EQ, IN, CONTAINS.
+     * `operator`  - Filter operator, for example, EQ, IN, CONTAINS.
      *  For information about the supported filter operators,
      *  see link:https://developers.thoughtspot.com/docs/runtime-filters#rtOperator[Developer Documentation].
      *
@@ -3819,8 +3825,8 @@ var HostEvent;
      *
      * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
      *     filter: {
-     *         column: "item type",
-     *         oper: "IN",
+     *         columnName: "item type",
+     *         operator: "IN",
      *         values: ["bags","shirts"]
      *        }
      *    });
@@ -3830,8 +3836,8 @@ var HostEvent;
      *
      * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
      *     filter: {
-     *         column: "date",
-     *         oper: "EQ",
+     *         columnName: "date",
+     *         operator: "EQ",
      *         values: ["JULY","2023"],
      *         type: "MONTH_YEAR"
      *        }
@@ -3842,18 +3848,18 @@ var HostEvent;
      * ```js
      * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
      *  filters: [{
-     *      column: "Item Type",
-     *      oper: 'IN',
+     *      columnName: "Item Type",
+     *      operator: 'IN',
      *      values: ["bags","shirts"]
      *  },
      *    {
-     *      column: "Region",
-     *      oper: 'IN',
+     *      columnName: "Region",
+     *      operator: 'IN',
      *      values: ["West","Midwest"]
      *  },
      *    {
-     *      column: "Date",
-     *      oper: 'EQ',
+     *      columnName: "Date",
+     *      operator: 'EQ',
      *      values: ["2023-07-31"],
      *      type: "EXACT_DATE"
      *    }]
@@ -3867,13 +3873,13 @@ var HostEvent;
      * ```js
      * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
      *  filters: [{
-     *      column: "(Sample) Retail - Apparel::city",
-     *      oper: 'IN',
+     *      columnName: "(Sample) Retail - Apparel::city",
+     *      operator: 'IN',
      *      values: ["atlanta"]
      *  },
      *  {
-     *      column: "(Sample) Retail - Apparel::Region",
-     *      oper: 'IN',
+     *      columnName: "(Sample) Retail - Apparel::Region",
+     *      operator: 'IN',
      *      values: ["West","Midwest"]
      *  }]
      * });
@@ -3884,8 +3890,8 @@ var HostEvent;
      * import { ContextType } from '@thoughtspot/visual-embed-sdk';
      * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
      *     filter: {
-     *         column: "item type",
-     *         oper: "IN",
+     *         columnName: "item type",
+     *         operator: "IN",
      *         values: ["shoes", "boots"]
      *     }
      * }, ContextType.Liveboard);
@@ -3895,8 +3901,8 @@ var HostEvent;
      * // Scope the filter to a specific Liveboard tab
      * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
      *     filter: {
-     *         column: "item type",
-     *         oper: "IN",
+     *         columnName: "item type",
+     *         operator: "IN",
      *         values: ["bags", "shirts"],
      *         applicability: {
      *             level: "TAB",
@@ -3905,6 +3911,12 @@ var HostEvent;
      *     }
      * });
      * ```
+     * Use `columnName` and `operator` - the same spelling as
+     * {@link RuntimeFilter}. The older `column` and `oper` spellings are
+     * deprecated; they are still accepted, but pass only one spelling of each
+     * field, never both. To reapply the filter state captured from
+     * {@link EmbedEvent.FilterChanged}, use `convertFilterChangedToUpdateFiltersPayload`
+     * to convert its payload into the shape expected here.
      * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
      */
     HostEvent["UpdateFilters"] = "updateFilters";
@@ -4890,7 +4902,6 @@ var Param;
     Param["IsStarterPromptsEnabled"] = "enableStarterPrompts";
     Param["UpdatedSpotterExperience"] = "updatedSpotterExperience";
     Param["SpotterDataSources"] = "spotterDataSources";
-    Param["AnalystId"] = "analystId";
     Param["OpenSpotterOnLiveboardByDefault"] = "openSpotterOnLiveboardByDefault";
     Param["ShowAnswerEditPanel"] = "showAnswerEditPanel";
 })(Param || (Param = {}));
@@ -7116,6 +7127,18 @@ var Action;
      * ```
      */
     Action["DeleteCollection"] = "deleteCollection";
+    /**
+     * Controls the visibility of the "Customize homepage" button on the
+     * embedded home page.
+     * @version SDK: 1.55.0 | ThoughtSpot Cloud: 26.12.0.cl
+     * @example
+     * ```js
+     * {
+     *     hiddenActions: [Action.CustomizeHomepage],
+     * }
+     * ```
+     */
+    Action["CustomizeHomepage"] = "customizeHomepage";
 })(Action || (Action = {}));
 var PrefetchFeatures;
 (function (PrefetchFeatures) {
@@ -7620,7 +7643,7 @@ var TableContentDensity;
     TableContentDensity["Compact"] = "COMPACT";
 })(TableContentDensity || (TableContentDensity = {}));
 
-var version$1="1.52.1";var pkg = {version:version$1};
+var version$1="1.52.2-beta";var pkg = {version:version$1};
 
 const { version } = pkg;
 
@@ -7793,7 +7816,7 @@ const ERROR_MESSAGE = {
     SSR_ENVIRONMENT_ERROR: 'SSR environment detected. This function cannot be called in SSR environment.',
     UPDATE_PARAMS_FAILED: 'Failed to update embed parameters',
     INVALID_SPOTTER_DOCUMENTATION_URL: 'Invalid spotterDocumentationUrl. Please provide a valid http or https URL.',
-    UPDATEFILTERS_INVALID_PAYLOAD: 'UpdateFilters requires a valid filter or filters array. Expected: { filter: { column, oper, values } } or { filters: [{ column, oper, values }, ...] }',
+    UPDATEFILTERS_INVALID_PAYLOAD: 'UpdateFilters requires a valid filter or filters array. Expected: { filter: { columnName, operator, values } } or { filters: [{ columnName, operator, values }, ...] }',
     DRILLDOWN_INVALID_PAYLOAD: 'DrillDown requires a valid points object. Expected: { points: { clickedPoint?, selectedPoints? }, autoDrillDown?, vizId? }',
     UPDATEPARAMETERS_INVALID_PAYLOAD: 'UpdateParameters received an invalid applicability. Expected: { level: LIVEBOARD | TAB | GROUP, targetId } where targetId is required for TAB and GROUP levels',
 };
@@ -10756,7 +10779,7 @@ class AnswerService {
     async getTML() {
         const { object } = await this.executeQuery(getAnswerTML, {});
         const edoc = object[0].edoc;
-        const YAML = await import('./index-C1pmYb5H.js');
+        const YAML = await import('./index-CcBYlGo9.js');
         const parsedDoc = YAML.parse(edoc);
         return {
             answer: {
@@ -21665,7 +21688,8 @@ var isUndefined_1 = isUndefined;
 const isValidApplicability = (a) => {
     if (isUndefined_1(a))
         return true;
-    // targetId is not required at LIVEBOARD level, since the filter applies to the whole Liveboard
+    // targetId is not required at LIVEBOARD level, since the filter applies to
+    // the whole Liveboard
     return isPlainObject_1(a)
         && Object.values(ApplicabilityLevel).includes(a.level)
         && (a.level === ApplicabilityLevel.Liveboard || (isString_1(a.targetId) && a.targetId.trim().length > 0));
@@ -21684,8 +21708,52 @@ function isValidUpdateFiltersPayload(payload) {
     const hasValidFilters = Array.isArray(payload.filters) && payload.filters.length > 0 && payload.filters.every(isValidFilter);
     return !!(hasValidFilter || hasValidFilters);
 }
+/**
+ * Rewrites one filter's `columnName`/`operator` to `column`/`oper`.
+ *
+ * Callers may use either spelling: `columnName`/`operator` match
+ * {@link RuntimeFilter} and the `EmbedEvent.FilterChanged` payload, so a
+ * converted payload can be replayed as-is. But the payload is forwarded to the
+ * embedded app unchanged, and only `column`/`oper` are known to be understood
+ * there - so the alias must be swapped here, or it would pass validation and
+ * then be silently ignored.
+ *
+ * If a caller supplies both spellings of a field - which TypeScript rejects,
+ * but JavaScript callers can still do - the documented `columnName`/`operator`
+ * wins. Deferring to the deprecated spelling would quietly discard the value
+ * the rest of the SDK tells people to use.
+ * @param filter One entry from the UpdateFilters payload.
+ */
+function resolveFilterAliases(filter) {
+    var _a, _b;
+    if (!isPlainObject_1(filter))
+        return filter;
+    const column = (_a = filter.columnName) !== null && _a !== void 0 ? _a : filter.column;
+    const oper = (_b = filter.operator) !== null && _b !== void 0 ? _b : filter.oper;
+    const { columnName, operator, ...rest } = filter;
+    return {
+        ...rest,
+        ...(isUndefined_1(column) ? {} : { column }),
+        ...(isUndefined_1(oper) ? {} : { oper }),
+    };
+}
+/**
+ * Rewrites every filter in an UpdateFilters payload to use `column`/`oper`,
+ * whichever spelling the caller supplied. Call after validation.
+ * @param payload The UpdateFilters host event payload.
+ */
+function resolveUpdateFiltersAliases(payload) {
+    if (!isPlainObject_1(payload))
+        return payload;
+    return {
+        ...payload,
+        ...(payload.filter ? { filter: resolveFilterAliases(payload.filter) } : {}),
+        ...(Array.isArray(payload.filters) ? { filters: payload.filters.map(resolveFilterAliases) } : {}),
+    };
+}
 function isValidUpdateParametersPayload(payload) {
-    // Only validates the applicability of each parameter (null treated as absent); the rest is forwarded as-is for backward compatibility.
+    // Only validates the applicability of each parameter (null treated as
+    // absent); the rest is forwarded as-is for backward compatibility.
     if (!Array.isArray(payload))
         return true;
     return payload.every((p) => {
@@ -21733,7 +21801,8 @@ function throwUpdateParametersValidationError() {
 /**
  * Maps HostEvent to its corresponding UIPassthroughEvent.
  * Includes both custom-handler events (Pin, SaveAnswer, UpdateFilters, DrillDown)
- * and getter events (GetAnswerSession, GetFilters, etc.) that use getDataWithPassthroughFallback.
+ * and getter events (GetAnswerSession, GetFilters, etc.) that use
+ * getDataWithPassthroughFallback.
  */
 const PASSTHROUGH_MAP = {
     // Custom handlers (setters with special logic)
@@ -21884,17 +21953,21 @@ class HostEventClient {
             throwUpdateFiltersValidationError();
         }
         // The shared contract accepts both current (columnName/operator) and
-        // legacy (column/oper) filter field names — as does the validation
-        // above and the app at runtime. The UIPassthrough FilterUpdate type
-        // still requires the legacy names; bridge until that contract is
-        // audited.
-        return this.handleHostEventWithParam(UIPassthroughEvent.UpdateFilters, payload, context);
+        // legacy (column/oper) filter field names, but only the legacy pair is
+        // understood downstream, so the payload is rewritten before it is
+        // forwarded — otherwise a columnName/operator filter passes validation
+        // here and is then silently ignored by the app. The cast bridges the
+        // UIPassthrough FilterUpdate type, which still declares only the legacy
+        // names.
+        const resolvedPayload = resolveUpdateFiltersAliases(payload);
+        return this.handleHostEventWithParam(UIPassthroughEvent.UpdateFilters, resolvedPayload, context);
     }
     handleUpdateParametersEvent(payload, context) {
         if (!isValidUpdateParametersPayload(payload)) {
             throwUpdateParametersValidationError();
         }
-        // UpdateParameters has no UI passthrough contract; dispatch over the legacy channel
+        // UpdateParameters has no UI passthrough contract; dispatch over the
+        // legacy channel
         return this.hostEventFallback(HostEvent.UpdateParameters, payload, context);
     }
     handleDrillDownEvent(payload, context) {
@@ -21905,8 +21978,8 @@ class HostEventClient {
     }
     /**
      * Dispatches a host event using the appropriate channel:
-     * 1. If the embedded app supports UI passthrough for this event, use it (custom handler or getter).
-     * 2. Otherwise fall back to the legacy host event channel.
+     * 1. If the embedded app supports UI passthrough for this event, use it (custom
+     * handler or getter). 2. Otherwise fall back to the legacy host event channel.
      *
      * @param hostEvent - The host event to trigger
      * @param payload - Optional payload for the event
@@ -21915,7 +21988,8 @@ class HostEventClient {
     async triggerHostEvent(hostEvent, payload, context) {
         const customHandler = this.customHandlers[hostEvent];
         const passthroughEvent = PASSTHROUGH_MAP[hostEvent];
-        // If embedded app supports passthrough but not this event, use legacy channel
+        // If embedded app supports passthrough but not this event, use legacy
+        // channel
         const keys = passthroughEvent ? await this.getAvailableUIPassthroughKeys(context) : [];
         if (passthroughEvent && keys.length > 0 && !keys.includes(passthroughEvent)) {
             return this.hostEventFallback(hostEvent, payload, context);
@@ -22125,9 +22199,60 @@ const PRERENDER_WRAPPER_ID_PREFIX = 'tsEmbed-pre-render-wrapper-';
 // The container applies UpdateEmbedParams through React state, so a delivered
 // post is not the same as the params being in effect.
 const UPDATE_EMBED_PARAMS_SETTLE_MS = 200;
-// The container ignores runtimeFilterParams/runtimeParameterParams unless truthy, so
-// null or '' leaves the previous embed's values in place. '&' is truthy and parses to {}.
+// The container ignores runtimeFilterParams/runtimeParameterParams unless
+// truthy, so null or '' leaves the previous embed's values in place. '&' is
+// truthy and parses to {}.
 const NO_RUNTIME_PARAMS = '&';
+/**
+ * Query parameters that stay on the iframe `src` while config is excluded from
+ * the URL, which is the default unless the embed sets the
+ * `excludeConfigFromURL` additional flag to `false`. These are the parameters the
+ * application shell needs before it can receive a postMessage at all: the
+ * embed marker, the host application URL used to validate the message origin,
+ * the SDK version, the flags that pick the authentication flow, and the
+ * boot-time settings that would otherwise be applied a frame late (viewport,
+ * log level, locale, formatting and org). Everything else is delivered over
+ * `HostEvent.UpdateEmbedParams`.
+ * @internal
+ */
+const BOOTSTRAP_URL_PARAMS = new Set([
+    Param.EmbedApp,
+    Param.HostAppUrl,
+    Param.Version,
+    Param.AuthType,
+    Param.AutoLogin,
+    Param.DisableLoginRedirect,
+    Param.ForceSAMLAutoRedirect,
+    Param.cookieless,
+    Param.preAuthCache,
+    Param.blockNonEmbedFullAppAccess,
+    Param.OverrideOrgId,
+    Param.ViewPortHeight,
+    Param.ViewPortWidth,
+    Param.ClientLogLevel,
+    Param.OverrideNativeConsole,
+    Param.PendoTrackingKey,
+    Param.NumberFormatLocale,
+    Param.DateFormatLocale,
+    Param.CurrencyFormat,
+    Param.Locale,
+    Param.searchEmbed,
+    Param.livedBoardEmbed,
+    Param.isSpotterAgentEmbed,
+    Param.SpotterEnabled,
+    Param.IsFullAppEmbed,
+    Param.IsOnBeforeGetVizDataInterceptEnabled,
+    Param.LinkOverride,
+    Param.EnableLinkOverridesV2,
+    Param.DisableRedirectionLinksInNewTab,
+    Param.OverrideHistoryState,
+    Param.ForceTable,
+    Param.StringIDsUrl,
+    Param.DataSources,
+    Param.ExposeTranslationIDs,
+    Param.IconSpriteUrl,
+    Param.Tag,
+]);
 /**
  * The event id map from v2 event names to v1 event id
  * v1 events are the classic embed events implemented in Blink v1
@@ -22324,15 +22449,20 @@ class TsEmbed {
                 const AUTH_INIT_FALLBACK_DELAY = 1000;
                 // Wait for 1 second to ensure the embed container is loaded
                 // This is a workaround to ensure the embed container is loaded
-                // this is needed until all clusters have EmbedListenerReady event
+                // this is needed until all clusters have EmbedListenerReady
+                // event
                 setTimeout(processEmbedContainerReady, AUTH_INIT_FALLBACK_DELAY);
             }
             else if (source === EmbedEvent.EmbedListenerReady) {
                 processEmbedContainerReady();
+                if (this.isConfigExcludedFromUrl()) {
+                    this.triggerUpdateEmbedParams();
+                }
             }
         };
         // Subclasses that navigate the pre-render on show must await this before
-        // triggering Navigate. Resolves even on failure, so navigation is never blocked.
+        // triggering Navigate. Resolves even on failure, so navigation is never
+        // blocked.
         this.preRenderParamsApplied = Promise.resolve();
         this.hostElement = getDOMNode(domSelector);
         this.eventHandlerMap = new Map();
@@ -22662,8 +22792,9 @@ class TsEmbed {
             ...this.viewConfig,
             ...queryParams,
             ...appInitData,
-            // A show cycle has no URL to carry these, so the payload always states them
-            // — including "none", which is the case that leaks the previous filters.
+            // A show cycle has no URL to carry these, so the payload always
+            // states them — including "none", which is the case that leaks the
+            // previous filters.
             runtimeFilterParams: getFilterQuery((_a = this.viewConfig.runtimeFilters) !== null && _a !== void 0 ? _a : []) || NO_RUNTIME_PARAMS,
             runtimeParameterParams: getRuntimeParameters((_b = this.viewConfig.runtimeParameters) !== null && _b !== void 0 ? _b : [])
                 || NO_RUNTIME_PARAMS,
@@ -22831,13 +22962,20 @@ class TsEmbed {
         return path;
     }
     getEmbedParams() {
-        const queryParams = this.getEmbedParamsObject();
+        const queryParams = this.getUrlQueryParamsObject();
         return getQueryParamString(queryParams);
     }
     getEmbedParamsObject() {
         const params = this.getBaseQueryParams();
         return params;
     }
+    getUrlQueryParamsObject() {
+        const queryParams = this.getEmbedParamsObject();
+        if (!this.isConfigExcludedFromUrl()) {
+            return queryParams;
+        }
+        return Object.fromEntries(Object.entries(queryParams).filter(([key]) => BOOTSTRAP_URL_PARAMS.has(key)));
+    }
     getRootIframeSrc() {
         const query = this.getEmbedParams();
         return this.getEmbedBasePath(query);
@@ -23390,8 +23528,9 @@ class TsEmbed {
             return;
         this.preRenderWrapper[this.embedNodeKey] = this;
     }
-    // The flag lives on the wrapper because it describes the iframe: an instance
-    // hidden when the container announced itself would otherwise report false forever.
+    // The flag lives on the wrapper because it describes the iframe: an
+    // instance hidden when the container announced itself would otherwise
+    // report false forever.
     markEmbedContainerLoaded() {
         this.isEmbedContainerLoaded = true;
         if (this.preRenderWrapper) {
@@ -23744,6 +23883,27 @@ class TsEmbed {
         this.isRendered = true;
         return this.renderIFrame(prerenderFrameSrc);
     }
+    isConfigExcludedFromUrl() {
+        var _a, _b, _c;
+        const flag = (_b = (_a = this.viewConfig.additionalFlags) === null || _a === void 0 ? void 0 : _a.excludeConfigFromURL) !== null && _b !== void 0 ? _b : (_c = this.embedConfig.additionalFlags) === null || _c === void 0 ? void 0 : _c.excludeConfigFromURL;
+        // Enabled by default; only an explicit false opts out.
+        return flag !== false && flag !== 'false';
+    }
+    async triggerUpdateEmbedParams() {
+        try {
+            const params = await this.getUpdateEmbedParamsObject();
+            this.trigger(HostEvent.UpdateEmbedParams, params);
+        }
+        catch (error) {
+            logger$3.error(ERROR_MESSAGE.UPDATE_PARAMS_FAILED, error);
+            this.handleError({
+                errorType: ErrorDetailsTypes.API,
+                message: (error === null || error === void 0 ? void 0 : error.message) || ERROR_MESSAGE.UPDATE_PARAMS_FAILED,
+                code: EmbedErrorCodes.UPDATE_PARAMS_FAILED,
+                error: (error === null || error === void 0 ? void 0 : error.message) || error,
+            });
+        }
+    }
     beforePrerenderVisible() {
         // We can ignore this as its a bit expensive and the newer customers
         // have moved on to UpdateEmbedParams supported clusters
@@ -23754,17 +23914,7 @@ class TsEmbed {
         this.preRenderParamsApplied = new Promise((resolve) => {
             this.executeAfterEmbedContainerLoaded(async () => {
                 try {
-                    const params = await this.getUpdateEmbedParamsObject();
-                    this.trigger(HostEvent.UpdateEmbedParams, params);
-                }
-                catch (error) {
-                    logger$3.error(ERROR_MESSAGE.UPDATE_PARAMS_FAILED, error);
-                    this.handleError({
-                        errorType: ErrorDetailsTypes.API,
-                        message: (error === null || error === void 0 ? void 0 : error.message) || ERROR_MESSAGE.UPDATE_PARAMS_FAILED,
-                        code: EmbedErrorCodes.UPDATE_PARAMS_FAILED,
-                        error: (error === null || error === void 0 ? void 0 : error.message) || error,
-                    });
+                    await this.triggerUpdateEmbedParams();
                 }
                 finally {
                     setTimeout(resolve, UPDATE_EMBED_PARAMS_SETTLE_MS);
@@ -23799,8 +23949,9 @@ class TsEmbed {
         if (this.hostElement) {
             this.insertedDomEl = this.createPreRenderPlaceholder();
             if (this.viewConfig.fullHeight) {
-                // If fullHeight has already sized the wrapper, seed the placeholder
-                // with the same height so syncPreRenderStyle gets an accurate rect.
+                // If fullHeight has already sized the wrapper, seed the
+                // placeholder with the same height so syncPreRenderStyle gets
+                // an accurate rect.
                 const existingHeight = this.preRenderWrapper.style.height;
                 if (existingHeight) {
                     this.insertedDomEl.style.height = existingHeight;
@@ -23808,12 +23959,13 @@ class TsEmbed {
             }
             const placeHolderId = this.getPreRenderIds().placeHolder;
             // Remove any stale placeholder from a previous cycle. It is located
-            // via a subtree-wide querySelector, so it may be nested deeper than a
-            // direct child (E.g.: with fullHeight the host app can wrap it). Use
-            // Element.remove() — which detaches from whatever the real parent is —
-            // rather than hostElement.removeChild(), which throws NotFoundError
-            // when the match is not a direct child. Mirrors the wrapper/child
-            // cleanup in createPreRenderWrapper()/createPreRenderChild().
+            // via a subtree-wide querySelector, so it may be nested deeper
+            // than a direct child (E.g.: with fullHeight the host app can wrap
+            // it). Use Element.remove() — which detaches from whatever the real
+            // parent is — rather than hostElement.removeChild(), which throws
+            // NotFoundError when the match is not a direct child. Mirrors the
+            // wrapper/child cleanup in
+            // createPreRenderWrapper()/createPreRenderChild().
             (_a = this.hostElement.querySelector(`#${placeHolderId}`)) === null || _a === void 0 ? void 0 : _a.remove();
             this.hostElement.appendChild(this.insertedDomEl);
             this.syncPreRenderStyle();
@@ -23845,7 +23997,8 @@ class TsEmbed {
         if (this.iFrame) {
             this.setupFullscreenChangeHandler();
         }
-        // Last, so everything above still sees the instance being taken over from.
+        // Last, so everything above still sees the instance being taken over
+        // from.
         this.takeOverPreRender();
         return this;
     }
@@ -24132,6 +24285,18 @@ function buildStarterPromptsAppInitData(initData, viewConfig) {
             starterPrompts,
         },
     };
+}
+function buildSpotterAnalystAppInitData(initData, viewConfig) {
+    const { spotterAnalystConfig } = viewConfig;
+    if (!(spotterAnalystConfig === null || spotterAnalystConfig === void 0 ? void 0 : spotterAnalystConfig.analystId))
+        return initData;
+    return {
+        ...initData,
+        embedParams: {
+            ...(initData.embedParams || {}),
+            spotterAnalystConfig,
+        },
+    };
 }
 
 function buildSpotterVizAppInitData(initData, viewConfig) {
@@ -24329,7 +24494,7 @@ class AppEmbed extends V1Embed {
      * embedded Liveboard or visualization.
      */
     getEmbedParams() {
-        const params = this.getEmbedParamsObject();
+        const params = this.getUrlQueryParamsObject();
         return getQueryParamString(params, true);
     }
     getEmbedParamsObject() {
@@ -24725,8 +24890,9 @@ const addPreviewStylesIfNotPresent = () => {
  * @summary Liveboard & visualization embed
  * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
  */
-// Home unmounts the liveboard container, which is how its state gets cleared. The
-// settle window gives the container time to do it before we ask for the liveboard back.
+// Home unmounts the liveboard container, which is how its state gets cleared.
+// The settle window gives the container time to do it before we ask for the
+// liveboard back.
 const HOME_ROUTE = 'home';
 const HOME_SETTLE_MS = 200;
 /**
@@ -24786,7 +24952,7 @@ class LiveboardEmbed extends V1Embed {
      * embedded Liveboard or visualization.
      */
     getEmbedParams() {
-        const params = this.getEmbedParamsObject();
+        const params = this.getUrlQueryParamsObject();
         const queryParams = getQueryParamString(params, true);
         return queryParams;
     }
@@ -25024,21 +25190,24 @@ class LiveboardEmbed extends V1Embed {
     }
     beforePrerenderVisible() {
         super.beforePrerenderVisible();
-        // Captured before showPreRender() hands the wrapper over to this instance.
-        // Itself means a hide/show, not a hand-over, so there is nothing stale to clear.
+        // Captured before showPreRender() hands the wrapper over to this
+        // instance. Itself means a hide/show, not a hand-over, so there is
+        // nothing stale to clear.
         const previous = this.getPreRenderObj();
         const showing = previous === this ? undefined : previous === null || previous === void 0 ? void 0 : previous.currentLiveboardState;
         this.executeAfterEmbedContainerLoaded(async () => {
-            // Without this the params callback suspends on its await and Navigate
-            // goes out first, so the container loads with the previous config's filters.
+            // Without this the params callback suspends on its await and
+            // Navigate goes out first, so the container loads with the previous
+            // config's filters.
             await this.preRenderParamsApplied;
             if (this.isShowingLiveboardRoute(showing)) {
-                // Navigate to the route we are already on is a no-op, so the liveboard
-                // keeps its state. Home unmounts the container, which clears it.
+                // Navigate to the route we are already on is a no-op, so the
+                // liveboard keeps its state. Home unmounts the container, which
+                // clears it.
                 this.trigger(HostEvent.Navigate, HOME_ROUTE)
                     .catch((error) => logger$3.warn('Could not route via home', error));
-                // Not awaited above: the container never acks Navigate, so that promise
-                // only settles on the 30s trigger timeout.
+                // Not awaited above: the container never acks Navigate, so
+                // that promise only settles on the 30s trigger timeout.
                 await new Promise((resolve) => {
                     setTimeout(resolve, HOME_SETTLE_MS);
                 });
@@ -25052,8 +25221,9 @@ class LiveboardEmbed extends V1Embed {
             };
         });
     }
-    // The whole route, not just the liveboard id: the path is built from the viz, tab
-    // and view too, so a same-liveboard show onto another tab is a real navigation.
+    // The whole route, not just the liveboard id: the path is built from the
+    // viz, tab and view too, so a same-liveboard show onto another tab is a
+    // real navigation.
     isShowingLiveboardRoute(showing) {
         if (!(showing === null || showing === void 0 ? void 0 : showing.liveboardId))
             return false;
@@ -25313,7 +25483,7 @@ class SearchEmbed extends TsEmbed {
     }
     getEmbedParams() {
         const { runtimeParameters, runtimeFilters, excludeRuntimeParametersfromURL, excludeRuntimeFiltersfromURL, } = this.viewConfig;
-        const queryParams = this.getEmbedParamsObject();
+        const queryParams = this.getUrlQueryParamsObject();
         let query = '';
         const queryParamsString = getQueryParamString(queryParams, true);
         if (queryParamsString) {
@@ -25401,7 +25571,7 @@ class SearchBarEmbed extends TsEmbed {
      * @param dataSources A list of data source GUIDs
      */
     getIFrameSrc() {
-        const queryParams = this.getEmbedParamsObject();
+        const queryParams = this.getUrlQueryParamsObject();
         const path = 'search-bar-embed';
         let query = '';
         const queryParamsString = getQueryParamString(queryParams, true);
@@ -25835,7 +26005,7 @@ class ConversationMessage extends TsEmbed {
     getIframeSrc() {
         const { sessionId, genNo, acSessionId, acGenNo, convId, messageId, } = this.viewConfig;
         const path = 'conv-assist-answer';
-        const queryParams = this.getEmbedParamsObject();
+        const queryParams = this.getUrlQueryParamsObject();
         let query = '';
         const queryParamsString = getQueryParamString(queryParams, true);
         if (queryParamsString) {
@@ -26003,10 +26173,11 @@ class SpotterEmbed extends TsEmbed {
         const defaultAppInitData = await super.getAppInitData();
         const sidebarInitData = buildSpotterSidebarAppInitData(defaultAppInitData, this.viewConfig, this.handleError.bind(this));
         const shareInitData = buildSpotterShareConversationAppInitData(sidebarInitData, this.viewConfig);
-        return buildStarterPromptsAppInitData(shareInitData, this.viewConfig);
+        const starterPromptsInitData = buildStarterPromptsAppInitData(shareInitData, this.viewConfig);
+        return buildSpotterAnalystAppInitData(starterPromptsInitData, this.viewConfig);
     }
     getEmbedParamsObject() {
-        const { searchOptions, disableSourceSelection, hideSourceSelection, dataPanelV2, updatedSpotterExperience, showSpotterLimitations, hideSampleQuestions, runtimeFilters, excludeRuntimeFiltersfromURL, runtimeParameters, excludeRuntimeParametersfromURL, updatedSpotterChatPrompt, showSpotterRadiance, defaultQueryMode, enableStopAnswerGenerationEmbed, spotterChatConfig, spotterAnalystConfig, } = this.viewConfig;
+        const { searchOptions, disableSourceSelection, hideSourceSelection, dataPanelV2, updatedSpotterExperience, showSpotterLimitations, hideSampleQuestions, runtimeFilters, excludeRuntimeFiltersfromURL, runtimeParameters, excludeRuntimeParametersfromURL, updatedSpotterChatPrompt, showSpotterRadiance, defaultQueryMode, enableStopAnswerGenerationEmbed, spotterChatConfig, } = this.viewConfig;
         const queryParams = this.getBaseQueryParams();
         queryParams[Param.SpotterEnabled] = true;
         // Boolean params
@@ -26019,7 +26190,6 @@ class SpotterEmbed extends TsEmbed {
         setParamIfDefined(queryParams, Param.ShowSpotterRadiance, showSpotterRadiance, true);
         setParamIfDefined(queryParams, Param.DefaultQueryMode, defaultQueryMode);
         setParamIfDefined(queryParams, Param.EnableStopAnswerGenerationEmbed, enableStopAnswerGenerationEmbed, true);
-        setParamIfDefined(queryParams, Param.AnalystId, spotterAnalystConfig === null || spotterAnalystConfig === void 0 ? void 0 : spotterAnalystConfig.analystId);
         // Handle spotterChatConfig params
         if (spotterChatConfig) {
             const { hideToolResponseCardBranding, toolResponseCardBrandingLabel, spotterFileUploadEnabled, spotterFileUploadFileTypes, enableStarterPrompts, } = spotterChatConfig;
@@ -26043,7 +26213,7 @@ class SpotterEmbed extends TsEmbed {
         const path = sharedConversationId
             ? `insights/conv-assist/s/${encodeURIComponent(sharedConversationId)}`
             : 'insights/conv-assist';
-        const queryParams = this.getEmbedParamsObject();
+        const queryParams = this.getUrlQueryParamsObject();
         let query = '';
         const queryParamsString = getQueryParamString(queryParams, true);
         if (queryParamsString) {
@@ -26626,6 +26796,213 @@ const createLiveboardWithAnswers = async (answers, name) => {
     return result;
 };
 
+/**
+ * Copyright (c) 2026
+ *
+ * Utility to convert the payload emitted by `EmbedEvent.FilterChanged`
+ * into the payload shape expected by `HostEvent.UpdateFilters`, so that
+ * the current filter state of a Liveboard can be captured and re-applied
+ * later without having to hand-parse the event payload.
+ * @summary Filter payload converter
+ */
+/**
+ * Coerces an epoch/count field to a number, returning `null` when the value is
+ * absent or not a finite number. The payload arrives as JSON from the iframe,
+ * so a missing field can be `null` as well as `undefined`, and `Number(null)`
+ * or `Number('')` would otherwise silently become a valid-looking `0`
+ * (i.e. the Unix epoch, or a zero-length period).
+ * @param value Raw value from the date filter payload.
+ */
+function toFiniteNumber(value) {
+    if (isNil_1(value) || value === '')
+        return null;
+    const numericValue = Number(value);
+    return Number.isFinite(numericValue) ? numericValue : null;
+}
+const DATE_FILTER_VALUE_EXTRACTORS = {
+    EXACT_DATE: (dateFilter) => {
+        const epoch = toFiniteNumber(dateFilter.epoch);
+        return epoch === null ? [] : [epoch];
+    },
+    EXACT_DATE_RANGE: (dateFilter) => {
+        var _a;
+        const { lowEpoch, highEpoch } = (_a = dateFilter.dateRange) !== null && _a !== void 0 ? _a : {};
+        const low = toFiniteNumber(lowEpoch);
+        const high = toFiniteNumber(highEpoch);
+        return low === null || high === null ? [] : [low, high];
+    },
+    MONTH_YEAR: (dateFilter) => (dateFilter.monthName && dateFilter.yearName
+        ? [dateFilter.monthName, dateFilter.yearName]
+        : []),
+    QUARTER_YEAR: (dateFilter) => (dateFilter.quarterName && dateFilter.yearName
+        ? [dateFilter.quarterName, dateFilter.yearName]
+        : []),
+    YEAR_ONLY: (dateFilter) => (dateFilter.yearName ? [dateFilter.yearName] : []),
+    LAST_N_PERIOD: (dateFilter) => {
+        const count = toFiniteNumber(dateFilter.number);
+        return count === null ? [] : [count];
+    },
+    NEXT_N_PERIOD: (dateFilter) => {
+        const count = toFiniteNumber(dateFilter.number);
+        return count === null ? [] : [count];
+    },
+};
+// Date filter types with no `values` (e.g. TODAY needs no operand).
+const PERIOD_ONLY_DATE_FILTER_TYPES = new Set([
+    'THIS_PERIOD', 'PERIOD_TO_DATE', 'TODAY', 'YESTERDAY', 'TOMORROW',
+]);
+function convertDateFilterToParam(columnName, dateFilterContent) {
+    var _a;
+    const dateFilter = dateFilterContent === null || dateFilterContent === void 0 ? void 0 : dateFilterContent.dateFilter;
+    if (!(dateFilter === null || dateFilter === void 0 ? void 0 : dateFilter.type))
+        return null;
+    let values;
+    const getValues = DATE_FILTER_VALUE_EXTRACTORS[dateFilter.type];
+    if (getValues) {
+        values = getValues(dateFilter);
+        // Required fields (e.g. epoch, yearName) are missing - the source data
+        // can't be reconstructed faithfully, so skip rather than emit a filter
+        // that would clear/corrupt this column when re-applied.
+        if (values.length === 0)
+            return null;
+    }
+    else if (PERIOD_ONLY_DATE_FILTER_TYPES.has(dateFilter.type)) {
+        values = [];
+    }
+    else {
+        // Unrecognized date filter type - skip rather than guess.
+        return null;
+    }
+    const param = {
+        columnName,
+        operator: (_a = dateFilter.op) !== null && _a !== void 0 ? _a : RuntimeFilterOp.EQ,
+        values,
+        type: dateFilter.type,
+    };
+    if (dateFilter.datePeriod) {
+        param.datePeriod = dateFilter.datePeriod;
+    }
+    if (!isNil_1(dateFilter.includeCurrentPeriod)) {
+        param.includeCurrentPeriod = dateFilter.includeCurrentPeriod;
+    }
+    if (dateFilterContent.negate) {
+        param.negate = true;
+    }
+    return param;
+}
+function convertFilterContentToParam(columnName, filterContent) {
+    var _a;
+    if (!(filterContent === null || filterContent === void 0 ? void 0 : filterContent.filterType))
+        return null;
+    const values = ((_a = filterContent.value) !== null && _a !== void 0 ? _a : [])
+        .map((value) => value === null || value === void 0 ? void 0 : value.key)
+        .filter((value) => !isNil_1(value));
+    const param = {
+        columnName,
+        operator: filterContent.filterType,
+        values,
+    };
+    if (filterContent.negate) {
+        param.negate = true;
+    }
+    return param;
+}
+function convertFilterToParams(columnName, filter) {
+    var _a, _b;
+    const dateParams = ((_a = filter === null || filter === void 0 ? void 0 : filter.dateFilterContent) !== null && _a !== void 0 ? _a : [])
+        .map((dateFilterContent) => convertDateFilterToParam(columnName, dateFilterContent));
+    const contentParams = ((_b = filter === null || filter === void 0 ? void 0 : filter.filterContent) !== null && _b !== void 0 ? _b : [])
+        .map((filterContent) => convertFilterContentToParam(columnName, filterContent));
+    return [...dateParams, ...contentParams]
+        .filter((param) => param !== null);
+}
+/**
+ * Runtime filters need no reshaping, but they still come off the wire as JSON,
+ * so a malformed entry is possible. Skip it rather than pass it through: an
+ * entry missing a column, operator or values array fails
+ * `isValidUpdateFiltersPayload`, and that rejects the *whole* `filters` array,
+ * so one bad runtime filter would drop every other converted filter with it.
+ * @param runtimeFilter A runtime filter from the `FilterChanged` payload.
+ */
+function convertRuntimeFilterToParam(runtimeFilter) {
+    const { columnName, operator, values } = runtimeFilter !== null && runtimeFilter !== void 0 ? runtimeFilter : {};
+    if (typeof columnName !== 'string' || !columnName)
+        return null;
+    if (typeof operator !== 'string' || !operator)
+        return null;
+    if (!Array.isArray(values))
+        return null;
+    return { columnName, operator, values };
+}
+/**
+ * Mirrors `isValidApplicability` in `hostEventClient/utils`: a `TAB` or `GROUP`
+ * scope is meaningless without a `targetId`, and `UpdateFilters` rejects the
+ * whole `filters` array when any entry carries a malformed `applicability`.
+ * @param applicability Scope taken from the `FilterChanged` payload.
+ */
+function isUsableApplicability(applicability) {
+    const levels = Object.values(ApplicabilityLevel);
+    if (!levels.includes(applicability.level))
+        return false;
+    if (applicability.level === ApplicabilityLevel.Liveboard)
+        return true;
+    return typeof applicability.targetId === 'string' && applicability.targetId.trim().length > 0;
+}
+function convertFilterGroupToParams(filterGroup) {
+    var _a, _b;
+    const columnName = (_a = filterGroup === null || filterGroup === void 0 ? void 0 : filterGroup.columnInfo) === null || _a === void 0 ? void 0 : _a.name;
+    if (!columnName)
+        return [];
+    const { applicability } = filterGroup;
+    // A filter scoped to a tab or group has to keep that scope. Replaying it
+    // without `applicability` would silently widen it to the whole Liveboard,
+    // changing what every other tab shows. If a scope is present but unusable,
+    // skip the filter: widening is worse than dropping, and a malformed
+    // applicability would fail validation for every other filter alongside it.
+    if (!isNil_1(applicability) && !isUsableApplicability(applicability))
+        return [];
+    const params = ((_b = filterGroup.filters) !== null && _b !== void 0 ? _b : [])
+        .flatMap((filter) => convertFilterToParams(columnName, filter));
+    return isNil_1(applicability) ? params : params.map((param) => ({ ...param, applicability }));
+}
+/**
+ * Converts the payload emitted by {@link EmbedEvent.FilterChanged} into the
+ * payload shape expected by {@link HostEvent.UpdateFilters}, so the same
+ * filter state can be captured and re-applied later, for example on a
+ * subsequent page load.
+ *
+ * Both the Liveboard filters and the runtime filters present in the
+ * `FilterChanged` payload are included in the returned `filters` array.
+ *
+ * Note: a column with multiple date-filter conditions (e.g. an OR of two
+ * date ranges) is not guaranteed to round-trip losslessly - `HostEvent.UpdateFilters`
+ * treats date filters as replace-not-merge per column, so only the last
+ * converted entry for such a column will apply.
+ * @param filterChangedPayload The filter state carried by the
+ * `EmbedEvent.FilterChanged` callback, which is `payload.data` - the
+ * callback argument is the event envelope, and the filters sit under its
+ * `data` key.
+ * @example
+ * ```js
+ * let savedFilters;
+ * liveboardEmbed.on(EmbedEvent.FilterChanged, (payload) => {
+ *     savedFilters = convertFilterChangedToUpdateFiltersPayload(payload.data);
+ * });
+ *
+ * // later, e.g. after a fresh page load
+ * liveboardEmbed.trigger(HostEvent.UpdateFilters, savedFilters);
+ * ```
+ */
+function convertFilterChangedToUpdateFiltersPayload(filterChangedPayload) {
+    var _a, _b;
+    const liveboardFilterParams = ((_a = filterChangedPayload === null || filterChangedPayload === void 0 ? void 0 : filterChangedPayload.liveboardFilters) !== null && _a !== void 0 ? _a : [])
+        .flatMap(convertFilterGroupToParams);
+    const runtimeFilterParams = ((_b = filterChangedPayload === null || filterChangedPayload === void 0 ? void 0 : filterChangedPayload.runtimeFilters) !== null && _b !== void 0 ? _b : [])
+        .map(convertRuntimeFilterToParam)
+        .filter((param) => param !== null);
+    return { filters: [...liveboardFilterParams, ...runtimeFilterParams] };
+}
+
 /**
  * Starts an automatic renderer that watches the DOM for iframes containing
  * the `tsmcp=true` query parameter and replaces them with fully configured
@@ -26724,7 +27101,7 @@ class AutoFrameRenderer extends TsEmbed {
      * @returns The constructed URL to use for the ThoughtSpot embed iframe.
      */
     getMCPIframeSrc(sourceSrc) {
-        const queryParams = this.getEmbedParamsObject();
+        const queryParams = this.getUrlQueryParamsObject();
         const sourceURL = new URL(sourceSrc);
         const existingQueryParams = sourceURL.searchParams;
         const existingQueryParamsObject = Object.fromEntries(existingQueryParams);
@@ -26769,4 +27146,4 @@ class AutoFrameRenderer extends TsEmbed {
     }
 }
 
-export { Action, AnswerService, AppEmbed, ApplicabilityLevel, AuthEvent, AuthFailureType, AuthStatus, AuthType, BackgroundFormatType, BodylessConversation, ConditionalFormattingComparisonType, ConditionalFormattingOperator, ContextMenuTriggerOptions, ContextType, ConversationEmbed, CustomActionTarget, CustomActionsPosition, DataLabelFilterOperator, DataPanelCustomColumnGroupsAccordionState$1 as DataPanelCustomColumnGroupsAccordionState, DataSourceVisualMode, EmbedErrorCodes, EmbedErrorSeverity, EmbedEvent, ErrorDetailsTypes, HomeLeftNavItem, HomePage, HomePageSearchBarMode, HomepageModule, HostEvent, InterceptedApiType, LegendPosition, ListPage, ListPageColumns, LiveboardEmbed, LogLevel, MIXPANEL_EVENT, Page, PinboardEmbed, PrefetchFeatures, PrimaryNavbarVersion, RuntimeFilterOp, SearchBarEmbed, SearchEmbed, SpotterAgentEmbed, SpotterEmbed, SpotterQueryMode, TableContentDensity, TableTheme, UIPassthroughEvent, createLiveboardWithAnswers, executeTML, exportTML, getAnswerFromQuery, getEmbedConfig as getInitConfig, getSessionInfo, init, logout, prefetch, reloadIframe, resetCachedAuthToken, startAutoMCPFrameRenderer, tokenizedFetch, uploadMixpanelEvent };
+export { Action, AnswerService, AppEmbed, ApplicabilityLevel, AuthEvent, AuthFailureType, AuthStatus, AuthType, BackgroundFormatType, BodylessConversation, ConditionalFormattingComparisonType, ConditionalFormattingOperator, ContextMenuTriggerOptions, ContextType, ConversationEmbed, CustomActionTarget, CustomActionsPosition, DataLabelFilterOperator, DataPanelCustomColumnGroupsAccordionState$1 as DataPanelCustomColumnGroupsAccordionState, DataSourceVisualMode, EmbedErrorCodes, EmbedErrorSeverity, EmbedEvent, ErrorDetailsTypes, HomeLeftNavItem, HomePage, HomePageSearchBarMode, HomepageModule, HostEvent, InterceptedApiType, LegendPosition, ListPage, ListPageColumns, LiveboardEmbed, LogLevel, MIXPANEL_EVENT, Page, PinboardEmbed, PrefetchFeatures, PrimaryNavbarVersion, RuntimeFilterOp, SearchBarEmbed, SearchEmbed, SpotterAgentEmbed, SpotterEmbed, SpotterQueryMode, TableContentDensity, TableTheme, UIPassthroughEvent, convertFilterChangedToUpdateFiltersPayload, createLiveboardWithAnswers, executeTML, exportTML, getAnswerFromQuery, getEmbedConfig as getInitConfig, getSessionInfo, init, logout, prefetch, reloadIframe, resetCachedAuthToken, startAutoMCPFrameRenderer, tokenizedFetch, uploadMixpanelEvent };