@thoughtspot/visual-embed-sdk 1.35.3 → 1.35.5-hostEvent.1

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';
 }
 
@@ -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
@@ -1056,7 +1058,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,
@@ -3466,8 +3468,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
@@ -4948,7 +4950,17 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```
                 * @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.34.0 | Thoughtspot: 10.6.0.cl
+                */
+            SaveAnswer = "saveAnswer",
+            /**
+                * EmbedApi
+                * @hidden
+                */
+            UiPassthrough = "UiPassthrough"
     }
     /**
         * The different visual modes that the data sources panel within
@@ -7131,6 +7143,105 @@ 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 {
+        addVizToPinboard = "addVizToPinboard",
+        saveAnswer = "saveAnswer",
+        getA3AnalysisColumns = "getA3AnalysisColumns",
+        getDiscoverabilityStatus = "getDiscoverabilityStatus",
+        getAvailableUiPassthroughs = "getAvailableUiPassthroughs",
+        getAnswerPageConfig = "getAnswerPageConfig",
+        getPinboardPageConfig = "getPinboardPageConfig",
+        UiPassthroughEventNotFound = "UiPassthroughEventNotFound"
+    }
+    export type UiPassthroughContractBase = {
+        [UiPassthroughEvent.addVizToPinboard]: {
+            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;
+                errors?: any;
+            };
+        };
+        [UiPassthroughEvent.getA3AnalysisColumns]: {
+            request: {
+                vizId?: string;
+            };
+            response: {
+                data?: any;
+                errors?: any;
+            };
+        };
+        [UiPassthroughEvent.getDiscoverabilityStatus]: {
+            request: any;
+            response: {
+                shouldShowDiscoverability: boolean;
+                isDiscoverabilityCheckboxUnselectedPerOrg: boolean;
+            };
+        };
+        [UiPassthroughEvent.getAvailableUiPassthroughs]: {
+            request: any;
+            response: {
+                keys: string[];
+            };
+        };
+        [UiPassthroughEvent.getAnswerPageConfig]: {
+            request: {
+                vizId?: string;
+            };
+            response: any;
+        };
+        [UiPassthroughEvent.getPinboardPageConfig]: {
+            request: any;
+            response: any;
+        };
+        [UiPassthroughEvent.UiPassthroughEventNotFound]: {
+            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> = Promise<Array<{
+        redId?: string;
+        value?: UiPassthroughResponse<ApiName>;
+        error?: any;
+    }>>;
+    export type EmbedApiHostEventMapping = {
+        [HostEvent.Pin]: UiPassthroughEvent.addVizToPinboard;
+        [HostEvent.SaveAnswer]: UiPassthroughEvent.saveAnswer;
+        'hostEventNotMapped': UiPassthroughEvent.UiPassthroughEventNotFound;
+    };
+    export type FlattenType<T> = T extends infer R ? {
+        [K in keyof R]: R[K];
+    } : never;
+    export type HostEventRequest<HostEventT extends HostEvent> = HostEventT extends keyof EmbedApiHostEventMapping ? FlattenType<UiPassthroughRequest<EmbedApiHostEventMapping[HostEventT]>> : any;
+    export type HostEventResponse<HostEventT extends HostEvent> = HostEventT extends keyof EmbedApiHostEventMapping ? {
+        value?: UiPassthroughResponse<EmbedApiHostEventMapping[HostEventT]>;
+    } : any;
+}
+
 declare module '@thoughtspot/visual-embed-sdk/authToken' {
     import { EmbedConfig } from '@thoughtspot/visual-embed-sdk/types';
     /**
@@ -7158,8 +7269,10 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
         * @summary Base classes
         * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
         */
+    import { HostEventRequest, HostEventResponse } 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, UiPassthroughHandler } from '@thoughtspot/visual-embed-sdk/embed/hostEventClient/host-event-client';
     /**
         * Global prefix for all Thoughtspot postHash Params.
         */
@@ -7202,6 +7315,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
@@ -7323,8 +7437,17 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
                 * Triggers an event to the embedded app
                 * @param messageType The event type
                 * @param data The payload to send with the message
+                * @returns A promise that resolves with the response from the embedded app
+                */
+            trigger<HostEventT extends HostEvent>(messageType: HostEventT, data?: HostEventRequest<HostEventT>): Promise<HostEventResponse<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: UiPassthroughHandler;
             /**
                 * Marks the ThoughtSpot object to have been rendered
                 * Needs to be overridden by subclasses to do the actual
@@ -7444,3 +7567,19 @@ 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, FlattenType } from '@thoughtspot/visual-embed-sdk/embed/hostEventClient/contracts';
+    type UiPassthroughHandlerWithIframe = <UiPassthroughEventT extends UiPassthroughEvent>(iFrame: HTMLIFrameElement, apiName: UiPassthroughEventT, parameters: FlattenType<UiPassthroughRequest<UiPassthroughEventT>>) => UiPassthroughArrayResponse<UiPassthroughEventT>;
+    export type UiPassthroughHandler = <UiPassthroughEventT extends UiPassthroughEvent>(apiName: UiPassthroughEventT, parameters: FlattenType<UiPassthroughRequest<UiPassthroughEventT>>) => UiPassthroughArrayResponse<UiPassthroughEventT>;
+    export class HostEventClient {
+        thoughtSpotHost: string;
+        constructor(thoughtSpotHost: string);
+        executeUiPassthroughApi: UiPassthroughHandlerWithIframe;
+        handleUiPassthroughForHostEvent: UiPassthroughHandlerWithIframe;
+        hostEventFallback(iFrame: HTMLIFrameElement, hostEvent: HostEvent, data: any): Promise<any>;
+        executeHostEvent<T extends HostEvent>(iFrame: HTMLIFrameElement, hostEvent: HostEvent, payload?: HostEventRequest<T>): Promise<HostEventResponse<HostEvent>>;
+    }
+    export {};
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thoughtspot/visual-embed-sdk",
-    "version": "1.35.3",
+    "version": "1.35.5-hostEvent.1",
     "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/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,108 @@
+import { HostEvent } from '../../types';
+
+export enum UiPassthroughEvent {
+  addVizToPinboard = 'addVizToPinboard',
+  saveAnswer = 'saveAnswer',
+  getA3AnalysisColumns = 'getA3AnalysisColumns',
+  getDiscoverabilityStatus = 'getDiscoverabilityStatus',
+  getAvailableUiPassthroughs = 'getAvailableUiPassthroughs',
+  getAnswerPageConfig = 'getAnswerPageConfig',
+  getPinboardPageConfig = 'getPinboardPageConfig',
+  UiPassthroughEventNotFound = 'UiPassthroughEventNotFound',
+}
+
+export type UiPassthroughContractBase = {
+  [UiPassthroughEvent.addVizToPinboard]: {
+    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,
+      errors?: any;
+    };
+  };
+  [UiPassthroughEvent.getA3AnalysisColumns]: {
+    request: {
+      vizId?: string;
+    };
+    response: {
+      data?: any;
+      errors?: any;
+    };
+  };
+  [UiPassthroughEvent.getDiscoverabilityStatus]: {
+    request: any;
+    response: {
+      shouldShowDiscoverability: boolean;
+      isDiscoverabilityCheckboxUnselectedPerOrg: boolean;
+    };
+  };
+  [UiPassthroughEvent.getAvailableUiPassthroughs]: {
+    request: any;
+    response: {
+      keys: string[];
+    };
+  };
+  [UiPassthroughEvent.getAnswerPageConfig]: {
+    request: {
+      vizId?: string;
+    };
+    response: any;
+  };
+  [UiPassthroughEvent.getPinboardPageConfig]: {
+    request: any;
+    response: any;
+  };
+  [UiPassthroughEvent.UiPassthroughEventNotFound]: {
+    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> =
+  Promise<Array<{
+    redId?: string;
+    value?: UiPassthroughResponse<ApiName>;
+    error?: any;
+  }>>
+
+export type EmbedApiHostEventMapping = {
+  [HostEvent.Pin]: UiPassthroughEvent.addVizToPinboard;
+  [HostEvent.SaveAnswer]: UiPassthroughEvent.saveAnswer;
+  'hostEventNotMapped': UiPassthroughEvent.UiPassthroughEventNotFound;
+}
+
+export type FlattenType<T> = T extends infer R ? { [K in keyof R]: R[K] } : never;
+
+export type HostEventRequest<HostEventT extends HostEvent> =
+  HostEventT extends keyof EmbedApiHostEventMapping ?
+  FlattenType<UiPassthroughRequest<EmbedApiHostEventMapping[HostEventT]>> : any;
+
+export type HostEventResponse<HostEventT extends HostEvent> =
+  HostEventT extends keyof EmbedApiHostEventMapping ?
+  {
+    value?: UiPassthroughResponse<EmbedApiHostEventMapping[HostEventT]>
+  }
+  : any;

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

@@ -0,0 +1,234 @@
+import { getIFrameEl } from '../../test/test-utils';
+import { HostEvent } from '../../types';
+import { processTrigger } from '../../utils/processTrigger';
+import {
+    UiPassthroughEvent,
+    UiPassthroughRequest,
+    UiPassthroughArrayResponse,
+    HostEventRequest,
+} from './contracts';
+import { HostEventClient } from './host-event-client';
+
+jest.mock('../../utils/processTrigger');
+
+const mockProcessTrigger = processTrigger as jest.Mock;
+
+const createHostEventClient = () => {
+    const mockIframe = getIFrameEl();
+    const mockThoughtSpotHost = 'http://localhost';
+    const client = new HostEventClient(mockThoughtSpotHost);
+    return { client, mockIframe, mockThoughtSpotHost };
+};
+
+describe('HostEventClient', () => {
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+
+    describe('executeUiPassthroughApi', () => {
+        it('should call processTrigger with correct parameters and return response', async () => {
+            const { client, mockIframe, mockThoughtSpotHost } = createHostEventClient();
+
+            const apiName = UiPassthroughEvent.addVizToPinboard;
+            const parameters: UiPassthroughRequest<typeof apiName> = {
+                newVizName: 'testViz',
+            };
+            const triggerResponse = Promise.resolve([
+                { value: { pinboardId: 'testPinboard', tabId: 'testTab', vizId: 'testVizId' } },
+            ]);
+
+            mockProcessTrigger.mockResolvedValue(triggerResponse);
+
+            const result = await client.executeUiPassthroughApi(getIFrameEl(), apiName, parameters);
+
+            expect(mockProcessTrigger).toHaveBeenCalledWith(
+                mockIframe,
+                HostEvent.UiPassthrough,
+                mockThoughtSpotHost,
+                {
+                    type: apiName,
+                    parameters,
+                },
+            );
+            expect(result).toEqual(await triggerResponse);
+        });
+    });
+
+    describe('handleUiPassthroughForHostEvent', () => {
+        it('should return the value from the first valid response', async () => {
+            const { client } = createHostEventClient();
+            const apiName = UiPassthroughEvent.addVizToPinboard;
+            const parameters: UiPassthroughRequest<typeof apiName> = {
+                newVizName: 'testViz',
+            };
+            const triggerResponse = Promise.resolve([
+                { value: { pinboardId: 'testPinboard', tabId: 'testTab', vizId: 'testVizId' } },
+            ]);
+            mockProcessTrigger.mockResolvedValue(triggerResponse);
+
+            const result = await client.handleUiPassthroughForHostEvent(getIFrameEl(),
+                apiName, parameters);
+
+            expect(result).toEqual({
+                pinboardId: 'testPinboard',
+                tabId: 'testTab',
+                vizId: 'testVizId',
+            });
+        });
+
+        it('should throw an error if no valid response is found', async () => {
+            const { client } = createHostEventClient();
+            const apiName = UiPassthroughEvent.addVizToPinboard;
+            const parameters: UiPassthroughRequest<typeof apiName> = {
+                newVizName: 'testViz',
+            };
+            const triggerResponse: UiPassthroughArrayResponse<typeof apiName> = Promise.resolve([]);
+            mockProcessTrigger.mockResolvedValue(triggerResponse);
+
+            await expect(client.handleUiPassthroughForHostEvent(getIFrameEl(), apiName, parameters))
+                .rejects.toEqual({ error: 'No answer found.' });
+        });
+
+        it('should throw an error if no valid response is found for vizId', async () => {
+            const { client } = createHostEventClient();
+            const apiName = UiPassthroughEvent.addVizToPinboard;
+            const parameters: UiPassthroughRequest<typeof apiName> = {
+                newVizName: 'testViz',
+                vizId: 'testVizId',
+            };
+            const triggerResponse: UiPassthroughArrayResponse<typeof apiName> = Promise.resolve([]);
+            mockProcessTrigger.mockResolvedValue(triggerResponse);
+
+            await expect(client.handleUiPassthroughForHostEvent(getIFrameEl(), apiName, parameters))
+                .rejects.toEqual({ error: 'No answer found for vizId: testVizId.' });
+        });
+
+        it('should throw an error if the response contains errors', async () => {
+            const { client } = createHostEventClient();
+            const apiName = UiPassthroughEvent.addVizToPinboard;
+            const parameters: UiPassthroughRequest<typeof apiName> = {
+                newVizName: 'testViz',
+            };
+            const triggerResponse: UiPassthroughArrayResponse<typeof apiName> = Promise.resolve([
+                { error: 'Some error' },
+            ]);
+            mockProcessTrigger.mockResolvedValue(triggerResponse);
+
+            await expect(client.handleUiPassthroughForHostEvent(getIFrameEl(), apiName, parameters))
+                .rejects.toEqual({ error: 'Some error' });
+        });
+    });
+
+    describe('executeHostEvent', () => {
+        it('should call handleUiPassthroughForHostEvent for Pin event', async () => {
+            const { client } = createHostEventClient();
+            const hostEvent = HostEvent.Pin;
+            const payload: HostEventRequest<typeof hostEvent> = {
+                newVizName: 'testViz',
+            };
+            const mockResponse = {
+                value: {
+                    pinboardId: 'testPinboard',
+                    tabId: 'testTab',
+                    vizId: 'testVizId',
+                },
+            };
+
+            mockProcessTrigger.mockResolvedValue([mockResponse]);
+
+            const result = await client.executeHostEvent(getIFrameEl(), hostEvent, payload);
+
+            expect(mockProcessTrigger).toHaveBeenCalledWith(
+                getIFrameEl(),
+                HostEvent.UiPassthrough,
+                'http://localhost',
+                { parameters: payload, type: UiPassthroughEvent.addVizToPinboard },
+            );
+            expect(result).toEqual(mockResponse.value);
+        });
+
+        it('should call handleUiPassthroughForHostEvent for SaveAnswer event', async () => {
+            const { client } = createHostEventClient();
+            const hostEvent = HostEvent.SaveAnswer;
+            const payload: HostEventRequest<typeof hostEvent> = {
+                name: 'Test Answer',
+                description: 'Test Description',
+                vizId: 'testVizId',
+            };
+            const mockResponse = { answerId: 'testAnswerId' };
+            jest.spyOn(client, 'handleUiPassthroughForHostEvent').mockResolvedValue(mockResponse);
+
+            const result = await client.executeHostEvent(getIFrameEl(), hostEvent, payload);
+
+            expect(client.handleUiPassthroughForHostEvent).toHaveBeenCalledWith(
+                null,
+                UiPassthroughEvent.saveAnswer,
+                payload,
+            );
+            expect(result).toEqual(mockResponse);
+        });
+
+        it('should call hostEventFallback for unmapped events', async () => {
+            const { client } = createHostEventClient();
+            const hostEvent = 'testEvent' as HostEvent;
+            const payload = { data: 'testData' };
+            const mockResponse = { fallbackResponse: 'data' };
+            jest.spyOn(client, 'hostEventFallback').mockResolvedValue(mockResponse);
+
+            const result = await client.executeHostEvent(getIFrameEl(), hostEvent, payload);
+
+            expect(client.hostEventFallback).toHaveBeenCalledWith(null, hostEvent, payload);
+            expect(result).toEqual(mockResponse);
+        });
+
+        it('should call fallback  for Pin event', async () => {
+            const { client } = createHostEventClient();
+            const hostEvent = HostEvent.Pin;
+            const payload: HostEventRequest<typeof hostEvent> = {} as any;
+            const mockResponse = {
+                value: {
+                    pinboardId: 'testPinboard',
+                    tabId: 'testTab',
+                    vizId: 'testVizId',
+                },
+            };
+
+            mockProcessTrigger.mockResolvedValue([mockResponse]);
+
+            const result = await client.executeHostEvent(getIFrameEl(), hostEvent, payload);
+
+            expect(mockProcessTrigger).toHaveBeenCalledWith(
+                getIFrameEl(),
+                HostEvent.Pin,
+                'http://localhost',
+                {},
+            );
+            expect(result).toEqual([mockResponse]);
+        });
+
+        it('should call fallback for SaveAnswer event', async () => {
+            const { client } = createHostEventClient();
+            const hostEvent = HostEvent.SaveAnswer;
+            const payload: HostEventRequest<typeof hostEvent> = {} as any;
+            const mockResponse = {
+                value: {
+                    pinboardId: 'testPinboard',
+                    tabId: 'testTab',
+                    vizId: 'testVizId',
+                },
+            };
+
+            mockProcessTrigger.mockResolvedValue([mockResponse]);
+
+            const result = await client.executeHostEvent(getIFrameEl(), hostEvent, payload);
+
+            expect(mockProcessTrigger).toHaveBeenCalledWith(
+                getIFrameEl(),
+                HostEvent.Save,
+                'http://localhost',
+                {},
+            );
+            expect(result).toEqual([mockResponse]);
+        });
+    });
+});