@thoughtspot/visual-embed-sdk 1.46.1 → 1.46.2

package/src/css-variables.ts

@@ -517,42 +517,42 @@ export interface CustomCssVariables {
     /**
      * Padding of the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-padding'?: string;
 
     /**
      * Font size of the title of the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-title-font-size'?: string;
 
     /**
      * Font weight of the title of the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-title-font-weight'?: string;
 
     /**
      * Font size of the title of the tiles inside the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-tile-title-font-size'?: string;
 
     /**
      * Font weight of the title of the tiles inside the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-tile-title-font-weight'?: string;
 
     /**
      * Padding of the group tiles in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-tile-padding'?: string;
 
@@ -564,14 +564,14 @@ export interface CustomCssVariables {
     /**
      * Background color of the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-background'?: string;
 
     /**
      * Border color of the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-border-color'?: string;
 
@@ -588,63 +588,63 @@ export interface CustomCssVariables {
     /**
      * Font color of the title of the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-title-font-color'?: string;
 
     /**
      * Font color of the description of the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-description-font-color'?: string;
 
     /**
      * Font color of the title of the tiles inside the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-tile-title-font-color'?: string;
 
     /**
      * Font color of the description of the tiles inside the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-tile-description-font-color'?: string;
 
     /**
      * Background color of the tiles inside the groups in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-group-tile-background'?: string;
 
     /**
      * Background color of the filter chips in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-chip-background'?: string;
 
     /**
      * Font color of the filter chips in the Liveboard.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-chip-color'?: string;
 
     /**
      * Background color of the filter chips in the Liveboard on hover.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-chip--hover-background'?: string;
 
     /**
      * Background color of the filter chips in the Liveboard on active.
      * 
-     * Please enable the Liveboard styling and grouping feature in your ThoughtSpot instance and then set the isLiveboardStylingAndGrouping SDK flag to true to start modifying this CSS variable.
+     * Please enable the Liveboard Masterpieces feature in your ThoughtSpot instance and then set the isLiveboardMasterpiecesEnabled SDK flag to true to start modifying this CSS variable.
      */
     '--ts-var-liveboard-chip--active-background'?: string;
 

package/src/embed/app.spec.ts

@@ -397,7 +397,7 @@ describe('App embed tests', () => {
         });
     });
 
-    test('should set isLiveboardStylingAndGroupingEnabled to true in url', async () => {
+    test('should set isLiveboardStylingAndGroupingEnabled to true in url (deprecated, use isLiveboardMasterpiecesEnabled)', async () => {
         const appEmbed = new AppEmbed(getRootEl(), {
             ...defaultViewConfig,
             isLiveboardStylingAndGroupingEnabled: true,
@@ -425,6 +425,20 @@ describe('App embed tests', () => {
         });
     });
 
+    test('should set enableHomepageAnnouncement to true in url', async () => {
+        const appEmbed = new AppEmbed(getRootEl(), {
+            ...defaultViewConfig,
+            enableHomepageAnnouncement: true,
+        } as AppViewConfig);
+        appEmbed.render();
+        await executeAfterWait(() => {
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/?embedApp=true&profileAndHelpInNavBarHidden=false&enableHomepageAnnouncement=true${defaultParamsPost}#/home`,
+            );
+        });
+    });
+
     test('should set isPNGInScheduledEmailsEnabled to true in url', async () => {
         const appEmbed = new AppEmbed(getRootEl(), {
             ...defaultViewConfig,
@@ -509,6 +523,37 @@ describe('App embed tests', () => {
         });
     });
 
+    test('should set deprecated standalone enablePastConversationsSidebar in url', async () => {
+        const appEmbed = new AppEmbed(getRootEl(), {
+            ...defaultViewConfig,
+            enablePastConversationsSidebar: true,
+        } as AppViewConfig);
+        appEmbed.render();
+        await executeAfterWait(() => {
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/?embedApp=true&profileAndHelpInNavBarHidden=false&enablePastConversationsSidebar=true${defaultParamsPost}#/home`,
+            );
+        });
+    });
+
+    test('should prefer spotterSidebarConfig.enablePastConversationsSidebar over deprecated standalone flag in url', async () => {
+        const appEmbed = new AppEmbed(getRootEl(), {
+            ...defaultViewConfig,
+            enablePastConversationsSidebar: false,
+            spotterSidebarConfig: {
+                enablePastConversationsSidebar: true,
+            },
+        } as AppViewConfig);
+        appEmbed.render();
+        await executeAfterWait(() => {
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/?embedApp=true&profileAndHelpInNavBarHidden=false&enablePastConversationsSidebar=true${defaultParamsPost}#/home`,
+            );
+        });
+    });
+
     test('should set hideToolResponseCardBranding to true in url via spotterChatConfig', async () => {
         const appEmbed = new AppEmbed(getRootEl(), {
             ...defaultViewConfig,

package/src/embed/app.ts

@@ -9,7 +9,7 @@
  */
 
 import { logger } from '../utils/logger';
-import { calculateVisibleElementData, getQueryParamString, isUndefined, isValidCssMargin, setParamIfDefined, validateHttpUrl } from '../utils';
+import { calculateVisibleElementData, getQueryParamString, isUndefined, isValidCssMargin, setParamIfDefined, validateHttpUrl, resolveEnablePastConversationsSidebar } from '../utils';
 import {
     Param,
     DOMSelector,
@@ -140,7 +140,7 @@ export enum ListPage {
  */
 export interface DiscoveryExperience {
     /**
-     * primaryNavbarVersion determines the version of the navigation version.
+     * primaryNavbarVersion determines the version of the primary navigation bar.
      */
     primaryNavbarVersion?: PrimaryNavbarVersion;
     /**
@@ -164,8 +164,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * This flag also controls the homepage left navigation bar.
      *
      * Supported embed types: `AppEmbed`
-     * @default true
      * @version SDK: 1.2.0 | ThoughtSpot: 8.4.0.cl
+     * @default true
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -186,8 +186,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * **Note**: This attribute is not supported in the classic (V1) experience.
      *
      * Supported embed types: `AppEmbed`
-     * @default false
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
+     * @default false
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -204,8 +204,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * navigation bar is not hidden via `showPrimaryNavbar`.
      *
      * Supported embed types: `AppEmbed`
-     * @default false
      * @version SDK: 1.2.0 | ThoughtSpot: 8.4.0.cl
+     * @default false
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -216,12 +216,12 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      */
     disableProfileAndHelp?: boolean;
     /**
-     * @version SDK: 1.36.3 | ThoughtSpot: 10.1.0.cl
-     * @default true
      * Whether the help menu in the top navigation bar should be served
      * from Pendo or ThoughtSpot's internal help items.
      *
      * Supported embed types: `AppEmbed`
+     * @version SDK: 1.36.3 | ThoughtSpot: 10.1.0.cl
+     * @default true
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -236,8 +236,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * the top navigation bar in the V3 navigation experience.
      *
      * Supported embed types: `AppEmbed`
-     * @default false
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+     * @default false
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -256,8 +256,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * in the classic (V1) experience.
      *
      * Supported embed types: `AppEmbed`
-     * @default true
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+     * @default true
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -275,8 +275,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * in the classic (V1) and V2 experience modes.
      *
      * Supported embed types: `AppEmbed`
-     * @default true
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+     * @default true
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -292,7 +292,7 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * In the V3 experience, it shows or hides application selection
      * icons on the left navigation panel.
      * By default, the application selection menu and icons are
-     * shown in the UI
+     * shown in the UI.
      *
      * **Note**: This attribute is not supported in the classic (V1) experience.
      *
@@ -332,7 +332,7 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * takes precedence. This is the path post the `#/` in the URL of the standalone
      * ThoughtSpot app. Use this to open the embedded view to a specific path.
      *
-     * For eg, if you want the component to open to a specific Liveboard
+     * For example, if you want the component to open to a specific Liveboard
      * you could set the path to `pinboard/<liveboardId>/tab/<tabId>`.
      *
      * Supported embed types: `AppEmbed`
@@ -350,7 +350,7 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * The application page to set as the start page
      * in the embedded view.
      *
-     * Use this to open to particular page in the app. To open to a specific
+     * Use this to open to a particular page in the app. To open to a specific
      * path within the app, use the `path` attribute which is more flexible.
      *
      * Supported embed types: `AppEmbed`
@@ -430,8 +430,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * If set to true, the Search Assist feature is enabled.
      *
      * Supported embed types: `AppEmbed`
-     * @default true
      * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1-sw
+     * @default true
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -469,8 +469,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * For more information,
      * see link:https://developers.thoughtspot.com/docs/full-app-customize[full app embed documentation].
      * Supported embed types: `AppEmbed`
-     * @default false
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
+     * @default false
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -485,8 +485,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * For more information, see
      * link:https://developers.thoughtspot.com/docs/full-app-customize[full app embed documentation].
      * Supported embed types: `AppEmbed`
-     * @default false
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+     * @default false
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -501,10 +501,10 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      */
     discoveryExperience?: DiscoveryExperience;
     /**
-     * To set the initial state of the search bar in case of saved-answers.
+     * To set the initial state of the search bar in case of saved-answers. Use {@link collapseSearchBar} instead.
      * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl
+     * @deprecated This flag is deprecated.
      * @default false
-     * @deprecated Use {@link collapseSearchBar} instead
      */
     collapseSearchBarInitially?: boolean;
     /**
@@ -532,14 +532,14 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * Flag to use home page search bar mode
      *
      * Supported embed types: `AppEmbed`
-     * @version SDK : 1.33.0 | ThoughtSpot: 10.3.0.cl
+     * @version SDK: 1.33.0 | ThoughtSpot: 10.3.0.cl
      */
     homePageSearchBarMode?: HomePageSearchBarMode;
     /**
      * This flag is used to enable unified search experience for full app embed.
      *
      * Supported embed types: `AppEmbed`
-     * @version SDK: 1.34.0 | ThoughtSpot:10.5.0.cl
+     * @version SDK: 1.34.0 | ThoughtSpot: 10.5.0.cl
      * @default true
      * @example
      * ```js
@@ -552,7 +552,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
     isUnifiedSearchExperienceEnabled?: boolean;
 
     /**
-     * This flag is used to enable/disable the styling and grouping in a Liveboard
+     * This flag is used to enable/disable the styling and grouping in a Liveboard. Use {@link isLiveboardMasterpiecesEnabled} instead.
+     * @deprecated This flag is deprecated.
      *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @type {boolean}
@@ -622,6 +623,9 @@ export interface AppViewConfig extends AllEmbedViewConfig {
     /**
      * This flag is used to enable the full height lazy load data.
      *
+     * @type {boolean}
+     * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
+     * @default false
      * @example
      * ```js
      * const embed = new AppEmbed('#embed-container', {
@@ -630,10 +634,6 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      *    lazyLoadingForFullHeight: true,
      * })
      * ```
-     *
-     * @type {boolean}
-     * @default false
-     * @version SDK: 1.40.0 | ThoughtSpot:10.12.0.cl
      */
     lazyLoadingForFullHeight?: boolean;
 
@@ -641,23 +641,23 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * The margin to be used for lazy loading.
      *
      * For example, if the margin is set to '10px',
-     * the visualization will be loaded 10px before the its top edge is visible in the
+     * the visualization will be loaded 10px before its top edge is visible in the
      * viewport.
      *
      * The format is similar to CSS margin.
      *
+     * @type {string}
+     * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
      * @example
      * ```js
      * const embed = new AppEmbed('#embed-container', {
      *    // ...other options
      *    fullHeight: true,
      *    lazyLoadingForFullHeight: true,
-     *   // Using 0px, the visualization will be only loaded when its visible in the viewport.
+     *   // Using 0px, the visualization will be only loaded when it's visible in the viewport.
      *    lazyLoadingMargin: '0px',
      * })
      * ```
-     * @type {string}
-     * @version SDK: 1.40.0 | ThoughtSpot:10.12.0.cl
      */
     lazyLoadingMargin?: string;
 
@@ -665,6 +665,7 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * updatedSpotterChatPrompt : Controls the updated spotter chat prompt.
      *
      * Supported embed types: `AppEmbed`
+     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
      * @default false
      * @example
      * ```js
@@ -673,25 +674,36 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      *    updatedSpotterChatPrompt : true,
      * })
      * ```
-     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
      */
     updatedSpotterChatPrompt?: boolean;
+    /**
+     * Controls the visibility of the past conversations sidebar.
+     *
+     * Supported embed types: `AppEmbed`
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @deprecated from SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
+     * Use `spotterSidebarConfig.enablePastConversationsSidebar`.
+     * @default false
+     */
+    enablePastConversationsSidebar?: boolean;
     /**
      * Configuration for the Spotter sidebar UI customization.
      * Only applicable when navigating to Spotter within the app.
      *
      * Supported embed types: `AppEmbed`
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
-     *    ... //other embed view config
+     *    // Deprecated standalone flag (backward compatibility)
+     *    enablePastConversationsSidebar: false,
+     *    // Recommended config; this value takes precedence
      *    spotterSidebarConfig: {
      *        enablePastConversationsSidebar: true,
      *        spotterSidebarTitle: 'My Conversations',
      *    },
      * })
      * ```
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
      */
     spotterSidebarConfig?: SpotterSidebarViewConfig;
     /**
@@ -699,6 +711,7 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * branding in tool response cards.
      *
      * Supported embed types: `AppEmbed`
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -709,7 +722,6 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      *    },
      * })
      * ```
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterChatConfig?: SpotterChatViewConfig;
     /**
@@ -729,6 +741,22 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * ```
      */
     minimumHeight?: number;
+    /**
+     * To enable the homepage announcement banner.
+     * Controls the visibility of the announcement section
+     * on the homepage.
+     *
+     * Supported embed types: `AppEmbed`
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... // other embed view config
+     *    enableHomepageAnnouncement: true,
+     * })
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    enableHomepageAnnouncement?: boolean;
 }
 
 /**
@@ -809,6 +837,7 @@ export class AppEmbed extends V1Embed {
             spotterChatConfig,
             minimumHeight,
             isThisPeriodInDateFiltersEnabled,
+            enableHomepageAnnouncement,
         } = this.viewConfig;
 
         let params: any = {};
@@ -837,10 +866,15 @@ export class AppEmbed extends V1Embed {
             params[Param.UpdatedSpotterChatPrompt] = !!updatedSpotterChatPrompt;
         }
 
+        const resolvedEnablePastConversationsSidebar = resolveEnablePastConversationsSidebar({
+            spotterSidebarConfigValue: spotterSidebarConfig?.enablePastConversationsSidebar,
+            standaloneValue: this.viewConfig.enablePastConversationsSidebar,
+        });
+        setParamIfDefined(params, Param.EnablePastConversationsSidebar, resolvedEnablePastConversationsSidebar, true);
+
         // Handle spotterSidebarConfig params
         if (spotterSidebarConfig) {
             const {
-                enablePastConversationsSidebar,
                 spotterSidebarTitle,
                 spotterSidebarDefaultExpanded,
                 spotterChatRenameLabel,
@@ -853,7 +887,6 @@ export class AppEmbed extends V1Embed {
                 spotterNewChatButtonTitle,
             } = spotterSidebarConfig;
 
-            setParamIfDefined(params, Param.EnablePastConversationsSidebar, enablePastConversationsSidebar, true);
             setParamIfDefined(params, Param.SpotterSidebarDefaultExpanded, spotterSidebarDefaultExpanded, true);
             setParamIfDefined(params, Param.SpotterSidebarTitle, spotterSidebarTitle);
             setParamIfDefined(params, Param.SpotterChatRenameLabel, spotterChatRenameLabel);
@@ -979,6 +1012,10 @@ export class AppEmbed extends V1Embed {
             params[Param.IsThisPeriodInDateFiltersEnabled] = isThisPeriodInDateFiltersEnabled;
         }
 
+        if (enableHomepageAnnouncement !== undefined) {
+            params[Param.EnableHomepageAnnouncement] = enableHomepageAnnouncement;
+        }
+
         this.defaultHeight = minimumHeight || this.defaultHeight;
 
         params[Param.DataPanelV2Enabled] = dataPanelV2;

package/src/embed/base.ts

@@ -345,7 +345,7 @@ export const renderInQueue = (fn: (next?: (val?: any) => void) => Promise<any>):
  *  }).catch(error => {
  *      console.error(error);
  *  });
- *```
+ * ```
  * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
  * @group Global methods
  */
@@ -466,9 +466,9 @@ export function reset(): void {
 
 /**
  * Reloads the ThoughtSpot iframe.
+ * @version SDK: 1.43.1
  * @param iFrame
  * @group Global methods
- * @version SDK: 1.43.1
  */
 export const reloadIframe = (iFrame: HTMLIFrameElement) => {
     if (!iFrame) {

package/src/embed/bodyless-conversation.ts

@@ -17,8 +17,8 @@ export interface SpotterAgentEmbedViewConfig extends Omit<BaseViewConfig, 'prima
 
 /**
  * Configuration for conversation options.
- * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
  * Use {@link SpotterAgentEmbedViewConfig} instead
+ * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
  * @group Embed components
  */
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
@@ -87,6 +87,8 @@ export class ConversationMessage extends TsEmbed {
 /**
  * Create a conversation embed, which can be integrated inside
  * chatbots or other conversational interfaces.
+ * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
+ * @group Embed components
  * @example
  * ```js
  * import { SpotterAgentEmbed } from '@thoughtspot/visual-embed-sdk';
@@ -100,8 +102,6 @@ export class ConversationMessage extends TsEmbed {
  * // append the container to the DOM
  * document.body.appendChild(container); // or to any other element
  * ```
- * @group Embed components
- * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
  */
 export class SpotterAgentEmbed {
     private conversationService: ConversationService;
@@ -164,8 +164,9 @@ export class SpotterAgentEmbed {
 /**
  * Create a conversation embed, which can be integrated inside
  * chatbots or other conversational interfaces.
- * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
  * Use {@link SpotterAgentEmbed} instead
+ * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+ * @group Embed components
  * @example
  * ```js
  * import { SpotterAgentEmbed } from '@thoughtspot/visual-embed-sdk';
@@ -179,7 +180,6 @@ export class SpotterAgentEmbed {
  * // append the container to the DOM
  * document.body.appendChild(container); // or to any other element
  * ```
- * @group Embed components
  */
 export class BodylessConversation extends SpotterAgentEmbed {
     constructor(viewConfig: BodylessConversationViewConfig) {

package/src/embed/conversation.spec.ts

@@ -327,6 +327,43 @@ describe('ConversationEmbed', () => {
         );
     });
 
+    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',