@thoughtspot/visual-embed-sdk 1.49.3 → 1.50.1

package/lib/src/visual-embed-sdk.d.ts

@@ -412,6 +412,14 @@ export interface CustomCssVariables {
 	 * Background color of the tiles in the Liveboard.
 	 */
 	"--ts-var-liveboard-tile-background"?: string;
+	/**
+	 * Font color of the insight tiles in the Liveboard.
+	 */
+	"--ts-var-liveboard-insight-tile-font-color"?: string;
+	/**
+	 * Background color of the insight tiles in the Liveboard.
+	 */
+	"--ts-var-liveboard-insight-tile-background"?: string;
 	/**
 	 * Border radius of the tiles in the Liveboard.
 	 */
@@ -960,6 +968,10 @@ export interface CustomCssVariables {
 	 * header underline, left panel border, thinking step connector and dots.
 	 */
 	"--ts-var-spotterviz-border-color"?: string;
+	/**
+	 * Expanded user chat message bubble border color in SpotterViz.
+	 */
+	"--ts-var-spotterviz-expanded-border-color"?: string;
 	/**
 	 * Background color of the reference-mode toggle button in the SpotterViz
 	 * chat input when it is unselected and the user hovers over it.
@@ -977,6 +989,53 @@ export interface CustomCssVariables {
 	 * on each referenced-entity chip in the chat input.
 	 */
 	"--ts-var-spotterviz-reference-icon-selected-background"?: string;
+	/**
+	 * Background color of the shared conversation header (recipient's read-only view).
+	 */
+	"--ts-var-shared-conv-header-background"?: string;
+	/**
+	 * Border color of the shared conversation header.
+	 */
+	"--ts-var-shared-conv-header-border-color"?: string;
+	/**
+	 * Font color of the title text in the shared conversation header.
+	 */
+	"--ts-var-shared-conv-title-color"?: string;
+	/**
+	 * Background gradient color-stop of the share chat header's outer container
+	 * (sender's pre-share header). Defaults to transparent.
+	 */
+	"--ts-var-share-chat-header-container-background"?: string;
+	/**
+	 * Background color of the share chat header's inner title/actions row.
+	 * Defaults to transparent.
+	 */
+	"--ts-var-share-chat-header-background"?: string;
+	/**
+	 * Font color of the title text in the share chat header.
+	 */
+	"--ts-var-share-chat-header-title-color"?: string;
+	/**
+	 * Font color of the title input field in the share chat header.
+	 */
+	"--ts-var-share-chat-header-input-text-color"?: string;
+	/**
+	 * Background color of the title input field in the share chat header.
+	 */
+	"--ts-var-share-chat-header-input-background"?: string;
+	/**
+	 * Border color of the title input field in the share chat header.
+	 */
+	"--ts-var-share-chat-header-input-border-color"?: string;
+	/**
+	 * Background color of the shimmer loading effect. Also affects the
+	 * saved chats sidebar's new-chat shimmer, which shares the same style.
+	 */
+	"--ts-var-shimmer-background"?: string;
+	/**
+	 * Background color of the shimmer sweep animation's gradient mid-stop.
+	 */
+	"--ts-var-shimmer-sweep-background"?: string;
 }
 export interface SessionInterface {
 	sessionId: string;
@@ -1406,7 +1465,14 @@ export enum HomeLeftNavItem {
 	 * Available in the V3 navigation experience.
 	 * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
 	 */
-	Favorites = "favorites"
+	Favorites = "favorites",
+	/**
+	 * The *Collections* menu option in
+	 * the *Insights* left navigation panel.
+	 * Shown when collections are enabled on the cluster.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	Collections = "collections"
 }
 export type DOMSelector = string | HTMLElement;
 /**
@@ -2096,7 +2162,8 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * The list of actions to completely remove from the embedded view.
 	 * Hidden actions are not visible to the user at all (fully removed from the UI).
 	 * Use this when you want to remove an action entirely.
-	 * To keep an action visible but non-interactive (grayed out), use {@link disabledActions} instead.
+	 * To keep an action visible but non-interactive (grayed out), use {@link
+	 * disabledActions} instead.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
@@ -2116,7 +2183,8 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * (...), and the contextual menu. These will be only actions that
 	 * are visible to the user.
 	 * Use this as an allowlist — only the actions listed here will be shown.
-	 * All other actions will be hidden. Use either this or {@link hiddenActions}, not both.
+	 * All other actions will be hidden. Use either this or {@link hiddenActions}, not
+	 * both.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
@@ -2351,6 +2419,26 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * ```
 	 */
 	overrideOrgId?: number;
+	/**
+	 * Overrides the browser history behavior for embedding application users.
+	 * This parameter changes standard history navigation (pushState) into a
+	 * state replacement (replaceState), preventing users from getting trapped in
+	 * back-button loops inside the embedded iframe environment.
+	 * The overrideHistoryState setting is honored only if the
+	 * application is running within an embedded context.
+	 *
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#tsEmbed', {
+	 *     // ... other embed view config
+	 *     overrideHistoryState: true,
+	 * });
+	 * ```
+	 */
+	overrideHistoryState?: boolean;
 	/**
 	 * Flag to override the *Open Link in New Tab* context
 	 * menu option.
@@ -4811,6 +4899,30 @@ export enum EmbedEvent {
 	 * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
 	 */
 	SpotterConversationSelected = "spotterConversationSelected",
+	/**
+	 * Emitted when the Spotter agent finishes streaming/rendering a response.
+	 * Includes the conversation and message identifiers so the host app can
+	 * fetch the full conversation history via the REST API if needed.
+	 *
+	 * The payload data has the shape `{ convId: string, messageId: string }`.
+	 *
+	 * Works with SpotterEmbed as well as AppEmbed (when Spotter is reached
+	 * inside the full application).
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterResponseComplete, (payload) => {
+	 *     console.log('Spotter response complete', payload);
+	 * })
+	 * ```
+	 * @example
+	 * ```js
+	 * appEmbed.on(EmbedEvent.SpotterResponseComplete, (payload) => {
+	 *     console.log('Spotter response complete', payload);
+	 * })
+	 * ```
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterResponseComplete = "spotterResponseComplete",
 	/**
 	 * @hidden
 	 * Emitted when the auth token is about to get expired and needs to be refreshed.
@@ -4835,10 +4947,11 @@ export enum EmbedEvent {
 	 */
 	EmbedPageContextChanged = "EmbedPageContextChanged",
 	/**
-	 * Represents a special embed event that is triggered whenever any host event is subscribed.
+	 * Represents a special embed event that is triggered whenever any host event is
+	 * subscribed.
 	 *
-	 * You can listen to this event when you need to dispatch a host event during load or render,
-	 * particularly in situations where timing issues may occur.
+	 * You can listen to this event when you need to dispatch a host event during load or
+	 * render, particularly in situations where timing issues may occur.
 	 *
 	 * @example
 	 * ```js
@@ -6373,6 +6486,14 @@ export enum HostEvent {
 	/**
 	 * Get details of filters applied on the Liveboard.
 	 * Returns arrays containing Liveboard filter and runtime filter elements.
+	 * Each Liveboard filter may include an `applicability` attribute
+	 * indicating the scope of the filter. It contains a `level`
+	 * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
+	 * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
+	 * level there is no `targetId`, since the filter applies to the
+	 * whole Liveboard.
+	 * The `applicability` attribute is available from SDK: 1.51.0 |
+	 * ThoughtSpot: 26.10.0.cl.
 	 * @example
 	 * ```js
 	 * const data = await liveboardEmbed.trigger(HostEvent.GetFilters);
@@ -6412,6 +6533,16 @@ export enum HostEvent {
 	 *
 	 * `type`  - To update filters for date time, specify the date format type.
 	 * For more information and examples, see link:https://developers.thoughtspot.com/docs/embed-liveboard#_date_filters[Date filters].
+	 *
+	 * `applicability` - Optional. Scopes the filter to a specific target,
+	 * for example, a single Liveboard tab. Available from SDK: 1.51.0 |
+	 * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
+	 *
+	 *  - `level`: The scope of the filter: `LIVEBOARD`, `TAB`, or `GROUP`.
+	 *  - `targetId`: The GUID of the target, for example, the tab GUID.
+	 *    Required when `level` is `TAB` or `GROUP`. Do not pass it when
+	 *    `level` is `LIVEBOARD`, since the filter applies to the whole
+	 *    Liveboard.
 	 * @example
 	 * ```js
 	 *
@@ -6488,6 +6619,21 @@ export enum HostEvent {
 	 *     }
 	 * }, ContextType.Liveboard);
 	 * ```
+	 * @example
+	 * ```js
+	 * // Scope the filter to a specific Liveboard tab
+	 * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
+	 *     filter: {
+	 *         column: "item type",
+	 *         oper: "IN",
+	 *         values: ["bags", "shirts"],
+	 *         applicability: {
+	 *             level: "TAB",
+	 *             targetId: "e0836cad-4fdf-42d4-bd97-567a6b2a6058"
+	 *         }
+	 *     }
+	 * });
+	 * ```
 	 * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
 	 */
 	UpdateFilters = "updateFilters",
@@ -6639,6 +6785,15 @@ export enum HostEvent {
 	 * - `name`: Name of the parameter.
 	 * - `value`: The value to set for the parameter.
 	 * - `isVisibleToUser`: Optional. To control the visibility of the parameter chip.
+	 * - `applicability`: Optional. Scopes the parameter to a specific target,
+	 * for example, a single Liveboard tab. Available from SDK: 1.51.0 |
+	 * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
+	 *
+	 *    - `level`: The scope of the parameter: `LIVEBOARD`, `TAB`, or `GROUP`.
+	 *    - `targetId`: The GUID of the target, for example, the tab GUID.
+	 *      Required when `level` is `TAB` or `GROUP`. Do not pass it when
+	 *      `level` is `LIVEBOARD`, since the parameter applies to the whole
+	 *      Liveboard.
 	 *
 	 * @example
 	 * ```js
@@ -6650,6 +6805,18 @@ export enum HostEvent {
 	 * ```
 	 * @example
 	 * ```js
+	 * // Scope the parameter to a specific Liveboard tab
+	 * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
+	 *   name: "Integer Range Param",
+	 *   value: 10,
+	 *   applicability: {
+	 *     level: "TAB",
+	 *     targetId: "e0836cad-4fdf-42d4-bd97-567a6b2a6058"
+	 *   }
+	 * }])
+	 * ```
+	 * @example
+	 * ```js
 	 * // Update parameters from liveboard context
 	 * import { ContextType } from '@thoughtspot/visual-embed-sdk';
 	 * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
@@ -6663,6 +6830,14 @@ export enum HostEvent {
 	UpdateParameters = "UpdateParameters",
 	/**
 	 * Triggers GetParameters to fetch the runtime Parameters.
+	 * Each parameter may include an `applicability` attribute
+	 * indicating the scope of the parameter. It contains a `level`
+	 * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
+	 * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
+	 * level there is no `targetId`, since the parameter applies to the
+	 * whole Liveboard.
+	 * The `applicability` attribute is available from SDK: 1.51.0 |
+	 * ThoughtSpot: 26.10.0.cl.
 	 * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.GetParameters).then((parameter) => {
@@ -7076,6 +7251,24 @@ export enum HostEvent {
 	 * ```
 	 */
 	InitSpotterVizConversation = "InitSpotterVizConversation",
+	/**
+	 * Opens the SpotterViz panel.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.trigger(HostEvent.OpenSpotterVizPanel);
+	 * ```
+	 */
+	OpenSpotterVizPanel = "OpenSpotterVizPanel",
+	/**
+	 * Closes the SpotterViz panel.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.trigger(HostEvent.CloseSpotterVizPanel);
+	 * ```
+	 */
+	CloseSpotterVizPanel = "CloseSpotterVizPanel",
 	/**
 	 * Clears browser cache and fetches new data for liveboard ChartViz Containers.
 	 * Requires `enableLiveboardDataCache` to be enabled.
@@ -8841,7 +9034,73 @@ export enum Action {
 	 * ```
 	 * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
 	 */
-	RefreshLiveboardBrowserCache = "refreshLiveboardBrowserCache"
+	RefreshLiveboardBrowserCache = "refreshLiveboardBrowserCache",
+	/**
+	 * Controls visibility and disable state of the share action
+	 * in the Spotter Analyst interface.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterAnalystShare]
+	 * disabledActions: [Action.SpotterAnalystShare]
+	 * ```
+	 */
+	SpotterAnalystShare = "spotterAnalystShare",
+	/**
+	 * Controls visibility and disable state of the edit action
+	 * in the Spotter Analyst interface.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterAnalystEdit]
+	 * disabledActions: [Action.SpotterAnalystEdit]
+	 * ```
+	 */
+	SpotterAnalystEdit = "spotterAnalystEdit",
+	/**
+	 * Controls visibility and disable state of the create action
+	 * in the Spotter Analyst interface.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterAnalystCreate]
+	 * disabledActions: [Action.SpotterAnalystCreate]
+	 * ```
+	 */
+	SpotterAnalystCreate = "spotterAnalystCreate",
+	/**
+	 * Controls visibility and disable state of the delete action
+	 * in the Spotter Analyst interface.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterAnalystDelete]
+	 * disabledActions: [Action.SpotterAnalystDelete]
+	 * ```
+	 */
+	SpotterAnalystDelete = "spotterAnalystDelete",
+	/**
+	 * Controls visibility and disable state of the make a copy action
+	 * in the Spotter Analyst interface.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterAnalystMakeACopy]
+	 * disabledActions: [Action.SpotterAnalystMakeACopy]
+	 * ```
+	 */
+	SpotterAnalystMakeACopy = "spotterAnalystMakeACopy",
+	/**
+	 * Controls visibility and disable state of the sidebar
+	 * in the Spotter Analyst interface.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterAnalystSidebar]
+	 * disabledActions: [Action.SpotterAnalystSidebar]
+	 * ```
+	 */
+	SpotterAnalystSidebar = "spotterAnalystSidebar"
 }
 export enum PrefetchFeatures {
 	FullApp = "FullApp",
@@ -9179,7 +9438,9 @@ export enum EmbedErrorCodes {
 	/** UpdateFilters payload is invalid - missing or malformed filter/filters */
 	UPDATEFILTERS_INVALID_PAYLOAD = "UPDATEFILTERS_INVALID_PAYLOAD",
 	/** DrillDown payload is invalid - missing or malformed points */
-	DRILLDOWN_INVALID_PAYLOAD = "DRILLDOWN_INVALID_PAYLOAD"
+	DRILLDOWN_INVALID_PAYLOAD = "DRILLDOWN_INVALID_PAYLOAD",
+	/** UpdateParameters payload is invalid - malformed applicability */
+	UPDATEPARAMETERS_INVALID_PAYLOAD = "UPDATEPARAMETERS_INVALID_PAYLOAD"
 }
 /**
  * Error event object emitted when an error occurs in an embedded component.
@@ -9825,6 +10086,35 @@ export interface LiveboardTab {
 	name: string;
 	[key: string]: any;
 }
+enum ApplicabilityLevel {
+	Liveboard = "LIVEBOARD",
+	Tab = "TAB",
+	Group = "GROUP"
+}
+/**
+ * Scopes a filter or parameter to a specific target.
+ * At `LIVEBOARD` level the filter applies to the whole Liveboard, so `targetId`
+ * is not required.
+ */
+export interface Applicability {
+	level: ApplicabilityLevel;
+	targetId?: string;
+}
+export interface FilterUpdate {
+	column: string;
+	oper: string;
+	values: string[];
+	type?: string;
+	applicability?: Applicability;
+}
+export interface LiveboardFilter {
+	applicability?: Applicability;
+	[key: string]: any;
+}
+export interface LiveboardParameter {
+	applicability?: Applicability;
+	[key: string]: any;
+}
 export enum UIPassthroughEvent {
 	PinAnswerToLiveboard = "addVizToPinboard",
 	SaveAnswer = "saveAnswer",
@@ -9919,7 +10209,7 @@ export type UIPassthroughContractBase = {
 			vizId?: string;
 		};
 		response: {
-			liveboardFilters: Record<string, any>[];
+			liveboardFilters: LiveboardFilter[];
 			runtimeFilters: RuntimeFilter[];
 		};
 	};
@@ -9932,7 +10222,7 @@ export type UIPassthroughContractBase = {
 	[UIPassthroughEvent.GetParameters]: {
 		request: Record<string, never>;
 		response: {
-			parameters: Record<string, any>[];
+			parameters: LiveboardParameter[];
 		};
 	};
 	[UIPassthroughEvent.GetTML]: {
@@ -9961,18 +10251,8 @@ export type UIPassthroughContractBase = {
 	};
 	[UIPassthroughEvent.UpdateFilters]: {
 		request: {
-			filter?: {
-				column: string;
-				oper: string;
-				values: string[];
-				type?: string;
-			};
-			filters?: {
-				column: string;
-				oper: string;
-				values: string[];
-				type?: string;
-			}[];
+			filter?: FilterUpdate;
+			filters?: FilterUpdate[];
 		};
 		response: unknown;
 	};
@@ -10049,6 +10329,7 @@ class HostEventClient {
 	protected handlePinEvent(payload: HostEventRequest<HostEvent.Pin>, context?: ContextType): Promise<HostEventResponse<HostEvent.Pin, ContextType>>;
 	protected handleSaveAnswerEvent(payload: HostEventRequest<HostEvent.SaveAnswer>, context?: ContextType): Promise<any>;
 	protected handleUpdateFiltersEvent(payload: HostEventRequest<HostEvent.UpdateFilters>, context?: ContextType): Promise<any>;
+	protected handleUpdateParametersEvent(payload: HostEventRequest<HostEvent.UpdateParameters>, context?: ContextType): Promise<any>;
 	protected handleDrillDownEvent(payload: HostEventRequest<HostEvent.DrillDown>, context?: ContextType): Promise<any>;
 	/**
 	 * Dispatches a host event using the appropriate channel:
@@ -10651,6 +10932,14 @@ export interface SearchOptions {
 	 */
 	searchQuery: string;
 }
+/**
+ * The query mode Spotter uses when answering a question.
+ * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+ */
+export enum SpotterQueryMode {
+	FAST_SEARCH = "fastSearch",
+	RESEARCH = "research"
+}
 /**
  * Configuration for the Spotter sidebar.
  * Can be used in SpotterEmbed and AppEmbed.
@@ -10725,6 +11014,18 @@ export interface SpotterSidebarViewConfig {
 	 * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
 	 */
 	spotterNewChatButtonTitle?: string;
+	/**
+	 * Custom label text for the Spotter Analyst section in the sidebar.
+	 * @version SDK: 1.51.0 | ThoughtSpot: 26.8.0.cl
+	 * @default Analyst
+	 */
+	spotterAnalystLabel?: string;
+	/**
+	 * Custom label text for the Spotter Analysts section in the sidebar.
+	 * @version SDK: 1.51.0 | ThoughtSpot: 26.8.0.cl
+	 * @default Analysts
+	 */
+	spotterAnalystsLabel?: string;
 }
 /**
  * Configuration for customizing Spotter chat UI branding.
@@ -10941,6 +11242,24 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, "primaryAct
 	 * ```
 	 */
 	updatedSpotterChatPrompt?: boolean;
+	/**
+	 * Sets the default query mode when Spotter loads — Fast Search or
+	 * Research Mode. Applies fresh on every new session for this embed
+	 * instance only; it does not persist as a user preference and does
+	 * not affect other embeds or native ThoughtSpot usage.
+	 *
+	 * Supported embed types: `SpotterEmbed`, `AppEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default SpotterQueryMode.FAST_SEARCH
+	 * @example
+	 * ```js
+	 * const embed = new SpotterEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    defaultQueryMode: SpotterQueryMode.RESEARCH,
+	 * })
+	 * ```
+	 */
+	defaultQueryMode?: SpotterQueryMode;
 	/**
 	 * Enables the stop answer generation button in the Spotter embed UI,
 	 * allowing users to interrupt an ongoing answer generation.
@@ -11111,6 +11430,12 @@ export interface SpotterVizStarterPrompt {
  *            { label: 'Tip', text: 'try asking about revenue by region' },
  *            { label: 'Tip', text: 'use natural language' },
  *        ],
+ *        // liveboardBrandName, spotterBrandName, insightTileBrandName, insightTileViewPlanLabel and insightTileLoaderText require SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+ *        liveboardBrandName: 'Reports',
+ *        spotterBrandName: 'Analyst',
+ *        insightTileBrandName: 'Insight card',
+ *        insightTileViewPlanLabel: 'View plan',
+ *        insightTileLoaderText: 'Generating insight',
  *    },
  * })
  * ```
@@ -11167,6 +11492,34 @@ export interface SpotterVizConfig {
 	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
 	 */
 	loaderTips?: SpotterVizLoaderTip[];
+	/**
+	 * Custom term used to replace "Liveboard" in the agent's responses.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default ''
+	 */
+	liveboardBrandName?: string;
+	/**
+	 * Custom term used to replace "Spotter" in the agent's responses.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default ''
+	 */
+	spotterBrandName?: string;
+	/**
+	 * Custom term used to replace "Insight tile" in the UI and in the agent's responses.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default ''
+	 */
+	insightTileBrandName?: string;
+	/**
+	 * Custom term used to replace "View plan" in the insight tile menu.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	insightTileViewPlanLabel?: string;
+	/**
+	 * Custom loader text shown on the insight tile.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	insightTileLoaderText?: string;
 }
 /**
  * A single tip shown in the SpotterViz loading state.
@@ -11214,7 +11567,11 @@ export enum Page {
 	/**
 	 *  Monitor Alerts Page
 	 */
-	Monitor = "monitor"
+	Monitor = "monitor",
+	/**
+	 * Collections listing page
+	 */
+	Collections = "collections"
 }
 /**
  * Define the initial state of column custom group accordions
@@ -11869,6 +12226,25 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	updatedSpotterChatPrompt?: boolean;
+	/**
+	 * Sets the default query mode when Spotter loads — Fast Search or
+	 * Research Mode. Applies fresh on every new session for this embed
+	 * instance only; it does not persist as a user preference and does
+	 * not affect other embeds or native ThoughtSpot usage.
+	 * Only applicable when navigating to Spotter within the app.
+	 *
+	 * Supported embed types: `AppEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default SpotterQueryMode.FAST_SEARCH
+	 * @example
+	 * ```js
+	 * const embed = new AppEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    defaultQueryMode: SpotterQueryMode.RESEARCH,
+	 * })
+	 * ```
+	 */
+	defaultQueryMode?: SpotterQueryMode;
 	/**
 	 * Controls the visibility of the past conversations sidebar.
 	 *
@@ -11941,6 +12317,12 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 *            { label: 'Tip', text: 'try asking about revenue by region' },
 	 *            { label: 'Tip', text: 'use natural language' },
 	 *        ],
+	 *        // liveboardBrandName, spotterBrandName, insightTileBrandName, insightTileViewPlanLabel and insightTileLoaderText require SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 *        liveboardBrandName: 'Reports',
+	 *        spotterBrandName: 'Analyst',
+	 *        insightTileBrandName: 'Insight card',
+	 *        insightTileViewPlanLabel: 'View plan',
+	 *        insightTileLoaderText: 'Generating insight',
 	 *    },
 	 * })
 	 * ```
@@ -12930,6 +13312,12 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 *            { label: 'Tip', text: 'try asking about revenue by region' },
 	 *            { label: 'Tip', text: 'use natural language' },
 	 *        ],
+	 *        // liveboardBrandName, spotterBrandName, insightTileBrandName, insightTileViewPlanLabel and insightTileLoaderText require SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 *        liveboardBrandName: 'Reports',
+	 *        spotterBrandName: 'Analyst',
+	 *        insightTileBrandName: 'Insight card',
+	 *        insightTileViewPlanLabel: 'View plan',
+	 *        insightTileLoaderText: 'Generating insight',
 	 *    },
 	 * })
 	 * ```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thoughtspot/visual-embed-sdk",
-    "version": "1.49.3",
+    "version": "1.50.1",
     "description": "ThoughtSpot Embed SDK",
     "module": "lib/src/index.js",
     "main": "dist/tsembed.js",

package/src/authToken.spec.ts

@@ -77,6 +77,12 @@ describe('AuthToken Unit tests', () => {
         loggerSpy.mockRestore();
     });
 
+    test('validateAuthToken: returns false when verifyTokenService throws (covers catch block)', async () => {
+        jest.spyOn(authServiceInstance, 'verifyTokenService').mockRejectedValueOnce(new Error('network error'));
+        const result = await validateAuthToken({ thoughtSpotHost: 'test', disableTokenVerification: false } as EmbedConfig, 'valid-token-string');
+        expect(result).toBe(false);
+    });
+
     describe('getAuthenticationToken: cached token skip validation condition', () => {
         beforeEach(() => {
             resetCachedAuthToken();