@thoughtspot/visual-embed-sdk 1.35.2 → 1.35.4

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

@@ -29,7 +29,8 @@ declare module '@thoughtspot/visual-embed-sdk' {
     import { tokenizedFetch } from '@thoughtspot/visual-embed-sdk/tokenizedFetch';
     import { getAnswerFromQuery } from '@thoughtspot/visual-embed-sdk/utils/graphql/nlsService/nls-answer-service';
     import { createLiveboardWithAnswers } from '@thoughtspot/visual-embed-sdk/utils/liveboardService/liveboardService';
-    export { init, logout, prefetch, executeTML, exportTML, executeTMLInput, exportTMLInput, getEmbedConfig as getInitConfig, getSessionInfo, tokenizedFetch, getAnswerFromQuery, createLiveboardWithAnswers, SearchEmbed, SearchBarEmbed, PinboardEmbed, LiveboardEmbed, SageEmbed, AppEmbed, BodylessConversation, BodylessConversationViewConfig, ConversationEmbed, ConversationViewConfig, 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, VizPoint, CustomActionPayload, };
+    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, BodylessConversation, BodylessConversationViewConfig, ConversationEmbed, ConversationViewConfig, 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, VizPoint, CustomActionPayload, UIPassthroughEvent, };
     export { resetCachedAuthToken } from '@thoughtspot/visual-embed-sdk/authToken';
 }
 
@@ -440,7 +441,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/app' {
                 */
             showLiveboardVerifiedBadge?: boolean;
             /**
-                * This flag is used to enable/disable hide irrelevant filters in liveboard tab
+                * This flag is used to enable/disable hide irrelevant filters in Liveboard tab
                 * @type {boolean}
                 * @default false
                 * @version SDK: 1.36.0 | ThoughtSpot:10.6.0.cl
@@ -566,7 +567,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/base' {
     /**
         * Initializes the Visual Embed SDK globally and perform
         * authentication if applicable. This function needs to be called before any ThoughtSpot
-        * component like liveboard etc can be embedded. But need not wait for AuthEvent.SUCCESS
+        * component like Liveboard etc can be embedded. But need not wait for AuthEvent.SUCCESS
         * to actually embed. That is handled internally.
         * @param embedConfig The configuration object containing ThoughtSpot host,
         * authentication mechanism and so on.
@@ -679,6 +680,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
         */
     import { DOMSelector, HostEvent, ViewConfig } from '@thoughtspot/visual-embed-sdk/types';
     import { V1Embed } from '@thoughtspot/visual-embed-sdk/embed/ts-embed';
+    import { HostEventRequest, HostEventResponse } from '@thoughtspot/visual-embed-sdk/embed/hostEventClient/contracts';
     /**
         * The configuration for the embedded Liveboard or visualization page view.
         * @group Embed components
@@ -899,7 +901,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 */
             enableAskSage?: boolean;
             /**
-                * This flag is used to enable the 2 column layout in liveboard
+                * This flag is used to enable the 2 column layout on a Liveboard
                 * @type {boolean}
                 * @default false
                 * @version SDK: 1.32.0 | ThoughtSpot:10.1.0.cl
@@ -934,7 +936,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 */
             showPreviewLoader?: boolean;
             /**
-                * This flag is used to enable the compact header in liveboard
+                * This flag is used to enable the compact header on a Liveboard
                 * @type {boolean}
                 * @default false
                 * @version SDK: 1.35.0 | ThoughtSpot:10.3.0.cl
@@ -948,7 +950,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 */
             isLiveboardCompactHeaderEnabled?: boolean;
             /**
-                * This flag is used to show/hide verified Icon in liveboard compact header
+                * This flag is used to show/hide verified icon in the Liveboard compact header
                 * @type {boolean}
                 * @default true
                 * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
@@ -962,7 +964,8 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 */
             showLiveboardVerifiedBadge?: boolean;
             /**
-                * This flag is used to show/hide re-verify banner in liveboard compact header
+                * This flag is used to show/hide the re-verify banner
+                * in Liveboard compact header
                 * @type {boolean}
                 * @default true
                 * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
@@ -976,7 +979,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 */
             showLiveboardReverifyBanner?: boolean;
             /**
-                * This flag is used to enable/disable hide irrelevant filters in liveboard tab
+                * This flag is used to enable/disable hide irrelevant filters in a Liveboard tab
                 * @type {boolean}
                 * @default false
                 * @version SDK: 1.36.0 | ThoughtSpot:10.6.0.cl
@@ -1056,7 +1059,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 * @param messageType The event type
                 * @param data The payload to send with the message
                 */
-            trigger(messageType: HostEvent, data?: any): Promise<any>;
+            trigger<HostEventT extends HostEvent>(messageType: HostEventT, data?: HostEventRequest<HostEventT>): Promise<HostEventResponse<HostEventT>>;
             /**
                 * Render an embedded ThoughtSpot Liveboard or visualization
                 * @param renderOptions An object specifying the Liveboard ID,
@@ -1065,8 +1068,8 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
             render(): Promise<LiveboardEmbed>;
             navigateToLiveboard(liveboardId: string, vizId?: string, activeTabId?: string): void;
             /**
-                * Returns the full url of the liveboard/viz which can be used to open
-                * this liveboard inside the full Thoughtspot application in a new tab.
+                * 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.
                 * @returns url string
                 */
             getLiveboardUrl(): string;
@@ -2857,8 +2860,12 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             enableCustomColumnGroups?: boolean;
             /**
-                * View content for another org directly without having to use the org switcher
-                * This flag is honoured if orgPerUrl feature is enabled for the ThoughtSpot cluster
+                * Overrides an Org context for embedding application users.
+                * This parameter allows a user authenticated to one Org to view the
+                * objects from another Org.
+                * The `overrideOrgId` setting is honoured only if the
+                * Per Org URL feature is enabled on your ThoughtSpot instance.
+                *
                 * @example
                 * ```js
                 * const embed = new LiveboardEmbed('#embed', {
@@ -3466,8 +3473,8 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 *
                 * **Note**: This event is deprecated in v1.21.0.
                 * To fire an event when a download action is initiated on a chart or table,
-                * use `EmbedEvent.DownloadAsPng`, `EmbedEvent.DownloadAsPDF`, `EmbedEvent.DownloadAsCSV`,
-                * or `EmbedEvent.DownloadAsXLSX`
+                * use `EmbedEvent.DownloadAsPng`, `EmbedEvent.DownloadAsPDF`,
+                * `EmbedEvent.DownloadAsCSV`, or `EmbedEvent.DownloadAsXLSX`
                 * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
                 * @example
                 *```js
@@ -4115,7 +4122,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * @param - autoDrillDown - Optional. If true, the drill down will be
                 * done automatically on the most popular column.
                 * @param - vizId [TS >= 9.8.0] - Optional. The GUID of the visualization to drill
-                * in case of a liveboard.
+                * in case of a Liveboard.
                 * @example
                 * ```js
                 * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
@@ -4202,26 +4209,26 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             SetActiveTab = "SetActiveTab",
             /**
-                * Update runtime filters applied on a Saved Answer or Liveboard. The
-                * runtime filters passed here are appended to the existing runtime
-                * filters.
+                * Updates the runtime filters applied on a Liveboard. The filter
+                * attributes passed with this event are appended to the existing runtime
+                * filters applied on a Liveboard.
+                *
                 * Pass an array of runtime filters with the following attributes:
                 *
-                * `columnName`
-                * _String_. The name of the column to filter on.
+                * `columnName` - _String_. The name of the column to filter on.
                 *
-                * `operator`
-                * Runtime filter operator to apply. For information,
+                * `operator` - Runtime filter operator to apply. For more information,
                 * see link:https://developers.thoughtspot.com/docs/?pageid=runtime-filters#rtOperator[Developer Documentation].
                 *
-                * `values`
-                * List of operands. Some operators such as EQ, LE allow a single value, whereas
-                * operators such as BW and IN accept multiple operands.
+                * `values` - List of operands. Some operators such as EQ and LE allow a
+                * single value, whereas BW and IN accept multiple values.
+                *
+                * **Note**: `HostEvent.UpdateRuntimeFilters` is supported in `LiveboardEmbed`
+                * and `AppEmbed` only. In full application embedding, this event updates
+                * the runtime filters applied on the Liveboard and saved Answer objects.
                 *
-                * **Note**: `HostEvent.UpdateRuntimeFilters` is not supported in
-                * Search embedding (SearchEmbed) and Natural Language Search
-                * embedding (SageEmbed).
                 * @param - {@link RuntimeFilter}[] an array of {@link RuntimeFilter} Types.
+                *
                 * @example
                 * ```js
                 * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
@@ -4920,7 +4927,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             ResetLiveboardPersonalisedView = "ResetLiveboardPersonalisedView",
             /**
-                * Triggers Update RuntimeParameters for answers and liveboard
+                * Triggers an event to Update Parameter values for Answers and Liveboard
                 * @example
                 * ```js
                 * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
@@ -4942,13 +4949,23 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             GetParameters = "GetParameters",
             /**
-                * Triggers update of persoanlised view for a liveboard
+                * Triggers an event to update a persoanlised view of a Liveboard
                 * ```js
                 * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {viewId: '1234'})
                 * ```
                 * @version SDK: 1.36.0 | Thoughtspot: 10.6.0.cl
                 */
-            UpdatePersonalisedView = "UpdatePersonalisedView"
+            UpdatePersonalisedView = "UpdatePersonalisedView",
+            /**
+                * Triggers the action to get the current view of the liveboard
+                * @version SDK: 1.36.0 | Thoughtspot: 10.6.0.cl
+                */
+            SaveAnswer = "saveAnswer",
+            /**
+                * EmbedApi
+                * @hidden
+                */
+            UIPassthrough = "UiPassthrough"
     }
     /**
         * The different visual modes that the data sources panel within
@@ -5921,7 +5938,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             ModifySageAnswer = "modifySageAnswer",
             /**
-                * The **Move to Tab** menu action on visualizations in liveboard edit mode.
+                * The **Move to Tab** menu action on visualizations in Liveboard edit mode.
                 * Allows moving a visualization to a different tab.
                 * @example
                 * ```js
@@ -5974,7 +5991,8 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             TML = "tml",
             /**
-                * Action Id for CreateLiveboard for liveboard list page & Pin Modal
+                * Action ID for the create Liveboard option on the Liveboard list page
+                * and Pin modal
                 * @example
                 * ```js
                 * hiddenAction: [Action.CreateLiveboard]
@@ -7131,6 +7149,87 @@ declare module '@thoughtspot/visual-embed-sdk/utils/liveboardService/liveboardSe
     export const createLiveboardWithAnswers: (answers: AnswerService[], name: string) => Promise<any>;
 }
 
+declare module '@thoughtspot/visual-embed-sdk/embed/hostEventClient/contracts' {
+    import { HostEvent } from '@thoughtspot/visual-embed-sdk/types';
+    export enum UIPassthroughEvent {
+        PinAnswerToLiveboard = "addVizToPinboard",
+        SaveAnswer = "saveAnswer",
+        GetDiscoverabilityStatus = "getDiscoverabilityStatus",
+        GetAvailableUIPassthroughs = "getAvailableUIPassthroughs",
+        GetAnswerConfig = "getAnswerPageConfig",
+        GetLiveboardConfig = "getPinboardPageConfig"
+    }
+    export type UIPassthroughContractBase = {
+        [UIPassthroughEvent.PinAnswerToLiveboard]: {
+            request: {
+                vizId?: string;
+                newVizName: string;
+                newVizDescription?: string;
+                pinboardId?: string;
+                tabId?: string;
+                newPinboardName?: string;
+                newTabName?: string;
+            };
+            response: {
+                pinboardId: string;
+                tabId: string;
+                vizId: string;
+            };
+        };
+        [UIPassthroughEvent.SaveAnswer]: {
+            request: {
+                name: string;
+                description: string;
+                vizId?: string;
+                isDiscoverable?: boolean;
+            };
+            response: {
+                answerId: string;
+                saveResponse?: any;
+                shareResponse?: any;
+            };
+        };
+        [UIPassthroughEvent.GetDiscoverabilityStatus]: {
+            request: any;
+            response: {
+                shouldShowDiscoverability: boolean;
+                isDiscoverabilityCheckboxUnselectedPerOrg: boolean;
+            };
+        };
+        [UIPassthroughEvent.GetAvailableUIPassthroughs]: {
+            request: any;
+            response: {
+                keys: string[];
+            };
+        };
+        [UIPassthroughEvent.GetAnswerConfig]: {
+            request: {
+                vizId?: string;
+            };
+            response: any;
+        };
+        [UIPassthroughEvent.GetLiveboardConfig]: {
+            request: any;
+            response: any;
+        };
+    };
+    export type UIPassthroughRequest<T extends keyof UIPassthroughContractBase> = UIPassthroughContractBase[T]['request'];
+    export type UIPassthroughResponse<T extends keyof UIPassthroughContractBase> = UIPassthroughContractBase[T]['response'];
+    export type UIPassthroughArrayResponse<ApiName extends keyof UIPassthroughContractBase> = Array<{
+        redId?: string;
+        value?: UIPassthroughResponse<ApiName>;
+        error?: any;
+    }>;
+    export type EmbedApiHostEventMapping = {
+        [HostEvent.Pin]: UIPassthroughEvent.PinAnswerToLiveboard;
+        [HostEvent.SaveAnswer]: UIPassthroughEvent.SaveAnswer;
+    };
+    export type HostEventRequest<HostEventT extends HostEvent> = HostEventT extends keyof EmbedApiHostEventMapping ? UIPassthroughRequest<EmbedApiHostEventMapping[HostEventT]> : any;
+    export type HostEventResponse<HostEventT extends HostEvent> = HostEventT extends keyof EmbedApiHostEventMapping ? UIPassthroughResponse<EmbedApiHostEventMapping[HostEventT]> : any;
+    export type TriggerPayload<PayloadT, HostEventT extends HostEvent> = PayloadT | HostEventRequest<HostEventT>;
+    export type TriggerResponse<PayloadT, HostEventT extends HostEvent> = PayloadT extends HostEventRequest<HostEventT> ? HostEventResponse<HostEventT> : any;
+}
+
 declare module '@thoughtspot/visual-embed-sdk/authToken' {
     import { EmbedConfig } from '@thoughtspot/visual-embed-sdk/types';
     /**
@@ -7158,8 +7257,10 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
         * @summary Base classes
         * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
         */
+    import { TriggerPayload, TriggerResponse, UIPassthroughArrayResponse, UIPassthroughEvent, UIPassthroughRequest } from '@thoughtspot/visual-embed-sdk/embed/hostEventClient/contracts';
     import { AnswerService } from '@thoughtspot/visual-embed-sdk/utils/graphql/answerService/answerService';
     import { DOMSelector, HostEvent, EmbedEvent, MessageCallback, EmbedConfig, MessageOptions, ViewConfig } from '@thoughtspot/visual-embed-sdk/types';
+    import { HostEventClient } from '@thoughtspot/visual-embed-sdk/embed/hostEventClient/host-event-client';
     /**
         * Global prefix for all Thoughtspot postHash Params.
         */
@@ -7191,6 +7292,11 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
                 * will be rendered.
                 */
             protected iFrame: HTMLIFrameElement;
+            /**
+                * Setter for the iframe element
+                * @param {HTMLIFrameElement} iFrame HTMLIFrameElement
+                */
+            protected setIframeElement(iFrame: HTMLIFrameElement): void;
             protected viewConfig: ViewConfig;
             protected embedConfig: EmbedConfig;
             /**
@@ -7202,6 +7308,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
                 * A flag that is set to true post render.
                 */
             protected isRendered: boolean;
+            protected hostEventClient: HostEventClient;
             constructor(domSelector: DOMSelector, viewConfig?: ViewConfig);
             /**
                 * Handles errors within the SDK
@@ -7321,10 +7428,19 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
             off(messageType: EmbedEvent, callback: MessageCallback): typeof TsEmbed.prototype;
             /**
                 * Triggers an event to the embedded app
-                * @param messageType The event type
-                * @param data The payload to send with the message
+                * @param {HostEvent} messageType The event type
+                * @param {any} data The payload to send with the message
+                * @returns A promise that resolves with the response from the embedded app
+                */
+            trigger<HostEventT extends HostEvent, PayloadT>(messageType: HostEventT, data?: TriggerPayload<PayloadT, HostEventT>): Promise<TriggerResponse<PayloadT, HostEventT>>;
+            /**
+                * Triggers an event to the embedded app, skipping the UI flow.
+                * @param {UIPassthroughEvent} apiName - The name of the API to be triggered.
+                * @param {UIPassthroughRequest} parameters - The parameters to be passed to the API.
+                * @returns {Promise<UIPassthroughRequest>} - A promise that resolves with the response
+                * from the embedded app.
                 */
-            trigger(messageType: HostEvent, data?: any): Promise<any>;
+            triggerUIPassThrough<UIPassthroughEventT extends UIPassthroughEvent>(apiName: UIPassthroughEventT, parameters: UIPassthroughRequest<UIPassthroughEventT>): Promise<UIPassthroughArrayResponse<UIPassthroughEventT>>;
             /**
                 * Marks the ThoughtSpot object to have been rendered
                 * Needs to be overridden by subclasses to do the actual
@@ -7398,7 +7514,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
             /**
                 * Returns the answerService which can be used to make arbitrary graphql calls on top
                 * session.
-                * @param vizId [Optional] to get for a specific viz in case of a liveboard.
+                * @param vizId [Optional] to get for a specific viz in case of a Liveboard.
                 * @version SDK: 1.25.0 / ThoughtSpot 9.10.0
                 */
             getAnswerService(vizId?: string): Promise<AnswerService>;
@@ -7444,3 +7560,30 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
     }
 }
 
+declare module '@thoughtspot/visual-embed-sdk/embed/hostEventClient/host-event-client' {
+    import { HostEvent } from '@thoughtspot/visual-embed-sdk/types';
+    import { UIPassthroughArrayResponse, UIPassthroughEvent, HostEventRequest, HostEventResponse, UIPassthroughRequest, UIPassthroughResponse, TriggerPayload, TriggerResponse } from '@thoughtspot/visual-embed-sdk/embed/hostEventClient/contracts';
+    export class HostEventClient {
+            iFrame: HTMLIFrameElement;
+            constructor(iFrame?: HTMLIFrameElement);
+            /**
+                * A wrapper over process trigger to
+                * @param {HostEvent} message Host event to send
+                * @param {any} data Data to send with the host event
+                * @returns {Promise<any>} - the response from the process trigger
+                */
+            protected processTrigger(message: HostEvent, data: any): Promise<any>;
+            handleHostEventWithParam<UIPassthroughEventT extends UIPassthroughEvent>(apiName: UIPassthroughEventT, parameters: UIPassthroughRequest<UIPassthroughEventT>): Promise<UIPassthroughResponse<UIPassthroughEventT>>;
+            hostEventFallback(hostEvent: HostEvent, data: any): Promise<any>;
+            /**
+                * Setter for the iframe element used for host events
+                * @param {HTMLIFrameElement} iFrame - the iframe element to set
+                */
+            setIframeElement(iFrame: HTMLIFrameElement): void;
+            triggerUIPassthroughApi<UIPassthroughEventT extends UIPassthroughEvent>(apiName: UIPassthroughEventT, parameters: UIPassthroughRequest<UIPassthroughEventT>): Promise<UIPassthroughArrayResponse<UIPassthroughEventT>>;
+            protected handlePinEvent(payload: HostEventRequest<HostEvent.Pin>): Promise<HostEventResponse<HostEvent.Pin>>;
+            protected handleSaveAnswerEvent(payload: HostEventRequest<HostEvent.SaveAnswer>): Promise<any>;
+            triggerHostEvent<HostEventT extends HostEvent, PayloadT>(hostEvent: HostEventT, payload?: TriggerPayload<PayloadT, HostEventT>): Promise<TriggerResponse<PayloadT, HostEventT>>;
+    }
+}
+

package/package.json

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

package/src/auth.spec.ts

@@ -125,6 +125,7 @@ describe('Unit test for auth', () => {
     afterEach(() => {
         authTokenService.resetCachedAuthToken();
         SessionService.resetCachedSessionInfo();
+        jest.resetAllMocks();
     });
     test('endpoints, SAML_LOGIN_TEMPLATE', () => {
         const ssoTemplateUrl = authService.EndPoints.SAML_LOGIN_TEMPLATE(thoughtSpotHost);
@@ -137,6 +138,8 @@ describe('Unit test for auth', () => {
         expect(sessionInfo.mixpanelToken).toEqual('prodKey');
         expect(sessionInfo.isPublicUser).toEqual(false);
         await SessionService.getSessionInfo();
+        const cachedInfo = SessionService.getCachedSessionInfo();
+        expect(cachedInfo).toEqual(sessionInfo);
         expect(tokenAuthService.fetchSessionInfoService).toHaveBeenCalledTimes(1);
     });
 
@@ -148,6 +151,16 @@ describe('Unit test for auth', () => {
         expect(mixPanelService.initMixpanel).not.toBeCalled();
     });
 
+    test('Log error is postLogin faild', async () => {
+        jest.spyOn(mixPanelService, 'initMixpanel');
+        jest.spyOn(SessionService, 'getSessionInfo').mockRejectedValueOnce(mockSessionInfo);
+        jest.spyOn(EmbedConfig, 'getEmbedConfig').mockReturnValue({ disableSDKTracking: true });
+        jest.spyOn(logger, 'error').mockResolvedValue(true);
+        await authInstance.postLoginService();
+        expect(mixPanelService.initMixpanel).not.toBeCalled();
+        expect(logger.error).toBeCalled();
+    });
+
     test('doCookielessTokenAuth: when authEndpoint and getAuthToken are not there, it throw error', async () => {
         try {
             await authInstance.doCookielessTokenAuth(

package/src/authToken.spec.ts

@@ -15,7 +15,7 @@ describe('AuthToken Unit tests', () => {
         expect(authServiceInstance.verifyTokenService).not.toBeCalled();
     });
 
-    test.only('getAuthenticationToken: When verification is enabled', async () => {
+    test('getAuthenticationToken: When verification is enabled', async () => {
         resetCachedAuthToken();
         jest.clearAllMocks();
         jest.spyOn(authServiceInstance, 'verifyTokenService').mockImplementation(() => true);

package/src/embed/app.ts

@@ -418,7 +418,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
      */
     showLiveboardVerifiedBadge?: boolean;
     /**
-     * This flag is used to enable/disable hide irrelevant filters in liveboard tab
+     * This flag is used to enable/disable hide irrelevant filters in Liveboard tab
      * @type {boolean}
      * @default false
      * @version SDK: 1.36.0 | ThoughtSpot:10.6.0.cl
@@ -627,10 +627,13 @@ export class AppEmbed extends V1Embed {
     };
 
     private setIframeHeightForNonEmbedLiveboard = (data: MessagePayload) => {
-        const { height: frameHeight, ...restParams } = this.viewConfig.frameParams || {};
-        if (!data.data.currentPath.startsWith('/pinboard/')) {
-            this.setIFrameHeight(frameHeight || this.defaultHeight);
+        if (
+            data.data.currentPath.startsWith('/embed/viz/')
+          || data.data.currentPath.startsWith('/embed/insights/viz/')
+        ) {
+            return;
         }
+        this.setIFrameHeight(this.defaultHeight);
     };
 
     /**

package/src/embed/base.ts

@@ -174,7 +174,7 @@ function backwardCompat(embedConfig: EmbedConfig): EmbedConfig {
 /**
  * Initializes the Visual Embed SDK globally and perform
  * authentication if applicable. This function needs to be called before any ThoughtSpot
- * component like liveboard etc can be embedded. But need not wait for AuthEvent.SUCCESS
+ * component like Liveboard etc can be embedded. But need not wait for AuthEvent.SUCCESS
  * to actually embed. That is handled internally.
  * @param embedConfig The configuration object containing ThoughtSpot host,
  * authentication mechanism and so on.

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

@@ -123,7 +123,6 @@ describe('BodylessConversation', () => {
 
         const conversationEmbed = new BodylessConversation(viewConfig);
         const result = await conversationEmbed.sendMessage('userMessage');
-        console.log(result.container);
         const iframeSrc = getIFrameSrc(result.container);
         expectUrlToHaveParamsWithValues(iframeSrc, {
             sessionId: 'sessionId',

package/src/embed/hostEventClient/contracts.ts

@@ -0,0 +1,105 @@
+import { HostEvent } from '../../types';
+
+export enum UIPassthroughEvent {
+  PinAnswerToLiveboard = 'addVizToPinboard',
+  SaveAnswer = 'saveAnswer',
+  GetDiscoverabilityStatus = 'getDiscoverabilityStatus',
+  GetAvailableUIPassthroughs = 'getAvailableUIPassthroughs',
+  GetAnswerConfig = 'getAnswerPageConfig',
+  GetLiveboardConfig = 'getPinboardPageConfig',
+}
+
+// UI Passthrough Contract
+export type UIPassthroughContractBase = {
+  [UIPassthroughEvent.PinAnswerToLiveboard]: {
+    request: {
+      vizId?: string;
+      newVizName: string;
+      newVizDescription?: string;
+      pinboardId?: string;
+      tabId?: string;
+      newPinboardName?: string;
+      newTabName?: string;
+    };
+    response: {
+      pinboardId: string;
+      tabId: string;
+      vizId: string;
+    };
+  };
+  [UIPassthroughEvent.SaveAnswer]: {
+    request: {
+      name: string;
+      description: string;
+      vizId?: string;
+      isDiscoverable?: boolean;
+    };
+    response: {
+      answerId: string,
+      saveResponse?: any;
+      shareResponse?: any;
+    };
+  };
+  [UIPassthroughEvent.GetDiscoverabilityStatus]: {
+    request: any;
+    response: {
+      shouldShowDiscoverability: boolean;
+      isDiscoverabilityCheckboxUnselectedPerOrg: boolean;
+    };
+  };
+  [UIPassthroughEvent.GetAvailableUIPassthroughs]: {
+    request: any;
+    response: {
+      keys: string[];
+    };
+  };
+  [UIPassthroughEvent.GetAnswerConfig]: {
+    request: {
+      vizId?: string;
+    };
+    response: any;
+  };
+  [UIPassthroughEvent.GetLiveboardConfig]: {
+    request: any;
+    response: any;
+  };
+};
+
+// UI Passthrough Request and Response
+export type UIPassthroughRequest<T
+  extends keyof UIPassthroughContractBase
+> = UIPassthroughContractBase[T]['request'];
+
+export type UIPassthroughResponse<
+  T extends keyof UIPassthroughContractBase
+> = UIPassthroughContractBase[T]['response'];
+
+export type UIPassthroughArrayResponse<ApiName extends keyof UIPassthroughContractBase> =
+  Array<{
+    redId?: string;
+    value?: UIPassthroughResponse<ApiName>;
+    error?: any;
+  }>
+
+// Host event and UI Passthrough Event Mapping
+export type EmbedApiHostEventMapping = {
+  [HostEvent.Pin]: UIPassthroughEvent.PinAnswerToLiveboard;
+  [HostEvent.SaveAnswer]: UIPassthroughEvent.SaveAnswer;
+}
+
+// Host Event Request and Response
+export type HostEventRequest<HostEventT extends HostEvent> =
+  HostEventT extends keyof EmbedApiHostEventMapping
+    ? UIPassthroughRequest<EmbedApiHostEventMapping[HostEventT]>
+    : any;
+
+export type HostEventResponse<HostEventT extends HostEvent> =
+  HostEventT extends keyof EmbedApiHostEventMapping
+    ? UIPassthroughResponse<EmbedApiHostEventMapping[HostEventT]>
+    : any;
+
+// trigger response and request
+export type TriggerPayload<PayloadT, HostEventT extends HostEvent> =
+  PayloadT | HostEventRequest<HostEventT>;
+export type TriggerResponse<PayloadT, HostEventT extends HostEvent> =
+  PayloadT extends HostEventRequest<HostEventT> ? HostEventResponse<HostEventT> : any;