@thoughtspot/visual-embed-sdk 1.24.0-alpha.6 → 1.24.0-dev

package/lib/src/utils.spec.js

@@ -1,7 +1,7 @@
 /**
  * @jest-environment node
  */
-import { getQueryParamString, getFilterQuery, getCssDimension, getEncodedQueryParamsString, appendToUrlHash, getRedirectUrl, checkReleaseVersionInBeta, } from './utils';
+import { getQueryParamString, getFilterQuery, getCssDimension, getEncodedQueryParamsString, appendToUrlHash, getRedirectUrl, checkReleaseVersionInBeta, getRuntimeParameters, } from './utils';
 import { RuntimeFilterOp } from './types';
 describe('unit test for utils', () => {
     test('getQueryParamString', () => {
@@ -44,6 +44,30 @@ describe('unit test for utils', () => {
         ];
         expect(getFilterQuery(filters)).toBe('col1=foo&op1=EQ&val1=42&col2=bar&op2=BW_INC&val2=1&val2=10&col3=baz&op3=CONTAINS&val3=abc');
     });
+    test('getParameterOverride', () => {
+        expect(getRuntimeParameters([])).toBe(null);
+        expect(getRuntimeParameters([
+            {
+                name: 'foo',
+                value: 'bar',
+            },
+        ])).toBe('param1=foo&paramVal1=bar');
+        const params = [
+            {
+                name: 'foo',
+                value: 42,
+            },
+            {
+                name: 'bar',
+                value: 'abc',
+            },
+            {
+                name: 'baz',
+                value: true,
+            },
+        ];
+        expect(getRuntimeParameters(params)).toBe('param1=foo&paramVal1=42&param2=bar&paramVal2=abc&param3=baz&paramVal3=true');
+    });
     test('getCssDimension', () => {
         expect(getCssDimension(100)).toBe('100px');
         expect(getCssDimension('100%')).toBe('100%');

package/lib/src/utils.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.spec.js","sourceRoot":"","sources":["../../src/utils.spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.spec.js","sourceRoot":"","sources":["../../src/utils.spec.ts"],"names":[],"mappings":"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"}

package/lib/src/visual-embed-sdk.d.ts

@@ -341,7 +341,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
         * @summary Liveboard & visualization embed
         * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
         */
-    import { DOMSelector, HostEvent, ViewConfig } from '@thoughtspot/visual-embed-sdk/types';
+    import { RuntimeParameter, DOMSelector, HostEvent, ViewConfig } from '@thoughtspot/visual-embed-sdk/types';
     import { V1Embed } from '@thoughtspot/visual-embed-sdk/embed/ts-embed';
     /**
         * The configuration for the embedded Liveboard or visualization page view.
@@ -425,6 +425,10 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
                 */
             hideTabPanel?: boolean;
+            /**
+                * The list of parameter override to apply to a Liveboard.
+                */
+            runtimeParameters?: RuntimeParameter[];
     }
     /**
         * Embed a ThoughtSpot Liveboard or a Thoughtspot visualization. When rendered it already
@@ -463,6 +467,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 * visualization ID and the runtime filters.
                 */
             render(): LiveboardEmbed;
+            preRender(): LiveboardEmbed;
             navigateToLiveboard(liveboardId: string, vizId?: string, activeTabId?: string): void;
     }
     /**
@@ -481,7 +486,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/search' {
         * @summary Search embed
         * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
         */
-    import { DOMSelector, Action, ViewConfig } from '@thoughtspot/visual-embed-sdk/types';
+    import { DOMSelector, Action, ViewConfig, RuntimeParameter } from '@thoughtspot/visual-embed-sdk/types';
     import { TsEmbed } from '@thoughtspot/visual-embed-sdk/embed/ts-embed';
     /**
         * Configuration for search options
@@ -578,6 +583,10 @@ declare module '@thoughtspot/visual-embed-sdk/embed/search' {
                 * @version: SDK: 1.24.0
                 */
             useLastSelectedSources?: boolean;
+            /**
+                * The list of parameter override to apply to a search answer.
+                */
+            runtimeParameters?: RuntimeParameter[];
     }
     export const HiddenActionItemByDefaultForSearchEmbed: Action[];
     /**
@@ -1452,6 +1461,11 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * visualization, or Liveboard.
                 */
             runtimeFilters?: RuntimeFilter[];
+            /**
+                * The list of parameter override to apply to a search answer,
+                * visualization, or Liveboard.
+                */
+            runtimeParameters?: RuntimeParameter[];
             /**
                 * The locale/language to use for the embedded view.
                 *
@@ -1561,6 +1575,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
             /**
                 * Hide the home page modules
                 * eg: hiddenHomepageModules = [HomepageModule.MyLibrary]
+                *
                 * @version SDK: 1.27.0 | Thoughtspot: 9.8.0.cl
                 */
             hiddenHomepageModules?: HomepageModule[];
@@ -1588,9 +1603,14 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * There are 8 home nav list items, we will send those item as list
                 * which we want to hide for TSE.
                 * eg: hiddenHomeLeftNavItems = [HomeLeftNavItem.Home] to hide home.
+                *
                 * @version SDK: 1.27.0 | Thoughtspot: 9.8.0.cl
                 */
             hiddenHomeLeftNavItems?: HomeLeftNavItem[];
+            /**
+                * TBD
+                */
+            preRenderId?: string;
     }
     /**
         * MessagePayload: Embed event payload: message type, data and status (start/end)
@@ -1751,6 +1771,20 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             values: (number | boolean | string)[];
     }
+    /**
+        * A filter that can be applied to ThoughtSpot answers, Liveboards, or
+        * visualizations at runtime.
+        */
+    export interface RuntimeParameter {
+            /**
+                * The name of the runtime parameter to filter on (case-sensitive)
+                */
+            name: string;
+            /**
+                * Values
+                */
+            value: number | boolean | string;
+    }
     /**
         * Event types emitted by the embedded ThoughtSpot application.
         *
@@ -2175,21 +2209,21 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             InsertIntoSlide = "insertInToSlide",
             /**
+                * @hidden
                 * Emitted when a user changes any filter on a Liveboard.
-                *
                 * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
                 */
             FilterChanged = "filterChanged",
             /**
                 *  Emitted when a user click on Go button in Sage Embed
                 *
-                * @version SDK : 1.27.0 | Thoughtspot: 9.7.0.cl
+                * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
                 */
             SageEmbedQuery = "sageEmbedQuery",
             /**
                 * Emitten when a user select data source in Sage Embed
                 *
-                * @version SDK : 1.27.0 | Thoughtspot: 9.7.0.cl
+                * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
                 */
             SageWorksheetUpdated = "sageWorksheetUpdated",
             /**
@@ -2197,7 +2231,52 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 *
                 * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
                 */
-            UpdateConnection = "updateConnection"
+            UpdateConnection = "updateConnection",
+            /**
+                * Emitted when name, status (private or public) or filter values of a
+                * PersonalisedView is updated.
+                *
+                * @returns viewName: string
+                * @returns viewId: string
+                * @returns liveboardId: string
+                * @returns isPublic: boolean
+                * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+                */
+            UpdatePersonalisedView = "updatePersonalisedView",
+            /**
+                * Emitted when a PersonalisedView is saved.
+                *
+                * @returns viewName: string
+                * @returns viewId: string
+                * @returns liveboardId: string
+                * @returns isPublic: boolean
+                * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+                */
+            SavePersonalisedView = "savePersonalisedView",
+            /**
+                * Emitted when a Liveboard is reset.
+                *
+                * @returns viewName: string
+                * @returns viewId: string
+                * @returns liveboardId: string
+                * @returns isPublic: boolean
+                * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+                */
+            ResetLiveboard = "resetLiveboard",
+            /**
+                * Emitted when a PersonalisedView is deleted.
+                *
+                * @returns views: string[]
+                * @returns liveboardId: string
+                * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+                */
+            DeletePersonalisedView = "deletePersonalisedView",
+            /**
+                * Emitten when a user creates a new worksheet
+                *
+                * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
+                */
+            CreateWorksheet = "createWorksheet"
     }
     /**
         * Event types that can be triggered by the host application
@@ -2840,16 +2919,16 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 */
             ResetSearch = "resetSearch",
             /**
+                * @hidden
                 * Gets the currents visible and runtime filters applied on a Liveboard
-                *
                 * @example
                 * liveboardEmbed.trigger(HostEvent.GetFilters)
                 * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
                 */
             GetFilters = "getFilters",
             /**
+                * @hidden
                 * Updates the visible filters on the Liveboard.
-                *
                 * @param - filter: filter object containing column name and filter operation and values
                 * @example
                 *
@@ -3829,7 +3908,17 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * disabledActions: [Action.ManageMonitor]
                 * ```
                 */
-            ManageMonitor = "ManageMonitor"
+            ManageMonitor = "ManageMonitor",
+            /**
+                * Action ID for Liveboard Personalised Views dropdown
+                *
+                *  @example
+                * ```js
+                * disabledActions: [Action.PersonalisedViewsDropdown]
+                * ```
+                *  @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+                */
+            PersonalisedViewsDropdown = "personalisedViewsDropdown"
     }
     export interface SessionInterface {
             sessionId: string;
@@ -4380,6 +4469,20 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
                 * @param frameOptions
                 */
             protected renderIFrame(url: string): Promise<any>;
+            getPreRenderIds(): {
+                    wrapper: string;
+                    shield: string;
+                    child: string;
+            };
+            protected createPreRenderWrapper(child: HTMLElement): HTMLDivElement;
+            protected preRenderWrapper: HTMLElement;
+            protected preRenderShield: HTMLElement;
+            protected preRenderChild: HTMLElement;
+            protected isPreRenderAvailable(): boolean;
+            protected insertIntoDOMForPreRender(child: string | HTMLElement): void;
+            hidePreRender(): void;
+            showPreRender(): void;
+            syncPreRenderStyle(): void;
             protected insertIntoDOM(child: string | Node): void;
             /**
                 * Sets the height of the iframe
@@ -4476,6 +4579,10 @@ declare module '@thoughtspot/visual-embed-sdk/embed/ts-embed' {
                 * @param args
                 */
             render(): TsEmbed;
+            /**
+                * Creates the preRender shell
+                */
+            preRender(): TsEmbed;
             /**
                 * Get the Post Url Params for THOUGHTSPOT from the current
                 * host app URL.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thoughtspot/visual-embed-sdk",
-    "version": "1.24.0-alpha.6",
+    "version": "1.24.0-dev",
     "description": "ThoughtSpot Embed SDK",
     "module": "lib/src/index.js",
     "main": "dist/tsembed.js",
@@ -37,10 +37,10 @@
     },
     "size-limit": [
         {
-          "path": "dist/tsembed.js",
-          "limit": "40 kB"
+            "path": "dist/tsembed.js",
+            "limit": "40 kB"
         }
-      ],
+    ],
     "scripts": {
         "lint": "eslint 'src/**'",
         "lint:fix": "eslint 'src/**/*.*' --fix",
@@ -64,7 +64,7 @@
         "test": "npm run test-sdk && npm run test-docs",
         "posttest": "cat ./coverage/sdk/lcov.info | coveralls",
         "is-publish-allowed": "node scripts/is-publish-allowed.js",
-        "prepublishOnly": "npm run is-publish-allowed && npm run test && npm run tsc && npm run bundle-dts-file && npm run bundle-dts && npm run bundle-dts-react && npm run bundle-dts-react-full && npm run build",
+        "prepublishOnly": "npm run tsc && npm run bundle-dts-file && npm run bundle-dts && npm run bundle-dts-react && npm run bundle-dts-react-full && npm run build",
         "check-size": "npm run build && size-limit",
         "publish-dev": "npm publish --tag dev",
         "publish-prod": "npm publish --tag latest"

package/src/embed/app.ts

@@ -277,6 +277,7 @@ export class AppEmbed extends V1Embed {
      * Gets the ThoughtSpot route of the page for a particular page ID.
      *
      * @param pageId The identifier for a page in the ThoughtSpot app.
+     * @param modularHomeExperience
      */
     private getPageRoute(pageId: Page, modularHomeExperience = false) {
         switch (pageId) {

package/src/embed/liveboard.spec.ts

@@ -337,22 +337,22 @@ describe('Liveboard/viz embed tests', () => {
             done();
         });
     });
-
-    test('SetActiveTab Hostevent trigger the navigate event with the correct path, not vizEmbed', async () => {
-        const mockProcessTrigger = jest.spyOn(tsEmbed.TsEmbed.prototype, 'trigger');
+    test('should set runtime parametere values in url params', async () => {
         const liveboardEmbed = new LiveboardEmbed(getRootEl(), {
-            enableVizTransformations: true,
             ...defaultViewConfig,
             liveboardId,
+            runtimeParameters: [
+                {
+                    name: 'Integer Date Range',
+                    value: 1,
+                },
+            ],
         } as LiveboardViewConfig);
         liveboardEmbed.render();
         await executeAfterWait(() => {
-            const result = liveboardEmbed.trigger(HostEvent.SetActiveTab, {
-                tabId: newActiveTabId,
-            });
-            expect(mockProcessTrigger).toHaveBeenCalledWith(
-                HostEvent.Navigate,
-                `embed/viz/${liveboardId}/tab/${newActiveTabId}`,
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/?embedApp=true${defaultParams}${prefixParams}&param1=Integer%20Date%20Range&paramVal1=1#/embed/viz/${liveboardId}`,
             );
         });
     });
@@ -373,4 +373,23 @@ describe('Liveboard/viz embed tests', () => {
             expect(mockProcessTrigger).not.toBeCalled();
         });
     });
+
+    test('SetActiveTab Hostevent trigger the navigate event with the correct path, not vizEmbed', async () => {
+        const mockProcessTrigger = jest.spyOn(tsEmbed.TsEmbed.prototype, 'trigger');
+        const liveboardEmbed = new LiveboardEmbed(getRootEl(), {
+            enableVizTransformations: true,
+            ...defaultViewConfig,
+            liveboardId,
+        } as LiveboardViewConfig);
+        liveboardEmbed.render();
+        await executeAfterWait(() => {
+            const result = liveboardEmbed.trigger(HostEvent.SetActiveTab, {
+                tabId: newActiveTabId,
+            });
+            expect(mockProcessTrigger).toHaveBeenCalledWith(
+                HostEvent.Navigate,
+                `embed/viz/${liveboardId}/tab/${newActiveTabId}`,
+            );
+        });
+    });
 });

package/src/embed/liveboard.ts

@@ -15,11 +15,12 @@ import {
     MessagePayload,
     Param,
     RuntimeFilter,
+    RuntimeParameter,
     DOMSelector,
     HostEvent,
     ViewConfig,
 } from '../types';
-import { getQueryParamString } from '../utils';
+import { getQueryParamString, getRuntimeParameters } from '../utils';
 import { getAuthPromise } from './base';
 import { V1Embed } from './ts-embed';
 
@@ -105,6 +106,10 @@ export interface LiveboardViewConfig extends ViewConfig {
      * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
      */
     hideTabPanel?: boolean;
+    /**
+     * The list of parameter override to apply to a Liveboard.
+     */
+    runtimeParameters?: RuntimeParameter[];
 }
 
 /**
@@ -154,6 +159,7 @@ export class LiveboardEmbed extends V1Embed {
             vizId,
             hideTabPanel,
             activeTabId,
+            runtimeParameters,
         } = this.viewConfig;
 
         const preventLiveboardFilterRemoval = this.viewConfig.preventLiveboardFilterRemoval
@@ -184,7 +190,10 @@ export class LiveboardEmbed extends V1Embed {
         if (hideTabPanel) {
             params[Param.HideTabPanel] = hideTabPanel;
         }
-        const queryParams = getQueryParamString(params, true);
+        let queryParams = getQueryParamString(params, true);
+
+        const parameterQuery = getRuntimeParameters(runtimeParameters || []);
+        if (parameterQuery) queryParams += `&${parameterQuery}`;
 
         return queryParams;
     }
@@ -282,6 +291,14 @@ export class LiveboardEmbed extends V1Embed {
         return this;
     }
 
+    public preRender(): LiveboardEmbed {
+        super.preRender();
+
+        this.render();
+
+        return this;
+    }
+
     public navigateToLiveboard(liveboardId: string, vizId?: string, activeTabId?: string) {
         const path = this.getIframeSuffixSrc(liveboardId, vizId, activeTabId);
         this.viewConfig.liveboardId = liveboardId;

package/src/embed/search.spec.ts

@@ -393,4 +393,22 @@ describe('Search embed tests', () => {
             );
         });
     });
+    test('should set runtime parametere values in url params', async () => {
+        const searchEmbed = new SearchEmbed(getRootEl(), {
+            ...defaultViewConfig,
+            runtimeParameters: [
+                {
+                    name: 'Integer Date Range',
+                    value: 1,
+                },
+            ],
+        });
+        searchEmbed.render();
+        await executeAfterWait(() => {
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/v2/?${defaultParamsWithHiddenActions}&dataSourceMode=expand&useLastSelectedSources=false${prefixParams}&param1=Integer%20Date%20Range&paramVal1=1#/embed/saved-answer/${answerId}`,
+            );
+        });
+    });
 });

package/src/embed/search.ts

@@ -14,8 +14,14 @@ import {
     Action,
     ViewConfig,
     RuntimeFilter,
+    RuntimeParameter,
 } from '../types';
-import { getQueryParamString, checkReleaseVersionInBeta, getFilterQuery } from '../utils';
+import {
+    getQueryParamString,
+    checkReleaseVersionInBeta,
+    getFilterQuery,
+    getRuntimeParameters,
+} from '../utils';
 import { TsEmbed } from './ts-embed';
 import { version } from '../../package.json';
 import { ERROR_MESSAGE } from '../errors';
@@ -118,6 +124,10 @@ export interface SearchViewConfig extends ViewConfig {
      * @version: SDK: 1.24.0
      */
     useLastSelectedSources?: boolean;
+    /**
+     * The list of parameter override to apply to a search answer.
+     */
+    runtimeParameters?: RuntimeParameter[];
 }
 
 export const HiddenActionItemByDefaultForSearchEmbed = [
@@ -172,6 +182,7 @@ export class SearchEmbed extends TsEmbed {
             excludeRuntimeFiltersfromURL,
             dataPanelV2 = false,
             useLastSelectedSources = false,
+            runtimeParameters,
         } = this.viewConfig;
         const queryParams = this.getBaseQueryParams();
 
@@ -219,6 +230,10 @@ export class SearchEmbed extends TsEmbed {
         if (queryParamsString) {
             query = `?${queryParamsString}`;
         }
+
+        const parameterQuery = getRuntimeParameters(runtimeParameters || []);
+        if (parameterQuery) query += `&${parameterQuery}`;
+
         const filterQuery = getFilterQuery(runtimeFilters || []);
         if (filterQuery && !excludeRuntimeFiltersfromURL) {
             query += `&${filterQuery}`;

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

@@ -185,7 +185,7 @@ describe('Unit test case for ts embed', () => {
             });
         });
 
-        test('Runtime filters from view Config should be part of app_init payload', async () => {
+        test('Runtime filters from view Config should be part of app_init payload when excludeRuntimeFiltersfromURL is true', async () => {
             const mockEmbedEventPayload = {
                 type: EmbedEvent.APP_INIT,
                 data: {},
@@ -200,6 +200,7 @@ describe('Unit test case for ts embed', () => {
 
             const searchEmbed = new SearchEmbed(getRootEl(), {
                 ...defaultViewConfig,
+                excludeRuntimeFiltersfromURL: true,
                 runtimeFilters: mockRuntimeFilters,
             });
             searchEmbed.render();
@@ -222,6 +223,44 @@ describe('Unit test case for ts embed', () => {
             });
         });
 
+        test('Runtime filters from view Config should not be part of app_init payload when excludeRuntimeFiltersfromURL is false', async () => {
+            const mockEmbedEventPayload = {
+                type: EmbedEvent.APP_INIT,
+                data: {},
+            };
+            const mockRuntimeFilters: RuntimeFilter[] = [
+                {
+                    columnName: 'color',
+                    operator: RuntimeFilterOp.EQ,
+                    values: ['blue'],
+                },
+            ];
+
+            const searchEmbed = new SearchEmbed(getRootEl(), {
+                ...defaultViewConfig,
+                excludeRuntimeFiltersfromURL: false,
+                runtimeFilters: mockRuntimeFilters,
+            });
+            searchEmbed.render();
+            const mockPort: any = {
+                postMessage: jest.fn(),
+            };
+            await executeAfterWait(() => {
+                const iframe = getIFrameEl();
+                postMessageToParent(iframe.contentWindow, mockEmbedEventPayload, mockPort);
+            });
+            expect(mockPort.postMessage).toHaveBeenCalledWith({
+                type: EmbedEvent.APP_INIT,
+                data: {
+                    customisations,
+                    authToken: '',
+                    runtimeFilterParams: null,
+                    hiddenHomeLeftNavItems: [],
+                    hiddenHomepageModules: [],
+                },
+            });
+        });
+
         test('homeLeftNav from view Config should be part of app_init payload', async () => {
             const mockEmbedEventPayload = {
                 type: EmbedEvent.APP_INIT,