@thoughtspot/visual-embed-sdk 1.28.0-alpha.2 → 1.28.0-alpha.5

package/dist/src/types.d.ts

@@ -176,15 +176,30 @@ export declare enum AuthType {
     Basic = "Basic"
 }
 export declare enum HomeLeftNavItem {
-    QueryBuilder = "query-builder",
+    /**
+     * @version SDK: 1.27.9| ThoughtSpot: 9.12.0.cl
+     */
+    SearchData = "search-data",
+    /**
+     * @version SDK: 1.27.9| ThoughtSpot: 9.12.0.cl
+     */
     Home = "insights-home",
+    /**
+     * @version SDK: 1.27.9| ThoughtSpot: 9.12.0.cl
+     */
     Liveboards = "liveboards",
+    /**
+     * @version SDK: 1.27.9| ThoughtSpot: 9.12.0.cl
+     */
     Answers = "answers",
+    /**
+     * @version SDK: 1.27.9| ThoughtSpot: 9.12.0.cl
+     */
     MonitorSubscription = "monitor-alerts",
-    SpotIQAnalysis = "spotiq-analysis",
-    Tutorials = "tutorials",
-    Documentation = "documentation",
-    Community = "community"
+    /**
+     * @version SDK: 1.27.9| ThoughtSpot: 9.12.0.cl
+     */
+    SpotIQAnalysis = "spotiq-analysis"
 }
 export type DOMSelector = string | HTMLElement;
 /**
@@ -240,6 +255,8 @@ export interface CustomStyles {
 /**
  * Configuration to define the customization on the Embedded
  * Thoughtspot components.
+ * You can customize styles, text strings, and icons.
+ * For more information, see https://developers.thoughtspot.com/docs/custom-css.
  *
  * @example
  * ```js
@@ -254,7 +271,12 @@ export interface CustomStyles {
  *     },
  *     content: {
  *      strings: {
- *        'LIVEBOARDS': 'Dashboards'
+ *        'LIVEBOARDS': 'Dashboards',
+ *        'ANSWERS': 'Visualizations',
+ *        'Edit': 'Modify',
+ *        'Show underlying data': 'Show source data',
+ *        'SpotIQ': 'Insights',
+ *        'Monitor': 'Alerts',
  *      }
  *     },
  *     iconSpriteUrl: 'https://my-custom-icon-sprite.svg'
@@ -286,12 +308,6 @@ export interface EmbedConfig {
      * The ThoughtSpot cluster hostname or IP address.
      */
     thoughtSpotHost: string;
-    /**
-     * If true, all the iframe links will have /v2 added automatically.
-     * If false, all the iframe links will have /v1 added automatically.
-     * If undefined, nothing will be added
-     */
-    enableReactShell?: boolean | undefined;
     /**
      * The authentication mechanism to use.
      */
@@ -536,6 +552,12 @@ export interface EmbedConfig {
      * @version SDK: 1.26.7 | ThoughtSpot: 9.10.0.cl
      */
     logLevel?: LogLevel;
+    /**
+     * Disables the Mixpanel tracking from the SDK.
+     *
+     * @version SDK: 1.27.9
+     */
+    disableSDKTracking?: boolean;
 }
 export interface LayoutConfig {
 }
@@ -574,8 +596,21 @@ export interface ViewConfig {
      */
     layoutConfig?: LayoutConfig;
     /**
-     * The <b>width</b> and <b>height</b> dimensions to render an embedded
+     * The width and height dimensions to render an embedded
      * object inside your app.  Specify the values in pixels or percentage.
+     *
+     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
+     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed', {
+     *   ... // other liveboard view config
+     *   frameParams: {
+     *     width: '500px' | '50%',
+     *      height: '400px' | '60%',
+     *   },
+     * });
+     * ```
      */
     frameParams?: FrameParams;
     /**
@@ -592,6 +627,7 @@ export interface ViewConfig {
      * for the user.
      * Use this to disable actions.
      *
+     * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#embed', {
@@ -603,6 +639,15 @@ export interface ViewConfig {
     disabledActions?: Action[];
     /**
      * The tooltip to display for disabled actions.
+     * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed', {
+     *   ... // other liveboard view config
+     *   disabledActions: [Action.Download, Action.Save]
+     *   disabledActionReason: "Reason for disabling",
+     * });
+     * ```
      */
     disabledActionReason?: string;
     /**
@@ -610,6 +655,8 @@ export interface ViewConfig {
      * This actions will be hidden from the user.
      * Use this to hide an action.
      *
+     * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
+     *
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#embed', {
@@ -630,17 +677,49 @@ export interface ViewConfig {
      *
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
      * @important
+     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed', {
+     *   ... // other liveboard view config
+     *   visibleActions: [Action.Download, Action.Export]
+     * });
+     * ```
      */
     visibleActions?: Action[];
     /**
      * Show alert messages and toast messages in the embedded view.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed-container', {
+     *    ... // other options
+     *    showAlerts:true,
+     * })
+     * ```
      */
     showAlerts?: boolean;
     /**
      * The list of runtime filters to apply to a search answer,
      * visualization, or Liveboard.
+     *
+     * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
+     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed-container', {
+     *    ... // other options
+     *    runtimeFilters: [
+     *           {
+     *             columnName: 'value',
+     *              operator: RuntimeFilterOp.EQ,
+     *             values: ['string' | 123 | true],
+     *           },
+     *       ],
+     * })
+     * ```
      */
     runtimeFilters?: RuntimeFilter[];
     /**
@@ -648,12 +727,32 @@ export interface ViewConfig {
      * visualization, or Liveboard.
      *
      * @version SDK : 1.25.0 | Thoughtspot: 9.2.0.cl, 9.5.0.sw
+     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed-container', {
+     *    ... // other options
+     *    runtimeParameters: [
+     *     {
+     *       name: 'value',
+     *       value: 'string' | 123 | true,
+     *     },
+     *   ],
+     * })
+     * ```
      */
     runtimeParameters?: RuntimeParameter[];
     /**
      * The locale/language to use for the embedded view.
      *
      * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed-container', {
+     *    ... // other options
+     *    locale:'en',
+     * })
+     * ```
      */
     locale?: string;
     /**
@@ -663,7 +762,16 @@ export interface ViewConfig {
      * Warning: This option is for advanced use only and is used internally
      * to control embed behavior in non-regular ways. We do not publish the
      * list of supported keys and values associated with each.
-     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed', {
+     *   ... // other liveboard view config
+     *   additionalFlags: {
+     *        flag1: 'value1',
+     *        flag2: 'value2'
+     *     }
+     * });
+     * ```
      * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
      */
     additionalFlags?: {
@@ -680,18 +788,42 @@ export interface ViewConfig {
     /**
      * Insert as a sibling of the target container, instead of appending to a
      * child inside it.
+     *
+     * @version SDK: 1.2.0 | Thoughtspot: 9.0.0.cl, 9.0.0.sw
+     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed-container', {
+     *    ... // other options
+     *    insertAsSibling:true,
+     * })
+     * ```
      */
     insertAsSibling?: boolean;
     /**
      * flag to set ContextMenu Trigger to either left or right click.
      *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#tsEmbed', {
+     *    ... // other options
+     *    contextMenuTrigger:ContextMenuTriggerOptions.LEFT_CLICK || RIGHT_CLICK,
+     * })
+     * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     contextMenuTrigger?: ContextMenuTriggerOptions;
     /**
-     * flag to override openNew tab context menu link
+     * Flag to override openNew tab context menu link
      *
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed-container', {
+     *    ... // other options
+     *    linkOverride:false,
+     * })
+     * ```
      */
     linkOverride?: boolean;
     /**
@@ -713,9 +845,14 @@ export interface ViewConfig {
     usePrerenderedIfAvailable?: boolean;
     /**
      * Boolean to exclude runtimeFilters in the URL
+     * By default it is true, this flag removes runtime filters from the URL
+     * when set to false, runtime filters will be included in the URL.
      *
-     * @default false
-     * @hidden
+     * Irrespective of this flag, runtime filters ( if passed ) will be applied to the
+     * embedded view.
+     *
+     * @default true
+     * @version SDK: 1.24.0 | ThoughtSpot: 9.5.0.cl
      */
     excludeRuntimeFiltersfromURL?: boolean;
     /**
@@ -737,16 +874,40 @@ export interface ViewConfig {
     hiddenTabs?: string[];
     /**
      * Hide the home page modules
-     * eg: hiddenHomepageModules = [HomepageModule.MyLibrary]
+     * For example: hiddenHomepageModules = [HomepageModule.MyLibrary]
+     *
+     * **Note**: This option does not apply to the classic homepage.
+     * To access the updated modular homepage, set
+     * `modularHomeExperience` to `true` (available in Early Access from 9.12 forward).
+     *
+     * @version SDK: 1.27.9 | Thoughtspot: 9.12.0.cl
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... // other options
+     *    hiddenHomepageModules : [HomepageModule.Favorite,HomepageModule.Learning],
+     * })
+     * ```
      *
-     * @version SDK: 1.27.0 | Thoughtspot: 9.12.0.cl
      */
     hiddenHomepageModules?: HomepageModule[];
     /**
      * reordering the home page modules
      * eg: reorderedHomepageModules = [HomepageModule.MyLibrary, HomepageModule.Watchlist]
      *
-     * @version SDK: 1.28.0 | Thoughtspot: 9.12.0.cl
+     * **Note**: This option does not apply to the classic homepage.
+     * To access the updated modular homepage, set
+     * `modularHomeExperience` to `true` (available in Early Access from 9.12.0.cl onwards).
+     *
+     * @version SDK: 1.27.9| Thoughtspot: 9.12.0.cl
+     *
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... // other options
+     *    reorderedHomepageModules:[HomepageModule.Favorite,HomepageModule.MyLibrary]
+     * })
+     * ```
      */
     reorderedHomepageModules?: HomepageModule[];
     /**
@@ -755,13 +916,18 @@ export interface ViewConfig {
      *
      * Use either `visibleTabs` or `hiddenTabs`.
      *
+     * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
+     *
      * @example
      * ```js
-     * visibleTabs: [
-     * '430496d6-6903-4601-937e-2c691821af3c',
-     * 'f547ec54-2a37-4516-a222-2b06719af726']
+     * const embed = new LiveboardEmbed('#embed-container', {
+     *    ... // other options
+     *    visibleTabs: [
+     *       '430496d6-6903-4601-937e-2c691821af3c',
+     *       'f547ec54-2a37-4516-a222-2b06719af726'
+     *     ]
+     * })
      * ```
-     * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
      */
     visibleTabs?: string[];
     /**
@@ -769,11 +935,21 @@ export interface ViewConfig {
      * There are 8 eight home navigation list items.
      * To hide these items, specify the string in the array.
      *
+     * @version SDK: 1.27.0 | Thoughtspot: 9.10.0.cl
+     *
+     * * @example
      * ```js
-     * hiddenHomeLeftNavItems = [HomeLeftNavItem.Home]
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... // other options
+     *    hiddenHomeLeftNavItems : [HomeLeftNavItem.Home,HomeLeftNavItem.Answers],
+     * })
      * ```
      *
-     * @version SDK: 1.27.0 | Thoughtspot: 9.12.0.cl
+     * **Note**: This option does not apply to the classic homepage.
+     * To access the updated modular homepage, set
+     * `modularHomeExperience` to `true` (available in Early Access from 9.12 forward).
+     *
+     * @version SDK: 1.27.9 | Thoughtspot: 9.12.0.cl
      */
     hiddenHomeLeftNavItems?: HomeLeftNavItem[];
     /**
@@ -800,7 +976,10 @@ export interface ViewConfig {
      *
      * @type {boolean}
      * @default false
+     * @version SDK: 1.24.0 | ThoughtSpot:9.4.0.cl, 9.4.0.sw
+     *
      * @example
+     * ```js
      * // Disable tracking PreRender size in the configuration
      * const config = {
      *   doNotTrackPreRenderSize: true,
@@ -808,6 +987,7 @@ export interface ViewConfig {
      *
      * // Instantiate an object with the configuration
      * const myComponent = new MyComponent(config);
+     * ```
      */
     doNotTrackPreRenderSize?: boolean;
     /**
@@ -949,6 +1129,10 @@ export declare enum HomepageModule {
     MyLibrary = "MY_LIBRARY",
     /**
      * Trending list
+     *
+     * **Note**: This option does not apply to the classic homepage.
+     * To access the updated modular homepage, set
+     * `modularHomeExperience` to `true` (available in Early Access from 9.12.0.cl onwards).
      */
     Trending = "TRENDING",
     /**
@@ -1087,7 +1271,7 @@ export declare enum EmbedEvent {
      * @returns nonFilteredColumns - The columns that were not filtered
      * @example
      *```js
-     * searchEmbed.trigger(HostEvent.DrillDown, {
+     * searchEmbed.trigger(EmbedEvent.DrillDown, {
      *    points: {
      *        clickedPoint,
      *        selectedPoints: selectedPoint
@@ -1179,7 +1363,7 @@ export declare enum EmbedEvent {
      * @important
      * @example
      * ```js
-     * embed.on(ThoughtSpotEmbed.Event.VizPointClick, ({data}) => {
+     * embed.on(EmbedEvent.VizPointClick, ({data}) => {
      *   console.log(
      *    data.vizId, // viz id
      *    data.clickedPoint.selectedAttributes[0].value,
@@ -1194,19 +1378,20 @@ export declare enum EmbedEvent {
     /**
      * An error has occurred. This event is fired for the following error types:
      *
-     *  `API` - API call failure error.
+     *  API - API call failure error.
      *
-     *  `FULLSCREEN` - Error when presenting a Liveboard or visualization in full screen mode.
+     *  FULLSCREEN - Error when presenting a Liveboard or visualization in full screen mode.
      *
-     *  `SINGLE_VALUE_FILTER` - Error due to multiple values in the single value filter.
+     *  SINGLE_VALUE_FILTER - Error due to multiple values in the single value filter.
      *
-     *  `NON_EXIST_FILTER` - Error due to a non-existent filter.
+     *  NON_EXIST_FILTER - Error due to a non-existent filter.
      *
-     *  `INVALID_DATE_VALUE` - Invalid date value error.
+     *  INVALID_DATE_VALUE - Invalid date value error.
      *
-     *  `INVALID_OPERATOR` - Use of invalid operator during filter application.
+     *  INVALID_OPERATOR - Use of invalid operator during filter application.
      *
      *  For more information, see [Developer Documentation](https://developers.thoughtspot.com/docs/events-app-integration#errorType)
+     *
      * @returns error - An error object or message
      * @example
      * ```js
@@ -1771,7 +1956,7 @@ export declare enum EmbedEvent {
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      * @example
      *```js
-     * liveboardEmbed.trigger(HostEvent.Delete,
+     * liveboardEmbed.trigger(EmbedEvent.Delete,
      *   {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
      *```
      */
@@ -1782,7 +1967,7 @@ export declare enum EmbedEvent {
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      * @example
      *```js
-     * liveboardEmbed.trigger(HostEvent.SchedulesList)
+     * liveboardEmbed.trigger(EmbedEvent.SchedulesList)
      *```
      */
     SchedulesList = "schedule-list",
@@ -1792,7 +1977,7 @@ export declare enum EmbedEvent {
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      * @example
      *```js
-     * liveboardEmbed.trigger(HostEvent.Cancel)
+     * liveboardEmbed.trigger(EmbedEvent.Cancel)
      *```
      */
     Cancel = "cancel",
@@ -1802,7 +1987,7 @@ export declare enum EmbedEvent {
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      * @example
      *```js
-     * liveboardEmbed.trigger(HostEvent.Explore,  {
+     * liveboardEmbed.trigger(EmbedEvent.Explore,  {
      *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
      *```
      */
@@ -1813,7 +1998,7 @@ export declare enum EmbedEvent {
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      * @example
      *```js
-     * liveboardEmbed.trigger(HostEvent.CopyLink, {
+     * liveboardEmbed.trigger(EmbedEvent.CopyLink, {
      *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
      *```
      */
@@ -2082,10 +2267,13 @@ export declare enum HostEvent {
      * _String_. The name of the column to filter on.
      * `operator`
      *  Runtime filter operator to apply. For information,
-     *  see [Runtime filter operators](https://developers.thoughtspot.com/docs/?pageid=runtime-filters#rtOperator).
+     *  see https://developers.thoughtspot.com/docs/?pageid=runtime-filters#rtOperator.
      * `values`
      *  List of operands. Some operators such as EQ, LE allow a single value, whereas
      *  operators such as BW and IN accept multiple operands.
+     *  **Note**: `HostEvent.UpdateRuntimeFilters` is not supported in
+     *  Search embedding (SearchEmbed) and Natural Language Search
+     *  embedding (SageEmbed).
      *
      * @param - {@link RuntimeFilter}[] an array of {@link RuntimeFilter} Types.
      * @example
@@ -2610,6 +2798,7 @@ export declare enum HostEvent {
     /**
      *
      * Get 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
@@ -2618,12 +2807,13 @@ export declare enum HostEvent {
     /**
      *
      * Update the visible filters on the Liveboard.
+     *
      * @param - filter: filter object containing column name and filter operation and values
      * @example
      *
      * ```js
      * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
-     *  filter: { column: 'column name', oper: 'in', values: [1,2,3], is_mandatory: false }
+     *  filter: { column: 'column name', oper: 'IN', values: [1,2,3], is_mandatory: false }
      * })
      * ```
      * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
@@ -2709,7 +2899,33 @@ export declare enum HostEvent {
      * ```
      * @version SDK: 1.29.0 | Thoughtspot: 9.12.0.cl
      */
-    AskSage = "AskSage"
+    AskSage = "AskSage",
+    /**
+     * Trigger UpdateCrossFilter for Liveboard
+     *
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.UpdateCrossFilter, {
+     *      vizId: 'b535c760-8bbe-4e6f-bb26-af56b4129a1e',
+     *      conditions: [
+     *      { columnName: 'Category', values: ['mfgr#12','mfgr#14'] },
+     *      { columnName: 'color', values: ['mint','hot'] },
+     *    ],
+     * });
+     * ```
+     * @version SDK: 1.29.0 | Thoughtspot: 10.0.0.cl
+     */
+    UpdateCrossFilter = "UpdateCrossFilter",
+    /**
+     * Trigger ResetLiveboardPersonalisedView for Liveboard
+     *
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.ResetLiveboardPersonalisedView);
+     * ```
+     * @version SDK: 1.29.0 | Thoughtspot: 10.1.0.cl
+     */
+    ResetLiveboardPersonalisedView = "ResetLiveboardPersonalisedView"
 }
 /**
  * The different visual modes that the data sources panel within
@@ -3674,7 +3890,47 @@ export declare enum Action {
      * ```
      *  @version SDK: 1.29.0 | Thoughtspot: 9.12.0.cl
      */
-    AskAi = "AskAi"
+    AskAi = "AskAi",
+    /**
+     * The **Add KPI to Watchlist** action on Home page watchlist.
+     *
+     * @example
+     * ```js
+     * disabledActions: [Action.AddToWatchlist]
+     * ```
+     * @version SDK : 1.27.9 | Thoughtspot: 9.12.5.cl
+     */
+    AddToWatchlist = "addToWatchlist",
+    /**
+     * The **Remove from watchlist** menu action on KPI watchlist.
+     *
+     * @example
+     * ```js
+     * disabledActions: [Action.RemoveFromWatchlist]
+     * ```
+     * @version SDK : 1.27.9 | Thoughtspot: 9.12.5.cl
+     */
+    RemoveFromWatchlist = "removeFromWatchlist",
+    /**
+     * The **Copy KPI Link** menu action on KPI watchlist.
+     *
+     * @example
+     * ```js
+     * disabledActions: [Action.CopyKpiLink]
+     * ```
+     * @version SDK : 1.27.9 | Thoughtspot: 9.12.5.cl
+     */
+    CopyKpiLink = "copyKpiLink",
+    /**
+     * Action ID for AI Highlights button
+     *
+     *  @example
+     * ```js
+     * hiddenAction: [Action.AIHighlights]
+     * ```
+     *  @version SDK: 1.27.10 | Thoughtspot: 9.12.5.cl
+     */
+    AIHighlights = "AIHighlights"
 }
 export interface AnswerServiceType {
     getAnswer?: (offset: number, batchSize: number) => any;