@thoughtspot/visual-embed-sdk 1.33.3 → 1.33.5

package/src/embed/app.ts

@@ -366,7 +366,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
      */
     dataPanelCustomGroupsAccordionInitialState?: DataPanelCustomColumnGroupsAccordionState;
     /**
-     * This flag is used to enable the 2 column layout in liveboard
+     * This attribute can be used to enable the two-column layout on an embedded Liveboard
      * @type {boolean}
      * @default false
      * @version SDK: 1.32.0 | ThoughtSpot:10.1.0.cl
@@ -380,17 +380,17 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
      */
     enable2ColumnLayout?: boolean;
     /**
-     * Flag to use OnBeforeSearchExecute embed event
+     * Flag that allows using `EmbedEvent.OnBeforeGetVizDataIntercept`.
      * @version SDK : 1.29.0 | Thoughtspot : 10.1.0.cl
      */
     isOnBeforeGetVizDataInterceptEnabled?: boolean;
     /**
      * Flag to use home page search bar mode
-     * @version SDK : 1.33.0 | Thoughtspot : 10.2.0.cl
+     * @version SDK : 1.33.0 | Thoughtspot : 10.3.0.cl
      */
     homePageSearchBarMode?: HomePageSearchBarMode;
     /**
-     * This flag is used to enable the compact header in liveboard
+     * This flag can be used to enable the compact header in Liveboard
      * @type {boolean}
      * @default false
      * @version SDK: 1.35.0 | ThoughtSpot:10.3.0.cl
@@ -404,7 +404,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
      */
     isLiveboardCompactHeaderEnabled?: boolean;
     /**
-     * This flag is used to show/hide verified Icon in liveboard compact header
+     * This flag can be used to show or hide the Liveboard verified icon in the compact header.
      * @type {boolean}
      * @default true
      * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
@@ -418,7 +418,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
      */
     showLiveboardVerifiedBadge?: boolean;
     /**
-     * This flag is used to show/hide re-verify banner in liveboard compact header
+     * This flag can be used to show or hide the re-verify banner on the Liveboard compact header
      * @type {boolean}
      * @default true
      * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
@@ -431,6 +431,20 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
      * ```
      */
     showLiveboardReverifyBanner?: boolean;
+    /**
+     * This flag is used to enable unified search experience for full app embed.
+     * @type {boolean}
+     * @default true
+     * @version SDK: 1.34.0 | ThoughtSpot:10.5.0.cl
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#embed-container', {
+     *    ... // other options
+     *    isUnifiedSearchExperienceEnabled: true,
+     * })
+     * ```
+     */
+    isUnifiedSearchExperienceEnabled?: boolean;
 }
 
 /**
@@ -468,7 +482,7 @@ export class AppEmbed extends V1Embed {
             hideOrgSwitcher,
             enableSearchAssist,
             fullHeight,
-            dataPanelV2 = true,
+            dataPanelV2 = false,
             hideLiveboardHeader = false,
             showLiveboardTitle = true,
             showLiveboardDescription = true,
@@ -487,10 +501,10 @@ export class AppEmbed extends V1Embed {
             showLiveboardVerifiedBadge = true,
             showLiveboardReverifyBanner = true,
             homePageSearchBarMode,
+            isUnifiedSearchExperienceEnabled = true,
         } = this.viewConfig;
 
         let params = {};
-        params[Param.EmbedApp] = true;
         params[Param.PrimaryNavHidden] = !showPrimaryNavbar;
         params[Param.HideProfleAndHelp] = !!disableProfileAndHelp;
         params[Param.HideApplicationSwitcher] = !!hideApplicationSwitcher;
@@ -503,6 +517,7 @@ export class AppEmbed extends V1Embed {
         params[Param.LiveboardHeaderV2] = isLiveboardCompactHeaderEnabled;
         params[Param.ShowLiveboardVerifiedBadge] = showLiveboardVerifiedBadge;
         params[Param.ShowLiveboardReverifyBanner] = showLiveboardReverifyBanner;
+        params[Param.IsUnifiedSearchExperienceEnabled] = isUnifiedSearchExperienceEnabled;
 
         params = this.getBaseQueryParams(params);
 

package/src/embed/base.spec.ts

@@ -56,7 +56,7 @@ describe('Base TS Embed', () => {
         authEE.on(auth.AuthStatus.FAILURE, (reason) => {
             expect(reason).toEqual(auth.AuthFailureType.NO_COOKIE_ACCESS);
             expect(window.alert).toBeCalledWith(
-                'Third party cookie access is blocked on this browser, please allow third party cookies for this to work properly. \nYou can use `suppressNoCookieAccessAlert` to suppress this message.',
+                'Third-party cookie access is blocked on this browser. Please allow third-party cookies for this to work properly. \nYou can use `suppressNoCookieAccessAlert` to suppress this message.',
             );
             done();
         });
@@ -249,7 +249,7 @@ describe('Base TS Embed', () => {
     });
 
     test('Should add the prefetch iframe when prefetch is called. Should remove it once init is called.', async () => {
-        const url = 'https://10.87.90.95/';
+        const url = 'https://10.87.90.95/?embedApp=true';
         index.init({
             thoughtSpotHost: url,
             authType: index.AuthType.None,
@@ -266,8 +266,8 @@ describe('Base TS Embed', () => {
 
     test('Should add the prefetch iframe when prefetch is called with multiple options', async () => {
         const url = 'https://10.87.90.95/';
-        const searchUrl = `${url}v2/#/embed/answer`;
-        const liveboardUrl = url;
+        const searchUrl = `${url}v2/?embedApp=true#/embed/answer`;
+        const liveboardUrl = `${url}?embedApp=true`;
         index.prefetch(url, [
             index.PrefetchFeatures.SearchEmbed,
             index.PrefetchFeatures.LiveboardEmbed,
@@ -281,6 +281,51 @@ describe('Base TS Embed', () => {
         expect(secondIframe.src).toBe(liveboardUrl);
     });
 
+    test('Should add the prefetch iframe with additionalFlags', async () => {
+        const url = 'https://10.87.90.95/';
+        const searchUrl = `${url}v2/?embedApp=true&flag2=bool&flag3=block&flag1=true#/embed/answer`;
+        const liveboardUrl = `${url}?embedApp=true&flag2=bool&flag3=block&flag1=true`;
+        base.init({
+            thoughtSpotHost: url,
+            authType: index.AuthType.None,
+            additionalFlags: {
+                flag2: 'bar',
+                flag3: 'block',
+            },
+        });
+        index.prefetch(url, [
+            index.PrefetchFeatures.SearchEmbed,
+            index.PrefetchFeatures.LiveboardEmbed,
+        ],
+        { flag1: true, flag2: 'bool' });
+        expect(getAllIframeEl().length).toBe(2);
+        const prefetchIframe = document.querySelectorAll<HTMLIFrameElement>('.prefetchIframe');
+        expect(prefetchIframe.length).toBe(2);
+        const firstIframe = <HTMLIFrameElement>prefetchIframe[0];
+        expect(firstIframe.src).toBe(searchUrl);
+        const secondIframe = <HTMLIFrameElement>prefetchIframe[1];
+        expect(secondIframe.src).toBe(liveboardUrl);
+    });
+
+    test('Should add the prefetch iframe with additionalFlags for prefetch from init', async () => {
+        const url = 'https://10.87.90.95/';
+        const prefetchUrl = `${url}?embedApp=true&flag2=bar&flag3=block`;
+        base.init({
+            thoughtSpotHost: url,
+            authType: index.AuthType.None,
+            additionalFlags: {
+                flag2: 'bar',
+                flag3: 'block',
+            },
+            callPrefetch: true,
+        });
+        expect(getAllIframeEl().length).toBe(1);
+        const prefetchIframe = document.querySelectorAll<HTMLIFrameElement>('.prefetchIframe');
+        expect(prefetchIframe.length).toBe(1);
+        const firstIframe = <HTMLIFrameElement>prefetchIframe[0];
+        expect(firstIframe.src).toBe(prefetchUrl);
+    });
+
     test('Should not generate a prefetch iframe when url is empty string', async () => {
         const url = '';
         index.prefetch(url);
@@ -411,6 +456,18 @@ describe('Base TS Embed', () => {
         });
         expect(embedConfigInstance.getEmbedConfig().inPopup).toBe(false);
     });
+    test('@P0 @SCAL-226935 embedConfig should contain correct value of customCSSUrl when added in init ', async () => {
+        index.init({
+            thoughtSpotHost,
+            authType: index.AuthType.None,
+            customizations: {
+                style: {
+                    customCSSUrl: 'test.com',
+                },
+            },
+        });
+        expect(embedConfigInstance.getEmbedConfig().customizations.style.customCSSUrl).toEqual('test.com');
+    });
 });
 
 describe('Base without init', () => {

package/src/embed/base.ts

@@ -15,7 +15,7 @@ import { tokenizedFetch } from '../tokenizedFetch';
 import { EndPoints } from '../utils/authService/authService';
 import { getThoughtSpotHost } from '../config';
 import {
-    AuthType, EmbedConfig, LogLevel, PrefetchFeatures,
+    AuthType, EmbedConfig, LogLevel, Param, PrefetchFeatures,
 } from '../types';
 import {
     authenticate,
@@ -33,6 +33,7 @@ import {
 } from '../auth';
 import { uploadMixpanelEvent, MIXPANEL_EVENT } from '../mixpanel-service';
 import { getEmbedConfig, setEmbedConfig } from './embedConfig';
+import { getQueryParamString } from '../utils';
 
 const CONFIG_DEFAULTS: Partial<EmbedConfig> = {
     loginFailedMessage: 'Not logged in',
@@ -88,10 +89,10 @@ export const handleAuth = (): Promise<boolean> => {
 };
 
 const hostUrlToFeatureUrl = {
-    [PrefetchFeatures.SearchEmbed]: (url: string) => `${url}v2/#/embed/answer`,
-    [PrefetchFeatures.LiveboardEmbed]: (url: string) => url,
-    [PrefetchFeatures.FullApp]: (url: string) => url,
-    [PrefetchFeatures.VizEmbed]: (url: string) => url,
+    [PrefetchFeatures.SearchEmbed]: (url: string, flags: string) => `${url}v2/?${flags}#/embed/answer`,
+    [PrefetchFeatures.LiveboardEmbed]: (url: string, flags: string) => `${url}?${flags}`,
+    [PrefetchFeatures.FullApp]: (url: string, flags: string) => `${url}?${flags}`,
+    [PrefetchFeatures.VizEmbed]: (url: string, flags: string) => `${url}?${flags}`,
 };
 
 /**
@@ -100,20 +101,33 @@ const hostUrlToFeatureUrl = {
  * to your app.
  * @param url The URL provided for prefetch
  * @param prefetchFeatures Specify features which needs to be prefetched.
+ * @param additionalFlags This can be used to add any URL flag.
  * @version SDK: 1.4.0 | ThoughtSpot: ts7.sep.cl, 7.2.1
  * @group Global methods
  */
-export const prefetch = (url?: string, prefetchFeatures?: PrefetchFeatures[]): void => {
+export const prefetch = (
+    url?: string,
+    prefetchFeatures?: PrefetchFeatures[],
+    additionalFlags?: { [key: string]: string | number | boolean },
+): void => {
     if (url === '') {
         // eslint-disable-next-line no-console
         logger.warn('The prefetch method does not have a valid URL');
     } else {
         const features = prefetchFeatures || [PrefetchFeatures.FullApp];
         let hostUrl = url || getEmbedConfig().thoughtSpotHost;
+        const prefetchFlags = {
+            [Param.EmbedApp]: true,
+            ...getEmbedConfig()?.additionalFlags,
+            ...additionalFlags,
+        };
         hostUrl = hostUrl[hostUrl.length - 1] === '/' ? hostUrl : `${hostUrl}/`;
         Array.from(
             new Set(features
-                .map((feature) => hostUrlToFeatureUrl[feature](hostUrl))),
+                .map((feature) => hostUrlToFeatureUrl[feature](
+                    hostUrl,
+                    getQueryParamString(prefetchFlags),
+                ))),
         )
             .forEach(
                 (prefetchUrl, index) => {

package/src/embed/bodyless-conversation.ts

@@ -4,6 +4,10 @@ import { Conversation as ConversationService } from '../utils/graphql/nlsService
 import { getEmbedConfig } from './embedConfig';
 import { getQueryParamString } from '../utils';
 
+/**
+ * Configuration for bodyless conversation options.
+ * @group Embed components
+ */
 export interface BodylessConversationViewConfig extends ViewConfig {
     /**
      * The ID of the worksheet to use for the conversation.
@@ -60,6 +64,19 @@ class ConversationMessage extends TsEmbed {
 /**
  * Create a conversation embed, which can be integrated inside
  * chatbots or other conversational interfaces.
+ * @example
+ * ```js
+ * import { BodylessConversation } from '@thoughtspot/visual-embed-sdk';
+ *
+ * const conversation = new BodylessConversation({
+ *  worksheetId: 'worksheetId',
+ * });
+ *
+ * const { container, error } = await conversation.sendMessage('show me sales by region');
+ *
+ * // append the container to the DOM
+ * document.body.appendChild(container); // or to any other element
+ * ```
  * @group Embed components
  * @version SDK: 1.33.1 | ThoughtSpot: 10.5.0.cl
  */

package/src/embed/conversation.spec.ts

@@ -14,6 +14,7 @@ import {
     defaultParamsWithoutHiddenActions as defaultParams,
     expectUrlMatchesWithParams,
 } from '../test/test-utils';
+import { ERROR_MESSAGE } from '../errors';
 
 const thoughtSpotHost = 'tshost';
 
@@ -43,4 +44,19 @@ describe('ConversationEmbed', () => {
             `http://${thoughtSpotHost}/v2/?${defaultParams}&isSpotterExperienceEnabled=true#/embed/insights/conv-assist?worksheet=worksheetId&query=searchQuery`,
         );
     });
+
+    it('should handle error when worksheetId is not provided', async () => {
+        const viewConfig: ConversationViewConfig = {
+            worksheetId: '',
+            searchOptions: {
+                searchQuery: 'searchQuery',
+            },
+        };
+        const conversationEmbed = new ConversationEmbed(getRootEl(), viewConfig);
+        (conversationEmbed as any).handleError = jest.fn();
+        await conversationEmbed.render();
+        expect((conversationEmbed as any).handleError).toHaveBeenCalledWith(
+            ERROR_MESSAGE.SPOTTER_EMBED_WORKSHEED_ID_NOT_FOUND,
+        );
+    });
 });

package/src/embed/conversation.ts

@@ -1,3 +1,4 @@
+import { ERROR_MESSAGE } from '../errors';
 import { ViewConfig, Param } from '../types';
 import { TsEmbed } from './ts-embed';
 import { getQueryParamString } from '../utils';
@@ -49,6 +50,9 @@ export class ConversationEmbed extends TsEmbed {
             searchOptions,
         } = this.viewConfig;
         const path = 'insights/conv-assist';
+        if (!worksheetId) {
+            this.handleError(ERROR_MESSAGE.SPOTTER_EMBED_WORKSHEED_ID_NOT_FOUND);
+        }
         const queryParams = this.getBaseQueryParams();
         queryParams[Param.SpotterEnabled] = true;
 

package/src/embed/liveboard.spec.ts

@@ -67,7 +67,7 @@ describe('Liveboard/viz embed tests', () => {
         });
     });
 
-    test('should render liveboard with data panel v2 flag set to true by default', async () => {
+    test('should render liveboard with data panel v2 flag set to false by default', async () => {
         const liveboardEmbed = new LiveboardEmbed(getRootEl(), {
             ...defaultViewConfig,
             liveboardId,
@@ -76,7 +76,7 @@ describe('Liveboard/viz embed tests', () => {
         await executeAfterWait(() => {
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/?embedApp=true${defaultParams}${prefixParams}&enableDataPanelV2=true#/embed/viz/${liveboardId}`,
+                `http://${thoughtSpotHost}/?embedApp=true${defaultParams}${prefixParams}&enableDataPanelV2=false#/embed/viz/${liveboardId}`,
             );
         });
     });

package/src/embed/liveboard.ts

@@ -363,7 +363,6 @@ export class LiveboardEmbed extends V1Embed {
      */
     protected getEmbedParams() {
         let params = {};
-        params[Param.EmbedApp] = true;
         params = this.getBaseQueryParams(params);
         const {
             enableVizTransformations,
@@ -383,7 +382,7 @@ export class LiveboardEmbed extends V1Embed {
             showLiveboardReverifyBanner = true,
             enableAskSage,
             enable2ColumnLayout,
-            dataPanelV2 = true,
+            dataPanelV2 = false,
             enableCustomColumnGroups = false,
         } = this.viewConfig;
 

package/src/embed/sage.ts

@@ -158,7 +158,6 @@ export class SageEmbed extends V1Embed {
         } = this.viewConfig;
 
         const params = this.getBaseQueryParams();
-        params[Param.EmbedApp] = true;
         params[Param.IsSageEmbed] = true;
         params[Param.DisableWorksheetChange] = !!disableWorksheetChange;
         params[Param.HideWorksheetSelector] = !!hideWorksheetSelector;

package/src/embed/search.spec.ts

@@ -52,7 +52,7 @@ describe('Search embed tests', () => {
         await executeAfterWait(() => {
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&enableDataPanelV2=true&dataSourceMode=expand&useLastSelectedSources=false${prefixParams}#/embed/answer`,
+                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&enableDataPanelV2=false&dataSourceMode=expand&useLastSelectedSources=false${prefixParams}#/embed/answer`,
             );
         });
     });
@@ -438,7 +438,7 @@ describe('Search embed tests', () => {
         await executeAfterWait(() => {
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSourceMode=expand&enableDataPanelV2=true&useLastSelectedSources=true${prefixParams}#/embed/saved-answer/${answerId}`,
+                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSourceMode=expand&enableDataPanelV2=false&useLastSelectedSources=true${prefixParams}#/embed/saved-answer/${answerId}`,
             );
         });
     });
@@ -453,7 +453,7 @@ describe('Search embed tests', () => {
         await executeAfterWait(() => {
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSources=[%22data-source-1%22]&dataSourceMode=expand&enableDataPanelV2=true&useLastSelectedSources=false${prefixParams}#/embed/saved-answer/${answerId}`,
+                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSources=[%22data-source-1%22]&dataSourceMode=expand&enableDataPanelV2=false&useLastSelectedSources=false${prefixParams}#/embed/saved-answer/${answerId}`,
             );
         });
     });
@@ -468,7 +468,7 @@ describe('Search embed tests', () => {
         await executeAfterWait(() => {
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSources=[%22data-source-1%22]&dataSourceMode=expand&enableDataPanelV2=true&useLastSelectedSources=false${prefixParams}#/embed/saved-answer/${answerId}`,
+                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSources=[%22data-source-1%22]&dataSourceMode=expand&enableDataPanelV2=false&useLastSelectedSources=false${prefixParams}#/embed/saved-answer/${answerId}`,
             );
         });
     });
@@ -499,7 +499,7 @@ describe('Search embed tests', () => {
         await executeAfterWait(() => {
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSourceMode=expand&enableDataPanelV2=true&useLastSelectedSources=false&hideSearchBar=true${prefixParams}#/embed/saved-answer/${answerId}`,
+                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSourceMode=expand&enableDataPanelV2=false&useLastSelectedSources=false&hideSearchBar=true${prefixParams}#/embed/saved-answer/${answerId}`,
             );
         });
     });
@@ -514,7 +514,7 @@ describe('Search embed tests', () => {
         await executeAfterWait(() => {
             expectUrlMatchesWithParams(
                 getIFrameSrc(),
-                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSourceMode=expand&enableDataPanelV2=true&useLastSelectedSources=false&dataPanelCustomGroupsAccordionInitialState=EXPAND_FIRST${prefixParams}#/embed/saved-answer/${answerId}`,
+                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSourceMode=expand&enableDataPanelV2=false&useLastSelectedSources=false&dataPanelCustomGroupsAccordionInitialState=EXPAND_FIRST${prefixParams}#/embed/saved-answer/${answerId}`,
             );
         });
     });

package/src/embed/search.ts

@@ -330,7 +330,7 @@ export class SearchEmbed extends TsEmbed {
             dataSources,
             excludeRuntimeFiltersfromURL,
             hideSearchBar,
-            dataPanelV2 = true,
+            dataPanelV2 = false,
             useLastSelectedSources = false,
             runtimeParameters,
             collapseSearchBarInitially = false,

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

@@ -13,6 +13,7 @@ import {
 import {
     Action, HomeLeftNavItem, RuntimeFilter, RuntimeFilterOp, HomepageModule, HostEvent,
     RuntimeParameter,
+    Param,
 } from '../types';
 import {
     executeAfterWait,
@@ -24,10 +25,12 @@ import {
     defaultParamsForPinboardEmbed,
     waitFor,
     expectUrlMatchesWithParams,
+    expectUrlToHaveParamsWithValues,
     mockMessageChannel,
     createRootEleForEmbed,
 } from '../test/test-utils';
 import * as config from '../config';
+import * as embedConfig from './embedConfig';
 import * as tsEmbedInstance from './ts-embed';
 import * as mixpanelInstance from '../mixpanel-service';
 import * as authInstance from '../auth';
@@ -1274,6 +1277,36 @@ describe('Unit test case for ts embed', () => {
             );
         });
 
+        it('should set the additional flags correctly on the iframe src from init and view config', async () => {
+            init({
+                thoughtSpotHost: 'http://tshost',
+                authType: AuthType.None,
+                additionalFlags: {
+                    foo: 'bar1',
+                    foo2: 'bar2',
+                    foo3: false,
+                },
+            });
+            const appEmbed = new AppEmbed(getRootEl(), {
+                frameParams: {
+                    width: '100%',
+                    height: '100%',
+                },
+                additionalFlags: {
+                    foo: 'bar',
+                    baz: 1,
+                    bool: true,
+                },
+            });
+            await appEmbed.render();
+            console.log('val ', getIFrameSrc());
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/?embedApp=true&primaryNavHidden=true&profileAndHelpInNavBarHidden=false&${defaultParamsForPinboardEmbed}`
+                + `&foo=bar&foo2=bar2&foo3=false&baz=1&bool=true${defaultParamsPost}#/home`,
+            );
+        });
+
         it('Sets the showAlerts param', async () => {
             const appEmbed = new AppEmbed(getRootEl(), {
                 frameParams: {
@@ -1407,6 +1440,20 @@ describe('Unit test case for ts embed', () => {
                 `http://${thoughtSpotHost}/?embedApp=true&primaryNavHidden=true&profileAndHelpInNavBarHidden=false&numberFormatLocale=en-US&dateFormatLocale=en-IN&currencyFormat=USD${defaultParamsPost}#/home`,
             );
         });
+        it('Sets the overrideOrgId param', async () => {
+            const overrideOrgId = 142536;
+            const appEmbed = new AppEmbed(getRootEl(), {
+                frameParams: {
+                    width: '100%',
+                    height: '100%',
+                },
+                overrideOrgId,
+            });
+            await appEmbed.render();
+            expectUrlToHaveParamsWithValues(getIFrameSrc(), {
+                orgId: overrideOrgId,
+            });
+        });
     });
 
     describe('When destroyed', () => {
@@ -1615,7 +1662,7 @@ describe('Unit test case for ts embed', () => {
             });
             libEmbed.preRender();
 
-            expect(logger.error).toHaveBeenCalledWith('PreRender id is required for preRender');
+            expect(logger.error).toHaveBeenCalledWith('PreRender ID is required for preRender');
         });
 
         it('showPreRender should preRender if not available', async () => {

package/src/embed/ts-embed.ts

@@ -7,6 +7,8 @@
  */
 
 import isEqual from 'lodash/isEqual';
+import isEmpty from 'lodash/isEmpty';
+import isObject from 'lodash/isObject';
 import { logger } from '../utils/logger';
 import { getAuthenticationToken } from '../authToken';
 import { AnswerService } from '../utils/graphql/answerService/answerService';
@@ -398,6 +400,7 @@ export class TsEmbed {
         if (hostAppUrl.includes('localhost') || hostAppUrl.includes('127.0.0.1')) {
             hostAppUrl = 'local-host';
         }
+        queryParams[Param.EmbedApp] = true;
         queryParams[Param.HostAppUrl] = encodeURIComponent(hostAppUrl);
         queryParams[Param.ViewPortHeight] = window.innerHeight;
         queryParams[Param.ViewPortWidth] = window.innerWidth;
@@ -435,15 +438,23 @@ export class TsEmbed {
             hiddenTabs,
             visibleTabs,
             showAlerts,
-            additionalFlags,
+            additionalFlags: additionalFlagsFromView,
             locale,
             customizations,
             contextMenuTrigger,
             linkOverride,
             insertInToSlide,
             disableRedirectionLinksInNewTab,
+            overrideOrgId,
         } = this.viewConfig;
 
+        const { additionalFlags: additionalFlagsFromInit } = this.embedConfig;
+
+        const additionalFlags = {
+            ...additionalFlagsFromInit,
+            ...additionalFlagsFromView,
+        };
+
         if (Array.isArray(visibleActions) && Array.isArray(hiddenActions)) {
             this.handleError('You cannot have both hidden actions and visible actions');
             return queryParams;
@@ -503,11 +514,14 @@ export class TsEmbed {
         if (disableRedirectionLinksInNewTab) {
             queryParams[Param.DisableRedirectionLinksInNewTab] = disableRedirectionLinksInNewTab;
         }
+        if (overrideOrgId !== undefined) {
+            queryParams[Param.OverrideOrgId] = overrideOrgId;
+        }
 
         queryParams[Param.OverrideNativeConsole] = true;
         queryParams[Param.ClientLogLevel] = this.embedConfig.logLevel;
 
-        if (additionalFlags && additionalFlags.constructor.name === 'Object') {
+        if (isObject(additionalFlags) && !isEmpty(additionalFlags)) {
             Object.assign(queryParams, additionalFlags);
         }
 

package/src/errors.ts

@@ -1,18 +1,19 @@
 export const ERROR_MESSAGE = {
     INVALID_THOUGHTSPOT_HOST: 'Error parsing ThoughtSpot host. Please provide a valid URL.',
-    LIVEBOARD_VIZ_ID_VALIDATION: 'Please select a liveboard to embed.',
-    TRIGGER_TIMED_OUT: 'Trigger timedout in getting response',
-    SEARCHEMBED_BETA_WRANING_MESSAGE: 'Search Embed is in Beta in this release.',
-    SAGE_EMBED_BETA_WARNING_MESSAGE: 'Sage Embed is in Beta in this release.',
-    THIRD_PARTY_COOKIE_BLOCKED_ALERT: 'Third party cookie access is blocked on this browser, please allow third party cookies for this to work properly. \nYou can use `suppressNoCookieAccessAlert` to suppress this message.',
-    DUPLICATE_TOKEN_ERR: 'Duplicate token, please issue a new token every time getAuthToken callback is called. See https://developers.thoughtspot.com/docs/?pageid=embed-auth#trusted-auth-embed for more details.',
+    SPOTTER_EMBED_WORKSHEED_ID_NOT_FOUND: 'Please select a worksheet to get started',
+    LIVEBOARD_VIZ_ID_VALIDATION: 'Please select a Liveboard to embed.',
+    TRIGGER_TIMED_OUT: 'Trigger timed-out in getting a response',
+    SEARCHEMBED_BETA_WRANING_MESSAGE: 'SearchEmbed is in Beta in this release.',
+    SAGE_EMBED_BETA_WARNING_MESSAGE: 'SageEmbed is in Beta in this release.',
+    THIRD_PARTY_COOKIE_BLOCKED_ALERT: 'Third-party cookie access is blocked on this browser. Please allow third-party cookies for this to work properly. \nYou can use `suppressNoCookieAccessAlert` to suppress this message.',
+    DUPLICATE_TOKEN_ERR: 'Duplicate token. Please issue a new token every time getAuthToken callback is called. See https://developers.thoughtspot.com/docs/?pageid=embed-auth#trusted-auth-embed for more details.',
     SDK_NOT_INITIALIZED: 'SDK not initialized',
-    SESSION_INFO_FAILED: 'Failed to get session info',
+    SESSION_INFO_FAILED: 'Failed to get session information',
     INVALID_TOKEN_ERROR: 'Received invalid token from getAuthToken callback or authToken endpoint.',
     MIXPANEL_TOKEN_NOT_FOUND: 'Mixpanel token not found in session info',
-    PRERENDER_ID_MISSING: 'PreRender id is required for preRender',
+    PRERENDER_ID_MISSING: 'PreRender ID is required for preRender',
     SYNC_STYLE_CALLED_BEFORE_RENDER: 'PreRender should be called before using syncPreRenderStyle',
     CSP_VIOLATION_ALERT: 'CSP violation detected. Please check the console errors for more details.',
-    CSP_FRAME_HOST_VIOLATION_LOG_MESSAGE: 'Please setup CSP Correctly for the Application to start working. You can know more about setting CSP Correctly here: https://developers.thoughtspot.com/docs/security-settings#csp-viz-embed-hosts. \n In case you are still facing error, please read: https://developers.thoughtspot.com/docs/security-settings#csp-viz-embed-hosts',
+    CSP_FRAME_HOST_VIOLATION_LOG_MESSAGE: 'Please set up CSP correctly for the application to start working. For more information, see https://developers.thoughtspot.com/docs/security-settings#csp-viz-embed-hosts. \n If the issue persists, refer to https://developers.thoughtspot.com/docs/security-settings#csp-viz-embed-hosts',
     MISSING_REPORTING_OBSERVER: 'ReportingObserver not supported',
 };

package/src/react/index.spec.tsx

@@ -56,7 +56,7 @@ describe('React Components', () => {
                 ),
             ).toBe(true);
             expect(getIFrameSrc(container)).toBe(
-                `http://${thoughtSpotHost}/?hostAppUrl=local-host&viewPortHeight=768&viewPortWidth=1024&sdkVersion=${version}&authType=None&blockNonEmbedFullAppAccess=true&hideAction=[%22${Action.ReportError}%22,%22editACopy%22,%22saveAsView%22,%22updateTSL%22,%22editTSL%22,%22onDeleteAnswer%22]&overrideConsoleLogs=true&clientLogLevel=ERROR&enableDataPanelV2=true&dataSourceMode=hide&useLastSelectedSources=false&isSearchEmbed=true&collapseSearchBarInitially=true&enableCustomColumnGroups=false&dataPanelCustomGroupsAccordionInitialState=EXPAND_ALL#/embed/answer`,
+                `http://${thoughtSpotHost}/?embedApp=true&hostAppUrl=local-host&viewPortHeight=768&viewPortWidth=1024&sdkVersion=${version}&authType=None&blockNonEmbedFullAppAccess=true&hideAction=[%22${Action.ReportError}%22,%22editACopy%22,%22saveAsView%22,%22updateTSL%22,%22editTSL%22,%22onDeleteAnswer%22]&overrideConsoleLogs=true&clientLogLevel=ERROR&enableDataPanelV2=false&dataSourceMode=hide&useLastSelectedSources=false&isSearchEmbed=true&collapseSearchBarInitially=true&enableCustomColumnGroups=false&dataPanelCustomGroupsAccordionInitialState=EXPAND_ALL#/embed/answer`,
             );
         });
 
@@ -230,7 +230,7 @@ describe('React Components', () => {
                 ),
             ).toBe(true);
             expect(getIFrameSrc(container)).toBe(
-                `http://${thoughtSpotHost}/?hostAppUrl=local-host&viewPortHeight=768&viewPortWidth=1024&sdkVersion=${version}&authType=None&blockNonEmbedFullAppAccess=true&hideAction=[%22${Action.ReportError}%22]&overrideConsoleLogs=true&clientLogLevel=ERROR&dataSources=[%22test%22]&searchTokenString=%5Brevenue%5D&executeSearch=true&useLastSelectedSources=false&isSearchEmbed=true#/embed/search-bar-embed`,
+                `http://${thoughtSpotHost}/?embedApp=true&hostAppUrl=local-host&viewPortHeight=768&viewPortWidth=1024&sdkVersion=${version}&authType=None&blockNonEmbedFullAppAccess=true&hideAction=[%22${Action.ReportError}%22]&overrideConsoleLogs=true&clientLogLevel=ERROR&dataSources=[%22test%22]&searchTokenString=%5Brevenue%5D&executeSearch=true&useLastSelectedSources=false&isSearchEmbed=true#/embed/search-bar-embed`,
             );
         });
     });