@thoughtspot/visual-embed-sdk 1.46.4 → 1.46.5

package/src/embed/conversation.spec.ts

@@ -2,13 +2,16 @@ import { SpotterEmbed, SpotterEmbedViewConfig, ConversationEmbed } from './conve
 import { TsEmbed } from './ts-embed';
 import * as authInstance from '../auth';
 import { Action, init } from '../index';
-import { AuthType, Param, RuntimeFilterOp, ErrorDetailsTypes, EmbedErrorCodes  } from '../types';
+import { AuthType, Param, RuntimeFilterOp, ErrorDetailsTypes, EmbedErrorCodes, EmbedEvent } from '../types';
 import {
     getDocumentBody,
     getIFrameSrc,
+    getIFrameEl,
     getRootEl,
     defaultParamsWithoutHiddenActions as defaultParams,
     expectUrlMatchesWithParams,
+    postMessageToParent,
+    executeAfterWait,
 } from '../test/test-utils';
 import { ERROR_MESSAGE } from '../errors';
 
@@ -289,81 +292,6 @@ describe('ConversationEmbed', () => {
         );
     });
 
-    it('should render the conversation embed with past conversations sidebar enabled', async () => {
-        const viewConfig: SpotterEmbedViewConfig = {
-            worksheetId: 'worksheetId',
-            searchOptions: {
-                searchQuery: 'searchQuery',
-            },
-            spotterSidebarConfig: {
-                enablePastConversationsSidebar: true,
-            },
-        };
-
-        const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
-        await conversationEmbed.render();
-        expectUrlMatchesWithParams(
-            getIFrameSrc(),
-            `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true&enablePastConversationsSidebar=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
-        );
-    });
-
-    it('should render the conversation embed with past conversations sidebar disabled', async () => {
-        const viewConfig: SpotterEmbedViewConfig = {
-            worksheetId: 'worksheetId',
-            searchOptions: {
-                searchQuery: 'searchQuery',
-            },
-            spotterSidebarConfig: {
-                enablePastConversationsSidebar: false,
-            },
-        };
-
-        const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
-        await conversationEmbed.render();
-        expectUrlMatchesWithParams(
-            getIFrameSrc(),
-            `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true&enablePastConversationsSidebar=false#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
-        );
-    });
-
-    it('should render the conversation embed with deprecated standalone enablePastConversationsSidebar flag', async () => {
-        const viewConfig: SpotterEmbedViewConfig = {
-            worksheetId: 'worksheetId',
-            searchOptions: {
-                searchQuery: 'searchQuery',
-            },
-            enablePastConversationsSidebar: true,
-        };
-
-        const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
-        await conversationEmbed.render();
-        expectUrlMatchesWithParams(
-            getIFrameSrc(),
-            `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true&enablePastConversationsSidebar=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
-        );
-    });
-
-    it('should prefer spotterSidebarConfig.enablePastConversationsSidebar over deprecated standalone flag', async () => {
-        const viewConfig: SpotterEmbedViewConfig = {
-            worksheetId: 'worksheetId',
-            searchOptions: {
-                searchQuery: 'searchQuery',
-            },
-            enablePastConversationsSidebar: false,
-            spotterSidebarConfig: {
-                enablePastConversationsSidebar: true,
-            },
-        };
-
-        const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
-        await conversationEmbed.render();
-        expectUrlMatchesWithParams(
-            getIFrameSrc(),
-            `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true&enablePastConversationsSidebar=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
-        );
-    });
-
     it('should render the conversation embed with all boolean flags set', async () => {
         const viewConfig: SpotterEmbedViewConfig = {
             worksheetId: 'worksheetId',
@@ -375,16 +303,13 @@ describe('ConversationEmbed', () => {
             dataPanelV2: true,
             showSpotterLimitations: true,
             hideSampleQuestions: true,
-            spotterSidebarConfig: {
-                enablePastConversationsSidebar: true,
-            },
         };
 
         const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
         await conversationEmbed.render();
         expectUrlMatchesWithParams(
             getIFrameSrc(),
-            `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true&disableSourceSelection=true&hideSourceSelection=true&enableDataPanelV2=true&showSpotterLimitations=true&hideSampleQuestions=true&enablePastConversationsSidebar=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
+            `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true&disableSourceSelection=true&hideSourceSelection=true&enableDataPanelV2=true&showSpotterLimitations=true&hideSampleQuestions=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
         );
     });
 
@@ -484,73 +409,179 @@ describe('ConversationEmbed', () => {
         );
     });
 
-    describe('spotter sidebar config params', () => {
+    describe('spotter chat hiddenActions', () => {
         it.each([
-            ['enablePastConversationsSidebar', true, 'enablePastConversationsSidebar=true'],
-            ['spotterSidebarTitle', 'My Conversations', 'spotterSidebarTitle=My%20Conversations'],
-            ['spotterSidebarDefaultExpanded', true, 'spotterSidebarDefaultExpanded=true'],
-            ['spotterChatRenameLabel', 'Edit Name', 'spotterChatRenameLabel=Edit%20Name'],
-            ['spotterChatDeleteLabel', 'Remove', 'spotterChatDeleteLabel=Remove'],
-            ['spotterDeleteConversationModalTitle', 'Remove Conversation', 'spotterDeleteConversationModalTitle=Remove%20Conversation'],
-            ['spotterPastConversationAlertMessage', 'Viewing past conversation', 'spotterPastConversationAlertMessage=Viewing%20past%20conversation'],
-            ['spotterBestPracticesLabel', 'Help Tips', 'spotterBestPracticesLabel=Help%20Tips'],
-            ['spotterConversationsBatchSize', 50, 'spotterConversationsBatchSize=50'],
-            ['spotterNewChatButtonTitle', 'Start New Conversation', 'spotterNewChatButtonTitle=Start%20New%20Conversation'],
-            ['spotterDocumentationUrl', 'https://docs.example.com/spotter', 'spotterDocumentationUrl=https%3A%2F%2Fdocs.example.com%2Fspotter'],
-        ])('should render with spotterSidebarConfig.%s', async (configKey, configValue, expectedParam) => {
+            ['SpotterChatConnectorResources', Action.SpotterChatConnectorResources],
+            ['SpotterChatConnectors', Action.SpotterChatConnectors],
+            ['SpotterChatModeSwitcher', Action.SpotterChatModeSwitcher],
+        ])('should render with hiddenActions for %s', async (_, action) => {
             const viewConfig: SpotterEmbedViewConfig = {
                 worksheetId: 'worksheetId',
-                spotterSidebarConfig: {
-                    [configKey]: configValue,
-                },
+                searchOptions: { searchQuery: 'searchQuery' },
+                hiddenActions: [action],
+            };
+            const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
+            await conversationEmbed.render();
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/v2/?${defaultParams}&hideAction=[%22${Action.ReportError}%22,%22${action}%22]&isSpotterExperienceEnabled=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
+            );
+        });
+
+        it('should render with multiple spotter chat actions hidden together', async () => {
+            const viewConfig: SpotterEmbedViewConfig = {
+                worksheetId: 'worksheetId',
+                searchOptions: { searchQuery: 'searchQuery' },
+                hiddenActions: [
+                    Action.SpotterChatConnectorResources,
+                    Action.SpotterChatConnectors,
+                    Action.SpotterChatModeSwitcher,
+                ],
             };
             const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
             await conversationEmbed.render();
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true&${expectedParam}#/embed/insights/conv-assist?worksheet=worksheetId&query=`,
+                `http://${thoughtSpotHost}/v2/?${defaultParams}&hideAction=[%22${Action.ReportError}%22,%22${Action.SpotterChatConnectorResources}%22,%22${Action.SpotterChatConnectors}%22,%22${Action.SpotterChatModeSwitcher}%22]&isSpotterExperienceEnabled=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
             );
         });
+    });
 
+    describe('spotter chat disabledActions', () => {
         it.each([
-            ['invalid URL format', 'invalid-url'],
-            ['invalid protocol (ftp)', 'ftp://docs.example.com/spotter'],
-        ])('should handle error for spotterSidebarConfig.spotterDocumentationUrl with %s', async (_, invalidUrl) => {
+            ['SpotterChatConnectorResources', Action.SpotterChatConnectorResources],
+            ['SpotterChatConnectors', Action.SpotterChatConnectors],
+            ['SpotterChatModeSwitcher', Action.SpotterChatModeSwitcher],
+        ])('should render with disabledActions for %s', async (_, action) => {
+            const disabledReason = 'testing disabled reason';
             const viewConfig: SpotterEmbedViewConfig = {
                 worksheetId: 'worksheetId',
-                spotterSidebarConfig: {
-                    spotterDocumentationUrl: invalidUrl,
-                },
+                searchOptions: { searchQuery: 'searchQuery' },
+                disabledActions: [action],
+                disabledActionReason: disabledReason,
             };
             const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
-            (conversationEmbed as any).handleError = jest.fn();
             await conversationEmbed.render();
-            expect((conversationEmbed as any).handleError).toHaveBeenCalledWith(
-                expect.objectContaining({
-                    errorType: ErrorDetailsTypes.VALIDATION_ERROR,
-                    message: ERROR_MESSAGE.INVALID_SPOTTER_DOCUMENTATION_URL,
-                    code: EmbedErrorCodes.INVALID_URL,
-                }),
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/v2/?${defaultParams}&${Param.DisableActions}=[%22${action}%22]&${Param.DisableActionReason}=${disabledReason}&isSpotterExperienceEnabled=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
             );
         });
 
-        it('should render with multiple spotterSidebarConfig options', async () => {
+        it('should render with multiple spotter chat actions disabled together', async () => {
+            const disabledReason = 'not available';
             const viewConfig: SpotterEmbedViewConfig = {
                 worksheetId: 'worksheetId',
-                spotterSidebarConfig: {
-                    enablePastConversationsSidebar: true,
-                    spotterSidebarTitle: 'Chats',
-                    spotterSidebarDefaultExpanded: true,
-                    spotterNewChatButtonTitle: 'New',
-                    spotterConversationsBatchSize: 25,
-                },
+                searchOptions: { searchQuery: 'searchQuery' },
+                disabledActions: [
+                    Action.SpotterChatConnectorResources,
+                    Action.SpotterChatConnectors,
+                    Action.SpotterChatModeSwitcher,
+                ],
+                disabledActionReason: disabledReason,
             };
             const conversationEmbed = new SpotterEmbed(getRootEl(), viewConfig);
             await conversationEmbed.render();
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true&enablePastConversationsSidebar=true&spotterSidebarDefaultExpanded=true&spotterSidebarTitle=Chats&spotterConversationsBatchSize=25&spotterNewChatButtonTitle=New#/embed/insights/conv-assist?worksheet=worksheetId&query=`,
+                `http://${thoughtSpotHost}/v2/?${defaultParams}&${Param.DisableActions}=[%22${Action.SpotterChatConnectorResources}%22,%22${Action.SpotterChatConnectors}%22,%22${Action.SpotterChatModeSwitcher}%22]&${Param.DisableActionReason}=${disabledReason}&isSpotterExperienceEnabled=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
             );
         });
     });
+
 });
+
+describe('SpotterEmbed APP_INIT embedParams', () => {
+    const mockEmbedEventPayload = { type: EmbedEvent.APP_INIT, data: {} };
+
+    async function getAppInitResponse(viewConfig: SpotterEmbedViewConfig) {
+        const embed = new SpotterEmbed(getRootEl(), viewConfig);
+        embed.render();
+        const mockPort: any = { postMessage: jest.fn() };
+        await executeAfterWait(() => {
+            postMessageToParent(getIFrameEl().contentWindow, mockEmbedEventPayload, mockPort);
+        });
+        await executeAfterWait(() => {});
+        return mockPort.postMessage.mock.calls[0]?.[0];
+    }
+
+    it('should include spotterSidebarConfig in embedParams when spotterSidebarConfig is provided', async () => {
+        const response = await getAppInitResponse({
+            worksheetId: 'ws1',
+            spotterSidebarConfig: {
+                enablePastConversationsSidebar: true,
+                spotterSidebarTitle: 'My Conversations',
+                spotterSidebarDefaultExpanded: true,
+            },
+        });
+        expect(response.data.embedParams.spotterSidebarConfig).toEqual({
+            enablePastConversationsSidebar: true,
+            spotterSidebarTitle: 'My Conversations',
+            spotterSidebarDefaultExpanded: true,
+        });
+    });
+
+    it('should populate enablePastConversationsSidebar from deprecated standalone flag', async () => {
+        const response = await getAppInitResponse({
+            worksheetId: 'ws1',
+            enablePastConversationsSidebar: true,
+        });
+        expect(response.data.embedParams.spotterSidebarConfig).toEqual({
+            enablePastConversationsSidebar: true,
+        });
+    });
+
+    it('should use spotterSidebarConfig.enablePastConversationsSidebar over deprecated standalone flag', async () => {
+        const response = await getAppInitResponse({
+            worksheetId: 'ws1',
+            enablePastConversationsSidebar: false,
+            spotterSidebarConfig: {
+                enablePastConversationsSidebar: true,
+                spotterSidebarTitle: 'Chats',
+            },
+        });
+        expect(response.data.embedParams.spotterSidebarConfig.enablePastConversationsSidebar).toBe(true);
+        expect(response.data.embedParams.spotterSidebarConfig.spotterSidebarTitle).toBe('Chats');
+    });
+
+    it('should fall back to deprecated standalone flag when spotterSidebarConfig omits enablePastConversationsSidebar', async () => {
+        const response = await getAppInitResponse({
+            worksheetId: 'ws1',
+            enablePastConversationsSidebar: true,
+            spotterSidebarConfig: {
+                spotterSidebarTitle: 'My Chats',
+            },
+        });
+        expect(response.data.embedParams.spotterSidebarConfig.enablePastConversationsSidebar).toBe(true);
+        expect(response.data.embedParams.spotterSidebarConfig.spotterSidebarTitle).toBe('My Chats');
+    });
+
+    it('should not include embedParams when neither spotterSidebarConfig nor standalone flag is set', async () => {
+        const response = await getAppInitResponse({ worksheetId: 'ws1' });
+        expect(response.data.embedParams).toBeUndefined();
+    });
+
+    it('should call handleError and exclude spotterDocumentationUrl from embedParams when URL is invalid', async () => {
+        const embed = new SpotterEmbed(getRootEl(), {
+            worksheetId: 'ws1',
+            spotterSidebarConfig: { spotterDocumentationUrl: 'invalid-url' },
+        });
+        (embed as any).handleError = jest.fn();
+        embed.render();
+        const mockPort: any = { postMessage: jest.fn() };
+        await executeAfterWait(() => {
+            postMessageToParent(getIFrameEl().contentWindow, mockEmbedEventPayload, mockPort);
+        });
+        await executeAfterWait(() => {});
+        expect((embed as any).handleError).toHaveBeenCalledWith(
+            expect.objectContaining({
+                errorType: ErrorDetailsTypes.VALIDATION_ERROR,
+                message: ERROR_MESSAGE.INVALID_SPOTTER_DOCUMENTATION_URL,
+                code: EmbedErrorCodes.INVALID_URL,
+            }),
+        );
+        expect(mockPort.postMessage.mock.calls[0]?.[0].data.embedParams?.spotterSidebarConfig?.spotterDocumentationUrl).toBeUndefined();
+    });
+
+});
+

package/src/embed/conversation.ts

@@ -1,8 +1,9 @@
 import isUndefined from 'lodash/isUndefined';
 import { ERROR_MESSAGE } from '../errors';
-import { Param, BaseViewConfig, RuntimeFilter, RuntimeParameter, ErrorDetailsTypes, EmbedErrorCodes } from '../types';
+import { Param, BaseViewConfig, RuntimeFilter, RuntimeParameter, ErrorDetailsTypes, EmbedErrorCodes, DefaultAppInitData } from '../types';
 import { TsEmbed } from './ts-embed';
-import { getQueryParamString, getFilterQuery, getRuntimeParameters, validateHttpUrl, setParamIfDefined, resolveEnablePastConversationsSidebar } from '../utils';
+import { buildSpotterSidebarAppInitData } from './spotter-utils';
+import { getQueryParamString, getFilterQuery, getRuntimeParameters, setParamIfDefined } from '../utils';
 
 /**
  * Configuration for search options
@@ -343,6 +344,16 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface ConversationViewConfig extends SpotterEmbedViewConfig {}
 
+/**
+ * APP_INIT data shape for SpotterEmbed.
+ * @internal
+ */
+export interface SpotterAppInitData extends DefaultAppInitData {
+    embedParams?: {
+        spotterSidebarConfig?: SpotterSidebarViewConfig;
+    };
+}
+
 /**
  * Embed ThoughtSpot AI Conversation.
  * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
@@ -369,6 +380,23 @@ export class SpotterEmbed extends TsEmbed {
         super(container, viewConfig);
     }
 
+    /**
+     * Extends the default APP_INIT payload with `embedParams.spotterSidebarConfig`
+     * so the conv-assist app can read sidebar configuration on initialisation.
+     *
+     * Precedence for `enablePastConversationsSidebar`:
+     * `spotterSidebarConfig.enablePastConversationsSidebar` wins over the
+     * deprecated top-level `enablePastConversationsSidebar` flag; if the former
+     * is absent the latter is used as a fallback.
+     *
+     * An invalid `spotterDocumentationUrl` triggers a validation error and is
+     * excluded from the payload rather than forwarded to the app.
+     */
+    protected async getAppInitData(): Promise<SpotterAppInitData> {
+        const defaultAppInitData = await super.getAppInitData();
+        return buildSpotterSidebarAppInitData(defaultAppInitData, this.viewConfig, this.handleError.bind(this));
+    }
+
     protected getEmbedParamsObject() {
         const {
             worksheetId,
@@ -383,29 +411,9 @@ export class SpotterEmbed extends TsEmbed {
             runtimeParameters,
             excludeRuntimeParametersfromURL,
             updatedSpotterChatPrompt,
-            spotterSidebarConfig,
             spotterChatConfig,
         } = this.viewConfig;
 
-        // Extract sidebar config properties
-        const {
-            enablePastConversationsSidebar: sidebarEnablePastConversationsSidebar,
-            spotterSidebarTitle,
-            spotterSidebarDefaultExpanded,
-            spotterChatRenameLabel,
-            spotterChatDeleteLabel,
-            spotterDeleteConversationModalTitle,
-            spotterPastConversationAlertMessage,
-            spotterDocumentationUrl,
-            spotterBestPracticesLabel,
-            spotterConversationsBatchSize,
-            spotterNewChatButtonTitle,
-        } = spotterSidebarConfig || {};
-        const resolvedEnablePastConversationsSidebar = resolveEnablePastConversationsSidebar({
-            spotterSidebarConfigValue: sidebarEnablePastConversationsSidebar,
-            standaloneValue: this.viewConfig.enablePastConversationsSidebar,
-        });
-
         if (!worksheetId) {
             this.handleError({
                 errorType: ErrorDetailsTypes.VALIDATION_ERROR,
@@ -424,38 +432,6 @@ export class SpotterEmbed extends TsEmbed {
         setParamIfDefined(queryParams, Param.ShowSpotterLimitations, showSpotterLimitations, true);
         setParamIfDefined(queryParams, Param.HideSampleQuestions, hideSampleQuestions, true);
         setParamIfDefined(queryParams, Param.UpdatedSpotterChatPrompt, updatedSpotterChatPrompt, true);
-        setParamIfDefined(
-            queryParams,
-            Param.EnablePastConversationsSidebar,
-            resolvedEnablePastConversationsSidebar,
-            true,
-        );
-        setParamIfDefined(queryParams, Param.SpotterSidebarDefaultExpanded, spotterSidebarDefaultExpanded, true);
-
-        // String params
-        setParamIfDefined(queryParams, Param.SpotterSidebarTitle, spotterSidebarTitle);
-        setParamIfDefined(queryParams, Param.SpotterChatRenameLabel, spotterChatRenameLabel);
-        setParamIfDefined(queryParams, Param.SpotterChatDeleteLabel, spotterChatDeleteLabel);
-        setParamIfDefined(queryParams, Param.SpotterDeleteConversationModalTitle, spotterDeleteConversationModalTitle);
-        setParamIfDefined(queryParams, Param.SpotterPastConversationAlertMessage, spotterPastConversationAlertMessage);
-        setParamIfDefined(queryParams, Param.SpotterBestPracticesLabel, spotterBestPracticesLabel);
-        setParamIfDefined(queryParams, Param.SpotterConversationsBatchSize, spotterConversationsBatchSize);
-        setParamIfDefined(queryParams, Param.SpotterNewChatButtonTitle, spotterNewChatButtonTitle);
-
-        // URL param with validation
-        if (spotterDocumentationUrl !== undefined) {
-            const [isValid, validationError] = validateHttpUrl(spotterDocumentationUrl);
-            if (isValid) {
-                queryParams[Param.SpotterDocumentationUrl] = spotterDocumentationUrl;
-            } else {
-                this.handleError({
-                    errorType: ErrorDetailsTypes.VALIDATION_ERROR,
-                    message: ERROR_MESSAGE.INVALID_SPOTTER_DOCUMENTATION_URL,
-                    code: EmbedErrorCodes.INVALID_URL,
-                    error: validationError?.message || ERROR_MESSAGE.INVALID_SPOTTER_DOCUMENTATION_URL,
-                });
-            }
-        }
 
         // Handle spotterChatConfig params
         if (spotterChatConfig) {

package/src/embed/events.spec.ts

@@ -2,6 +2,7 @@ import { logger } from '../utils/logger';
 import {
     init,
     AuthType,
+    Action,
     EmbedEvent,
     SearchEmbed,
     PinboardEmbed,
@@ -254,6 +255,75 @@ describe('test communication between host app and ThoughtSpot', () => {
         };
         expect(mockPort.postMessage).toHaveBeenCalledWith(heightObj);
     });
+    test('should handle UpdatePersonalizedView as alias for UpdatePersonalisedView', async () => {
+        const handler = jest.fn();
+
+        const liveboardEmbed = new LiveboardEmbed(getRootEl(), {
+            ...defaultViewConfig,
+            liveboardId: 'eca215d4-0d2c-4a55-90e3-d81ef6848ae0',
+        } as LiveboardViewConfig);
+        liveboardEmbed.on(EmbedEvent.UpdatePersonalizedView, handler).render();
+
+        await executeAfterWait(() => {
+            const iframe = getIFrameEl();
+            postMessageToParent(iframe.contentWindow, {
+                type: EmbedEvent.UpdatePersonalisedView,
+                data: PAYLOAD,
+            });
+        });
+
+        await executeAfterWait(() => {
+            expect(handler).toHaveBeenCalled();
+            expect(handler.mock.calls[0][0].data).toBe(PAYLOAD);
+        }, EVENT_WAIT_TIME);
+    });
+
+    test('should handle SavePersonalizedView as alias for SavePersonalisedView', async () => {
+        const handler = jest.fn();
+
+        const liveboardEmbed = new LiveboardEmbed(getRootEl(), {
+            ...defaultViewConfig,
+            liveboardId: 'eca215d4-0d2c-4a55-90e3-d81ef6848ae0',
+        } as LiveboardViewConfig);
+        liveboardEmbed.on(EmbedEvent.SavePersonalizedView, handler).render();
+
+        await executeAfterWait(() => {
+            const iframe = getIFrameEl();
+            postMessageToParent(iframe.contentWindow, {
+                type: EmbedEvent.SavePersonalisedView,
+                data: PAYLOAD,
+            });
+        });
+
+        await executeAfterWait(() => {
+            expect(handler).toHaveBeenCalled();
+            expect(handler.mock.calls[0][0].data).toBe(PAYLOAD);
+        }, EVENT_WAIT_TIME);
+    });
+
+    test('should handle DeletePersonalizedView as alias for DeletePersonalisedView', async () => {
+        const handler = jest.fn();
+
+        const liveboardEmbed = new LiveboardEmbed(getRootEl(), {
+            ...defaultViewConfig,
+            liveboardId: 'eca215d4-0d2c-4a55-90e3-d81ef6848ae0',
+        } as LiveboardViewConfig);
+        liveboardEmbed.on(EmbedEvent.DeletePersonalizedView, handler).render();
+
+        await executeAfterWait(() => {
+            const iframe = getIFrameEl();
+            postMessageToParent(iframe.contentWindow, {
+                type: EmbedEvent.DeletePersonalisedView,
+                data: PAYLOAD,
+            });
+        });
+
+        await executeAfterWait(() => {
+            expect(handler).toHaveBeenCalled();
+            expect(handler.mock.calls[0][0].data).toBe(PAYLOAD);
+        }, EVENT_WAIT_TIME);
+    });
+
     test('ALL event listener should fire for all events with the event type set correctly', async () => {
         const embed = new AppEmbed(getRootEl(), defaultViewConfig);
         const spy = jest.fn();
@@ -286,3 +356,21 @@ describe('test communication between host app and ThoughtSpot', () => {
         }, EVENT_WAIT_TIME);
     });
 });
+
+describe('Americanized enum alias values', () => {
+    test('EmbedEvent aliases should resolve to the same values as their British counterparts', () => {
+        expect(EmbedEvent.UpdatePersonalizedView).toBe(EmbedEvent.UpdatePersonalisedView);
+        expect(EmbedEvent.SavePersonalizedView).toBe(EmbedEvent.SavePersonalisedView);
+        expect(EmbedEvent.DeletePersonalizedView).toBe(EmbedEvent.DeletePersonalisedView);
+    });
+
+    test('HostEvent aliases should resolve to the same values as their British counterparts', () => {
+        expect(HostEvent.ResetLiveboardPersonalizedView).toBe(HostEvent.ResetLiveboardPersonalisedView);
+        expect(HostEvent.UpdatePersonalizedView).toBe(HostEvent.UpdatePersonalisedView);
+    });
+
+    test('Action aliases should resolve to the same values as their British counterparts', () => {
+        expect(Action.PersonalizedViewsDropdown).toBe(Action.PersonalisedViewsDropdown);
+        expect(Action.OrganizeFavorites).toBe(Action.OrganiseFavourites);
+    });
+});