@thoughtspot/visual-embed-sdk 1.39.2 → 1.39.3

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

@@ -11,7 +11,7 @@ declare module '@thoughtspot/visual-embed-sdk' {
       * @summary ThoughtSpot Visual Embed SDK
       * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
       */
-    import { AppEmbed, Page, AppViewConfig, HomePageSearchBarMode, PrimaryNavbarVersion, HomePage, DataPanelCustomColumnGroupsAccordionState } from '@thoughtspot/visual-embed-sdk/embed/app';
+    import { AppEmbed, Page, AppViewConfig, HomePageSearchBarMode, PrimaryNavbarVersion, HomePage, ListPage, DataPanelCustomColumnGroupsAccordionState } from '@thoughtspot/visual-embed-sdk/embed/app';
     import { init, prefetch, logout, executeTML, exportTML, executeTMLInput, exportTMLInput } from '@thoughtspot/visual-embed-sdk/embed/base';
     import { PinboardEmbed, LiveboardViewConfig, LiveboardEmbed } from '@thoughtspot/visual-embed-sdk/embed/liveboard';
     import { SearchEmbed, SearchViewConfig } from '@thoughtspot/visual-embed-sdk/embed/search';
@@ -30,7 +30,7 @@ declare module '@thoughtspot/visual-embed-sdk' {
     import { getAnswerFromQuery } from '@thoughtspot/visual-embed-sdk/utils/graphql/nlsService/nls-answer-service';
     import { createLiveboardWithAnswers } from '@thoughtspot/visual-embed-sdk/utils/liveboardService/liveboardService';
     import { UIPassthroughEvent } from '@thoughtspot/visual-embed-sdk/embed/hostEventClient/contracts';
-    export { init, logout, prefetch, executeTML, exportTML, executeTMLInput, exportTMLInput, getEmbedConfig as getInitConfig, getSessionInfo, tokenizedFetch, getAnswerFromQuery, createLiveboardWithAnswers, SearchEmbed, SearchBarEmbed, PinboardEmbed, LiveboardEmbed, SageEmbed, AppEmbed, SpotterAgentEmbed, SpotterAgentEmbedViewConfig, BodylessConversationViewConfig, BodylessConversation, SpotterEmbed, SpotterEmbedViewConfig, ConversationViewConfig, ConversationEmbed, AuthFailureType, AuthStatus, AuthEvent, AuthEventEmitter, AnswerService, SessionInterface, UnderlyingDataPoint, Page, AuthType, RuntimeFilter, RuntimeFilterOp, EmbedEvent, HostEvent, DataSourceVisualMode, Action, ContextMenuTriggerOptions, EmbedConfig, SearchViewConfig, SearchBarViewConfig, LiveboardViewConfig, SageViewConfig, AppViewConfig, PrefetchFeatures, FrameParams, HomeLeftNavItem, HomepageModule, DOMSelector, MessageOptions, MessageCallback, MessagePayload, CustomisationsInterface, CustomStyles, customCssInterface, CustomCssVariables, RuntimeParameter, LogLevel, uploadMixpanelEvent, MIXPANEL_EVENT, HomePageSearchBarMode, PrimaryNavbarVersion, HomePage, VizPoint, CustomActionPayload, UIPassthroughEvent, ListPageColumns, DataPanelCustomColumnGroupsAccordionState, };
+    export { init, logout, prefetch, executeTML, exportTML, executeTMLInput, exportTMLInput, getEmbedConfig as getInitConfig, getSessionInfo, tokenizedFetch, getAnswerFromQuery, createLiveboardWithAnswers, SearchEmbed, SearchBarEmbed, PinboardEmbed, LiveboardEmbed, SageEmbed, AppEmbed, SpotterAgentEmbed, SpotterAgentEmbedViewConfig, BodylessConversationViewConfig, BodylessConversation, SpotterEmbed, SpotterEmbedViewConfig, ConversationViewConfig, ConversationEmbed, AuthFailureType, AuthStatus, AuthEvent, AuthEventEmitter, AnswerService, SessionInterface, UnderlyingDataPoint, Page, AuthType, RuntimeFilter, RuntimeFilterOp, EmbedEvent, HostEvent, DataSourceVisualMode, Action, ContextMenuTriggerOptions, EmbedConfig, SearchViewConfig, SearchBarViewConfig, LiveboardViewConfig, SageViewConfig, AppViewConfig, PrefetchFeatures, FrameParams, HomeLeftNavItem, HomepageModule, DOMSelector, MessageOptions, MessageCallback, MessagePayload, CustomisationsInterface, CustomStyles, customCssInterface, CustomCssVariables, RuntimeParameter, LogLevel, uploadMixpanelEvent, MIXPANEL_EVENT, HomePageSearchBarMode, PrimaryNavbarVersion, HomePage, ListPage, VizPoint, CustomActionPayload, UIPassthroughEvent, ListPageColumns, DataPanelCustomColumnGroupsAccordionState, };
     export { resetCachedAuthToken } from '@thoughtspot/visual-embed-sdk/authToken';
 }
 
@@ -129,6 +129,21 @@ declare module '@thoughtspot/visual-embed-sdk/embed/app' {
                 */
             Modular = "v2"
     }
+    /**
+        * Define the version of the list page
+        * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
+        */
+    export enum ListPage {
+            /**
+                * List (v2) is the traditional List Experience.
+                * It serves as the foundational version of the list page.
+                */
+            List = "v2",
+            /**
+                * ListWithUXChanges (v3) introduces the new updated list page with UX changes.
+                */
+            ListWithUXChanges = "v3"
+    }
     /**
         * Define the discovery experience
         * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
@@ -142,6 +157,10 @@ declare module '@thoughtspot/visual-embed-sdk/embed/app' {
                 * homePage determines the version of the home page.
                 */
             homePage?: HomePage;
+            /**
+                * listPageVersion determines the version of the list page.
+                */
+            listPageVersion?: ListPage;
     }
     /**
         * The view configuration for full app embedding.
@@ -513,21 +532,6 @@ declare module '@thoughtspot/visual-embed-sdk/embed/app' {
                 * ```
                 */
             isUnifiedSearchExperienceEnabled?: boolean;
-            /**
-             * Show alert messages and toast messages in the embedded
-             * view in full app embed.
-             *
-             * Supported embed types: `AppEmbed`
-             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
-             * @example
-             * ```js
-             * const embed = new AppEmbed('#tsEmbed', {
-             *    ... // other embed view config
-             *    showAlerts:true,
-             * })
-             * ```
-             */
-            showAlerts?: boolean;
             /**
                 * This flag is used to enable/disable the styling and grouping in a Liveboard
                 *
@@ -985,23 +989,6 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 * })
                 */
             dataSourceId?: string;
-            /**
-                * This flag is for show/hide checkboxes for include or exclude
-                * cover page and filters in the Liveboard PDF.
-                *
-                * Supported embed types: `LiveboardEmbed`
-                * @version SDK: 1.37.0 | ThoughtSpot:10.8.0.cl
-                * @default true
-                * Supported embed types: `LiveboardEmbed`
-                * @example
-                * ```js
-                * const embed = new LiveboardEmbed('#tsEmbed', {
-                *    ... //other embed view config
-                *    coverAndFilterOptionInPDF: false,
-                * })
-                * ```
-                */
-            coverAndFilterOptionInPDF?: boolean;
             /**
                 * The list of tab IDs to hide from the embedded.
                 * This Tabs will be hidden from their respective LBs.
@@ -1581,10 +1568,6 @@ declare module '@thoughtspot/visual-embed-sdk/embed/bodyless-conversation' {
                 * The ID of the worksheet to use for the conversation.
                 */
             worksheetId: string;
-            /**
-                * Optional CSS class name to add to the container div.
-                */
-            containerClassName?: string;
     }
     /**
         * Configuration for conversation options.
@@ -1594,13 +1577,15 @@ declare module '@thoughtspot/visual-embed-sdk/embed/bodyless-conversation' {
         */
     export interface BodylessConversationViewConfig extends SpotterAgentEmbedViewConfig {
     }
-    interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConfig {
+    export interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConfig {
             sessionId: string;
             genNo: number;
             acSessionId: string;
             acGenNo: number;
+            convId: string;
+            messageId: string;
     }
-    class ConversationMessage extends TsEmbed {
+    export class ConversationMessage extends TsEmbed {
             protected viewConfig: SpotterAgentMessageViewConfig;
             constructor(container: HTMLElement, viewConfig: SpotterAgentMessageViewConfig);
             getIframeSrc(): string;
@@ -1636,6 +1621,25 @@ declare module '@thoughtspot/visual-embed-sdk/embed/bodyless-conversation' {
                     viz: ConversationMessage;
                     error?: undefined;
             }>;
+            /**
+                * Send a message to the conversation service and return only the data.
+                * @param userMessage - The message to send to the conversation service.
+                * @returns The data from the conversation service.
+                */
+            sendMessageData(userMessage: string): Promise<{
+                    error: any;
+                    data?: undefined;
+            } | {
+                    data: {
+                            convId: any;
+                            messageId: any;
+                            sessionId: any;
+                            genNo: any;
+                            acSessionId: any;
+                            acGenNo: any;
+                    };
+                    error?: undefined;
+            }>;
     }
     /**
         * Create a conversation embed, which can be integrated inside
@@ -1660,7 +1664,6 @@ declare module '@thoughtspot/visual-embed-sdk/embed/bodyless-conversation' {
     export class BodylessConversation extends SpotterAgentEmbed {
             constructor(viewConfig: BodylessConversationViewConfig);
     }
-    export {};
 }
 
 declare module '@thoughtspot/visual-embed-sdk/embed/conversation' {
@@ -2322,7 +2325,13 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * available when new navigation V3 is enabled.
                 * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
                 */
-            Spotter = "spotter"
+            Spotter = "spotter",
+            /**
+                * Favorites option in the insights left navigation,
+                * available when new navigation V3 is enabled.
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            Favorites = "favorites"
     }
     export type DOMSelector = string | HTMLElement;
     /**
@@ -3088,6 +3097,20 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * @private
                 */
             insertInToSlide?: boolean;
+            /**
+                * Show alert messages and toast messages in the embed.
+                * Supported embed in all embed types.
+                *
+                * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+                * @example
+                * ```js
+                * const embed = new AppEmbed('#tsEmbed', {
+                *    ... // other embed view config
+                *    showAlerts:true,
+                * })
+                * ```
+                */
+            showAlerts?: boolean;
     }
     /**
         * The configuration object for Home page embeds configs.
@@ -3465,6 +3488,22 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```
                 */
             enableAskSage?: boolean;
+            /**
+             * This flag is used to show or hide checkboxes for including or excluding
+             * the cover and filters pages in the Liveboard PDF.
+             *
+             * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+             * @version SDK: 1.40.0 | ThoughtSpot:10.8.0.cl
+             * @example
+             * ```js
+             * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
+             * const embed = new <EmbedComponent>('#tsEmbed', {
+             *    ... // other embed view config
+             *    coverAndFilterOptionInPDF: false,
+             * })
+             * ```
+             */
+            coverAndFilterOptionInPDF?: boolean;
     }
     export interface AllEmbedViewConfig extends BaseViewConfig, SearchLiveboardCommonViewConfig, HomePageConfig, LiveboardAppEmbedViewConfig {
     }
@@ -4724,7 +4763,84 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * Emitted when a user exits present mode.
                 * @version SDK : 1.40.0 | ThoughtSpot: 10.11.0.cl
                 */
-            ExitPresentMode = "exitPresentMode"
+            ExitPresentMode = "exitPresentMode",
+            /**
+                * Emitted when spotter response is text data
+                * @example
+                * ```js
+                * spotterEmbed.on(EmbedEvent.SpotterData, (payload) => {
+                *     console.log('payload', payload);
+                * })
+                *```
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            SpotterData = "SpotterData",
+            /**
+                * Emitted when user opens up the worksheet preview modal in spotter embed.
+                * @example
+                * ```js
+                * spotterEmbed.on(EmbedEvent.PreviewSpotterData, (payload) => {
+                *     console.log('payload', payload);
+                * })
+                *```
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            PreviewSpotterData = "PreviewSpotterData",
+            /**
+                * Emitted when the spotter query is triggered in spotter embed.
+                * @example
+                * ```js
+                * spotterEmbed.on(EmbedEvent.SpotterQueryTriggered, (payload) => {
+                *     console.log('payload', payload);
+                * })
+                *```
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            SpotterQueryTriggered = "SpotterQueryTriggered",
+            /**
+                * Emitted when the last spotter query is edited in spotter embed.
+                * @example
+                * ```js
+                * spotterEmbed.on(EmbedEvent.LastPromptEdited, (payload) => {
+                *     console.log('payload', payload);
+                * })
+                *```
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            LastPromptEdited = "LastPromptEdited",
+            /**
+                * Emitted when the last spotter query is deleted in spotter embed.
+                * @example
+                * ```js
+                * spotterEmbed.on(EmbedEvent.LastPromptDeleted, (payload) => {
+                *     console.log('payload', payload);
+                * })
+                *```
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            LastPromptDeleted = "LastPromptDeleted",
+            /**
+                * Emitted when the coversation is reset in spotter embed.
+                * @example
+                * ```js
+                * spotterEmbed.on(EmbedEvent.ResetSpotterConversation, (payload) => {
+                *     console.log('payload', payload);
+                * })
+                *```
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            ResetSpotterConversation = "ResetSpotterConversation",
+            /**
+                * Emitted when the *Spotter* is initialized.
+                * @example
+                * ```js
+                * spotterEmbed.on(EmbedEvent.SpotterInit, (payload) => {
+                *     console.log('payload', payload);
+                * })
+                *```
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            SpotterInit = "SpotterInit"
     }
     /**
         * Event types that can be triggered by the host application
@@ -5013,6 +5129,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * @param
                 * `vizId`-  GUID of the saved Answer or visualization to pin to a Liveboard.
                 *  Optional when pinning a new chart or table generated from a Search query.
+                *  **Required** in Spotter Embed.
                 * @param
                 * `liveboardID` - GUID of the Liveboard to pin an Answer. If there is no Liveboard,
                 *  specify the `newLiveboardName` parameter to create a new Liveboard.
@@ -5060,6 +5177,12 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```js
                 * appEmbed.trigger(HostEvent.Pin)
                 * ```
+                * @example
+                * ```js
+                * const pinResponse = await spotterEmbed.trigger(HostEvent.Pin, {
+                *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+                *  });
+                * ```
                 * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
                 */
             Pin = "pin",
@@ -5153,6 +5276,12 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```js
                 * searchEmbed.trigger(HostEvent.MakeACopy)
                 * ```
+                * @example
+                * ```js
+                * const pinResponse = await spotterEmbed.trigger(HostEvent.MakeACopy, {
+                *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+                *  });
+                * ```
                 * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
                 */
             MakeACopy = "makeACopy",
@@ -5225,6 +5354,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * This event is not supported in visualization embed and search embed.
                 * @param - object - To trigger the action for a specific visualization
                 * in Liveboard embed, pass in `vizId` as a key.
+                * **Required** in Spotter embed.
                 * @example
                 * ```js
                 * liveboardEmbed.trigger(HostEvent.Edit)
@@ -5233,6 +5363,12 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * liveboardEmbed.trigger(HostEvent.Edit, {vizId:
                 * '730496d6-6903-4601-937e-2c691821af3c'})
                 * ```
+                * @example
+                * ```js
+                * const pinResponse = await spotterEmbed.trigger(HostEvent.Edit, {
+                *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+                *  });
+                * ```
                 * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
                 */
             Edit = "edit",
@@ -5280,6 +5416,16 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 *   );
                 * })
                 * ```
+                * @example
+                * ```js
+                * spotterEmbed.trigger(HostEvent.GetTML, {
+                *   vizId: '730496d6-6903-4601-937e-2c691821af3c'
+                * }).then((tml) => {
+                *   console.log(
+                *      tml.answer.search_query // TML representation of the search query
+                *   );
+                * })
+                * ```
                 * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1.sw
                 * @important
                 */
@@ -5367,7 +5513,12 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * vizEmbed.trigger(HostEvent.DownloadAsPng)
                 *
                 * searchEmbed.trigger(HostEvent.DownloadAsPng)
+                *
+                * spotterEmbed.trigger(HostEvent.DownloadAsPng, {
+                *       vizId:"730496d6-6903-4601-937e-2c691821af3c"
+                * })
                 * ```
+                *
                 * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.1.sw
                 */
             DownloadAsPng = "downloadAsPng",
@@ -5385,6 +5536,11 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```js
                 * searchEmbed.trigger(HostEvent.DownloadAsCsv)
                 * ```
+                * ```js
+                * spotterEmbed.trigger(HostEvent.DownloadAsCsv, {
+                *       vizId:"730496d6-6903-4601-937e-2c691821af3c"
+                * })
+                * ```
                 * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
                 */
             DownloadAsCsv = "downloadAsCSV",
@@ -5402,6 +5558,11 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```js
                 * searchEmbed.trigger(HostEvent.DownloadAsXlsx)
                 * ```
+                * ```js
+                * spotterEmbed.trigger(HostEvent.downloadAsXLSX, {
+                *       vizId:"730496d6-6903-4601-937e-2c691821af3c"
+                * })
+                * ```
                 * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
                 */
             DownloadAsXlsx = "downloadAsXLSX",
@@ -5421,6 +5582,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
             /**
                 * Trigger the **Save**  action on a Liveboard or Answer.
                 * Saves the changes.
+                * @param - `vizId` is required in Spotter Embed.
                 * @example
                 * ```js
                 * liveboardEmbed.trigger(HostEvent.Save)
@@ -5428,6 +5590,11 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```js
                 * searchEmbed.trigger(HostEvent.Save)
                 * ```
+                * ```js
+                * spotterEmbed.trigger(HostEvent.Save, {
+                *       vizId:"730496d6-6903-4601-937e-2c691821af3c"
+                * })
+                * ```
                 * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
                 */
             Save = "save",
@@ -5711,7 +5878,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
             ResetLiveboardPersonalisedView = "ResetLiveboardPersonalisedView",
             /**
                 * Triggers an action to update Parameter values on embedded
-                * Answers and Liveboard.
+                * Answers, Liveboard and Spotter answer in Edit mode.
                 *
                 * @example
                 * ```js
@@ -5730,6 +5897,13 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 *  console.log('parameters', parameter);
                 * });
                 *```
+                *```js
+                * spotterEmbed.trigger(HostEvent.GetParameters, {
+                *  vizId: '730496d6-6903-4601-937e-2c691821af3c'
+                * }).then((parameter) => {
+                *  console.log('parameters', parameter);
+                * });
+                *```
                 * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
                 */
             GetParameters = "GetParameters",
@@ -5797,6 +5971,64 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl
                 */
             TransformTableVizData = "TransformTableVizData",
+            /**
+                * Triggers a search operation with the search tokens specified in
+                * the search query string in spotter embed.
+                * @param - `queryString`: Text string in Natural Language format
+                * @param - `executeSearch`: Boolean to execute search and update search query
+                * @example
+                * ```js
+                * spotterEmbed.trigger(HostEvent.SpotterSearch, {
+                *  query: 'revenue per year',
+                *  executeSearch: true,
+                * })
+                * ```
+                */
+            SpotterSearch = "SpotterSearch",
+            /**
+                * Edits the last prompt in spotter embed.
+                * @param - `query`: Text string
+                * @example
+                * ```js
+                * spotterEmbed.trigger(HostEvent.EditLastPrompt, "revenue per year");
+                * ```
+                */
+            EditLastPrompt = "EditLastPrompt",
+            /**
+                * Opens the Worksheet preview modal in Spotter Embed.
+                * @example
+                * ```js
+                * spotterEmbed.trigger(HostEvent.PreviewSpotterData);
+                * ```
+                */
+            PreviewSpotterData = "PreviewSpotterData",
+            /**
+                * Resets the Spotter Embed Conversation.
+                * @example
+                * ```js
+                * spotterEmbed.trigger(HostEvent.ResetSpotterConversation);
+                * ```
+                */
+            ResetSpotterConversation = "ResetSpotterConversation",
+            /**
+                * Deletes the last prompt in spotter embed.
+                * @example
+                * ```js
+                * spotterEmbed.trigger(HostEvent.DeleteLastPrompt);
+                * ```
+                */
+            DeleteLastPrompt = "DeleteLastPrompt",
+            /**
+                * Toggle the visualization to chart or table view.
+                * @param - `vizId ` In Spotter Embed, vizId is required.
+                * @example
+                * ```js
+                * spotterEmbed.trigger(HostEvent.AnswerChartSwitcher, {
+                *          vizId:"'b535c760-8bbe-4e6f-bb26-af56b4129a1e'"
+                * });
+                *```
+                */
+            AnswerChartSwitcher = "answerChartSwitcher",
             /**
                 * @hidden
                 * Trigger exit from presentation mode when user exits fullscreen.
@@ -5806,7 +6038,17 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 *```
                 * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
                 */
-            ExitPresentMode = "exitPresentMode"
+            ExitPresentMode = "exitPresentMode",
+            /**
+                * Trigger the *Ask Sage* action for visualizations
+                * @example
+                * ```js
+                * liveboardEmbed.trigger(HostEvent.AskSpotter,
+                * {containerId:'730496d6-6903-4601-937e-2c691821af3c'})
+                * ```
+                * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+                */
+            AskSpotter = "askSpotter"
     }
     /**
         * The different visual modes that the data sources panel within
@@ -5902,6 +6144,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
             Query = "query",
             HideHomepageLeftNav = "hideHomepageLeftNav",
             ModularHomeExperienceEnabled = "modularHomeExperience",
+            ListPageVersion = "listpageVersion",
             PendoTrackingKey = "additionalPendoKey",
             LiveboardHeaderSticky = "isLiveboardHeaderSticky",
             IsProductTour = "isProductTour",
@@ -5936,7 +6179,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
             DataSourceId = "dataSourceId",
             preAuthCache = "preAuthCache",
             ShowSpotterLimitations = "showSpotterLimitations",
-            CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF",
+            CoverAndFilterOptionInPDF = "arePdfCoverFilterPageCheckboxesEnabled",
             PrimaryAction = "primaryAction",
             isSpotterAgentEmbed = "isSpotterAgentEmbed",
             IsLiveboardStylingAndGroupingEnabled = "isLiveboardStylingAndGroupingEnabled"
@@ -7159,7 +7402,23 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```
                 *  @version SDK: 1.37.0 | ThoughtSpot Cloud: 10.8.0.cl
                 */
-            CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF"
+            CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF",
+            /**
+                * Action ID for hide or disable the
+                * Spotter in conversation training widget.
+                * The Add to Coaching feature is currently in beta
+                * and is disabled by default on embed deployments.
+                * To enable this feature on your instance,
+                * contact ThoughtSpot Support.
+                *  @example
+                * ```js
+                * hiddenAction: [Action.InConversationTraining]
+                * disabledActions: [Action.InConversationTraining]
+                *
+                * ```
+                *  @version SDK: 1.39.0 | ThoughtSpot Cloud: 10.10.0.cl
+                */
+            InConversationTraining = "InConversationTraining"
     }
     export interface AnswerServiceType {
             getAnswer?: (offset: number, batchSize: number) => any;
@@ -8083,13 +8342,14 @@ declare module '@thoughtspot/visual-embed-sdk/embed/embedConfig' {
         *
         * @example
         * ```js
+        * import { getInitConfig } from '@thoughtspot/visual-embed-sdk';
+        * // Call the getInitConfig method to retrieve the embed configuration
         * const config = getInitConfig();
+        * // Log the configuration settings
         * console.log(config);
         * ```
-        * @example
-        *
-        * Returns the `EmbedConfig` object, which
-        * contains the configuration settings used to
+        * Returns the link:https://developers.thoughtspot.com/docs/Interface_EmbedConfig[EmbedConfig]
+        * object, which contains the configuration settings used to
         * initialize the SDK, including the following:
         *
         *  - `thoughtSpotHost` - ThoughtSpot host URL
@@ -8098,9 +8358,10 @@ declare module '@thoughtspot/visual-embed-sdk/embed/embedConfig' {
         *  - `customizations` - Style, text, and icon customization settings
         *  that were applied during the SDK initialization.
         *
-        * For a comprehensive list of embed configuration settings,
-        * see link:https://developers.thoughtspot.com/docs/Interface_EmbedConfig[Developer Documentation].
+        * The following JSON output shows the embed configuration
+        * settings returned from the code in the previous example:
         *
+        * @example
         * ```json
         * {
         *   "thoughtSpotHost": "https://{ThoughtSpot-Host}",
@@ -8122,7 +8383,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/embedConfig' {
         *   "authTriggerContainer": "#your-own-div"
         *  }
         * ```
-        * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.cl, and later
+        * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw, and later
         * @group Global methods
         */
     export const getEmbedConfig: () => EmbedConfig;

package/package.json

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

package/src/config.spec.ts

@@ -21,6 +21,17 @@ describe('getThoughtSpotHost', () => {
         expect(testFn).toThrow(Error);
     });
 
+    test('invalid URL format', () => {
+        const testFn = () => {
+            getThoughtSpotHost({
+                ...embedConfig,
+                thoughtSpotHost: '',
+            });
+        };
+
+        expect(testFn).toThrow('Error parsing ThoughtSpot host. Please provide a valid URL.');
+    });
+
     test('IP address/hostname only', () => {
         expect(
             getThoughtSpotHost({