@thoughtspot/visual-embed-sdk 1.40.1-alpha.1 → 1.40.1-alpha.2

package/dist/visual-embed-sdk-react.d.ts

@@ -354,6 +354,8 @@ export function useSpotterAgent(config: SpotterAgentEmbedViewConfig): {
                 query: string;
                 message: {
                         worksheetId: string;
+                        convId: any;
+                        messageId: any;
                         sessionId: any;
                         genNo: any;
                         acSessionId: any;
@@ -650,6 +652,7 @@ export declare class SearchBarEmbed extends TsEmbed {
         protected viewConfig: SearchBarViewConfig;
         protected embedComponentType: string;
         constructor(domSelector: string, viewConfig: SearchBarViewConfig);
+        protected getEmbedParamsObject(): Record<any, any>;
         /**
             * Render the embedded ThoughtSpot search
             */
@@ -802,6 +805,7 @@ export declare class SageEmbed extends V1Embed {
             */
         protected viewConfig: SageViewConfig;
         constructor(domSelector: DOMSelector, viewConfig: SageViewConfig);
+        protected getEmbedParamsObject(): Record<any, any>;
         /**
             * Constructs a map of parameters to be passed on to the
             * embedded Eureka or Sage search page.
@@ -1139,6 +1143,7 @@ export declare class SearchEmbed extends TsEmbed {
                 };
         };
         protected getAppInitData(): Promise<SearchAppInitData>;
+        protected getEmbedParamsObject(): Record<any, any>;
         protected getEmbedParams(): string;
         /**
             * Construct the URL of the embedded ThoughtSpot search to be
@@ -2119,6 +2124,7 @@ export declare class LiveboardEmbed extends V1Embed {
             * embedded Liveboard or visualization.
             */
         protected getEmbedParams(): string;
+        protected getEmbedParamsObject(): any;
         protected beforePrerenderVisible(): void;
         protected handleRenderForPrerender(): Promise<TsEmbed>;
         /**
@@ -2139,7 +2145,8 @@ export declare class LiveboardEmbed extends V1Embed {
             * visualization ID and the runtime filters.
             */
         render(): Promise<LiveboardEmbed>;
-        navigateToLiveboard(liveboardId: string, vizId?: string, activeTabId?: string): void;
+        currentLiveboardId: string;
+        navigateToLiveboard(liveboardId: string, vizId?: string, activeTabId?: string, onNavigateCalled?: () => void): void;
         /**
             * Returns the full url of the Liveboard/visualization which can be used to open
             * this Liveboard inside the full ThoughtSpot application in a new tab.
@@ -2176,10 +2183,13 @@ export interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConf
         genNo: number;
         acSessionId: string;
         acGenNo: number;
+        convId: string;
+        messageId: string;
 }
 export declare class ConversationMessage extends TsEmbed {
         protected viewConfig: SpotterAgentMessageViewConfig;
         constructor(container: HTMLElement, viewConfig: SpotterAgentMessageViewConfig);
+        protected getEmbedParamsObject(): Record<any, any>;
         getIframeSrc(): string;
         render(): Promise<ConversationMessage>;
 }
@@ -2223,6 +2233,8 @@ export declare class SpotterAgentEmbed {
                 data?: undefined;
         } | {
                 data: {
+                        convId: any;
+                        messageId: any;
                         sessionId: any;
                         genNo: any;
                         acSessionId: any;
@@ -4911,7 +4923,84 @@ export declare enum EmbedEvent {
             * @version SDK : 1.39.0 | ThoughtSpot : 10.10.0.cl
             * @hidden
             */
-        RequestVisibleEmbedCoordinates = "requestVisibleEmbedCoordinates"
+        RequestVisibleEmbedCoordinates = "requestVisibleEmbedCoordinates",
+        /**
+            * 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
@@ -4929,7 +5018,7 @@ export declare enum EmbedEvent {
     * // create the liveboard embed.
     *
     * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
-    *   { columnName: 'state, operator: RuntimeFilterOp.EQ, values: ['california']}
+    *   { columnName: 'state', operator: RuntimeFilterOp.EQ, values: ["california"]}
     * ]);
     * ```
     * @example
@@ -5137,12 +5226,12 @@ export declare enum HostEvent {
             * Works with Search and Liveboard embed.
             * @param - { columnId: string,
             *  name: string,
-            *  type: INT64/CHAR/DATE,
-            *  dataType: ATTRIBUTE/MEASURE }
+            *  type: ATTRIBUTE/MEASURE,
+            *  dataType: INT64/CHAR/DATE }
             * @example
             * ```js
             * searchEmbed.trigger(HostEvent.OpenFilter,
-            *  {column: { columnId: '<column-GUID>', name: 'column name', type: 'INT64', dataType: 'ATTRIBUTE'}})
+            *  {column: { columnId: '<column-GUID>', name: 'column name', type: 'ATTRIBUTE', dataType: 'INT64'}})
             * ```
             * @example
             * ```js
@@ -5200,6 +5289,7 @@ export declare enum HostEvent {
             * @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.
@@ -5247,6 +5337,12 @@ export declare enum HostEvent {
             * ```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",
@@ -5340,6 +5436,12 @@ export declare enum HostEvent {
             * ```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",
@@ -5412,6 +5514,7 @@ export declare enum HostEvent {
             * 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)
@@ -5420,6 +5523,12 @@ export declare enum HostEvent {
             * 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",
@@ -5467,6 +5576,16 @@ export declare enum HostEvent {
             *   );
             * })
             * ```
+            * @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
             */
@@ -5554,7 +5673,12 @@ export declare enum HostEvent {
             * 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",
@@ -5572,6 +5696,11 @@ export declare enum HostEvent {
             * ```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",
@@ -5589,6 +5718,11 @@ export declare enum HostEvent {
             * ```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",
@@ -5608,6 +5742,7 @@ export declare enum HostEvent {
         /**
             * 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)
@@ -5615,6 +5750,11 @@ export declare enum HostEvent {
             * ```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",
@@ -5898,7 +6038,7 @@ export declare enum HostEvent {
         ResetLiveboardPersonalisedView = "ResetLiveboardPersonalisedView",
         /**
             * Triggers an action to update Parameter values on embedded
-            * Answers and Liveboard.
+            * Answers, Liveboard and Spotter answer in Edit mode.
             *
             * @example
             * ```js
@@ -5917,6 +6057,13 @@ export declare enum HostEvent {
             *  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",
@@ -5984,6 +6131,64 @@ export declare enum HostEvent {
             * @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.
@@ -6006,7 +6211,27 @@ export declare enum HostEvent {
             *
             * @hidden
             */
-        VisibleEmbedCoordinates = "visibleEmbedCoordinates"
+        VisibleEmbedCoordinates = "visibleEmbedCoordinates",
+        /**
+            * 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",
+        /**
+            * @hidden
+            * Triggers the update of the embed params.
+            *
+            * @example
+            * ```js
+            * liveboardEmbed.trigger(HostEvent.UpdateEmbedParams, viewConfig);
+            * ```
+            */
+        UpdateEmbedParams = "updateEmbedParams"
 }
 /**
     * The different visual modes that the data sources panel within
@@ -7682,6 +7907,7 @@ export interface ConversationViewConfig extends SpotterEmbedViewConfig {
 export declare class SpotterEmbed extends TsEmbed {
         protected viewConfig: SpotterEmbedViewConfig;
         constructor(container: HTMLElement, viewConfig: SpotterEmbedViewConfig);
+        protected getEmbedParamsObject(): Record<any, any>;
         getIframeSrc(): string;
         render(): Promise<SpotterEmbed>;
 }
@@ -7777,20 +8003,25 @@ export declare class TsEmbed {
         protected isRendered: boolean;
         protected hostEventClient: HostEventClient;
         protected isReadyForRenderPromise: Promise<void>;
+        id: string;
         constructor(domSelector: DOMSelector, viewConfig?: ViewConfig);
         /**
             * Handles errors within the SDK
             * @param error The error message or object
             */
         protected handleError(error: string | Record<string, unknown>): void;
+        isEmbedContainerLoaded: boolean;
         protected getAuthTokenForCookielessInit(): Promise<string>;
         protected getDefaultAppInitData(): Promise<DefaultAppInitData>;
         protected getAppInitData(): Promise<DefaultAppInitData>;
+        protected getPreRenderObj<T extends TsEmbed>(): T;
+        protected triggerAfterLoad(eventType: HostEvent, data: TriggerPayload<any, HostEvent>, onEventTriggered?: () => void): void;
         /**
             * Constructs the base URL string to load the ThoughtSpot app.
             * @param query
             */
         protected getEmbedBasePath(query: string): string;
+        protected getUpdateEmbedParamsObject(): Record<any, any>;
         /**
             * Common query params set for all the embed modes.
             * @param queryParams
@@ -7806,6 +8037,7 @@ export declare class TsEmbed {
             */
         protected getV1EmbedBasePath(queryString: string): string;
         protected getEmbedParams(): string;
+        protected getEmbedParamsObject(): Record<any, any>;
         protected getRootIframeSrc(): string;
         protected createIframeEl(frameSrc: string): HTMLIFrameElement;
         protected handleInsertionIntoDOM(child: string | Node): void;