@thoughtspot/visual-embed-sdk 1.26.6 → 1.26.7

package/lib/src/types.js

@@ -29,10 +29,14 @@ export var AuthType;
      */
     AuthType["None"] = "None";
     /**
-     * Passthrough SSO to the embedded App within the iframe. Requires least
+     * Passthrough SSO to the embedded application within the iframe. Requires least
      * configuration, but may not be supported by all IDPs. This will behave like `None`
      * if SSO is not configured on ThoughtSpot.
      *
+     * To use this:
+     * Your SAML or OpenID provider must allow iframe redirects.
+     * For example, if you are using Okta as IdP, you can enable iframe embedding.
+     *
      * @example
      * ```js
      * init({
@@ -40,12 +44,7 @@ export var AuthType;
      *   authType: AuthType.EmbeddedSSO,
      *  });
      * ```
-     * Set authentication type as Embedded SSO.
-     *
-     * To use this:
-     * Your SAML or OpenID provider must allow iframe redirects.
-     * eg. If you are using okta as IdP, you can enable iFrame embedding.
-     * @version: SDK: 1.15.0 | ThouhgtSpot: 8.8.0.cl
+     * @version: SDK: 1.15.0 | ThoughtSpot: 8.8.0.cl
      */
     AuthType["EmbeddedSSO"] = "EmbeddedSSO";
     /**
@@ -64,10 +63,10 @@ export var AuthType;
     AuthType["SAML"] = "SSO_SAML";
     /**
      * SSO using SAML
-     * Will make the host application redirect to the SAML Idp. Use this
-     * when the idp does not allow itself to be embedded.
+     * Makes the host application redirect to the SAML IdP. Use this
+     * if your IdP does not allow itself to be embedded.
      *
-     * This redirects the host application to the SAML Idp. The host application
+     * This redirects the host application to the SAML IdP. The host application
      * will be redirected back to the ThoughtSpot app after authentication.
      *
      * @example
@@ -78,7 +77,7 @@ export var AuthType;
      *  });
      * ```
      *
-     * This opens the SAML Idp in a popup window. The popup is triggered
+     * This opens the SAML IdP in a popup window. The popup is triggered
      * when the user clicks the trigger button. The popup window will be
      * closed automatically after authentication.
      * @example
@@ -92,8 +91,8 @@ export var AuthType;
      * });
      * ```
      *
-     * Can also use event to trigger the popup flow. Works the same
-     * as above example.
+     * Can also use the event to trigger the popup flow. Works the same
+     * as the above example.
      * @example
      * ```js
      * const authEE = init({
@@ -117,7 +116,7 @@ export var AuthType;
     AuthType["OIDC"] = "SSO_OIDC";
     /**
      * SSO using OIDC
-     * Will make the host application redirect to the OIDC Idp.
+     * Will make the host application redirect to the OIDC IdP.
      * See code samples in {@link SAMLRedirect}.
      */
     AuthType["OIDCRedirect"] = "SSO_OIDC";
@@ -129,8 +128,8 @@ export var AuthType;
      */
     AuthType["AuthServer"] = "AuthServer";
     /**
-     * Trusted authentication server, Use your own authentication server
-     * which returns a bearer token, generated using the secret_key obtained
+     * Trusted authentication server. Use your own authentication server
+     * which returns a bearer token, generated using the `secret_key` obtained
      * from ThoughtSpot.
      *
      * @example
@@ -147,11 +146,11 @@ export var AuthType;
      */
     AuthType["TrustedAuthToken"] = "AuthServer";
     /**
-     * Trusted authentication server Cookieless, Use you own authentication
-     * server which returns a bearer token, generated using the secret_key
+     * Trusted authentication server Cookieless, Use your own authentication
+     * server which returns a bearer token, generated using the `secret_key`
      * obtained from ThoughtSpot. This uses a cookieless authentication
-     * approach, recommended to by pass third-party cookie-blocking restriction
-     * implemented by some browsers
+     * approach, recommended to bypass the third-party cookie-blocking restriction
+     * implemented by some browsers.
      *
      * @example
      * ```js
@@ -164,7 +163,7 @@ export var AuthType;
      *      .then((data) => data.token);
      *  }
      * ```
-     * @version SDK: 1.22.0| ThouhgtSpot: 9.3.0.cl, 9.5.1.sw
+     * @version SDK: 1.22.0| ThoughtSpot: 9.3.0.cl, 9.5.1.sw
      */
     AuthType["TrustedAuthTokenCookieless"] = "AuthServerCookieless";
     /**
@@ -251,7 +250,7 @@ export var RuntimeFilterOp;
     RuntimeFilterOp["IN"] = "IN";
 })(RuntimeFilterOp || (RuntimeFilterOp = {}));
 /**
- * Home page module that can be hide
+ * Home page module that can be hidden
  */
 // eslint-disable-next-line no-shadow
 export var HomepageModule;
@@ -269,7 +268,7 @@ export var HomepageModule;
      */
     HomepageModule["Favorite"] = "FAVORITE";
     /**
-     * List of answers and liveboards
+     * List of answers and Liveboards
      */
     HomepageModule["MyLibrary"] = "MY_LIBRARY";
     /**
@@ -307,12 +306,26 @@ export var EmbedEvent;
     /**
      * Rendering has initialized.
      *
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Init, showLoader)
+     *  //show a loader
+     * function showLoader() {
+     * document.getElementById("loader");
+     * }
+     *```
      * @returns timestamp - The timestamp when the event was generated.
      */
     EmbedEvent["Init"] = "init";
     /**
      * Authentication has either succeeded or failed.
      *
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.AuthInit, payload => {
+     *    console.log('AuthInit', payload);
+     * })
+     *```
      * @returns isLoggedIn - A Boolean specifying whether authentication was successful.
      */
     EmbedEvent["AuthInit"] = "authInit";
@@ -320,37 +333,91 @@ export var EmbedEvent;
      * The embed object container has loaded.
      *
      * @returns timestamp - The timestamp when the event was generated.
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Load, hideLoader)
+     *    //hide loader
+     * function hideLoader() {
+     *   document.getElementById("loader");
+     * }
+     *```
      */
     EmbedEvent["Load"] = "load";
     /**
      * Data pertaining to answer or Liveboard is received
      *
      * @return data - The answer or Liveboard data
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Data, payload => {
+     *    console.log('data', payload);
+     * })
+     *```
      * @important
      */
     EmbedEvent["Data"] = "data";
     /**
-     * Search/answer/Liveboard filters have been applied/updated by the user.
+     * Search/Answer/Liveboard filters have been applied/updated by the user.
      *
      * @hidden
      */
     EmbedEvent["FiltersChanged"] = "filtersChanged";
     /**
      * Search query has been updated by the user.
+     *
+     * @example
+     *```js
+     * searchEmbed.on(EmbedEvent.QueryChanged, payload => console.log('data', payload))
+     *```
      */
     EmbedEvent["QueryChanged"] = "queryChanged";
     /**
-     * A drill down operation has been performed.
+     * A drill-down operation has been performed.
      *
      * @returns additionalFilters - Any additional filters applied
      * @returns drillDownColumns - The columns on which drill down was performed
      * @returns nonFilteredColumns - The columns that were not filtered
+     * @example
+     *```js
+     * searchEmbed.trigger(HostEvent.DrillDown, {
+     *    points: {
+     *        clickedPoint,
+     *        selectedPoints: selectedPoint
+     *    },
+     *    autoDrillDown: true,
+     * })
+     *```
+     * In this example, `VizPointDoubleClick` event is used for
+     * triggering the `DrillDown` event when an area or specific
+     * data point on a table or chart is double-clicked.
+     * @example
+     *```js
+     * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
+     *   console.log(payload);
+     *   const clickedPoint = payload.data.clickedPoint;
+     *   const selectedPoint = payload.data.selectedPoints;
+     *   console.log('>>> called', clickedPoint);
+     *   embed.trigger(HostEvent.DrillDown, {
+     *      points: {
+     *      clickedPoint,
+     *          selectedPoints: selectedPoint
+     *     },
+     *   autoDrillDown: true,
+     *     })
+     * })
+     *```
      */
     EmbedEvent["Drilldown"] = "drillDown";
     /**
      * One or more data sources have been selected.
      *
      * @returns dataSourceIds - the list of data sources
+     * @example
+     * ```js
+     * searchEmbed.on(EmbedEvent.DataSourceSelected, payload => {
+     *    console.log('DataSourceSelected', payload);
+     * })
+     * ```
      */
     EmbedEvent["DataSourceSelected"] = "dataSourceSelected";
     /**
@@ -358,25 +425,49 @@ export var EmbedEvent;
      *
      * @returns columnIds - the list of columns
      * @version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
+     * @example
+     * ```js
+     * appEmbed.on(EmbedEvent.AddRemoveColumns, payload => {
+     *   console.log('AddRemoveColumns', payload);
+     * })
+     * ```
      */
     EmbedEvent["AddRemoveColumns"] = "addRemoveColumns";
     /**
-     * A custom action has been triggered
+     * A custom action has been triggered.
      *
-     * @returns actionId - The id of the custom action
-     * @returns data - The answer or Liveboard data
+     * @returns actionId - ID of the custom action
+     * @returns data - Response payload with the Answer or Liveboard data
+     * @example
+     * ```js
+     * appEmbed.on(EmbedEvent.customAction, payload => {
+     *     const data = payload.data;
+     *     if (data.id === 'insert Custom Action ID here') {
+     *         console.log('Custom Action event:', data.embedAnswerData);
+     *     }
+     * })
+     * ```
      */
     EmbedEvent["CustomAction"] = "customAction";
     /**
-     * Listen to double clicks on a visualization
+     * Listen to double click actions on a visualization.
      *
-     * @return ContextMenuInputPoints - data point that is double clicked
+     * @return ContextMenuInputPoints - Data point that is double-clicked
      * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
+     * @example
+     * ```js
+     * livebaordEmbed.on(EmbedEvent.VizPointDoubleClick, payload => {
+     *      console.log('VizPointDoubleClick', payload)
+     * })
+     * ```
      */
     EmbedEvent["VizPointDoubleClick"] = "vizPointDoubleClick";
     /**
-     * Listen to clicks on a visualization in a liveboard or Search result.
+     * Listen to clicks on a visualization in a Liveboard or Search result.
      *
+     * @return viz, clickedPoint - metadata about the point that is clicked
+     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @important
      * @example
      * ```js
      * embed.on(ThoughtSpotEmbed.Event.VizPointClick, ({data}) => {
@@ -389,25 +480,42 @@ export var EmbedEvent;
      *   )
      * });
      * ```
-     * @return viz, clickedPoint - metadata about point that is clicked
-     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
-     * @important
      */
     EmbedEvent["VizPointClick"] = "vizPointClick";
     /**
      * An error has occurred.
      *
      * @returns error - An error object or message
+     * @example
+     * ```js
+     * SearchEmbed.on(EmbedEvent.Error, showErrorMsg)
+     * //show error messaage
+     *  function showErrorMsg() {
+     *    document.getElementById("error");
+     * ```
      */
     EmbedEvent["Error"] = "Error";
     /**
-     * The embedded object has sent an alert
+     * The embedded object has sent an alert.
      *
      * @returns alert - An alert object
+     * @example
+     * ```js
+     * searchEmbed.on(EmbedEvent.Alert)
+     * ```
      */
     EmbedEvent["Alert"] = "alert";
     /**
      * The ThoughtSpot auth session has expired.
+     *
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.AuthExpire, showAuthExpired)
+     * //show auth expired banner
+     * function showAuthExpired() {
+     *    document.getElementById("authExpiredBanner");
+     * }
+     *```
      */
     EmbedEvent["AuthExpire"] = "ThoughtspotAuthExpired";
     /**
@@ -437,14 +545,27 @@ export var EmbedEvent;
      */
     EmbedEvent["EmbedIframeCenter"] = "EmbedIframeCenter";
     /**
-     * Emitted when  the "Get Data" button in Search Bar embed
-     * is clicked.
+     * Emitted when the **Get Data** action is initiated.
+     * Applicable to `SearchBarEmbed` only.
      *
-     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.0.sw
+     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
+     * @example
+     *```js
+     * searchbarEmbed.on(EmbedEvent.GetDataClick)
+     *  .then(data => {
+     *  console.log('Answer Data:', data);
+     * })
+     *```
      */
     EmbedEvent["GetDataClick"] = "getDataClick";
     /**
      * Detects the route change.
+     *
+     * @example
+     *```js
+     * searchEmbed.on(EmbedEvent.RouteChange, payload =>
+     *    console.log('data', payload))
+     *```
      */
     EmbedEvent["RouteChange"] = "ROUTE_CHANGE";
     /**
@@ -454,10 +575,15 @@ export var EmbedEvent;
      */
     EmbedEvent["V1Data"] = "exportVizDataToParent";
     /**
-     * Emitted when the embed does not have cookie access. This
-     * happens on Safari where third-party cookies are blocked by default.
+     * Emitted when the embed does not have cookie access. This happens
+     * when Safari and other Web browsers block third-party cookies
+     * are blocked by default. `NoCookieAccess` can trigger
      *
-     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.NoCookieAccess)
+     *```
+     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1.sw
      */
     EmbedEvent["NoCookieAccess"] = "noCookieAccess";
     /**
@@ -471,12 +597,24 @@ export var EmbedEvent;
      * Emitted when any modal is opened in the app
      *
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.DialogOpen, payload => {
+     *    console.log('dialog open', payload);
+     *  })
+     *```
      */
     EmbedEvent["DialogOpen"] = "dialog-open";
     /**
      * Emitted when any modal is closed in the app
      *
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.DialogClose, payload => {
+     *     console.log('dialog close', payload);
+     * })
+     *```
      */
     EmbedEvent["DialogClose"] = "dialog-close";
     /**
@@ -485,6 +623,21 @@ export var EmbedEvent;
      * other events on the rendered Liveboard.
      *
      * @version SDK: 1.9.1 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.LiveboardRendered, payload => {
+           console.log('Liveboard is rendered', payload);
+       })
+     *```
+     * The following example shows how to trigger
+     * `SetVisibleVizs` event using LiveboardRendered embed event:
+     * @example
+     *```js
+     * const embedRef = useEmbedRef();
+     * const onLiveboardRendered = () => {
+     * embed.trigger(HostEvent.SetVisibleVizs, ['viz1', 'viz2']);
+     * };
+     *```
      */
     EmbedEvent["LiveboardRendered"] = "PinboardRendered";
     /**
@@ -492,216 +645,470 @@ export var EmbedEvent;
      * is triggered on all events.
      *
      * @Version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.ALL, payload => {
+     *  console.log('Embed Events', payload)
+     * })
+     *```
      */
     EmbedEvent["ALL"] = "*";
     /**
      * Emitted when an Answer is saved in the app
      *
      * @Version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     *  searchEmbed.on(EmbedEvent.Save, payload => {
+     *    console.log('Save', payload)
+     *  }, {
+     *    start: true
+     * })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.Save, payload => {
+     *    console.log('Save', payload)
+     * })
+     *```
      */
     EmbedEvent["Save"] = "save";
     /**
      * Emitted when the download action is triggered on an answer
      *
+     * **Note**: This event is deprecated in v1.21.0.
+     * To fire an event when a download action is initiated on a chart or table,
+     * use `EmbedEvent.DownloadAsPng`, `EmbedEvent.DownloadAsPDF`, `EmbedEvent.DownloadAsCSV`,
+     * or `EmbedEvent.DownloadAsXLSX`
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Download, {
+     * vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * })
+     *```
      */
     EmbedEvent["Download"] = "download";
     /**
      * Emitted when the download action is triggered on an answer
      *
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.0.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
+     *   console.log('download PNG', payload)}, {start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
+     *   console.log('download PNG', payload)})
+     *```
      */
     EmbedEvent["DownloadAsPng"] = "downloadAsPng";
     /**
      * Emitted when the Download as PDF action is triggered on an answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
+     *   console.log('download PDF', payload)}, {start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
+     *   console.log('download PDF', payload)})
+     *```
      */
     EmbedEvent["DownloadAsPdf"] = "downloadAsPdf";
     /**
      * Emitted when the Download as CSV action is triggered on an answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
+     *   console.log('download CSV', payload)}, {start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
+     *    console.log('download CSV', payload)})
+     *```
      */
     EmbedEvent["DownloadAsCsv"] = "downloadAsCsv";
     /**
      * Emitted when the Download as XLSX action is triggered on an answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
+     *   console.log('download Xlsx', payload)}, { start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
+     *   console.log('download Xlsx', payload)})
+     *```
      */
     EmbedEvent["DownloadAsXlsx"] = "downloadAsXlsx";
     /**
-     * Emitted when an answer is deleted in the app
+     * Emitted when an Answer is deleted in the app
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
+     *    console.log('delete answer', payload)}, {start: true })
+     * //trigger when action is completed
+     * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
+     *    console.log('delete answer', payload)})
+     *```
      */
     EmbedEvent["AnswerDelete"] = "answerDelete";
     /**
      * Emitted when an answer is pinned to a Liveboard
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.Pin, payload => {
+     *    console.log('pin', payload)
+     * }, {
+     * start: true
+     * })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.Pin, payload => {
+     *    console.log('pin', payload)
+     * })
+     *```
      */
     EmbedEvent["Pin"] = "pin";
     /**
      * Emitted when SpotIQ analysis is triggered
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
+     *   console.log('SpotIQAnalyze', payload)
+     * }, {
+     * start: true
+     * })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
+     *   console.log('SpotIQ analyze', payload)
+     * })
+     *```
      */
     EmbedEvent["SpotIQAnalyze"] = "spotIQAnalyze";
     /**
      * Emitted when a user shares an object with another user or group
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.Share, payload => {
+     *    console.log('Share', payload)
+     * }, {
+     * start: true
+     * })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.Share, payload => {
+     *   console.log('Share', payload)
+     * })
+     *```
      */
     EmbedEvent["Share"] = "share";
     /**
-     * Emitted when a user clicks the Include action to include a specific value or data
-     * on a chart or table
+     * Emitted when a user clicks the **Include** action to include a specific value or
+     * data on a chart or table.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.DrillInclude, payload => {
+     *    console.log('Drill include', payload);
+     * })
+     *```
      */
     EmbedEvent["DrillInclude"] = "context-menu-item-include";
     /**
-     * Emitted when a user clicks the Exclude action to exclude a specific value or data
-     * on a chart or table
+     * Emitted when a user clicks the **Exclude** action to exclude a specific value or
+     * data on a chart or table
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.DrillExclude, payload => {
+     *     console.log('Drill exclude', payload);
+     * })
+     *```
      */
     EmbedEvent["DrillExclude"] = "context-menu-item-exclude";
     /**
-     * Emitted when copied column value on the app
+     * Emitted when a column value is copied in the embedded app.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * seachEmbed.on(EmbedEvent.CopyToClipboard, payload => {
+     *    console.log('copy to clipboard', payload);
+     * })
+     *```
      */
     EmbedEvent["CopyToClipboard"] = "context-menu-item-copy-to-clipboard";
     /**
-     * Emitted when a user clicks the Update TML action
+     * Emitted when a user clicks the **Update TML** action
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.UpdateTML)
+     * })
+     *```
      */
     EmbedEvent["UpdateTML"] = "updateTSL";
     /**
-     * Emitted when a user clicks the Edit TML action
+     * Emitted when a user clicks the **Edit TML** action
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.EditTML, payload => {
+     *    console.log('Edit TML', payload);
+     * })
+     *```
      */
     EmbedEvent["EditTML"] = "editTSL";
     /**
-     * Emitted when ExportTML trigger in answer on the app
+     * Emitted when the **Export TML** action is triggered on an
+     * an embedded object in the app
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.ExportTML, payload => {
+     *     console.log('Export TML', payload)}, { start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.ExportTML, payload => {
+     *     console.log('Export TML', payload)})
+     *```
      */
     EmbedEvent["ExportTML"] = "exportTSL";
     /**
-     * Emitted when an answer is saved as a view
+     * Emitted when an Answer is saved as a View.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.SaveAsView, payload => {
+     *    console.log('View', payload);
+     * })
+     *```
      */
     EmbedEvent["SaveAsView"] = "saveAsView";
     /**
-     * Emitted when copy of existing answer on the app
+     * Emitted when the user creates a copy of an Answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
+     *    console.log('Copy and edit', payload)}, {start: true })
+     * //trigger when action ends
+     * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
+     *    console.log('Copy and edit', payload)})
+     *```
      */
     EmbedEvent["CopyAEdit"] = "copyAEdit";
     /**
-     * Emitted when a user clicks Show underlying data on an answe
+     * Emitted when a user clicks Show underlying data on an Answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.ShowUnderlyingData, payload => {
+     *    console.log('show data', payload);
+     * })
+     *```
      */
     EmbedEvent["ShowUnderlyingData"] = "showUnderlyingData";
     /**
-     * Emitted when an answer is switched to a chart or table view
+     * Emitted when an answer is switched to a chart or table view.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * searchEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
+     *    console.log('switch view', payload);
+     * })
+     *```
      */
     EmbedEvent["AnswerChartSwitcher"] = "answerChartSwitcher";
     /**
-     * Internal event to communicate the initial settings back to the TS APP
+     * Internal event to communicate the initial settings back to the ThoughtSpot app
      *
      * @hidden
      */
     EmbedEvent["APP_INIT"] = "appInit";
     /**
-     * Emitted when a user clicks Show Liveboard details on a Liveboard
+     * Emitted when a user clicks **Show Liveboard details** on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
+     *    console.log('Liveboard details', payload);
+     * })
+     *```
      */
     EmbedEvent["LiveboardInfo"] = "pinboardInfo";
     /**
      * Emitted when a user clicks on the Favorite icon on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.AddToFavorites, payload => {
+     *    console.log('favorites', payload);
+     * })
+     *```
      */
     EmbedEvent["AddToFavorites"] = "addToFavorites";
     /**
-     * Emitted when a user clicks Schedule on a Liveboard
+     * Emitted when a user clicks **Schedule** on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Schedule, payload => {
+     *    console.log(`Liveboard schedule', payload);
+     * })
+     *```
      */
     EmbedEvent["Schedule"] = "subscription";
     /**
-     * Emitted when a user clicks Edit on a Liveboard or visualization
+     * Emitted when a user clicks **Edit** on a Liveboard or visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Edit, payload => {
+     *    console.log(`Liveboard edit', payload);
+     * })
+     *```
      */
     EmbedEvent["Edit"] = "edit";
     /**
-     * Emitted when a user clicks Make a copy on a Liveboard
+     * Emitted when a user clicks *Make a copy* on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.MakeACopy, payload => {
+     *    console.log(`Copy', payload);
+     * })
+     *```
      */
     EmbedEvent["MakeACopy"] = "makeACopy";
     /**
-     * Emitted when a user clicks Present on a Liveboard or visualization
+     * Emitted when a user clicks **Present** on a Liveboard or visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Present)
+     *```
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Present, {
+     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * })
+     *```
      */
     EmbedEvent["Present"] = "present";
     /**
-     * Emitted when a user clicks Delete on a Liveboard
+     * Emitted when a user clicks **Delete** on a visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Delete,
+     *   {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *```
      */
     EmbedEvent["Delete"] = "delete";
     /**
      * Emitted when a user clicks Manage schedules on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.SchedulesList)
+     *```
      */
     EmbedEvent["SchedulesList"] = "schedule-list";
     /**
-     * Emitted when a user clicks Cancel in edit mode on a Liveboard
+     * Emitted when a user clicks **Cancel** in edit mode on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Cancel)
+     *```
      */
     EmbedEvent["Cancel"] = "cancel";
     /**
-     * Emitted when a user clicks Explore on a visualization
+     * Emitted when a user clicks **Explore** on a visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Explore,  {
+     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *```
      */
     EmbedEvent["Explore"] = "explore";
     /**
-     * Emitted when a user clicks Copy link action on a visualization
+     * Emitted when a user clicks **Copy link** action on a visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.CopyLink, {
+     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *```
      */
     EmbedEvent["CopyLink"] = "embedDocument";
     /**
-     * Emitted when a user interacts with cross filters on a visualization or liveboard
+     * Emitted when a user interacts with cross filters on a visualization or Liveboard
      *
-     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
+     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.CrossFilterChanged, {
+     *    vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *```
      */
     EmbedEvent["CrossFilterChanged"] = "cross-filter-changed";
     /**
      * Emitted when a user right clicks on a visualization (chart or table)
      *
-     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
+     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
+     * @example
+     *```js
+     * LiveboardEmbed.on(EmbedEvent.VizPointRightClick, payload => {
+     *    console.log('VizPointClick', payload)
+     * })
+     *```
      */
     EmbedEvent["VizPointRightClick"] = "vizPointRightClick";
     /**
-     * Emitted when a user clicks on Insert to slide on a visualization
+     * Emitted when a user clicks **Insert to slide** on a visualization
      *
      * @hidden
      */
@@ -709,52 +1116,52 @@ export var EmbedEvent;
     /**
      * @hidden
      * Emitted when a user changes any filter on a Liveboard.
-     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
+     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.0.sw
      */
     EmbedEvent["FilterChanged"] = "filterChanged";
     /**
-     *  Emitted when a user click on Go button in Sage Embed
+     *  Emitted when a user clicks the **Go** button on the Search page
      *
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     EmbedEvent["SageEmbedQuery"] = "sageEmbedQuery";
     /**
-     * Emitten when a user select data source in Sage Embed
+     * Emitted when a user selects a data source.
      *
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     EmbedEvent["SageWorksheetUpdated"] = "sageWorksheetUpdated";
     /**
-     * Emitted when a user updates a connection in Data tab
+     * Emitted when a user updates a connection on the **Data** page
      *
-     * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
+     * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
      */
     EmbedEvent["UpdateConnection"] = "updateConnection";
     /**
-     * Emitted when a user updates a connection in Data tab
+     * Emitted when a user updates a connection on the **Data** page
      *
-     * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
+     * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
      */
     EmbedEvent["CreateConnection"] = "createConnection";
     /**
      * Emitted when name, status (private or public) or filter values of a
-     * PersonalisedView is updated.
+     * Personalised view is updated.
      *
      * @returns viewName: string
      * @returns viewId: string
      * @returns liveboardId: string
      * @returns isPublic: boolean
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     EmbedEvent["UpdatePersonalisedView"] = "updatePersonalisedView";
     /**
-     * Emitted when a PersonalisedView is saved.
+     * Emitted when a Personalised view is saved.
      *
      * @returns viewName: string
      * @returns viewId: string
      * @returns liveboardId: string
      * @returns isPublic: boolean
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     EmbedEvent["SavePersonalisedView"] = "savePersonalisedView";
     /**
@@ -764,7 +1171,7 @@ export var EmbedEvent;
      * @returns viewId: string
      * @returns liveboardId: string
      * @returns isPublic: boolean
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     EmbedEvent["ResetLiveboard"] = "resetLiveboard";
     /**
@@ -772,20 +1179,30 @@ export var EmbedEvent;
      *
      * @returns views: string[]
      * @returns liveboardId: string
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     EmbedEvent["DeletePersonalisedView"] = "deletePersonalisedView";
     /**
-     * Emitten when a user creates a new worksheet
+     * Emitted when a user creates a new worksheet
      *
      * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
      */
     EmbedEvent["CreateWorksheet"] = "createWorksheet";
     /**
-    * Emitted when a LB/viz is renamed
-    *
-    * @version SDK : 1.28.0 | ThoughtSpot: 9.11.0.cl
-    */
+     * Emitted when Ask Sage is initialized.
+     *
+     * @returns viewName: string
+     * @returns viewId: string
+     * @returns liveboardId: string
+     * @returns isPublic: boolean
+     * @version SDK : 1.29.0 | Thoughtspot: 9.12.0.cl
+     */
+    EmbedEvent["AskSageInit"] = "AskSageInit";
+    /**
+     * Emitted when a LB/viz is renamed
+     *
+     * @version SDK : 1.28.0 | ThoughtSpot: 9.11.0.cl
+     */
     EmbedEvent["Rename"] = "rename";
 })(EmbedEvent || (EmbedEvent = {}));
 /**
@@ -814,15 +1231,16 @@ export var EmbedEvent;
 export var HostEvent;
 (function (HostEvent) {
     /**
-     * Triggers a search query in AppEmbed and SearchEmbed
-     * deployments.
+     * Triggers a search operation with the search tokens specified in
+     * the search query string.
+     * Supported in `AppEmbed` and `SearchEmbed` deployments.
      * Includes the following properties:
      *
-     * @param - dataSourceIds - The data source GUID to Search on
+     * @param - `searchQuery` - query string with search tokens
+     * @param - `dataSources` - Data source GUID to Search on
      *                        - Although an array, only a single source
      *                          is supported.
-     * @param - searchQuery - Query string with search tokens
-     * @param - execute - executes the existing / updated query
+     * @param - `execute` - executes search and updates the existing query
      * @example
      * ```js
      * searchembed.trigger(HostEvent.Search, {
@@ -842,6 +1260,10 @@ export var HostEvent;
      * @param - columnGuid - Optional. GUID of the column to drill
      * by. If not provided it will auto drill by the configured
      *   column.
+     * @param - autoDrillDown - Optional. If true, the drill down will be
+     * done automatically on the most popular column.
+     * @param - vizId [TS >= 9.8.0] - Optional. The GUID of the visualization to drill
+     * in case of a liveboard.
      * @example
      * ```js
      * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
@@ -858,6 +1280,25 @@ export var HostEvent;
      *       });
      * })
      * ```
+     * @example
+     * ```js
+     *  // Works with TS 9.8.0 and above
+     *
+     *  liveboardEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
+     *    console.log(payload);
+     *    const clickedPoint = payload.data.clickedPoint;
+     *    const selectedPoint = payload.data.selectedPoints;
+     *    console.log('>>> called', clickedPoint);
+     *    liveboardEmbed.trigger(HostEvent.DrillDown, {
+     *      points: {
+     *        clickedPoint,
+     *        selectedPoints: selectedPoint
+     *      },
+     *      autoDrillDown: true,
+     *      vizId: payload.data.vizId
+     *    });
+     *  })
+     * ```
      * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
      */
     HostEvent["DrillDown"] = "triggerDrillDown";
@@ -874,7 +1315,7 @@ export var HostEvent;
      */
     HostEvent["Reload"] = "reload";
     /**
-     * Sets the visible visualizations on a Liveboard.
+     * Display specific visualizations on a Liveboard.
      *
      * @param - An array of GUIDs of the visualization to show. The visualization IDs not passed
      *  in this parameter will be hidden.
@@ -888,7 +1329,7 @@ export var HostEvent;
      */
     HostEvent["SetVisibleVizs"] = "SetPinboardVisibleVizs";
     /**
-     * Set the Active Tab of a Liveboard.
+     * Set a Liveboard tab as an active tab.
      *
      * @param - tabId - string of id of Tab to show
      * @example
@@ -901,7 +1342,7 @@ export var HostEvent;
      */
     HostEvent["SetActiveTab"] = "SetActiveTab";
     /**
-     * Updates runtime filters applied on a Saved Answer or Liveboard. The
+     * Update runtime filters applied on a Saved Answer or Liveboard. The
      * runtime filters passed here are appended to the existing runtime
      * filters.
      * Pass an array of runtime filters with the following attributes:
@@ -927,10 +1368,11 @@ export var HostEvent;
      */
     HostEvent["UpdateRuntimeFilters"] = "UpdateRuntimeFilters";
     /**
-     * Navigate to a specific page in the embedded application without reloading the page.
+     * Navigate to a specific page in the embedded ThoughtSpot application.
      * This is the same as calling `appEmbed.navigateToPage(path, true)`
      *
-     * @param - path - the path to navigate to (can be a number[1/-1] to go forward/back)
+     * @param - `path` - the path to navigate to to go forward or back. The path value can
+     * be a number; for example, `1`, `-1`.
      * @example
      * ```js
      * appEmbed.navigateToPage(-1)
@@ -939,7 +1381,7 @@ export var HostEvent;
      */
     HostEvent["Navigate"] = "Navigate";
     /**
-     * Opens the filter panel for a particular column.
+     * Open the filter panel for a particular column.
      * Works with Search and Liveboard embed.
      *
      * @param - { columnId: string,
@@ -957,7 +1399,7 @@ export var HostEvent;
      */
     HostEvent["OpenFilter"] = "openFilter";
     /**
-     * Adds columns to the current search query.
+     * Add columns to the current search query.
      *
      * @param - { columnIds: string[] }
      * @example
@@ -968,7 +1410,7 @@ export var HostEvent;
      */
     HostEvent["AddColumns"] = "addColumns";
     /**
-     * Removes a column from the current search query.
+     * Remove a column from the current search query.
      *
      * @param - { columnId: string }
      * @example
@@ -979,27 +1421,29 @@ export var HostEvent;
      */
     HostEvent["RemoveColumn"] = "removeColumn";
     /**
-     * Gets the current Liveboard content.
+     * Get the transient state of a Liveboard as encoded content.
+     * This includes unsaved and ad hoc changes such as
+     * Liveboard filters, runtime filters applied on visualizations on a
+     * Liveboard, and Liveboard layout, changes to visualizations such as
+     * sorting, toggling of legends, and data drill down.
      *
      * @example
      * ```js
-     * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard)
+     * liveboardEmbed.trigger(HostEvent.getexportrequestforcurrentpinboard).then(
+     * data=>console.log(data))
      * ```
      * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1.sw
      */
     HostEvent["getExportRequestForCurrentPinboard"] = "getExportRequestForCurrentPinboard";
     /**
-     * Triggers the **Pin** action on an embedded object
+     * Trigger the **Pin** action on an embedded object
      *
      * @param - Liveboard embed takes the `vizId` as a
-     * key. Can be left undefined when embedding Search, full app or
+     * key. Can be left undefined when embedding Search, full app, or
      * a visualization.
      * @example
      * ```js
-     * liveboardEmbed.trigger(HostEvent.Pin, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
-     * ```
-     * ```js
-     * vizEmbed.trigger(HostEvent.Pin)
+     * appEmbed.trigger(HostEvent.Pin)
      * ```
      * ```js
      * searchEmbed.trigger(HostEvent.Pin)
@@ -1008,17 +1452,18 @@ export var HostEvent;
      */
     HostEvent["Pin"] = "pin";
     /**
-     * Triggers the **Show Liveboard details** action on a Liveboard
+     * Trigger the **Show Liveboard details** action
+     * on an embedded Liveboard.
      *
      * @example
-     * ```js
-     *  liveboardEmbed.trigger(HostEvent.LiveboardInfo)
-     * ```
+     *```js
+     * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
+     *```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     HostEvent["LiveboardInfo"] = "pinboardInfo";
     /**
-     * Triggers the **Schedule** action on a Liveboard
+     * Trigger the **Schedule** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1028,7 +1473,7 @@ export var HostEvent;
      */
     HostEvent["Schedule"] = "subscription";
     /**
-     * Triggers the **Manage schedule** action on a Liveboard
+     * Trigger the **Manage schedule** action on an embedded Liveboard
      *
      * @example
      * ```js
@@ -1038,7 +1483,7 @@ export var HostEvent;
      */
     HostEvent["SchedulesList"] = "schedule-list";
     /**
-     * Triggers the **Export TML** action on a Liveboard
+     * Trigger the **Export TML** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1048,7 +1493,7 @@ export var HostEvent;
      */
     HostEvent["ExportTML"] = "exportTSL";
     /**
-     * Triggers the **Edit TML** action on a Liveboard
+     * Trigger the **Edit TML** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1058,7 +1503,7 @@ export var HostEvent;
      */
     HostEvent["EditTML"] = "editTSL";
     /**
-     * Triggers the **Update TML** action on a Liveboard
+     * Trigger the **Update TML** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1068,7 +1513,7 @@ export var HostEvent;
      */
     HostEvent["UpdateTML"] = "updateTSL";
     /**
-     * Triggers the **Download PDF** action on a Liveboard
+     * Trigger the **Download PDF** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1078,8 +1523,8 @@ export var HostEvent;
      */
     HostEvent["DownloadAsPdf"] = "downloadAsPdf";
     /**
-     * Triggers the **Make a copy** action on a Liveboard, Search, or
-     * visualization page
+     * Trigger the **Make a copy** action on a Liveboard, Search, or
+     * visualization page.
      *
      * @example
      * ```js
@@ -1095,7 +1540,7 @@ export var HostEvent;
      */
     HostEvent["MakeACopy"] = "makeACopy";
     /**
-     * Triggers the **Delete** action on a Liveboard
+     * Trigger the **Delete** action for a Liveboard.
      *
      * @example
      * ```js
@@ -1105,7 +1550,7 @@ export var HostEvent;
      */
     HostEvent["Remove"] = "delete";
     /**
-     * Triggers the **Explore* action on a visualization
+     * Trigger the **Explore** action on a visualization.
      *
      * @param - an object with `vizId` as a key
      * @example
@@ -1116,7 +1561,7 @@ export var HostEvent;
      */
     HostEvent["Explore"] = "explore";
     /**
-     * Triggers the **Create alert** action on a visualization
+     * Trigger the **Create alert** action on a visualization
      *
      * @param - an object with `vizId` as a key
      * @example
@@ -1129,7 +1574,7 @@ export var HostEvent;
      */
     HostEvent["CreateMonitor"] = "createMonitor";
     /**
-     * Triggers the **Manage alerts** action on a visualization
+     * Trigger the **Manage alerts** action on a visualization
      *
      * @param - an object with `vizId` as a key
      * @example
@@ -1142,7 +1587,7 @@ export var HostEvent;
      */
     HostEvent["ManageMonitor"] = "manageMonitor";
     /**
-     * Triggers the **Edit** action on a Liveboard or visualization
+     * Trigger the **Edit** action on a Liveboard or visualization
      *
      * @param - object - To trigger the action for a specific visualization
      * in Liveboard embed, pass in `vizId` as a key.
@@ -1163,7 +1608,7 @@ export var HostEvent;
      */
     HostEvent["Edit"] = "edit";
     /**
-     * Triggers the **Copy link** action on a Liveboard or visualization
+     * Trigger the **Copy link** action on a Liveboard or visualization
      *
      * @param - object - to trigger the action for a
      * specific visualization in Liveboard embed, pass in `vizId` as a key
@@ -1181,7 +1626,7 @@ export var HostEvent;
      */
     HostEvent["CopyLink"] = "embedDocument";
     /**
-     * Triggers the **Present** action on a Liveboard or visualization
+     * Trigger the **Present** action on a Liveboard or visualization
      *
      * @param - object - to trigger the action for a specific visualization
      *  in Liveboard embed, pass in `vizId` as a key
@@ -1199,7 +1644,7 @@ export var HostEvent;
      */
     HostEvent["Present"] = "present";
     /**
-     * Gets TML for the current search.
+     * Get TML for the current search.
      *
      * @example
      * ```js
@@ -1214,7 +1659,7 @@ export var HostEvent;
      */
     HostEvent["GetTML"] = "getTML";
     /**
-     * Triggers the **Show underlying data** action on visualization or search
+     * Trigger the **Show underlying data** action on visualization or search
      *
      * @param - an object with vizId as a key
      * @example
@@ -1232,7 +1677,9 @@ export var HostEvent;
      */
     HostEvent["ShowUnderlyingData"] = "showUnderlyingData";
     /**
-     * Triggers the **Delete** action on visualization or search
+     * Trigger the **Delete** action for a visualization
+     * in an embedded Liveboard, or a chart or table
+     * generated from Search.
      *
      * @param - Liveboard embed takes an object with `vizId` as a key.
      * Can be left empty if embedding Search or visualization.
@@ -1242,16 +1689,13 @@ export var HostEvent;
      * '730496d6-6903-4601-937e-2c691821af3c'})
      * ```
      * ```js
-     * vizEmbed.trigger(HostEvent.Delete)
-     * ```
-     * ```js
      * searchEmbed.trigger(HostEvent.Delete)
      * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     HostEvent["Delete"] = "onDeleteAnswer";
     /**
-     * Triggers the **SpotIQ analyze** action on visualization
+     * Trigger the **SpotIQ analyze** action on visualization
      * or search.
      *
      * @param - Liveboard embed takes `vizId` as a
@@ -1272,7 +1716,7 @@ export var HostEvent;
      */
     HostEvent["SpotIQAnalyze"] = "spotIQAnalyze";
     /**
-     * Triggers the **Download** action on charts in
+     * Trigger the **Download** action on charts in
      * the embedded view.
      *
      * @example
@@ -1281,17 +1725,15 @@ export var HostEvent;
      * '730496d6-6903-4601-937e-2c691821af3c'})
      * ```
      * ```js
-     * vizEmbed.trigger(HostEvent.Download)
-     * ```
-     * ```js
-     * searchEmbed.trigger(HostEvent.Download)
+     * embed.trigger(HostEvent.Download)
      * ```
-     * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw ,Use {@link DownloadAsPng}
+     * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw
+     * Use {@link DownloadAsPng}
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     HostEvent["Download"] = "downloadAsPng";
     /**
-     * Triggers the **Download** > **PNG** action on
+     * Trigger the **Download** > **PNG** action on
      * charts in the embedded view.
      *
      * @example
@@ -1307,7 +1749,7 @@ export var HostEvent;
      */
     HostEvent["DownloadAsPng"] = "downloadAsPng";
     /**
-     * Triggers the **Download** > **CSV**  action on tables in
+     * Trigger the **Download** > **CSV**  action on tables in
      * the embedded view.
      *
      * @example
@@ -1325,7 +1767,7 @@ export var HostEvent;
      */
     HostEvent["DownloadAsCsv"] = "downloadAsCSV";
     /**
-     * Triggers the **Download** > **XLSX**  action on tables
+     * Trigger the **Download** > **XLSX**  action on tables
      * in the embedded view.
      *
      * @example
@@ -1343,7 +1785,7 @@ export var HostEvent;
      */
     HostEvent["DownloadAsXlsx"] = "downloadAsXLSX";
     /**
-     * Triggers the **Share** action on an embedded
+     * Trigger the **Share** action on an embedded
      * Liveboard or Answer.
      *
      * @example
@@ -1357,7 +1799,7 @@ export var HostEvent;
      */
     HostEvent["Share"] = "share";
     /**
-     * Triggers the **Save**  action on a Liveboard or Answer.
+     * Trigger the **Save**  action on a Liveboard or Answer.
      * Saves the changes.
      *
      * @example
@@ -1371,7 +1813,7 @@ export var HostEvent;
      */
     HostEvent["Save"] = "save";
     /**
-     * Triggers the **Sync to Sheets** action on an embedded visualization or Answer
+     * Trigger the **Sync to Sheets** action on an embedded visualization or Answer
      * Sends data from an Answer or Liveboard visualization to a Google sheet.
      *
      * @param - an object with `vizId` as a key
@@ -1387,7 +1829,7 @@ export var HostEvent;
      */
     HostEvent["SyncToSheets"] = "sync-to-sheets";
     /**
-     * Triggers the **Sync to Other Apps** action on an embedded visualization or Answer
+     * Trigger the **Sync to Other Apps** action on an embedded visualization or Answer
      * Sends data from an Answer or Liveboard visualization to third-party apps such
      * as Slack, Salesforce, Microsoft Teams, ServiceNow and so on.
      *
@@ -1404,7 +1846,7 @@ export var HostEvent;
      */
     HostEvent["SyncToOtherApps"] = "sync-to-other-apps";
     /**
-     * Triggers the **Manage pipelines** action on an embedded
+     * Trigger the **Manage pipelines** action on an embedded
      * visualization or Answer.
      * Allows users to manage ThoughtSpot Sync pipelines.
      *
@@ -1421,18 +1863,21 @@ export var HostEvent;
      */
     HostEvent["ManagePipelines"] = "manage-pipeline";
     /**
-     * Triggers the Reset search on the Search page
+     * Reset search operation on the Search or Answer page.
      *
      * @example
      * ```js
      * searchEmbed.trigger(HostEvent.ResetSearch)
      * ```
+     * ```js
+     * appEmbed.trigger(HostEvent.ResetSearch)
+     * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.0.1.sw
      */
     HostEvent["ResetSearch"] = "resetSearch";
     /**
      * @hidden
-     * Gets the currents visible and runtime filters applied on a Liveboard
+     * 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
@@ -1440,7 +1885,7 @@ export var HostEvent;
     HostEvent["GetFilters"] = "getFilters";
     /**
      * @hidden
-     * Updates the visible filters on the Liveboard.
+     * Update the visible filters on the Liveboard.
      * @param - filter: filter object containing column name and filter operation and values
      * @example
      *
@@ -1453,7 +1898,7 @@ export var HostEvent;
      */
     HostEvent["UpdateFilters"] = "updateFilters";
     /**
-     * Get Tab for the current Liveboard.
+     * Get tab details for the current Liveboard.
      *
      * @example
      * ```js
@@ -1467,9 +1912,9 @@ export var HostEvent;
      */
     HostEvent["GetTabs"] = "getTabs";
     /**
-     * Set the visible Tabs on a Liveboard.
+     * Set the visible tabs on a Liveboard.
      *
-     * @param - an array of ids of Tabs to show, the ids not passed
+     * @param - an array of ids of tabs to show, the IDs not passed
      *          will be hidden.
      * @example
      * ```js
@@ -1483,8 +1928,8 @@ export var HostEvent;
     /**
      * Set the hidden tabs on a Liveboard.
      *
-     * @param - an array of ids of Tabs to hide, the ids not passed
-     *          will be shown.
+     * @param - an array of the IDs of the tabs to hide.
+     * The IDs not passed will be shown.
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.SetHiddenTabs, [
@@ -1495,9 +1940,10 @@ export var HostEvent;
      */
     HostEvent["SetHiddenTabs"] = "SetPinboardHiddenTabs";
     /**
-     * Updates the search query for sage embed.
+     * Updates the search query string for Natural Language Search operations.
      *
-     * @param - searchOptions: an object queryString and option to execute the query.
+     * @param - `queryString`: Text string in Natural Language format
+     * @param - `executeSearch`: Boolean to execute search and update search query
      * @example
      * ```js
      * sageEmbed.trigger(HostEvent.UpdateSageQuery, {
@@ -1505,7 +1951,7 @@ export var HostEvent;
      *  executeSearch: true,
      * })
      * ```
-     * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
      */
     HostEvent["UpdateSageQuery"] = "updateSageQuery";
     /**
@@ -1518,26 +1964,38 @@ export var HostEvent;
      *      vizId: '123', // For Liveboard Visualization.
      *  })
      * ```
+     * @version SDK: 1.26.0 | Thoughtspot: 9.10.0.cl
      */
     HostEvent["GetAnswerSession"] = "getAnswerSession";
+    /**
+     * Trigger Ask Sage for viz
+     *
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.AskSage,
+     * {vizId:'730496d6-6903-4601-937e-2c691821af3c'})
+     * ```
+     * @version SDK: 1.29.0 | Thoughtspot: 9.12.0.cl
+     */
+    HostEvent["AskSage"] = "AskSage";
 })(HostEvent || (HostEvent = {}));
 /**
  * The different visual modes that the data sources panel within
- * search could appear in, i.e., hidden, collapsed, or expanded.
+ * search could appear in, such as hidden, collapsed, or expanded.
  */
 // eslint-disable-next-line no-shadow
 export var DataSourceVisualMode;
 (function (DataSourceVisualMode) {
     /**
-     * Data source panel is hidden.
+     * The data source panel is hidden.
      */
     DataSourceVisualMode["Hidden"] = "hide";
     /**
-     * Data source panel is collapsed, but the user can manually expand it.
+     * The data source panel is collapsed, but the user can manually expand it.
      */
     DataSourceVisualMode["Collapsed"] = "collapse";
     /**
-     * Data source panel is expanded, but the user can manually collapse it.
+     * The data source panel is expanded, but the user can manually collapse it.
      */
     DataSourceVisualMode["Expanded"] = "expand";
 })(DataSourceVisualMode || (DataSourceVisualMode = {}));
@@ -1617,6 +2075,10 @@ export var Param;
     Param["IsProductTour"] = "isProductTour";
     Param["HideSearchBarTitle"] = "hideSearchBarTitle";
     Param["HideSageAnswerHeader"] = "hideSageAnswerHeader";
+    Param["HideSearchBar"] = "hideSearchBar";
+    Param["ClientLogLevel"] = "clientLogLevel";
+    Param["OverrideNativeConsole"] = "overrideConsoleLogs";
+    Param["enableAskSage"] = "enableAskSage";
 })(Param || (Param = {}));
 /**
  * ThoughtSpot application pages include actions and menu commands
@@ -1678,9 +2140,11 @@ export var Action;
     Action["SaveAsView"] = "saveAsView";
     /**
      * The **Make a copy** action on a Liveboard or Answer
-     * page.
-     * Creates a copy of the Liveboard, visualization,
-     * or Answer.
+     * page. Creates a copy of the Liveboard.
+     * In LiveboardEmbed, the **Make a copy** action is not available for
+     * visualizations in the embedded Liveboard view.
+     * In AppEmbed, the **Make a copy** action is available on both
+     * Liveboards and visualizations.
      *
      * @example
      * ```js
@@ -1864,7 +2328,7 @@ export var Action;
      */
     Action["DownloadAsPdf"] = "downloadAsPdf";
     /**
-     * The **Download**  > **CSV** menu action for tables on a Liveboard
+     * The **Download** > **CSV** menu action for tables on a Liveboard
      * or Answer page.
      * Downloads a visualization or Answer in the XLSX format.
      *
@@ -2395,6 +2859,7 @@ export var Action;
      */
     Action["RenameModalTitleDescription"] = "renameModalTitleDescription";
     /**
+     *
      * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
      */
     Action["RequestVerification"] = "requestVerification";
@@ -2475,6 +2940,16 @@ export var Action;
      *  @version SDK: 1.29.0 | Thoughtspot: 9.10.0.cl
      */
     Action["VerifiedLiveboard"] = "verifiedLiveboard";
+    /**
+     * Action ID for ask sage button
+     *
+     *  @example
+     * ```js
+     * hiddenAction: [Action.AskAi]
+     * ```
+     *  @version SDK: 1.29.0 | Thoughtspot: 9.12.0.cl
+     */
+    Action["AskAi"] = "AskAi";
 })(Action || (Action = {}));
 export var PrefetchFeatures;
 (function (PrefetchFeatures) {
@@ -2491,4 +2966,13 @@ export var ContextMenuTriggerOptions;
     ContextMenuTriggerOptions["LEFT_CLICK"] = "left-click";
     ContextMenuTriggerOptions["RIGHT_CLICK"] = "right-click";
 })(ContextMenuTriggerOptions || (ContextMenuTriggerOptions = {}));
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["SILENT"] = "SILENT";
+    LogLevel["ERROR"] = "ERROR";
+    LogLevel["WARN"] = "WARN";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["TRACE"] = "TRACE";
+})(LogLevel || (LogLevel = {}));
 //# sourceMappingURL=types.js.map