@thoughtspot/visual-embed-sdk 1.29.0-alpha.7 → 1.29.0-alpha.SCAL-205893-1

package/dist/visual-embed-sdk-react.d.ts

@@ -2188,6 +2188,23 @@ export interface EmbedConfig {
             * @version SDK: 1.28.4 | Thoughtspot: 10.0.0.cl, 9.5.0.sw
             */
         currencyFormat?: string;
+        /**
+            * This flag is used to disable the token verification in the SDK.
+            * Enabling this flag will also disable the caching of the token.
+            *
+            * @hidden
+            *
+            * @example
+            * ```js
+            * init({
+            *   ...embedConfig,
+            *   disableTokenVerification : true
+            * })
+            * ```
+            *
+            * @version SDK: 1.28.5 | Thoughtspot: *
+            */
+        disableTokenVerification?: boolean;
 }
 export interface LayoutConfig {
 }
@@ -2787,7 +2804,7 @@ export interface RuntimeFilter {
             * a single operand, whereas other operators like BW and IN accept multiple
             * operands.
             */
-        values: (number | boolean | string)[];
+        values: (number | boolean | string | bigint)[];
 }
 /**
     * A filter that can be applied to ThoughtSpot Answers, Liveboards, or
@@ -2841,6 +2858,8 @@ export declare enum EmbedEvent {
         /**
             * Authentication has either succeeded or failed.
             *
+            * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
+            *
             * @example
             *```js
             * appEmbed.on(EmbedEvent.AuthInit, payload => {
@@ -2854,6 +2873,8 @@ export declare enum EmbedEvent {
             * The embed object container has loaded.
             *
             * @returns timestamp - The timestamp when the event was generated.
+            *
+            * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
             * @example
             *```js
             * liveboardEmbed.on(EmbedEvent.Load, hideLoader)
@@ -2868,6 +2889,8 @@ export declare enum EmbedEvent {
             * Data pertaining to answer or Liveboard is received
             *
             * @return data - The answer or Liveboard data
+            *
+            * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
             * @example
             *```js
             * liveboardEmbed.on(EmbedEvent.Data, payload => {
@@ -2886,6 +2909,7 @@ export declare enum EmbedEvent {
         /**
             * Search query has been updated by the user.
             *
+            * @version SDK: 1.4.0 | ThoughtSpot: ts7.sep.cl, 8.4.1.sw
             * @example
             *```js
             * searchEmbed.on(EmbedEvent.QueryChanged, payload => console.log('data', payload))
@@ -2895,12 +2919,14 @@ export declare enum EmbedEvent {
         /**
             * A drill-down operation has been performed.
             *
+            * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
+            *
             * @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(EmbedEvent.DrillDown, {
+            * searchEmbed.on(EmbedEvent.DrillDown, {
             *    points: {
             *        clickedPoint,
             *        selectedPoints: selectedPoint
@@ -2933,6 +2959,8 @@ export declare enum EmbedEvent {
             * One or more data sources have been selected.
             *
             * @returns dataSourceIds - the list of data sources
+            *
+            * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
             * @example
             * ```js
             * searchEmbed.on(EmbedEvent.DataSourceSelected, payload => {
@@ -2960,6 +2988,8 @@ export declare enum EmbedEvent {
             * @returns actionId - ID of the custom action
             * @returns payload {@link CustomActionPayload} - Response payload with the
             * Answer or Liveboard data
+            *
+            * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
             * @example
             * ```js
             * appEmbed.on(EmbedEvent.customAction, payload => {
@@ -3007,21 +3037,18 @@ export declare enum EmbedEvent {
         /**
             * An error has occurred. This event is fired for the following error types:
             *
-            *  API - API call failure error.
-            *
-            *  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.
+            *  `API` - API call failure error.
+            *  `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.
+            *  `NON_EXIST_FILTER` - Error due to a non-existent filter.
+            *  `INVALID_DATE_VALUE` - Invalid date value error.
+            *  `INVALID_OPERATOR` - Use of invalid operator during filter application.
             *
-            *  NON_EXIST_FILTER - Error due to a non-existent filter.
-            *
-            *  INVALID_DATE_VALUE - Invalid date value error.
-            *
-            *  INVALID_OPERATOR - Use of invalid operator during filter application.
-            *
-            *  For more information, see [Developer Documentation](https://developers.thoughtspot.com/docs/events-app-integration#errorType)
+            *  For more information, see https://developers.thoughtspot.com/docs/events-app-integration#errorType
             *
             * @returns error - An error object or message
+            *
+            * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
             * @example
             * ```js
             * // API error
@@ -3047,6 +3074,9 @@ export declare enum EmbedEvent {
             * The embedded object has sent an alert.
             *
             * @returns alert - An alert object
+            *
+            * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
+            *
             * @example
             * ```js
             * searchEmbed.on(EmbedEvent.Alert)
@@ -3056,6 +3086,8 @@ export declare enum EmbedEvent {
         /**
             * The ThoughtSpot auth session has expired.
             *
+            * @version SDK: 1.4.0 | ThoughtSpot: ts7.sep.cl, 8.4.1.sw
+            *
             * @example
             *```js
             * appEmbed.on(EmbedEvent.AuthExpire, showAuthExpired)
@@ -3109,6 +3141,7 @@ export declare enum EmbedEvent {
         /**
             * Detects the route change.
             *
+            * @version SDK: 1.7.0 | ThoughtSpot: 8.0.0.cl, 8.4.1.sw
             * @example
             *```js
             * searchEmbed.on(EmbedEvent.RouteChange, payload =>
@@ -3189,8 +3222,7 @@ export declare enum EmbedEvent {
             */
         LiveboardRendered = "PinboardRendered",
         /**
-            * This can be used to register an event listener which
-            * is triggered on all events.
+            * Emits all events.
             *
             * @Version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
             * @example
@@ -3207,13 +3239,13 @@ export declare enum EmbedEvent {
             * @Version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //Emit when action starts
             *  searchEmbed.on(EmbedEvent.Save, payload => {
             *    console.log('Save', payload)
             *  }, {
             *    start: true
             * })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.Save, payload => {
             *    console.log('Save', payload)
             * })
@@ -3231,7 +3263,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * liveboardEmbed.trigger(HostEvent.Download, {
+            * liveboardEmbed.on(EmbedEvent.Download, {
             * vizId: '730496d6-6903-4601-937e-2c691821af3c'
             * })
             *```
@@ -3243,10 +3275,10 @@ export declare enum EmbedEvent {
             * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.0.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
             *   console.log('download PNG', payload)}, {start: true })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
             *   console.log('download PNG', payload)})
             *```
@@ -3258,10 +3290,10 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
             *   console.log('download PDF', payload)}, {start: true })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
             *   console.log('download PDF', payload)})
             *```
@@ -3273,10 +3305,10 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
             *   console.log('download CSV', payload)}, {start: true })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
             *    console.log('download CSV', payload)})
             *```
@@ -3288,10 +3320,10 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
             *   console.log('download Xlsx', payload)}, { start: true })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
             *   console.log('download Xlsx', payload)})
             *```
@@ -3303,7 +3335,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
             *    console.log('delete answer', payload)}, {start: true })
             * //trigger when action is completed
@@ -3318,13 +3350,13 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * searchEmbed.on(EmbedEvent.Pin, payload => {
             *    console.log('pin', payload)
             * }, {
             * start: true
             * })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.Pin, payload => {
             *    console.log('pin', payload)
             * })
@@ -3337,13 +3369,13 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
             *   console.log('SpotIQAnalyze', payload)
             * }, {
             * start: true
             * })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
             *   console.log('SpotIQ analyze', payload)
             * })
@@ -3356,13 +3388,13 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * searchEmbed.on(EmbedEvent.Share, payload => {
             *    console.log('Share', payload)
             * }, {
             * start: true
             * })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.Share, payload => {
             *   console.log('Share', payload)
             * })
@@ -3437,10 +3469,10 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * searchEmbed.on(EmbedEvent.ExportTML, payload => {
             *     console.log('Export TML', payload)}, { start: true })
-            * //trigger when action ends
+            * //emit when action ends
             * searchEmbed.on(EmbedEvent.ExportTML, payload => {
             *     console.log('Export TML', payload)})
             *```
@@ -3464,10 +3496,10 @@ export declare enum EmbedEvent {
             * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
             * @example
             *```js
-            * //trigger when action starts
+            * //emit when action starts
             * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
             *    console.log('Copy and edit', payload)}, {start: true })
-            * //trigger when action ends
+            * //emit when action ends
             * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
             *    console.log('Copy and edit', payload)})
             *```
@@ -3569,7 +3601,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             * @example
             *```js
-            * liveboardEmbed.trigger(HostEvent.Present)
+            * liveboardEmbed.on(EmbedEvent.Present)
             *```
             * @example
             *```js
@@ -3585,7 +3617,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             * @example
             *```js
-            * liveboardEmbed.trigger(EmbedEvent.Delete,
+            * liveboardEmbed.on(EmbedEvent.Delete,
             *   {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
             *```
             */
@@ -3596,7 +3628,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             * @example
             *```js
-            * liveboardEmbed.trigger(EmbedEvent.SchedulesList)
+            * liveboardEmbed.on(EmbedEvent.SchedulesList)
             *```
             */
         SchedulesList = "schedule-list",
@@ -3606,7 +3638,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             * @example
             *```js
-            * liveboardEmbed.trigger(EmbedEvent.Cancel)
+            * liveboardEmbed.on(EmbedEvent.Cancel)
             *```
             */
         Cancel = "cancel",
@@ -3616,7 +3648,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             * @example
             *```js
-            * liveboardEmbed.trigger(EmbedEvent.Explore,  {
+            * liveboardEmbed.on(EmbedEvent.Explore,  {
             *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
             *```
             */
@@ -3627,7 +3659,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             * @example
             *```js
-            * liveboardEmbed.trigger(EmbedEvent.CopyLink, {
+            * liveboardEmbed.on(EmbedEvent.CopyLink, {
             *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
             *```
             */
@@ -4005,7 +4037,7 @@ export declare enum HostEvent {
             *
             * @example
             * ```js
-            * liveboardEmbed.trigger(HostEvent.getexportrequestforcurrentpinboard).then(
+            * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard).then(
             * data=>console.log(data))
             * ```
             * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1.sw
@@ -4469,7 +4501,7 @@ export declare enum HostEvent {
             *
             * ```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]}
             * })
             * ```
             * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
@@ -5619,7 +5651,7 @@ export declare enum Action {
             * disabledActions: [Action.TML] // to disable all TML actions
             * ```
             *
-            * @version SDK : 1.28.2 | Thoughtspot: 9.10.5.cl
+            * @version SDK : 1.28.3 | Thoughtspot: 9.12.0.cl
             */
         TML = "tml",
         /**
@@ -6269,12 +6301,6 @@ export declare let loggedInStatus: boolean;
 export declare let samlAuthWindow: Window;
 export declare let samlCompletionPromise: Promise<void>;
 export declare const SSO_REDIRECTION_MARKER_GUID = "5e16222e-ef02-43e9-9fbd-24226bf3ce5b";
-interface sessionInfoInterface {
-        userGUID: any;
-        isPublicUser: any;
-        mixpanelToken: any;
-        [key: string]: any;
-}
 /**
     * Enum for auth failure types. This is the parameter passed to the listner
     * of {@link AuthStatus.FAILURE}.
@@ -6392,7 +6418,7 @@ export declare function notifyAuthSDKSuccess(): void;
 /**
     *
     */
-export declare function notifyAuthSuccess(): void;
+export declare function notifyAuthSuccess(): Promise<void>;
 /**
     *
     * @param failureType
@@ -6402,19 +6428,23 @@ export declare function notifyAuthFailure(failureType: AuthFailureType): void;
     *
     */
 export declare function notifyLogout(): void;
-export declare const initSession: (sessionDetails: sessionInfoInterface) => void;
-export declare const getSessionDetails: (sessionInfoResp: any) => sessionInfoInterface;
 /**
-    * Return releaseVersion if available
+    * Services to be called after the login is successful,
+    * This should be called after the cookie is set for cookie auth or
+    * after the token is set for cookieless.
+    *
+    * @return {Promise<void>}
+    * @example
+    * ```js
+    * await postLoginService();
+    * ```
+    * @version SDK: 1.28.3 | ThoughtSpot: *
     */
-export declare function getReleaseVersion(): string;
+export declare function postLoginService(): Promise<void>;
 /**
-    * Return a promise that resolves with the session information when
-    * authentication is successful. And info is available.
-    *
-    * @group Global methods
+    * Return releaseVersion if available
     */
-export declare function getSessionInfo(): Promise<sessionInfoInterface>;
+export declare function getReleaseVersion(): string;
 /**
     * Perform token based authentication
     *
@@ -6450,7 +6480,72 @@ export declare const authenticate: (embedConfig: EmbedConfig) => Promise<boolean
     * Check if we are authenticated to the ThoughtSpot cluster
     */
 export declare const isAuthenticated: () => boolean;
-export {};
+
+export type SessionInfo = {
+        releaseVersion: string;
+        userGUID: string;
+        currentOrgId: number;
+        privileges: string[];
+        mixpanelToken: string;
+        isPublicUser: boolean;
+        clusterId: string;
+        clusterName: string;
+        [key: string]: any;
+};
+/**
+    * Returns the session info object and caches it for future use.
+    * Once fetched the session info object is cached and returned from the cache on
+    * subsequent calls.
+    *
+    * @example ```js
+    * const sessionInfo = await getSessionInfo();
+    * console.log(sessionInfo);
+    * ```
+    * @version SDK: 1.28.3 | ThoughtSpot: *
+    * @returns {Promise<SessionInfo>} The session info object.
+    */
+export declare function getSessionInfo(): Promise<SessionInfo>;
+/**
+    * Returns the cached session info object. If the client is not authenticated the
+    * function will return null.
+    *
+    * @example ```js
+    * const sessionInfo = getCachedSessionInfo();
+    * if (sessionInfo) {
+    *   console.log(sessionInfo);
+    * } else {
+    *   console.log('Not authenticated');
+    * }
+    * ```
+    * @returns {SessionInfo | null} The session info object.
+    * @version SDK: 1.28.3 | ThoughtSpot: *
+    */
+export declare function getCachedSessionInfo(): SessionInfo | null;
+/**
+    * Processes the session info response and returns the session info object.
+    *
+    *  @param sessionInfoResp {any} Response from the session info API.
+    *  @returns {SessionInfo} The session info object.
+    *  @example ```js
+    *  const sessionInfoResp = await fetch(sessionInfoPath);
+    *  const sessionInfo = getSessionDetails(sessionInfoResp);
+    *  console.log(sessionInfo);
+    *  ```
+    * @version SDK: 1.28.3 | ThoughtSpot: *
+    */
+export declare const getSessionDetails: (sessionInfoResp: any) => SessionInfo;
+/**
+    * Resets the cached session info object and forces a new fetch on the next call.
+    *
+    * @example ```js
+    * resetCachedSessionInfo();
+    * const sessionInfo = await getSessionInfo();
+    * console.log(sessionInfo);
+    * ```
+    * @version SDK: 1.28.3 | ThoughtSpot ts7.april.cl, 7.2.1
+    * @returns {void}
+    */
+export declare function resetCachedSessionInfo(): void;
 
 /**
     * The list of customization css variables. These
@@ -6824,6 +6919,16 @@ export interface UnderlyingDataPoint {
     *     const data = await underlying.fetchData(0, 100);
     *  })
     * ```
+    * @example
+    * ```js
+    * embed.on(EmbedEvent.Data, async (e) => {
+    *     const service = await embed.getAnswerService();
+    *     await service.addColumns([
+    *         "<column guid>"
+    *     ]);
+    *     console.log(await service.fetchData());
+    * });
+    * ```
     * @version SDK: 1.25.0| ThoughtSpot: 9.10.0.cl
     * @group Events
     */
@@ -6963,7 +7068,7 @@ export declare function uploadMixpanelEvent(eventId: string, eventProps?: {}): v
     *
     * @param sessionInfo
     */
-export declare function initMixpanel(sessionInfo: any): void;
+export declare function initMixpanel(sessionInfo: SessionInfo): void;
 /**
     *
     */
@@ -6980,7 +7085,7 @@ export declare function testResetMixpanel(): void;
   */
 export declare const tokenizedFetch: typeof fetch;
 
-export declare const getAuthenticationToken: (embedConfig: EmbedConfig) => Promise<string>;
+export declare function getAuthenticationToken(embedConfig: EmbedConfig): Promise<string>;
 /**
   * Resets the auth token and a new token will be fetched on the next request.
   *