@thoughtspot/visual-embed-sdk 1.50.0 → 1.50.1

package/src/react/util.spec.tsx

@@ -84,5 +84,260 @@ describe('React util functions', () => {
                 [EmbedEvent.QueryChanged]: onQueryChanged,
             });
         });
+
+        test('all onX props map to their correct EmbedEvent listener keys', () => {
+            const onDrilldown: MessageCallback = jest.fn();
+            const onDataSourceSelected: MessageCallback = jest.fn();
+            const onAddRemoveColumns: MessageCallback = jest.fn();
+            const onVizPointDoubleClick: MessageCallback = jest.fn();
+            const onVizPointClick: MessageCallback = jest.fn();
+            const onAlert: MessageCallback = jest.fn();
+            const onGetDataClick: MessageCallback = jest.fn();
+            const onDialogClose: MessageCallback = jest.fn();
+            const onDownload: MessageCallback = jest.fn();
+            const onDownloadAsPng: MessageCallback = jest.fn();
+            const onDownloadAsPdf: MessageCallback = jest.fn();
+            const onDownloadAsCsv: MessageCallback = jest.fn();
+            const onDownloadAsXlsx: MessageCallback = jest.fn();
+            const onDownloadLiveboardAsContinuousPDF: MessageCallback = jest.fn();
+            const onAnswerDelete: MessageCallback = jest.fn();
+            const onAIHighlights: MessageCallback = jest.fn();
+            const onPin: MessageCallback = jest.fn();
+            const onSpotIQAnalyze: MessageCallback = jest.fn();
+            const onShare: MessageCallback = jest.fn();
+            const onDrillInclude: MessageCallback = jest.fn();
+            const onDrillExclude: MessageCallback = jest.fn();
+            const onCopyToClipboard: MessageCallback = jest.fn();
+            const onUpdateTML: MessageCallback = jest.fn();
+            const onEditTML: MessageCallback = jest.fn();
+            const onExportTML: MessageCallback = jest.fn();
+            const onSaveAsView: MessageCallback = jest.fn();
+            const onCopyAEdit: MessageCallback = jest.fn();
+            const onShowUnderlyingData: MessageCallback = jest.fn();
+            const onAnswerChartSwitcher: MessageCallback = jest.fn();
+            const onLiveboardInfo: MessageCallback = jest.fn();
+            const onAddToFavorites: MessageCallback = jest.fn();
+            const onSchedule: MessageCallback = jest.fn();
+            const onEdit: MessageCallback = jest.fn();
+            const onMakeACopy: MessageCallback = jest.fn();
+            const onPresent: MessageCallback = jest.fn();
+            const onDelete: MessageCallback = jest.fn();
+            const onSchedulesList: MessageCallback = jest.fn();
+            const onCancel: MessageCallback = jest.fn();
+            const onExplore: MessageCallback = jest.fn();
+            const onCopyLink: MessageCallback = jest.fn();
+            const onCrossFilterChanged: MessageCallback = jest.fn();
+            const onVizPointRightClick: MessageCallback = jest.fn();
+            const onInsertIntoSlide: MessageCallback = jest.fn();
+            const onFilterChanged: MessageCallback = jest.fn();
+            const onUpdateConnection: MessageCallback = jest.fn();
+            const onCreateConnection: MessageCallback = jest.fn();
+            const onResetLiveboard: MessageCallback = jest.fn();
+            const onChangePersonalizedView: MessageCallback = jest.fn();
+            const onCreateWorksheet: MessageCallback = jest.fn();
+            const onAskSageInit: MessageCallback = jest.fn();
+            const onRename: MessageCallback = jest.fn();
+            const onParameterChanged: MessageCallback = jest.fn();
+            const onTableVizRendered: MessageCallback = jest.fn();
+            const onCreateLiveboard: MessageCallback = jest.fn();
+            const onCreateModel: MessageCallback = jest.fn();
+            const onSpotterData: MessageCallback = jest.fn();
+            const onPreviewSpotterData: MessageCallback = jest.fn();
+            const onAddToCoaching: MessageCallback = jest.fn();
+            const onDataModelInstructions: MessageCallback = jest.fn();
+            const onSpotterQueryTriggered: MessageCallback = jest.fn();
+            const onLastPromptEdited: MessageCallback = jest.fn();
+            const onLastPromptDeleted: MessageCallback = jest.fn();
+            const onResetSpotterConversation: MessageCallback = jest.fn();
+            const onSpotterInit: MessageCallback = jest.fn();
+            const onSpotterLoadComplete: MessageCallback = jest.fn();
+            const onOrgSwitched: MessageCallback = jest.fn();
+            const onSpotterConversationRenamed: MessageCallback = jest.fn();
+            const onSpotterConversationDeleted: MessageCallback = jest.fn();
+            const onSpotterConversationSelected: MessageCallback = jest.fn();
+            const onEmbedPageContextChanged: MessageCallback = jest.fn();
+            const onSubscribed: MessageCallback = jest.fn();
+            const onSendTestScheduleEmail: MessageCallback = jest.fn();
+            const onSpotterVizInit: MessageCallback = jest.fn();
+            const onSpotterVizQueryTriggered: MessageCallback = jest.fn();
+            const onSpotterVizResponseComplete: MessageCallback = jest.fn();
+            const onSpotterVizCheckpointCreated: MessageCallback = jest.fn();
+            const onSpotterVizCheckpointRestored: MessageCallback = jest.fn();
+            const onSpotterVizError: MessageCallback = jest.fn();
+            const onSpotterVizClosed: MessageCallback = jest.fn();
+            const onRefreshLiveboardBrowserCache: MessageCallback = jest.fn();
+            const onV1Data: MessageCallback = jest.fn();
+
+            const props = {
+                onDrilldown,
+                onDataSourceSelected,
+                onAddRemoveColumns,
+                onVizPointDoubleClick,
+                onVizPointClick,
+                onAlert,
+                onGetDataClick,
+                onDialogClose,
+                onDownload,
+                onDownloadAsPng,
+                onDownloadAsPdf,
+                onDownloadAsCsv,
+                onDownloadAsXlsx,
+                onDownloadLiveboardAsContinuousPDF,
+                onAnswerDelete,
+                onAIHighlights,
+                onPin,
+                onSpotIQAnalyze,
+                onShare,
+                onDrillInclude,
+                onDrillExclude,
+                onCopyToClipboard,
+                onUpdateTML,
+                onEditTML,
+                onExportTML,
+                onSaveAsView,
+                onCopyAEdit,
+                onShowUnderlyingData,
+                onAnswerChartSwitcher,
+                onLiveboardInfo,
+                onAddToFavorites,
+                onSchedule,
+                onEdit,
+                onMakeACopy,
+                onPresent,
+                onDelete,
+                onSchedulesList,
+                onCancel,
+                onExplore,
+                onCopyLink,
+                onCrossFilterChanged,
+                onVizPointRightClick,
+                onInsertIntoSlide,
+                onFilterChanged,
+                onUpdateConnection,
+                onCreateConnection,
+                onResetLiveboard,
+                onChangePersonalizedView,
+                onCreateWorksheet,
+                onAskSageInit,
+                onRename,
+                onParameterChanged,
+                onTableVizRendered,
+                onCreateLiveboard,
+                onCreateModel,
+                onSpotterData,
+                onPreviewSpotterData,
+                onAddToCoaching,
+                onDataModelInstructions,
+                onSpotterQueryTriggered,
+                onLastPromptEdited,
+                onLastPromptDeleted,
+                onResetSpotterConversation,
+                onSpotterInit,
+                onSpotterLoadComplete,
+                onOrgSwitched,
+                onSpotterConversationRenamed,
+                onSpotterConversationDeleted,
+                onSpotterConversationSelected,
+                onEmbedPageContextChanged,
+                onSubscribed,
+                onSendTestScheduleEmail,
+                onSpotterVizInit,
+                onSpotterVizQueryTriggered,
+                onSpotterVizResponseComplete,
+                onSpotterVizCheckpointCreated,
+                onSpotterVizCheckpointRestored,
+                onSpotterVizError,
+                onSpotterVizClosed,
+                onRefreshLiveboardBrowserCache,
+                onV1Data,
+            };
+
+            const result = getViewPropsAndListeners(props);
+
+            expect(result.viewConfig).toEqual({});
+            expect(result.listeners).toEqual({
+                [EmbedEvent.Drilldown]: onDrilldown,
+                [EmbedEvent.DataSourceSelected]: onDataSourceSelected,
+                [EmbedEvent.AddRemoveColumns]: onAddRemoveColumns,
+                [EmbedEvent.VizPointDoubleClick]: onVizPointDoubleClick,
+                [EmbedEvent.VizPointClick]: onVizPointClick,
+                [EmbedEvent.Alert]: onAlert,
+                [EmbedEvent.GetDataClick]: onGetDataClick,
+                [EmbedEvent.DialogClose]: onDialogClose,
+                [EmbedEvent.Download]: onDownload,
+                [EmbedEvent.DownloadAsPng]: onDownloadAsPng,
+                [EmbedEvent.DownloadAsPdf]: onDownloadAsPdf,
+                [EmbedEvent.DownloadAsCsv]: onDownloadAsCsv,
+                [EmbedEvent.DownloadAsXlsx]: onDownloadAsXlsx,
+                [EmbedEvent.DownloadLiveboardAsContinuousPDF]: onDownloadLiveboardAsContinuousPDF,
+                [EmbedEvent.AnswerDelete]: onAnswerDelete,
+                [EmbedEvent.AIHighlights]: onAIHighlights,
+                [EmbedEvent.Pin]: onPin,
+                [EmbedEvent.SpotIQAnalyze]: onSpotIQAnalyze,
+                [EmbedEvent.Share]: onShare,
+                [EmbedEvent.DrillInclude]: onDrillInclude,
+                [EmbedEvent.DrillExclude]: onDrillExclude,
+                [EmbedEvent.CopyToClipboard]: onCopyToClipboard,
+                [EmbedEvent.UpdateTML]: onUpdateTML,
+                [EmbedEvent.EditTML]: onEditTML,
+                [EmbedEvent.ExportTML]: onExportTML,
+                [EmbedEvent.SaveAsView]: onSaveAsView,
+                [EmbedEvent.CopyAEdit]: onCopyAEdit,
+                [EmbedEvent.ShowUnderlyingData]: onShowUnderlyingData,
+                [EmbedEvent.AnswerChartSwitcher]: onAnswerChartSwitcher,
+                [EmbedEvent.LiveboardInfo]: onLiveboardInfo,
+                [EmbedEvent.AddToFavorites]: onAddToFavorites,
+                [EmbedEvent.Schedule]: onSchedule,
+                [EmbedEvent.Edit]: onEdit,
+                [EmbedEvent.MakeACopy]: onMakeACopy,
+                [EmbedEvent.Present]: onPresent,
+                [EmbedEvent.Delete]: onDelete,
+                [EmbedEvent.SchedulesList]: onSchedulesList,
+                [EmbedEvent.Cancel]: onCancel,
+                [EmbedEvent.Explore]: onExplore,
+                [EmbedEvent.CopyLink]: onCopyLink,
+                [EmbedEvent.CrossFilterChanged]: onCrossFilterChanged,
+                [EmbedEvent.VizPointRightClick]: onVizPointRightClick,
+                [EmbedEvent.InsertIntoSlide]: onInsertIntoSlide,
+                [EmbedEvent.FilterChanged]: onFilterChanged,
+                [EmbedEvent.UpdateConnection]: onUpdateConnection,
+                [EmbedEvent.CreateConnection]: onCreateConnection,
+                [EmbedEvent.ResetLiveboard]: onResetLiveboard,
+                [EmbedEvent.ChangePersonalizedView]: onChangePersonalizedView,
+                [EmbedEvent.CreateWorksheet]: onCreateWorksheet,
+                [EmbedEvent.AskSageInit]: onAskSageInit,
+                [EmbedEvent.Rename]: onRename,
+                [EmbedEvent.ParameterChanged]: onParameterChanged,
+                [EmbedEvent.TableVizRendered]: onTableVizRendered,
+                [EmbedEvent.CreateLiveboard]: onCreateLiveboard,
+                [EmbedEvent.CreateModel]: onCreateModel,
+                [EmbedEvent.SpotterData]: onSpotterData,
+                [EmbedEvent.PreviewSpotterData]: onPreviewSpotterData,
+                [EmbedEvent.AddToCoaching]: onAddToCoaching,
+                [EmbedEvent.DataModelInstructions]: onDataModelInstructions,
+                [EmbedEvent.SpotterQueryTriggered]: onSpotterQueryTriggered,
+                [EmbedEvent.LastPromptEdited]: onLastPromptEdited,
+                [EmbedEvent.LastPromptDeleted]: onLastPromptDeleted,
+                [EmbedEvent.ResetSpotterConversation]: onResetSpotterConversation,
+                [EmbedEvent.SpotterInit]: onSpotterInit,
+                [EmbedEvent.SpotterLoadComplete]: onSpotterLoadComplete,
+                [EmbedEvent.OrgSwitched]: onOrgSwitched,
+                [EmbedEvent.SpotterConversationRenamed]: onSpotterConversationRenamed,
+                [EmbedEvent.SpotterConversationDeleted]: onSpotterConversationDeleted,
+                [EmbedEvent.SpotterConversationSelected]: onSpotterConversationSelected,
+                [EmbedEvent.EmbedPageContextChanged]: onEmbedPageContextChanged,
+                [EmbedEvent.Subscribed]: onSubscribed,
+                [EmbedEvent.SendTestScheduleEmail]: onSendTestScheduleEmail,
+                [EmbedEvent.SpotterVizInit]: onSpotterVizInit,
+                [EmbedEvent.SpotterVizQueryTriggered]: onSpotterVizQueryTriggered,
+                [EmbedEvent.SpotterVizResponseComplete]: onSpotterVizResponseComplete,
+                [EmbedEvent.SpotterVizCheckpointCreated]: onSpotterVizCheckpointCreated,
+                [EmbedEvent.SpotterVizCheckpointRestored]: onSpotterVizCheckpointRestored,
+                [EmbedEvent.SpotterVizError]: onSpotterVizError,
+                [EmbedEvent.SpotterVizClosed]: onSpotterVizClosed,
+                [EmbedEvent.RefreshLiveboardBrowserCache]: onRefreshLiveboardBrowserCache,
+                [EmbedEvent.V1Data]: onV1Data,
+            });
+        });
     });
 });

package/src/types.ts

@@ -244,6 +244,13 @@ export enum HomeLeftNavItem {
      * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
      */
     Favorites = 'favorites',
+    /**
+     * The *Collections* menu option in
+     * the *Insights* left navigation panel.
+     * Shown when collections are enabled on the cluster.
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    Collections = 'collections',
 }
 export type DOMSelector = string | HTMLElement;
 
@@ -1220,6 +1227,26 @@ export interface BaseViewConfig extends ApiInterceptFlags {
      * ```
      */
     overrideOrgId?: number;
+    /**
+     * Overrides the browser history behavior for embedding application users.
+     * This parameter changes standard history navigation (pushState) into a
+     * state replacement (replaceState), preventing users from getting trapped in
+     * back-button loops inside the embedded iframe environment.
+     * The overrideHistoryState setting is honored only if the
+     * application is running within an embedded context.
+     *
+     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     * @example
+     * ```js
+     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
+     * const embed = new <EmbedComponent>('#tsEmbed', {
+     *     // ... other embed view config
+     *     overrideHistoryState: true,
+     * });
+     * ```
+     */
+    overrideHistoryState?: boolean;
     /**
      * Flag to override the *Open Link in New Tab* context
      * menu option.
@@ -3736,6 +3763,31 @@ export enum EmbedEvent {
      */
     SpotterConversationSelected = 'spotterConversationSelected',
 
+    /**
+     * Emitted when the Spotter agent finishes streaming/rendering a response.
+     * Includes the conversation and message identifiers so the host app can
+     * fetch the full conversation history via the REST API if needed.
+     *
+     * The payload data has the shape `{ convId: string, messageId: string }`.
+     *
+     * Works with SpotterEmbed as well as AppEmbed (when Spotter is reached
+     * inside the full application).
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterResponseComplete, (payload) => {
+     *     console.log('Spotter response complete', payload);
+     * })
+     * ```
+     * @example
+     * ```js
+     * appEmbed.on(EmbedEvent.SpotterResponseComplete, (payload) => {
+     *     console.log('Spotter response complete', payload);
+     * })
+     * ```
+     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterResponseComplete = 'spotterResponseComplete',
+
     /**
      * @hidden
      * Emitted when the auth token is about to get expired and needs to be refreshed.
@@ -5312,6 +5364,14 @@ export enum HostEvent {
     /**
      * Get details of filters applied on the Liveboard.
      * Returns arrays containing Liveboard filter and runtime filter elements.
+     * Each Liveboard filter may include an `applicability` attribute
+     * indicating the scope of the filter. It contains a `level`
+     * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
+     * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
+     * level there is no `targetId`, since the filter applies to the
+     * whole Liveboard.
+     * The `applicability` attribute is available from SDK: 1.51.0 |
+     * ThoughtSpot: 26.10.0.cl.
      * @example
      * ```js
      * const data = await liveboardEmbed.trigger(HostEvent.GetFilters);
@@ -5351,6 +5411,16 @@ export enum HostEvent {
      *
      * `type`  - To update filters for date time, specify the date format type.
      * For more information and examples, see link:https://developers.thoughtspot.com/docs/embed-liveboard#_date_filters[Date filters].
+     *
+     * `applicability` - Optional. Scopes the filter to a specific target,
+     * for example, a single Liveboard tab. Available from SDK: 1.51.0 |
+     * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
+     *
+     *  - `level`: The scope of the filter: `LIVEBOARD`, `TAB`, or `GROUP`.
+     *  - `targetId`: The GUID of the target, for example, the tab GUID.
+     *    Required when `level` is `TAB` or `GROUP`. Do not pass it when
+     *    `level` is `LIVEBOARD`, since the filter applies to the whole
+     *    Liveboard.
      * @example
      * ```js
      *
@@ -5427,6 +5497,21 @@ export enum HostEvent {
      *     }
      * }, ContextType.Liveboard);
      * ```
+     * @example
+     * ```js
+     * // Scope the filter to a specific Liveboard tab
+     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
+     *     filter: {
+     *         column: "item type",
+     *         oper: "IN",
+     *         values: ["bags", "shirts"],
+     *         applicability: {
+     *             level: "TAB",
+     *             targetId: "e0836cad-4fdf-42d4-bd97-567a6b2a6058"
+     *         }
+     *     }
+     * });
+     * ```
      * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
      */
     UpdateFilters = 'updateFilters',
@@ -5578,6 +5663,15 @@ export enum HostEvent {
      * - `name`: Name of the parameter.
      * - `value`: The value to set for the parameter.
      * - `isVisibleToUser`: Optional. To control the visibility of the parameter chip.
+     * - `applicability`: Optional. Scopes the parameter to a specific target,
+     * for example, a single Liveboard tab. Available from SDK: 1.51.0 |
+     * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
+     *
+     *    - `level`: The scope of the parameter: `LIVEBOARD`, `TAB`, or `GROUP`.
+     *    - `targetId`: The GUID of the target, for example, the tab GUID.
+     *      Required when `level` is `TAB` or `GROUP`. Do not pass it when
+     *      `level` is `LIVEBOARD`, since the parameter applies to the whole
+     *      Liveboard.
      *
      * @example
      * ```js
@@ -5589,6 +5683,18 @@ export enum HostEvent {
      * ```
      * @example
      * ```js
+     * // Scope the parameter to a specific Liveboard tab
+     * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
+     *   name: "Integer Range Param",
+     *   value: 10,
+     *   applicability: {
+     *     level: "TAB",
+     *     targetId: "e0836cad-4fdf-42d4-bd97-567a6b2a6058"
+     *   }
+     * }])
+     * ```
+     * @example
+     * ```js
      * // Update parameters from liveboard context
      * import { ContextType } from '@thoughtspot/visual-embed-sdk';
      * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
@@ -5602,6 +5708,14 @@ export enum HostEvent {
     UpdateParameters = 'UpdateParameters',
     /**
      * Triggers GetParameters to fetch the runtime Parameters.
+     * Each parameter may include an `applicability` attribute
+     * indicating the scope of the parameter. It contains a `level`
+     * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
+     * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
+     * level there is no `targetId`, since the parameter applies to the
+     * whole Liveboard.
+     * The `applicability` attribute is available from SDK: 1.51.0 |
+     * ThoughtSpot: 26.10.0.cl.
      * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
      * ```js
      * liveboardEmbed.trigger(HostEvent.GetParameters).then((parameter) => {
@@ -6193,6 +6307,7 @@ export enum Param {
     SpotterEnabled = 'isSpotterExperienceEnabled',
     IsUnifiedSearchExperienceEnabled = 'isUnifiedSearchExperienceEnabled',
     OverrideOrgId = 'orgId',
+    OverrideHistoryState = 'overrideHistoryState',
     OauthPollingInterval = 'oAuthPollingInterval',
     IsForceRedirect = 'isForceRedirect',
     DataSourceId = 'dataSourceId',
@@ -6213,6 +6328,7 @@ export enum Param {
     isLinkParametersEnabled = 'isLinkParametersEnabled',
     EnablePastConversationsSidebar = 'enablePastConversationsSidebar',
     UpdatedSpotterChatPrompt = 'updatedSpotterChatPrompt',
+    DefaultQueryMode = 'defaultQueryMode',
     EnableStopAnswerGenerationEmbed = 'enableStopAnswerGenerationEmbed',
     SpotterSidebarTitle = 'spotterSidebarTitle',
     SpotterSidebarDefaultExpanded = 'spotterSidebarDefaultExpanded',
@@ -8436,6 +8552,9 @@ export enum EmbedErrorCodes {
 
     /** DrillDown payload is invalid - missing or malformed points */
     DRILLDOWN_INVALID_PAYLOAD = 'DRILLDOWN_INVALID_PAYLOAD',
+
+    /** UpdateParameters payload is invalid - malformed applicability */
+    UPDATEPARAMETERS_INVALID_PAYLOAD = 'UPDATEPARAMETERS_INVALID_PAYLOAD',
 }
 
 /**

package/src/utils/processData.spec.ts

@@ -80,6 +80,11 @@ describe('Unit test for process data', () => {
         );
     });
 
+    test('ProcessData QueryChanged default branch returns payload unchanged', () => {
+        const e = { type: EmbedEvent.QueryChanged, data: { query: 'revenue by region' } };
+        expect(processDataInstance.processEventData(EmbedEvent.QueryChanged, e, thoughtSpotHost, null)).toEqual(e);
+    });
+
     test('ProcessData, when Action is non CustomAction', () => {
         const processedData = { type: EmbedEvent.Data };
         jest.spyOn(processDataInstance, 'processCustomAction').mockImplementation(async () => ({}));
@@ -311,6 +316,98 @@ describe('Unit test for process data', () => {
         expect(base.notifyAuthFailure).not.toHaveBeenCalled();
     });
 
+    test('processEventData default branch returns payload unchanged for non-special events', () => {
+        const events = [
+            EmbedEvent.Drilldown,
+            EmbedEvent.DataSourceSelected,
+            EmbedEvent.AddRemoveColumns,
+            EmbedEvent.VizPointDoubleClick,
+            EmbedEvent.VizPointClick,
+            EmbedEvent.Alert,
+            EmbedEvent.GetDataClick,
+            EmbedEvent.DialogClose,
+            EmbedEvent.Download,
+            EmbedEvent.DownloadAsPng,
+            EmbedEvent.DownloadAsPdf,
+            EmbedEvent.DownloadAsCsv,
+            EmbedEvent.DownloadAsXlsx,
+            EmbedEvent.DownloadLiveboardAsContinuousPDF,
+            EmbedEvent.AnswerDelete,
+            EmbedEvent.AIHighlights,
+            EmbedEvent.Pin,
+            EmbedEvent.SpotIQAnalyze,
+            EmbedEvent.Share,
+            EmbedEvent.DrillInclude,
+            EmbedEvent.DrillExclude,
+            EmbedEvent.CopyToClipboard,
+            EmbedEvent.UpdateTML,
+            EmbedEvent.EditTML,
+            EmbedEvent.ExportTML,
+            EmbedEvent.SaveAsView,
+            EmbedEvent.CopyAEdit,
+            EmbedEvent.ShowUnderlyingData,
+            EmbedEvent.AnswerChartSwitcher,
+            EmbedEvent.LiveboardInfo,
+            EmbedEvent.AddToFavorites,
+            EmbedEvent.Schedule,
+            EmbedEvent.Edit,
+            EmbedEvent.MakeACopy,
+            EmbedEvent.Present,
+            EmbedEvent.Delete,
+            EmbedEvent.SchedulesList,
+            EmbedEvent.Cancel,
+            EmbedEvent.Explore,
+            EmbedEvent.CopyLink,
+            EmbedEvent.CrossFilterChanged,
+            EmbedEvent.VizPointRightClick,
+            EmbedEvent.InsertIntoSlide,
+            EmbedEvent.FilterChanged,
+            EmbedEvent.UpdateConnection,
+            EmbedEvent.CreateConnection,
+            EmbedEvent.ResetLiveboard,
+            EmbedEvent.ChangePersonalizedView,
+            EmbedEvent.CreateWorksheet,
+            EmbedEvent.AskSageInit,
+            EmbedEvent.Rename,
+            EmbedEvent.ParameterChanged,
+            EmbedEvent.TableVizRendered,
+            EmbedEvent.CreateLiveboard,
+            EmbedEvent.CreateModel,
+            EmbedEvent.SpotterData,
+            EmbedEvent.PreviewSpotterData,
+            EmbedEvent.AddToCoaching,
+            EmbedEvent.DataModelInstructions,
+            EmbedEvent.SpotterQueryTriggered,
+            EmbedEvent.LastPromptEdited,
+            EmbedEvent.LastPromptDeleted,
+            EmbedEvent.ResetSpotterConversation,
+            EmbedEvent.SpotterInit,
+            EmbedEvent.SpotterLoadComplete,
+            EmbedEvent.OrgSwitched,
+            EmbedEvent.SpotterConversationRenamed,
+            EmbedEvent.SpotterConversationDeleted,
+            EmbedEvent.SpotterConversationSelected,
+            EmbedEvent.EmbedPageContextChanged,
+            EmbedEvent.Subscribed,
+            EmbedEvent.SendTestScheduleEmail,
+            EmbedEvent.SpotterVizInit,
+            EmbedEvent.SpotterVizQueryTriggered,
+            EmbedEvent.SpotterVizResponseComplete,
+            EmbedEvent.SpotterVizCheckpointCreated,
+            EmbedEvent.SpotterVizCheckpointRestored,
+            EmbedEvent.SpotterVizError,
+            EmbedEvent.SpotterVizClosed,
+            EmbedEvent.RefreshLiveboardBrowserCache,
+            EmbedEvent.V1Data,
+        ];
+        events.forEach((eventType) => {
+            const e = { type: eventType, data: 'test-payload' };
+            expect(
+                processDataInstance.processEventData(eventType, e, thoughtSpotHost, null),
+            ).toEqual(e);
+        });
+    });
+
     test('should handle ClearInfoCache', () => {
         const mockResetCachedPreauthInfo = jest.spyOn(sessionInfoService, 'resetCachedPreauthInfo').mockImplementation(() => {});
         const mockResetCachedSessionInfo = jest.spyOn(sessionInfoService, 'resetCachedSessionInfo').mockImplementation(() => {});

package/src/utils/processTrigger.spec.ts

@@ -216,5 +216,96 @@ describe('Unit test for processTrigger', () => {
                 'Fullscreen presentation mode is disabled. Set disableFullscreenPresentation: false to enable this feature.',
             );
         });
+
+        test('postMessage is called with type=present when disableFullscreenPresentation is false', () => {
+            mockGetEmbedConfig.mockReturnValue({ disableFullscreenPresentation: false });
+            const thoughtSpotHost = 'https://example.thoughtspot.com';
+            _processTriggerInstance.processTrigger(iFrame, HostEvent.Present, thoughtSpotHost, {});
+            expect(iFrame.contentWindow.postMessage).toHaveBeenCalledWith(
+                expect.objectContaining({ type: HostEvent.Present }),
+                thoughtSpotHost,
+                expect.anything(),
+            );
+        });
+
+        test('postMessage is still called with type=present when disableFullscreenPresentation is true', () => {
+            mockGetEmbedConfig.mockReturnValue({ disableFullscreenPresentation: true });
+            const thoughtSpotHost = 'https://example.thoughtspot.com';
+            _processTriggerInstance.processTrigger(iFrame, HostEvent.Present, thoughtSpotHost, {});
+            expect(iFrame.contentWindow.postMessage).toHaveBeenCalledWith(
+                expect.objectContaining({ type: HostEvent.Present }),
+                thoughtSpotHost,
+                expect.anything(),
+            );
+        });
+
+        test('handlePresentEvent receives the exact iFrame reference passed to processTrigger', () => {
+            mockGetEmbedConfig.mockReturnValue({ disableFullscreenPresentation: false });
+            _processTriggerInstance.processTrigger(
+                iFrame, HostEvent.Present, 'https://example.thoughtspot.com', {},
+            );
+            expect(mockHandlePresentEvent).toHaveBeenCalledWith(iFrame);
+        });
+    });
+
+    test('nested responseData.data.error causes promise rejection', async () => {
+        const messageType = HostEvent.Search;
+        const thoughtSpotHost = 'http://localhost:3000';
+        mockMessageChannel();
+        const triggerPromise = _processTriggerInstance.processTrigger(
+            iFrame, messageType, thoughtSpotHost, {},
+        );
+        messageChannelMock.port1.onmessage({ data: { data: { error: 'nested-error' } } });
+        await expect(triggerPromise).rejects.toEqual('nested-error');
+    });
+
+    test('context parameter is forwarded as context field in the postMessage payload', async () => {
+        const messageType = HostEvent.Search;
+        const thoughtSpotHost = 'http://localhost:3000';
+        const context = 'Liveboard' as any;
+        mockMessageChannel();
+        _processTriggerInstance.processTrigger(iFrame, messageType, thoughtSpotHost, {}, context);
+        expect(iFrame.contentWindow.postMessage).toHaveBeenCalledWith(
+            expect.objectContaining({ context }),
+            thoughtSpotHost,
+            expect.anything(),
+        );
+    });
+
+    describe('Reload timing and side-effects', () => {
+        test('src is cleared immediately but not restored until exactly 100ms', () => {
+            jest.useFakeTimers();
+            const iFrameElement = document.createElement('iframe');
+            iFrameElement.src = 'http://localhost:3000';
+            const originalSrc = iFrameElement.src; // normalized by jsdom
+
+            _processTriggerInstance.reload(iFrameElement);
+
+            expect(iFrameElement.src).not.toBe(originalSrc); // cleared
+            jest.advanceTimersByTime(99);
+            expect(iFrameElement.src).not.toBe(originalSrc); // not yet restored
+            jest.advanceTimersByTime(1);
+            expect(iFrameElement.src).toBe(originalSrc); // restored at 100ms
+            jest.useRealTimers();
+        });
+
+        test('processTrigger(Reload) does not call iFrame.contentWindow.postMessage', () => {
+            jest.useFakeTimers();
+            // Use the outer iFrame mock which has a mockable contentWindow
+            jest.clearAllMocks();
+            _processTriggerInstance.processTrigger(
+                iFrame, HostEvent.Reload, 'http://localhost:3000', {},
+            );
+            jest.advanceTimersByTime(200);
+            expect(iFrame.contentWindow.postMessage).not.toHaveBeenCalled();
+            jest.useRealTimers();
+        });
+
+        test('processTrigger(Reload) resolves with null', async () => {
+            const result = await _processTriggerInstance.processTrigger(
+                iFrame, HostEvent.Reload, 'http://localhost:3000', {},
+            );
+            expect(result).toBeNull();
+        });
     });
 });