@thoughtspot/visual-embed-sdk 1.35.14 → 1.36.1

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

@@ -1698,6 +1698,11 @@ declare module '@thoughtspot/visual-embed-sdk/auth' {
                 * Emits when the SDK authenticates successfully
                 */
             SDK_SUCCESS = "SDK_SUCCESS",
+            /**
+                * @hidden
+                * Emits when iframe is loaded and session info is available
+                */
+            SESSION_INFO_SUCCESS = "SESSION_INFO_SUCCESS",
             /**
                 * Emits when the app sends an authentication success message
                 */
@@ -1852,6 +1857,36 @@ declare module '@thoughtspot/visual-embed-sdk/utils/sessionInfoService' {
             clusterName: string;
             [key: string]: any;
     };
+    export type PreauthInfo = {
+            info?: SessionInfo;
+            headers: Record<string, string>;
+            status: number;
+            [key: string]: any;
+    };
+    /**
+        * Processes the session info response and returns the session info object.
+        *  @param preauthInfoResp {any} Response from the session info API.
+        *  @returns {PreauthInfo} The session info object.
+        *  @example ```js
+        *  const preauthInfoResp = await fetch(sessionInfoPath);
+        *  const sessionInfo = await formatPreauthInfo(preauthInfoResp);
+        *  console.log(sessionInfo);
+        *  ```
+        * @version SDK: 1.28.3 | ThoughtSpot: *
+        */
+    export const formatPreauthInfo: (preauthInfoResp: any) => Promise<PreauthInfo>;
+    /**
+        * Returns the session info object and caches it for future use.
+        * Once fetched the session info object is cached and returned from the cache on
+        * subsequent calls.
+        * @example ```js
+        * const preauthInfo = await getPreauthInfo();
+        * console.log(preauthInfo);
+        * ```
+        * @version SDK: 1.28.3 | ThoughtSpot: *
+        * @returns {Promise<SessionInfo>} The session info object.
+        */
+    export function getPreauthInfo(allowCache?: boolean): Promise<PreauthInfo>;
     /**
         * Returns the session info object and caches it for future use.
         * Once fetched the session info object is cached and returned from the cache on
@@ -2510,6 +2545,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 *  @version SDK 1.37.0 | ThoughtSpot: 10.7.0.cl
                 */
             customVariablesForThirdPartyTools?: Record<string, any>;
+            disablePreauthCache?: boolean;
     }
     export interface LayoutConfig {
     }
@@ -4469,16 +4505,63 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             getExportRequestForCurrentPinboard = "getExportRequestForCurrentPinboard",
             /**
-                * Trigger the **Pin** action on an embedded object
-                * @param - Liveboard embed takes the `vizId` as a
-                * key. Can be left undefined when embedding Search, full app, or
-                * a visualization.
+                * Trigger **Pin** action on an embedded object.
+                * If no parameters are defined, the pin action is triggered
+                * for the Answer that the user is currently on
+                * and a modal opens for Liveboard selection.
+                * To add an Answer or visualization to a Liveboard programmatically without
+                * showing requiring additional user input via *Pin to Liveboard* modal, define
+                * the following parameters:
+                *
+                * @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.
+                * @param
+                * `liveboardID` - GUID of the Liveboard to pin an Answer. If there is no Liveboard,
+                *  specify the `newLiveboardName` parameter to create a new Liveboard.
+                * @param
+                * `tabId` - GUID of the Liveboard tab. Adds the Answer to the Liveboard tab
+                *  specified in the code.
+                * @param
+                * `newVizName` - Name string for the Answer or visualization. If defined,
+                *  this parameter adds a new visualization object or creates a copy of the
+                *  Answer or visualization specified in `vizId`.
+                *  Required attribute.
+                * @param
+                * `newLiveboardName` - Name string for the Liveboard.
+                *  Creates a new Liveboard object with the specified name.
+                * @param
+                * `newTabName` - Name of the tab. Adds a new tab Liveboard specified
+                *  in the code.
+                *
                 * @example
                 * ```js
-                * appEmbed.trigger(HostEvent.Pin)
+                * const pinResponse = await appEmbed.trigger(HostEvent.Pin, {
+                *     vizId: "123",
+                *     newVizName: "Sales by region",
+                *     liveboardId: "123",
+                *     tabId: "123"
+                *  });
                 * ```
+                * @example
+                * ```js
+                * const pinResponse = await appEmbed.trigger(HostEvent.Pin, {
+                *     newVizName: "Total sales of Jackets",
+                *     liveboardId: "123"
+                *  });
+                * ```
+                *
+                * @example
                 * ```js
-                * searchEmbed.trigger(HostEvent.Pin)
+                * const pinResponse = await searchEmbed.trigger(HostEvent.Pin, {
+                *     newVizName: "Sales by state",
+                *     newLiveboardName: "Sales",
+                *     newTabName: "Products"
+                *  });
+                * ```
+                * @example
+                * ```js
+                * appEmbed.trigger(HostEvent.Pin)
                 * ```
                 * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
                 */
@@ -5125,7 +5208,33 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             UpdatePersonalisedView = "UpdatePersonalisedView",
             /**
-                * Triggers the action to get the current view of the Liveboard.
+                * @hidden
+                * Notify when info call is completed successfully
+                * ```js
+                * liveboardEmbed.trigger(HostEvent.InfoSuccess, data);
+                *```
+                * @version SDK: 1.36.0 | Thoughtspot: 10.6.0.cl
+                */
+            InfoSuccess = "InfoSuccess",
+            /**
+                * Trigger the save action for an Answer.
+                * To programmatically save an answer without opening the
+                * *Describe your Answer* modal, define the `name` and `description`
+                * properties.
+                * If no parameters are specified, the save action is
+                * triggered with a modal to prompt users to
+                * add a name and description for the Answer.
+                * @param - optional attributes to set Answer properties.
+                *  `name` - Name string for the Answer.
+                *  `description` - Description text for the Answer.
+                *
+                * @example
+                * ```js
+                * const saveAnswerResponse = await searchEmbed.trigger(HostEvent.SaveAnswer, {
+                *      name: "Sales by states",
+                *      description: "Total sales by states in MidWest"
+                *   });
+                * ```
                 * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
                 */
             SaveAnswer = "saveAnswer",
@@ -5273,6 +5382,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
             OauthPollingInterval = "oAuthPollingInterval",
             IsForceRedirect = "isForceRedirect",
             DataSourceId = "dataSourceId",
+            preAuthCache = "preAuthCache",
             ShowSpotterLimitations = "showSpotterLimitations"
     }
     /**
@@ -6710,6 +6820,14 @@ declare module '@thoughtspot/visual-embed-sdk/css-variables' {
                 * panel.
                 */
             '--ts-var-search-auto-complete-subtext-font-color'?: string;
+            /**
+                * Background color of the input box in the Spotter page.
+                */
+            '--ts-var-spotter-input-background'?: string;
+            /**
+                * Background color of the previously asked prompt message in the Spotter page.
+                */
+            '--ts-var-spotter-prompt-background': string;
             /**
                 * Background color of the data panel.
                 */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thoughtspot/visual-embed-sdk",
-    "version": "1.35.14",
+    "version": "1.36.1",
     "description": "ThoughtSpot Embed SDK",
     "module": "lib/src/index.js",
     "main": "dist/tsembed.js",
@@ -72,7 +72,6 @@
         "classnames": "^2.3.1",
         "eventemitter3": "^4.0.7",
         "gatsby-plugin-vercel": "^1.0.3",
-        "html-react-parser": "^1.4.12",
         "lodash": "^4.17.21",
         "mixpanel-browser": "2.47.0",
         "ts-deepmerge": "^6.0.2",
@@ -117,7 +116,7 @@
         "eslint-plugin-comment-length": "1.7.3",
         "eslint-plugin-jsdoc": "^46.9.0",
         "fs-extra": "^10.0.0",
-        "gh-pages": "^3.1.0",
+        "gh-pages": "6.3.0",
         "highlight.js": "^10.6.0",
         "html-to-text": "^8.0.0",
         "identity-obj-proxy": "^3.0.0",

package/src/auth.ts

@@ -15,7 +15,7 @@ import {
 } from './utils/authService';
 import { isActiveService } from './utils/authService/tokenizedAuthService';
 import { logger } from './utils/logger';
-import { getSessionInfo } from './utils/sessionInfoService';
+import { getSessionInfo, getPreauthInfo } from './utils/sessionInfoService';
 import { ERROR_MESSAGE } from './errors';
 
 // eslint-disable-next-line import/no-mutable-exports
@@ -55,6 +55,11 @@ export enum AuthStatus {
      * Emits when the SDK authenticates successfully
      */
     SDK_SUCCESS = 'SDK_SUCCESS',
+    /**
+     * @hidden
+     * Emits when iframe is loaded and session info is available
+     */
+    SESSION_INFO_SUCCESS = 'SESSION_INFO_SUCCESS',
     /**
      * Emits when the app sends an authentication success message
      */
@@ -168,6 +173,7 @@ export async function notifyAuthSuccess(): Promise<void> {
         return;
     }
     try {
+        getPreauthInfo();
         const sessionInfo = await getSessionInfo();
         authEE.emit(AuthStatus.SUCCESS, sessionInfo);
     } catch (e) {
@@ -224,6 +230,7 @@ async function isLoggedIn(thoughtSpotHost: string): Promise<boolean> {
  */
 export async function postLoginService(): Promise<void> {
     try {
+        getPreauthInfo();
         const sessionInfo = await getSessionInfo();
         releaseVersion = sessionInfo.releaseVersion;
         const embedConfig = getEmbedConfig();

package/src/css-variables.ts

@@ -111,6 +111,16 @@ export interface CustomCssVariables {
      */
     '--ts-var-search-auto-complete-subtext-font-color'?: string;
 
+    /**
+     * Background color of the input box in the Spotter page.
+     */
+    '--ts-var-spotter-input-background'?: string;
+
+    /**
+     * Background color of the previously asked prompt message in the Spotter page.
+     */
+    '--ts-var-spotter-prompt-background': string;
+
     /**
      * Background color of the data panel.
      */

package/src/embed/hostEventClient/host-event-client.spec.ts

@@ -133,6 +133,7 @@ describe('HostEventClient', () => {
             const mockResponse = {
                 value: {
                     pinboardId: 'testPinboard',
+                    liveboardId: 'testPinboard',
                     tabId: 'testTab',
                     vizId: 'testVizId',
                 },
@@ -250,5 +251,65 @@ describe('HostEventClient', () => {
             );
             expect(result).toEqual([mockResponse]);
         });
+
+        it('Pin response support pinboardId as well', async () => {
+            const { client, mockIframe } = createHostEventClient();
+            const hostEvent = HostEvent.Pin;
+            const payload: HostEventRequest<typeof hostEvent> = {
+                newVizDescription: 'Test Description',
+                vizId: 'testVizId',
+                newVizName: 'Test Answer',
+                newLiveboardName: 'testLiveboard',
+            } as any;
+            const mockResponse = [{
+                value: {
+                    pinboardId: 'testLiveboard',
+                    liveboardId: 'testPinboard',
+                    tabId: 'testTab',
+                    vizId: 'testVizId',
+                },
+                refId: 'testVizId',
+            }];
+            mockProcessTrigger.mockResolvedValue(mockResponse);
+            const result = await client.triggerHostEvent(hostEvent, payload);
+            expect(result.liveboardId).toBe('testLiveboard');
+        });
+
+        it('should request liveboardId as well', async () => {
+            const { client, mockIframe } = createHostEventClient();
+            const hostEvent = HostEvent.Pin;
+            const payload: HostEventRequest<typeof hostEvent> = {
+                liveboardId: 'test',
+                newVizName: 'Test Answer',
+                newPinboardName: 'testLiveboard1',
+                newLiveboardName: 'testLiveboard',
+            } as any;
+            const mockResponse = [{
+                value: {
+                    pinboardId: 'testLiveboard',
+                    tabId: 'testTab',
+                    vizId: 'testVizId',
+                },
+                refId: 'testVizId',
+            }];
+            mockProcessTrigger.mockResolvedValue(mockResponse);
+            const result = await client.triggerHostEvent(hostEvent, payload);
+            expect(result.liveboardId).toBe('testLiveboard');
+            expect(mockProcessTrigger).toHaveBeenCalledWith(
+                mockIframe,
+                HostEvent.UIPassthrough,
+                mockThoughtSpotHost,
+                {
+                    parameters: { ...payload, pinboardId: 'test', newPinboardName: 'testLiveboard' },
+                    type: 'addVizToPinboard',
+                },
+            );
+            expect(result).toEqual({
+                pinboardId: 'testLiveboard',
+                tabId: 'testTab',
+                vizId: 'testVizId',
+                liveboardId: 'testLiveboard',
+            });
+        });
     });
 });

package/src/embed/hostEventClient/host-event-client.ts

@@ -98,13 +98,18 @@ export class HostEventClient {
 
       const formattedPayload = {
           ...payload,
-          pinboardId: payload.liveboardId,
-          newPinboardName: payload.newLiveboardName,
+          pinboardId: payload.liveboardId ?? (payload as any).pinboardId,
+          newPinboardName: payload.newLiveboardName ?? (payload as any).newPinboardName,
       };
 
-      return this.handleHostEventWithParam(
+      const data = await this.handleHostEventWithParam(
           UIPassthroughEvent.PinAnswerToLiveboard, formattedPayload,
       );
+
+      return {
+          ...data,
+          liveboardId: (data as any).pinboardId,
+      };
   }
 
   protected async handleSaveAnswerEvent(

package/src/embed/ts-embed.spec.ts

@@ -51,12 +51,13 @@ import * as mixpanelInstance from '../mixpanel-service';
 import * as authInstance from '../auth';
 import * as baseInstance from './base';
 import { MIXPANEL_EVENT } from '../mixpanel-service';
-import * as authService from '../utils/authService/authService';
+import * as authService from '../utils/authService';
 import { logger } from '../utils/logger';
 import { version } from '../../package.json';
 import { HiddenActionItemByDefaultForSearchEmbed } from './search';
 import { processTrigger } from '../utils/processTrigger';
 import { UIPassthroughEvent } from './hostEventClient/contracts';
+import * as sessionInfoService from '../utils/sessionInfoService';
 
 jest.mock('../utils/processTrigger');
 
@@ -1147,6 +1148,99 @@ describe('Unit test case for ts embed', () => {
         });
     });
 
+    describe('Trigger infoSuccess event on iframe load', () => {
+        beforeAll(() => {
+            jest.clearAllMocks();
+            init({
+                thoughtSpotHost,
+                authType: AuthType.None,
+                loginFailedMessage: 'Failed to Login',
+            });
+        });
+
+        const setup = async (isLoggedIn = false, overrideOrgId: number | undefined = undefined) => {
+            jest.spyOn(window, 'addEventListener').mockImplementationOnce(
+                (event, handler, options) => {
+                    handler({
+                        data: {
+                            type: 'xyz',
+                        },
+                        ports: [3000],
+                        source: null,
+                    });
+                },
+            );
+            mockProcessTrigger.mockResolvedValueOnce({ session: 'test' });
+            // resetCachedPreauthInfo();
+            let mockGetPreauthInfo = null;
+
+            if (overrideOrgId) {
+                mockGetPreauthInfo = jest.spyOn(sessionInfoService, 'getPreauthInfo').mockImplementation(jest.fn());
+            }
+
+            const mockPreauthInfoFetch = jest.spyOn(authService, 'fetchPreauthInfoService').mockResolvedValueOnce({
+                ok: true,
+                headers: new Headers({ 'content-type': 'application/json' }), // Mock headers correctly
+                json: async () => ({
+                    info: {
+                        configInfo: {
+                            mixpanelConfig: {
+                                devSdkKey: 'devSdkKey',
+                            },
+                        },
+                        userGUID: 'userGUID',
+                    },
+                }), // Mock JSON response
+            });
+            const iFrame: any = document.createElement('div');
+            jest.spyOn(baseInstance, 'getAuthPromise').mockResolvedValueOnce(isLoggedIn);
+            const tsEmbed = new SearchEmbed(getRootEl(), {
+                overrideOrgId,
+            });
+            iFrame.contentWindow = {
+                postMessage: jest.fn(),
+            };
+            tsEmbed.on(EmbedEvent.CustomAction, jest.fn());
+            jest.spyOn(iFrame, 'addEventListener').mockImplementationOnce(
+                (event, handler, options) => {
+                    handler({});
+                },
+            );
+            jest.spyOn(document, 'createElement').mockReturnValueOnce(iFrame);
+            await tsEmbed.render();
+
+            return {
+                mockPreauthInfoFetch,
+                mockGetPreauthInfo,
+                iFrame,
+            };
+        };
+
+        test('should call InfoSuccess Event on preauth call success', async () => {
+            const {
+                mockPreauthInfoFetch,
+                iFrame,
+            } = await setup(true);
+            expect(mockPreauthInfoFetch).toHaveBeenCalledTimes(1);
+
+            await executeAfterWait(() => {
+                expect(mockProcessTrigger).toHaveBeenCalledWith(
+                    iFrame,
+                    HostEvent.InfoSuccess,
+                    'http://tshost',
+                    expect.objectContaining({ info: expect.any(Object) }),
+                );
+            });
+        });
+
+        test('should not call InfoSuccess Event if overrideOrgId is true', async () => {
+            const {
+                mockGetPreauthInfo,
+            } = await setup(true, 123);
+            expect(mockGetPreauthInfo).toHaveBeenCalledTimes(0);
+        });
+    });
+
     describe('when thoughtSpotHost have value and authPromise return error', () => {
         beforeAll(() => {
             init({

package/src/embed/ts-embed.ts

@@ -70,6 +70,7 @@ import {
 import { AuthFailureType } from '../auth';
 import { getEmbedConfig } from './embedConfig';
 import { ERROR_MESSAGE } from '../errors';
+import { getPreauthInfo } from '../utils/sessionInfoService';
 import { HostEventClient } from './hostEventClient/host-event-client';
 
 const { version } = pkgInfo;
@@ -244,6 +245,24 @@ export class TsEmbed {
         return null;
     }
 
+    /**
+     * Checks if preauth cache is enabled
+     * from the view config and embed config
+     * @returns boolean
+     */
+    private isPreAuthCacheEnabled() {
+        // Disable preauth cache when:
+        // 1. overrideOrgId is present since:
+        //    - cached auth info would be for wrong org
+        //    - info call response changes for each different overrideOrgId
+        // 2. disablePreauthCache is explicitly set to true
+        const isDisabled = (
+            this.viewConfig.overrideOrgId !== undefined
+            || this.embedConfig.disablePreauthCache === true
+        );
+        return !isDisabled;
+    }
+
     /**
      * fix for ts7.sep.cl
      * will be removed for ts7.oct.cl
@@ -586,6 +605,10 @@ export class TsEmbed {
             queryParams[Param.OverrideOrgId] = overrideOrgId;
         }
 
+        if (this.isPreAuthCacheEnabled()) {
+            queryParams[Param.preAuthCache] = true;
+        }
+
         queryParams[Param.OverrideNativeConsole] = true;
         queryParams[Param.ClientLogLevel] = this.embedConfig.logLevel;
 
@@ -722,6 +745,14 @@ export class TsEmbed {
                             elHeight: this.iFrame.clientHeight,
                             timeTookToLoad: loadTimestamp - initTimestamp,
                         });
+                        // Send info event  if preauth cache is enabled
+                        if (this.isPreAuthCacheEnabled()) {
+                            getPreauthInfo().then((data) => {
+                                if (data?.info) {
+                                    this.trigger(HostEvent.InfoSuccess, data);
+                                }
+                            });
+                        }
                     });
                     this.iFrame.addEventListener('error', () => {
                         nextInQueue();

package/src/react/index.spec.tsx

@@ -56,7 +56,7 @@ describe('React Components', () => {
                 ),
             ).toBe(true);
             expect(getIFrameSrc(container)).toBe(
-                `http://${thoughtSpotHost}/?embedApp=true&hostAppUrl=local-host&viewPortHeight=768&viewPortWidth=1024&sdkVersion=${version}&authType=None&blockNonEmbedFullAppAccess=true&hideAction=[%22${Action.ReportError}%22,%22editACopy%22,%22saveAsView%22,%22updateTSL%22,%22editTSL%22,%22onDeleteAnswer%22]&overrideConsoleLogs=true&clientLogLevel=ERROR&enableDataPanelV2=false&dataSourceMode=hide&useLastSelectedSources=false&isSearchEmbed=true&collapseSearchBarInitially=true&enableCustomColumnGroups=false&dataPanelCustomGroupsAccordionInitialState=EXPAND_ALL#/embed/answer`,
+                `http://${thoughtSpotHost}/?embedApp=true&hostAppUrl=local-host&viewPortHeight=768&viewPortWidth=1024&sdkVersion=${version}&authType=None&blockNonEmbedFullAppAccess=true&hideAction=[%22${Action.ReportError}%22,%22editACopy%22,%22saveAsView%22,%22updateTSL%22,%22editTSL%22,%22onDeleteAnswer%22]&preAuthCache=true&overrideConsoleLogs=true&clientLogLevel=ERROR&enableDataPanelV2=false&dataSourceMode=hide&useLastSelectedSources=false&isSearchEmbed=true&collapseSearchBarInitially=true&enableCustomColumnGroups=false&dataPanelCustomGroupsAccordionInitialState=EXPAND_ALL#/embed/answer`,
             );
         });
 
@@ -230,7 +230,7 @@ describe('React Components', () => {
                 ),
             ).toBe(true);
             expect(getIFrameSrc(container)).toBe(
-                `http://${thoughtSpotHost}/?embedApp=true&hostAppUrl=local-host&viewPortHeight=768&viewPortWidth=1024&sdkVersion=${version}&authType=None&blockNonEmbedFullAppAccess=true&hideAction=[%22${Action.ReportError}%22]&overrideConsoleLogs=true&clientLogLevel=ERROR&dataSources=[%22test%22]&searchTokenString=%5Brevenue%5D&executeSearch=true&useLastSelectedSources=false&isSearchEmbed=true#/embed/search-bar-embed`,
+                `http://${thoughtSpotHost}/?embedApp=true&hostAppUrl=local-host&viewPortHeight=768&viewPortWidth=1024&sdkVersion=${version}&authType=None&blockNonEmbedFullAppAccess=true&hideAction=[%22${Action.ReportError}%22]&preAuthCache=true&overrideConsoleLogs=true&clientLogLevel=ERROR&dataSources=[%22test%22]&searchTokenString=%5Brevenue%5D&executeSearch=true&useLastSelectedSources=false&isSearchEmbed=true#/embed/search-bar-embed`,
             );
         });
     });

package/src/types.ts

@@ -629,6 +629,8 @@ export interface EmbedConfig {
      *  @version SDK 1.37.0 | ThoughtSpot: 10.7.0.cl
      */
     customVariablesForThirdPartyTools?: Record< string, any >;
+
+    disablePreauthCache?: boolean;
 }
 
 // eslint-disable-next-line @typescript-eslint/no-empty-interface
@@ -2613,16 +2615,63 @@ export enum HostEvent {
      */
     getExportRequestForCurrentPinboard = 'getExportRequestForCurrentPinboard',
     /**
-     * Trigger the **Pin** action on an embedded object
-     * @param - Liveboard embed takes the `vizId` as a
-     * key. Can be left undefined when embedding Search, full app, or
-     * a visualization.
+     * Trigger **Pin** action on an embedded object.
+     * If no parameters are defined, the pin action is triggered
+     * for the Answer that the user is currently on
+     * and a modal opens for Liveboard selection.
+     * To add an Answer or visualization to a Liveboard programmatically without
+     * showing requiring additional user input via *Pin to Liveboard* modal, define
+     * the following parameters:
+     *
+     * @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.
+     * @param
+     * `liveboardID` - GUID of the Liveboard to pin an Answer. If there is no Liveboard,
+     *  specify the `newLiveboardName` parameter to create a new Liveboard.
+     * @param
+     * `tabId` - GUID of the Liveboard tab. Adds the Answer to the Liveboard tab
+     *  specified in the code.
+     * @param
+     * `newVizName` - Name string for the Answer or visualization. If defined,
+     *  this parameter adds a new visualization object or creates a copy of the
+     *  Answer or visualization specified in `vizId`.
+     *  Required attribute.
+     * @param
+     * `newLiveboardName` - Name string for the Liveboard.
+     *  Creates a new Liveboard object with the specified name.
+     * @param
+     * `newTabName` - Name of the tab. Adds a new tab Liveboard specified
+     *  in the code.
+     *
      * @example
      * ```js
-     * appEmbed.trigger(HostEvent.Pin)
+     * const pinResponse = await appEmbed.trigger(HostEvent.Pin, {
+     *     vizId: "123",
+     *     newVizName: "Sales by region",
+     *     liveboardId: "123",
+     *     tabId: "123"
+     *  });
+     * ```
+     * @example
+     * ```js
+     * const pinResponse = await appEmbed.trigger(HostEvent.Pin, {
+     *     newVizName: "Total sales of Jackets",
+     *     liveboardId: "123"
+     *  });
      * ```
+     *
+     * @example
      * ```js
-     * searchEmbed.trigger(HostEvent.Pin)
+     * const pinResponse = await searchEmbed.trigger(HostEvent.Pin, {
+     *     newVizName: "Sales by state",
+     *     newLiveboardName: "Sales",
+     *     newTabName: "Products"
+     *  });
+     * ```
+     * @example
+     * ```js
+     * appEmbed.trigger(HostEvent.Pin)
      * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
@@ -3269,7 +3318,33 @@ export enum HostEvent {
      */
     UpdatePersonalisedView = 'UpdatePersonalisedView',
     /**
-     * Triggers the action to get the current view of the Liveboard.
+     * @hidden
+     * Notify when info call is completed successfully
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.InfoSuccess, data);
+     *```
+     * @version SDK: 1.36.0 | Thoughtspot: 10.6.0.cl
+     */
+     InfoSuccess = 'InfoSuccess',
+    /**
+     * Trigger the save action for an Answer.
+     * To programmatically save an answer without opening the
+     * *Describe your Answer* modal, define the `name` and `description`
+     * properties.
+     * If no parameters are specified, the save action is
+     * triggered with a modal to prompt users to
+     * add a name and description for the Answer.
+     * @param - optional attributes to set Answer properties.
+     *  `name` - Name string for the Answer.
+     *  `description` - Description text for the Answer.
+     *
+     * @example
+     * ```js
+     * const saveAnswerResponse = await searchEmbed.trigger(HostEvent.SaveAnswer, {
+     *      name: "Sales by states",
+     *      description: "Total sales by states in MidWest"
+     *   });
+     * ```
      * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
      */
     SaveAnswer = 'saveAnswer',
@@ -3427,6 +3502,7 @@ export enum Param {
     OauthPollingInterval = 'oAuthPollingInterval',
     IsForceRedirect = 'isForceRedirect',
     DataSourceId = 'dataSourceId',
+    preAuthCache = 'preAuthCache',
     ShowSpotterLimitations = 'showSpotterLimitations',
 }