@thoughtspot/visual-embed-sdk 1.26.3 → 1.27.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (188) hide show
  1. package/README.md +3 -3
  2. package/cjs/.DS_Store +0 -0
  3. package/cjs/package.json +1 -1
  4. package/cjs/src/.DS_Store +0 -0
  5. package/cjs/src/auth.d.ts +4 -4
  6. package/cjs/src/auth.d.ts.map +1 -1
  7. package/cjs/src/auth.js +10 -4
  8. package/cjs/src/auth.js.map +1 -1
  9. package/cjs/src/embed/app.d.ts +15 -15
  10. package/cjs/src/embed/app.d.ts.map +1 -1
  11. package/cjs/src/embed/app.js +1 -1
  12. package/cjs/src/embed/app.js.map +1 -1
  13. package/cjs/src/embed/liveboard.d.ts +28 -23
  14. package/cjs/src/embed/liveboard.d.ts.map +1 -1
  15. package/cjs/src/embed/liveboard.js +4 -3
  16. package/cjs/src/embed/liveboard.js.map +1 -1
  17. package/cjs/src/embed/sage.d.ts +48 -30
  18. package/cjs/src/embed/sage.d.ts.map +1 -1
  19. package/cjs/src/embed/sage.js +7 -6
  20. package/cjs/src/embed/sage.js.map +1 -1
  21. package/cjs/src/embed/sage.spec.js +3 -3
  22. package/cjs/src/embed/sage.spec.js.map +1 -1
  23. package/cjs/src/embed/search-bar.d.ts +22 -6
  24. package/cjs/src/embed/search-bar.d.ts.map +1 -1
  25. package/cjs/src/embed/search-bar.js.map +1 -1
  26. package/cjs/src/embed/search.d.ts +34 -19
  27. package/cjs/src/embed/search.d.ts.map +1 -1
  28. package/cjs/src/embed/search.js +7 -3
  29. package/cjs/src/embed/search.js.map +1 -1
  30. package/cjs/src/embed/search.spec.js +10 -0
  31. package/cjs/src/embed/search.spec.js.map +1 -1
  32. package/cjs/src/embed/ts-embed.d.ts +1 -0
  33. package/cjs/src/embed/ts-embed.d.ts.map +1 -1
  34. package/cjs/src/embed/ts-embed.js +27 -7
  35. package/cjs/src/embed/ts-embed.js.map +1 -1
  36. package/cjs/src/embed/ts-embed.spec.js +114 -0
  37. package/cjs/src/embed/ts-embed.spec.js.map +1 -1
  38. package/cjs/src/react/index.spec.js +0 -12
  39. package/cjs/src/react/index.spec.js.map +1 -1
  40. package/cjs/src/types.d.ts +680 -231
  41. package/cjs/src/types.d.ts.map +1 -1
  42. package/cjs/src/types.js +605 -164
  43. package/cjs/src/types.js.map +1 -1
  44. package/cjs/src/utils/answerService.d.ts +10 -0
  45. package/cjs/src/utils/answerService.d.ts.map +1 -0
  46. package/cjs/src/utils/answerService.js +61 -0
  47. package/cjs/src/utils/answerService.js.map +1 -0
  48. package/cjs/src/utils/answerService.spec.d.ts +2 -0
  49. package/cjs/src/utils/answerService.spec.d.ts.map +1 -0
  50. package/cjs/src/utils/answerService.spec.js +31 -0
  51. package/cjs/src/utils/answerService.spec.js.map +1 -0
  52. package/cjs/src/utils/authService.d.ts +37 -0
  53. package/cjs/src/utils/authService.d.ts.map +1 -0
  54. package/cjs/src/utils/authService.js +106 -0
  55. package/cjs/src/utils/authService.js.map +1 -0
  56. package/cjs/src/utils/authService.spec.d.ts +2 -0
  57. package/cjs/src/utils/authService.spec.d.ts.map +1 -0
  58. package/cjs/src/utils/authService.spec.js +72 -0
  59. package/cjs/src/utils/authService.spec.js.map +1 -0
  60. package/cjs/src/utils/graphql/answerService/answerService.d.ts +2 -4
  61. package/cjs/src/utils/graphql/answerService/answerService.d.ts.map +1 -1
  62. package/cjs/src/utils/graphql/answerService/answerService.js +2 -4
  63. package/cjs/src/utils/graphql/answerService/answerService.js.map +1 -1
  64. package/cjs/src/utils/processData.d.ts +6 -0
  65. package/cjs/src/utils/processData.d.ts.map +1 -1
  66. package/cjs/src/utils/processData.js +5 -1
  67. package/cjs/src/utils/processData.js.map +1 -1
  68. package/cjs/src/utils/processTrigger.js +1 -1
  69. package/dist/src/auth.d.ts +4 -4
  70. package/dist/src/auth.d.ts.map +1 -1
  71. package/dist/src/embed/app.d.ts +15 -15
  72. package/dist/src/embed/app.d.ts.map +1 -1
  73. package/dist/src/embed/liveboard.d.ts +28 -23
  74. package/dist/src/embed/liveboard.d.ts.map +1 -1
  75. package/dist/src/embed/sage.d.ts +48 -30
  76. package/dist/src/embed/sage.d.ts.map +1 -1
  77. package/dist/src/embed/search-bar.d.ts +22 -6
  78. package/dist/src/embed/search-bar.d.ts.map +1 -1
  79. package/dist/src/embed/search.d.ts +34 -19
  80. package/dist/src/embed/search.d.ts.map +1 -1
  81. package/dist/src/embed/ts-embed.d.ts +1 -0
  82. package/dist/src/embed/ts-embed.d.ts.map +1 -1
  83. package/dist/src/types.d.ts +680 -231
  84. package/dist/src/types.d.ts.map +1 -1
  85. package/dist/src/utils/answerService.d.ts +10 -0
  86. package/dist/src/utils/answerService.d.ts.map +1 -0
  87. package/dist/src/utils/answerService.spec.d.ts +2 -0
  88. package/dist/src/utils/answerService.spec.d.ts.map +1 -0
  89. package/dist/src/utils/authService.d.ts +37 -0
  90. package/dist/src/utils/authService.d.ts.map +1 -0
  91. package/dist/src/utils/authService.spec.d.ts +2 -0
  92. package/dist/src/utils/authService.spec.d.ts.map +1 -0
  93. package/dist/src/utils/graphql/answerService/answerService.d.ts +2 -4
  94. package/dist/src/utils/graphql/answerService/answerService.d.ts.map +1 -1
  95. package/dist/src/utils/processData.d.ts +6 -0
  96. package/dist/src/utils/processData.d.ts.map +1 -1
  97. package/dist/tsembed-react.es.js +664 -194
  98. package/dist/tsembed-react.js +663 -193
  99. package/dist/tsembed.es.js +667 -194
  100. package/dist/tsembed.js +665 -192
  101. package/dist/visual-embed-sdk-react-full.d.ts +851 -328
  102. package/dist/visual-embed-sdk-react.d.ts +851 -328
  103. package/dist/visual-embed-sdk.d.ts +851 -328
  104. package/lib/.DS_Store +0 -0
  105. package/lib/package.json +1 -1
  106. package/lib/src/.DS_Store +0 -0
  107. package/lib/src/auth.d.ts +4 -4
  108. package/lib/src/auth.d.ts.map +1 -1
  109. package/lib/src/auth.js +10 -4
  110. package/lib/src/auth.js.map +1 -1
  111. package/lib/src/embed/app.d.ts +15 -15
  112. package/lib/src/embed/app.d.ts.map +1 -1
  113. package/lib/src/embed/app.js +1 -1
  114. package/lib/src/embed/app.js.map +1 -1
  115. package/lib/src/embed/liveboard.d.ts +28 -23
  116. package/lib/src/embed/liveboard.d.ts.map +1 -1
  117. package/lib/src/embed/liveboard.js +4 -3
  118. package/lib/src/embed/liveboard.js.map +1 -1
  119. package/lib/src/embed/sage.d.ts +48 -30
  120. package/lib/src/embed/sage.d.ts.map +1 -1
  121. package/lib/src/embed/sage.js +7 -6
  122. package/lib/src/embed/sage.js.map +1 -1
  123. package/lib/src/embed/sage.spec.js +3 -3
  124. package/lib/src/embed/sage.spec.js.map +1 -1
  125. package/lib/src/embed/search-bar.d.ts +22 -6
  126. package/lib/src/embed/search-bar.d.ts.map +1 -1
  127. package/lib/src/embed/search-bar.js.map +1 -1
  128. package/lib/src/embed/search.d.ts +34 -19
  129. package/lib/src/embed/search.d.ts.map +1 -1
  130. package/lib/src/embed/search.js +7 -3
  131. package/lib/src/embed/search.js.map +1 -1
  132. package/lib/src/embed/search.spec.js +10 -0
  133. package/lib/src/embed/search.spec.js.map +1 -1
  134. package/lib/src/embed/ts-embed.d.ts +1 -0
  135. package/lib/src/embed/ts-embed.d.ts.map +1 -1
  136. package/lib/src/embed/ts-embed.js +28 -8
  137. package/lib/src/embed/ts-embed.js.map +1 -1
  138. package/lib/src/embed/ts-embed.spec.js +114 -0
  139. package/lib/src/embed/ts-embed.spec.js.map +1 -1
  140. package/lib/src/react/index.spec.js +0 -12
  141. package/lib/src/react/index.spec.js.map +1 -1
  142. package/lib/src/types.d.ts +680 -231
  143. package/lib/src/types.d.ts.map +1 -1
  144. package/lib/src/types.js +605 -164
  145. package/lib/src/types.js.map +1 -1
  146. package/lib/src/utils/answerService.d.ts +10 -0
  147. package/lib/src/utils/answerService.d.ts.map +1 -0
  148. package/lib/src/utils/answerService.js +57 -0
  149. package/lib/src/utils/answerService.js.map +1 -0
  150. package/lib/src/utils/answerService.spec.d.ts +2 -0
  151. package/lib/src/utils/answerService.spec.d.ts.map +1 -0
  152. package/lib/src/utils/answerService.spec.js +29 -0
  153. package/lib/src/utils/answerService.spec.js.map +1 -0
  154. package/lib/src/utils/authService.d.ts +37 -0
  155. package/lib/src/utils/authService.d.ts.map +1 -0
  156. package/lib/src/utils/authService.js +97 -0
  157. package/lib/src/utils/authService.js.map +1 -0
  158. package/lib/src/utils/authService.spec.d.ts +2 -0
  159. package/lib/src/utils/authService.spec.d.ts.map +1 -0
  160. package/lib/src/utils/authService.spec.js +70 -0
  161. package/lib/src/utils/authService.spec.js.map +1 -0
  162. package/lib/src/utils/graphql/answerService/answerService.d.ts +2 -4
  163. package/lib/src/utils/graphql/answerService/answerService.d.ts.map +1 -1
  164. package/lib/src/utils/graphql/answerService/answerService.js +2 -4
  165. package/lib/src/utils/graphql/answerService/answerService.js.map +1 -1
  166. package/lib/src/utils/processData.d.ts +6 -0
  167. package/lib/src/utils/processData.d.ts.map +1 -1
  168. package/lib/src/utils/processData.js +4 -1
  169. package/lib/src/utils/processData.js.map +1 -1
  170. package/lib/src/utils/processTrigger.js +1 -1
  171. package/lib/src/visual-embed-sdk.d.ts +851 -328
  172. package/package.json +1 -1
  173. package/src/.DS_Store +0 -0
  174. package/src/auth.ts +10 -4
  175. package/src/embed/app.ts +20 -20
  176. package/src/embed/liveboard.ts +32 -27
  177. package/src/embed/sage.spec.ts +3 -3
  178. package/src/embed/sage.ts +54 -36
  179. package/src/embed/search-bar.tsx +22 -6
  180. package/src/embed/search.spec.ts +13 -0
  181. package/src/embed/search.ts +42 -22
  182. package/src/embed/ts-embed.spec.ts +132 -0
  183. package/src/embed/ts-embed.ts +27 -9
  184. package/src/react/index.spec.tsx +0 -29
  185. package/src/types.ts +680 -232
  186. package/src/utils/graphql/answerService/answerService.ts +2 -4
  187. package/src/utils/processData.ts +4 -1
  188. package/src/utils/processTrigger.ts +1 -1
@@ -29,10 +29,14 @@ export declare enum AuthType {
29
29
  */
30
30
  None = "None",
31
31
  /**
32
- * Passthrough SSO to the embedded App within the iframe. Requires least
32
+ * Passthrough SSO to the embedded application within the iframe. Requires least
33
33
  * configuration, but may not be supported by all IDPs. This will behave like `None`
34
34
  * if SSO is not configured on ThoughtSpot.
35
35
  *
36
+ * To use this:
37
+ * Your SAML or OpenID provider must allow iframe redirects.
38
+ * For example, if you are using Okta as IdP, you can enable iframe embedding.
39
+ *
36
40
  * @example
37
41
  * ```js
38
42
  * init({
@@ -40,12 +44,7 @@ export declare enum AuthType {
40
44
  * authType: AuthType.EmbeddedSSO,
41
45
  * });
42
46
  * ```
43
- * Set authentication type as Embedded SSO.
44
- *
45
- * To use this:
46
- * Your SAML or OpenID provider must allow iframe redirects.
47
- * eg. If you are using okta as IdP, you can enable iFrame embedding.
48
- * @version: SDK: 1.15.0 | ThouhgtSpot: 8.8.0.cl
47
+ * @version: SDK: 1.15.0 | ThoughtSpot: 8.8.0.cl
49
48
  */
50
49
  EmbeddedSSO = "EmbeddedSSO",
51
50
  /**
@@ -64,10 +63,10 @@ export declare enum AuthType {
64
63
  SAML = "SSO_SAML",
65
64
  /**
66
65
  * SSO using SAML
67
- * Will make the host application redirect to the SAML Idp. Use this
68
- * when the idp does not allow itself to be embedded.
66
+ * Makes the host application redirect to the SAML IdP. Use this
67
+ * if your IdP does not allow itself to be embedded.
69
68
  *
70
- * This redirects the host application to the SAML Idp. The host application
69
+ * This redirects the host application to the SAML IdP. The host application
71
70
  * will be redirected back to the ThoughtSpot app after authentication.
72
71
  *
73
72
  * @example
@@ -78,7 +77,7 @@ export declare enum AuthType {
78
77
  * });
79
78
  * ```
80
79
  *
81
- * This opens the SAML Idp in a popup window. The popup is triggered
80
+ * This opens the SAML IdP in a popup window. The popup is triggered
82
81
  * when the user clicks the trigger button. The popup window will be
83
82
  * closed automatically after authentication.
84
83
  * @example
@@ -92,8 +91,8 @@ export declare enum AuthType {
92
91
  * });
93
92
  * ```
94
93
  *
95
- * Can also use event to trigger the popup flow. Works the same
96
- * as above example.
94
+ * Can also use the event to trigger the popup flow. Works the same
95
+ * as the above example.
97
96
  * @example
98
97
  * ```js
99
98
  * const authEE = init({
@@ -117,7 +116,7 @@ export declare enum AuthType {
117
116
  OIDC = "SSO_OIDC",
118
117
  /**
119
118
  * SSO using OIDC
120
- * Will make the host application redirect to the OIDC Idp.
119
+ * Will make the host application redirect to the OIDC IdP.
121
120
  * See code samples in {@link SAMLRedirect}.
122
121
  */
123
122
  OIDCRedirect = "SSO_OIDC",
@@ -129,8 +128,8 @@ export declare enum AuthType {
129
128
  */
130
129
  AuthServer = "AuthServer",
131
130
  /**
132
- * Trusted authentication server, Use your own authentication server
133
- * which returns a bearer token, generated using the secret_key obtained
131
+ * Trusted authentication server. Use your own authentication server
132
+ * which returns a bearer token, generated using the `secret_key` obtained
134
133
  * from ThoughtSpot.
135
134
  *
136
135
  * @example
@@ -147,11 +146,11 @@ export declare enum AuthType {
147
146
  */
148
147
  TrustedAuthToken = "AuthServer",
149
148
  /**
150
- * Trusted authentication server Cookieless, Use you own authentication
151
- * server which returns a bearer token, generated using the secret_key
149
+ * Trusted authentication server Cookieless, Use your own authentication
150
+ * server which returns a bearer token, generated using the `secret_key`
152
151
  * obtained from ThoughtSpot. This uses a cookieless authentication
153
- * approach, recommended to by pass third-party cookie-blocking restriction
154
- * implemented by some browsers
152
+ * approach, recommended to bypass the third-party cookie-blocking restriction
153
+ * implemented by some browsers.
155
154
  *
156
155
  * @example
157
156
  * ```js
@@ -164,7 +163,7 @@ export declare enum AuthType {
164
163
  * .then((data) => data.token);
165
164
  * }
166
165
  * ```
167
- * @version SDK: 1.22.0| ThouhgtSpot: 9.3.0.cl, 9.5.1.sw
166
+ * @version SDK: 1.22.0| ThoughtSpot: 9.3.0.cl, 9.5.1.sw
168
167
  */
169
168
  TrustedAuthTokenCookieless = "AuthServerCookieless",
170
169
  /**
@@ -286,13 +285,19 @@ export interface EmbedConfig {
286
285
  * The ThoughtSpot cluster hostname or IP address.
287
286
  */
288
287
  thoughtSpotHost: string;
288
+ /**
289
+ * If true, all the iframe links will have /v2 added automatically.
290
+ * If false, all the iframe links will have /v1 added automatically.
291
+ * If undefined, nothing will be added
292
+ */
293
+ enableReactShell?: boolean | undefined;
289
294
  /**
290
295
  * The authentication mechanism to use.
291
296
  */
292
297
  authType: AuthType;
293
298
  /**
294
299
  * [AuthServer] The trusted authentication endpoint to use to get the
295
- * authentication token. A GET request is made to the
300
+ * authentication token. A `GET` request is made to the
296
301
  * authentication API endpoint, which returns the token
297
302
  * as a plaintext response. For trusted authentication,
298
303
  * the `authEndpoint` or `getAuthToken` attribute is required.
@@ -305,8 +310,8 @@ export interface EmbedConfig {
305
310
  * attribute is required.
306
311
  *
307
312
  * It is advisable to fetch a new token inside this method and not
308
- * reuse and older issued token, as because when auth expires this is
309
- * called again and if it is called with an older token the authentication
313
+ * reuse the old issued token. When auth expires this method is
314
+ * called again and if it is called with an older token, the authentication
310
315
  * will not succeed.
311
316
  */
312
317
  getAuthToken?: () => Promise<string>;
@@ -316,7 +321,7 @@ export interface EmbedConfig {
316
321
  */
317
322
  username?: string;
318
323
  /**
319
- * [Basic] The ThoughtSpot login password corresponding to the user name
324
+ * [Basic] The ThoughtSpot login password corresponding to the username
320
325
  *
321
326
  * Warning: This feature is primarily intended for developer testing. It is
322
327
  * strongly advised not to use this authentication method in production.
@@ -324,7 +329,7 @@ export interface EmbedConfig {
324
329
  password?: string;
325
330
  /**
326
331
  * [SSO] For SSO Authentication, if `noRedirect` is set to true, it will
327
- * open the SAML auth flow in a popup, instead of redirecting browser in
332
+ * open the SAML auth flow in a popup, instead of redirecting the browser in
328
333
  * place.
329
334
  *
330
335
  * @default false
@@ -333,91 +338,93 @@ export interface EmbedConfig {
333
338
  noRedirect?: boolean;
334
339
  /**
335
340
  * [SSO] For SSO Authentication, if `inPopup` is set to true, it will open
336
- * the SAML auth flow in a popup, instead of redirecting browser in place.
341
+ * the SAML auth flow in a popup, instead of redirecting the browser in place.
337
342
  *
338
- * Need to use this with authTriggerContainer. Or manually trigger
339
- * the AuthEvent.TRIGGER_SSO_POPUP event on a user interaction.
343
+ * Need to use this with `authTriggerContainer`. Or manually trigger
344
+ * the `AuthEvent.TRIGGER_SSO_POPUP` event on a user interaction.
340
345
  *
341
346
  * @default false
342
347
  * @version SDK: 1.18.0
343
348
  */
344
349
  inPopup?: boolean;
345
350
  /**
346
- * [SSO] For SSO Authentication, one can supply an optional path param,
347
- * this will be the path on the host origin where the SAML flow will be
351
+ * [SSO] For SSO Authentication, one can supply an optional path param;
352
+ * This will be the path on the host origin where the SAML flow will be
348
353
  * terminated.
349
354
  *
350
355
  * Eg: "/dashboard", "#/foo" [Do not include the host]
351
356
  *
352
- * @version SDK: 1.10.2 | 8.2.0.cl, 8.4.1.sw
357
+ * @version SDK: 1.10.2 | ThoughtSpot 8.2.0.cl, 8.4.1.sw
353
358
  */
354
359
  redirectPath?: string;
355
360
  /** @internal */
356
361
  basepath?: string;
357
362
  /**
358
- * Should we encode URL Query Params using base64 encoding which thoughtspot
359
- * will generate for embedding. This provides additional security to
360
- * thoughtspot clusters against Cross site scripting attacks.
363
+ * Boolean to define if the query parameters in the ThoughtSpot URL
364
+ * should be encoded in base64. This provides additional security to
365
+ * Thoughtspot clusters against cross-site scripting attacks.
361
366
  *
362
367
  * @default false
363
368
  */
364
369
  shouldEncodeUrlQueryParams?: boolean;
365
370
  /**
366
- * Suppress cookie access alert when third party cookies are blocked by the
367
- * user's browser. Third party cookie blocking is the default behaviour on
368
- * Safari and opt-in for Firefox/Chrome. If you set this to `true`, you are
369
- * encouraged to handle `noCookieAccess` event, to show your own treatment
371
+ * Suppress cookie access alert when third-party cookies are blocked by the
372
+ * user's browser. Third-party cookie blocking is the default behaviour on
373
+ * some web browsers like Safari. If you set this attribute to `true`,
374
+ * you are encouraged to handle `noCookieAccess` event, to show your own treatment
370
375
  * in this case.
371
376
  *
372
377
  * @default false
373
378
  */
374
379
  suppressNoCookieAccessAlert?: boolean;
375
380
  /**
376
- * Ignore cookie access alert when third party cookies are blocked by the
381
+ * Ignore the cookie access alert when third-party cookies are blocked by the
377
382
  * user's browser. If you set this to `true`, the embedded iframe behaviour
378
- * persist even in case of non logged in user.
383
+ * persists even in the case of a non-logged-in user.
379
384
  *
380
385
  * @default false
381
386
  */
382
387
  ignoreNoCookieAccess?: boolean;
383
388
  /**
384
- * Re-login when session expires with the previous login options
389
+ * Re-login a user with the previous login options
390
+ * when a user session expires.
385
391
  *
386
392
  * @default false
387
393
  */
388
394
  autoLogin?: boolean;
389
395
  /**
390
396
  * Disable redirection to the login page when the embedded session expires
391
- * This flag is typically used alongside the combination of auth modes such as {@link
392
- * AuthType.AuthServer} and auto login behavior {@link EmbedConfig.autoLogin}
397
+ * This flag is typically used alongside the combination of authentication modes such
398
+ * as {@link AuthType.AuthServer} and auto-login behavior {@link
399
+ * EmbedConfig.autoLogin}
393
400
  *
394
401
  * @version SDK: 1.9.3 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
395
402
  * @default false
396
403
  */
397
404
  disableLoginRedirect?: boolean;
398
405
  /**
399
- * This message is displayed on the embed view when the login fails.
406
+ * This message is displayed in the embedded view when a user login fails.
400
407
  *
401
408
  * @version SDK: 1.10.1 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
402
409
  */
403
410
  loginFailedMessage?: string;
404
411
  /**
405
- * Calls the prefetch method internally when set to true
412
+ * Calls the prefetch method internally when set to `true`
406
413
  *
407
414
  * @default false
408
415
  */
409
416
  callPrefetch?: boolean;
410
417
  /**
411
- * When there are multiple embeds, queue the render of embed to start
412
- * after the previous embed's render is complete. This helps in the load
413
- * performance by decreasing the load on the browser.
418
+ * When there are multiple objects embedded, queue the rendering of embedded objects
419
+ * to start after the previous embed's render is complete. This helps improve
420
+ * performance by decreasing the load on the browser.
414
421
  *
415
422
  * @Version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
416
423
  * @default false
417
424
  */
418
425
  queueMultiRenders?: boolean;
419
426
  /**
420
- * Dynamic CSS Url to be injected in the loaded application.
427
+ * Dynamic CSS URL to be injected in the loaded application.
421
428
  * You would also need to set `style-src` in the CSP settings.
422
429
  *
423
430
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
@@ -425,9 +432,9 @@ export interface EmbedConfig {
425
432
  */
426
433
  customCssUrl?: string;
427
434
  /**
428
- * [AuthServer|Basic] Detect if 3rd party cookies are enabled by doing an
435
+ * [AuthServer|Basic] Detect if third-party party cookies are enabled by doing an
429
436
  * additional call. This is slower and should be avoided. Listen to the
430
- * NO_COOKIE_ACCESS event to handle the situation.
437
+ * `NO_COOKIE_ACCESS` event to handle the situation.
431
438
  *
432
439
  * This is slightly slower than letting the browser handle the cookie check, as it
433
440
  * involves an extra network call.
@@ -436,26 +443,26 @@ export interface EmbedConfig {
436
443
  */
437
444
  detectCookieAccessSlow?: boolean;
438
445
  /**
439
- * Hide beta alert warning message for SearchEmbed.
446
+ * Hide the `beta` alert warning message for SearchEmbed.
440
447
  *
441
448
  * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1.sw*
442
449
  */
443
450
  suppressSearchEmbedBetaWarning?: boolean;
444
451
  /**
445
- * Hide beta alert warning message for SageEmbed.
452
+ * Hide `beta` alert warning message for SageEmbed.
446
453
  *
447
454
  */
448
455
  suppressSageEmbedBetaWarning?: boolean;
449
456
  /**
450
457
  * Custom style params for embed Config.
451
458
  *
452
- * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl
459
+ * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
453
460
  */
454
461
  customizations?: CustomisationsInterface;
455
462
  /**
456
- * For inPopup SAMLRedirect or OIDCRedirect Auth, we need a button which the user
457
- * click to trigger the flow. This is the containing element
458
- * for that button.
463
+ * For `inPopup` SAMLRedirect or OIDCRedirect authentication, we need a
464
+ * button that the user can click to trigger the flow.
465
+ * This attribute sets a containing element for that button.
459
466
  *
460
467
  * @example
461
468
  * ```js
@@ -465,11 +472,11 @@ export interface EmbedConfig {
465
472
  * authTriggerContainer: '#auth-trigger-container'
466
473
  * })
467
474
  * ```
468
- * @version SDK: 1.17.0 | ThoughtSpot: *
475
+ * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
469
476
  */
470
477
  authTriggerContainer?: string | HTMLElement;
471
478
  /**
472
- * Specify that we want to use the AuthEvent.TRIGGER_SSO_POPUP event to trigger
479
+ * Specify that we want to use the `AuthEvent.TRIGGER_SSO_POPUP` event to trigger
473
480
  * SAML popup. This is useful when you want to trigger the popup on a custom user
474
481
  * action.
475
482
  *
@@ -477,20 +484,22 @@ export interface EmbedConfig {
477
484
  useEventForSAMLPopup?: boolean;
478
485
  /**
479
486
  * Text to show in the button which triggers the popup auth flow.
480
- * Default: "Authorize".
487
+ * Default: `Authorize`.
481
488
  *
482
- * @version SDK: 1.17.0 | ThoughtSpot: *
489
+ * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
483
490
  */
484
491
  authTriggerText?: string;
485
492
  /**
486
- * Disable Full App access of Embedded app outside of the iFrame.
493
+ * Prevent users from accessing the full application or ThoughtSpot application pages
494
+ * access to the embedded application users
495
+ * outside of the iframe.
487
496
  *
488
497
  * @default true
489
498
  * @version SDK: 1.22.0 | ThoughtSpot: 9.3.0.cl, 9.5.1.sw
490
499
  */
491
500
  blockNonEmbedFullAppAccess?: boolean;
492
501
  /**
493
- * Host config incase embedded app is inside TS app itself
502
+ * Host config in case embedded app is inside TS app itself
494
503
  *
495
504
  * @hidden
496
505
  */
@@ -516,17 +525,17 @@ export interface EmbedConfig {
516
525
  export interface LayoutConfig {
517
526
  }
518
527
  /**
519
- * Embedded iFrame configuration
528
+ * Embedded iframe configuration
520
529
  *
521
530
  * @group Embed components
522
531
  */
523
532
  export interface FrameParams {
524
533
  /**
525
- * The width of the iFrame (unit is pixels if numeric).
534
+ * The width of the iframe (unit is pixels if numeric).
526
535
  */
527
536
  width?: number | string;
528
537
  /**
529
- * The height of the iFrame (unit is pixels if numeric).
538
+ * The height of the iframe (unit is pixels if numeric).
530
539
  */
531
540
  height?: number | string;
532
541
  /**
@@ -627,7 +636,6 @@ export interface ViewConfig {
627
636
  */
628
637
  runtimeParameters?: RuntimeParameter[];
629
638
  /**
630
- /**
631
639
  * The locale/language to use for the embedded view.
632
640
  *
633
641
  * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
@@ -727,31 +735,30 @@ export interface ViewConfig {
727
735
  */
728
736
  reorderedHomepageModules?: HomepageModule[];
729
737
  /**
730
- * The list of tab IDs to show in the embedded.
731
- * Only this Tabs will be shown in their respective LBs.
732
- * Use this to show an tabID.
738
+ * The list of tab IDs to show in the embedded Liveboard.
739
+ * Only the tabs specified in the array will be shown in the Liveboard.
733
740
  *
734
- * Use either this or hiddenTabs.
741
+ * Use either `visibleTabs` or `hiddenTabs`.
735
742
  *
736
743
  * @example
737
744
  * ```js
738
- * const embed = new LiveboardEmbed('#embed', {
739
- * ... // other liveboard view config
740
- * visibleTabs: [
745
+ * visibleTabs: [
741
746
  * '430496d6-6903-4601-937e-2c691821af3c',
742
- * 'f547ec54-2a37-4516-a222-2b06719af726']
743
- * });
747
+ * 'f547ec54-2a37-4516-a222-2b06719af726']
744
748
  * ```
745
749
  * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
746
750
  */
747
751
  visibleTabs?: string[];
748
752
  /**
749
- * homepageLeftNavItems : show/hide Homeapage Left Nav Bar Items
750
- * There are 8 home nav list items, we will send those item as list
751
- * which we want to hide for TSE.
752
- * eg: hiddenHomeLeftNavItems = [HomeLeftNavItem.Home] to hide home.
753
+ * homepageLeftNavItems : Show or hide the left navigation bar items.
754
+ * There are 8 eight home navigation list items.
755
+ * To hide these items, specify the string in the array.
753
756
  *
754
- * @version SDK: 1.27.0 | Thoughtspot: 9.8.0.cl
757
+ * ```js
758
+ * hiddenHomeLeftNavItems = [HomeLeftNavItem.Home]
759
+ * ```
760
+ *
761
+ * @version SDK: 1.27.0 | Thoughtspot: 9.10.0.cl
755
762
  */
756
763
  hiddenHomeLeftNavItems?: HomeLeftNavItem[];
757
764
  /**
@@ -767,7 +774,7 @@ export interface ViewConfig {
767
774
  * });
768
775
  * embed.showPreRender();
769
776
  * ```
770
- * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
777
+ * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl, 9.8.0.sw
771
778
  */
772
779
  preRenderId?: string;
773
780
  /**
@@ -806,7 +813,7 @@ export type MessagePayload = {
806
813
  status?: string;
807
814
  };
808
815
  /**
809
- * MessageOptions: By Providing options, getting specific event start / end based on
816
+ * MessageOptions: By providing options, getting specific event start / end based on
810
817
  * option
811
818
  *
812
819
  * @group Events
@@ -814,7 +821,7 @@ export type MessagePayload = {
814
821
  export type MessageOptions = {
815
822
  /**
816
823
  * A boolean value indicating that start status events of this type
817
- * will be dispatched
824
+ * will be dispatched.
818
825
  */
819
826
  start?: boolean;
820
827
  };
@@ -834,7 +841,7 @@ responder?: (data: any) => void) => void;
834
841
  */
835
842
  export type MessageCallbackObj = {
836
843
  /**
837
- * options: It contains start, A boolean value indicating that start
844
+ * options: It contains start, a boolean value indicating that start
838
845
  * status events of this type will be dispatched
839
846
  */
840
847
  options: MessageOptions;
@@ -906,7 +913,7 @@ export declare enum RuntimeFilterOp {
906
913
  IN = "IN"
907
914
  }
908
915
  /**
909
- * Home page module that can be hide
916
+ * Home page module that can be hidden
910
917
  */
911
918
  export declare enum HomepageModule {
912
919
  /**
@@ -922,7 +929,7 @@ export declare enum HomepageModule {
922
929
  */
923
930
  Favorite = "FAVORITE",
924
931
  /**
925
- * List of answers and liveboards
932
+ * List of answers and Liveboards
926
933
  */
927
934
  MyLibrary = "MY_LIBRARY",
928
935
  /**
@@ -955,7 +962,7 @@ export interface RuntimeFilter {
955
962
  values: (number | boolean | string)[];
956
963
  }
957
964
  /**
958
- * A filter that can be applied to ThoughtSpot answers, Liveboards, or
965
+ * A filter that can be applied to ThoughtSpot Answers, Liveboards, or
959
966
  * visualizations at runtime.
960
967
  */
961
968
  export interface RuntimeParameter {
@@ -992,12 +999,26 @@ export declare enum EmbedEvent {
992
999
  /**
993
1000
  * Rendering has initialized.
994
1001
  *
1002
+ * @example
1003
+ *```js
1004
+ * liveboardEmbed.on(EmbedEvent.Init, showLoader)
1005
+ * //show a loader
1006
+ * function showLoader() {
1007
+ * document.getElementById("loader");
1008
+ * }
1009
+ *```
995
1010
  * @returns timestamp - The timestamp when the event was generated.
996
1011
  */
997
1012
  Init = "init",
998
1013
  /**
999
1014
  * Authentication has either succeeded or failed.
1000
1015
  *
1016
+ * @example
1017
+ *```js
1018
+ * appEmbed.on(EmbedEvent.AuthInit, payload => {
1019
+ * console.log('AuthInit', payload);
1020
+ * })
1021
+ *```
1001
1022
  * @returns isLoggedIn - A Boolean specifying whether authentication was successful.
1002
1023
  */
1003
1024
  AuthInit = "authInit",
@@ -1005,37 +1026,91 @@ export declare enum EmbedEvent {
1005
1026
  * The embed object container has loaded.
1006
1027
  *
1007
1028
  * @returns timestamp - The timestamp when the event was generated.
1029
+ * @example
1030
+ *```js
1031
+ * liveboardEmbed.on(EmbedEvent.Load, hideLoader)
1032
+ * //hide loader
1033
+ * function hideLoader() {
1034
+ * document.getElementById("loader");
1035
+ * }
1036
+ *```
1008
1037
  */
1009
1038
  Load = "load",
1010
1039
  /**
1011
1040
  * Data pertaining to answer or Liveboard is received
1012
1041
  *
1013
1042
  * @return data - The answer or Liveboard data
1043
+ * @example
1044
+ *```js
1045
+ * liveboardEmbed.on(EmbedEvent.Data, payload => {
1046
+ * console.log('data', payload);
1047
+ * })
1048
+ *```
1014
1049
  * @important
1015
1050
  */
1016
1051
  Data = "data",
1017
1052
  /**
1018
- * Search/answer/Liveboard filters have been applied/updated by the user.
1053
+ * Search/Answer/Liveboard filters have been applied/updated by the user.
1019
1054
  *
1020
1055
  * @hidden
1021
1056
  */
1022
1057
  FiltersChanged = "filtersChanged",
1023
1058
  /**
1024
1059
  * Search query has been updated by the user.
1060
+ *
1061
+ * @example
1062
+ *```js
1063
+ * searchEmbed.on(EmbedEvent.QueryChanged, payload => console.log('data', payload))
1064
+ *```
1025
1065
  */
1026
1066
  QueryChanged = "queryChanged",
1027
1067
  /**
1028
- * A drill down operation has been performed.
1068
+ * A drill-down operation has been performed.
1029
1069
  *
1030
1070
  * @returns additionalFilters - Any additional filters applied
1031
1071
  * @returns drillDownColumns - The columns on which drill down was performed
1032
1072
  * @returns nonFilteredColumns - The columns that were not filtered
1073
+ * @example
1074
+ *```js
1075
+ * searchEmbed.trigger(HostEvent.DrillDown, {
1076
+ * points: {
1077
+ * clickedPoint,
1078
+ * selectedPoints: selectedPoint
1079
+ * },
1080
+ * autoDrillDown: true,
1081
+ * })
1082
+ *```
1083
+ * In this example, `VizPointDoubleClick` event is used for
1084
+ * triggering the `DrillDown` event when an area or specific
1085
+ * data point on a table or chart is double-clicked.
1086
+ * @example
1087
+ *```js
1088
+ * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
1089
+ * console.log(payload);
1090
+ * const clickedPoint = payload.data.clickedPoint;
1091
+ * const selectedPoint = payload.data.selectedPoints;
1092
+ * console.log('>>> called', clickedPoint);
1093
+ * embed.trigger(HostEvent.DrillDown, {
1094
+ * points: {
1095
+ * clickedPoint,
1096
+ * selectedPoints: selectedPoint
1097
+ * },
1098
+ * autoDrillDown: true,
1099
+ * })
1100
+ * })
1101
+ *```
1033
1102
  */
1034
1103
  Drilldown = "drillDown",
1035
1104
  /**
1036
1105
  * One or more data sources have been selected.
1037
1106
  *
1038
1107
  * @returns dataSourceIds - the list of data sources
1108
+ * @example
1109
+ * ```js
1110
+ * searchEmbed.on(EmbedEvent.DataSourceSelected, payload => {
1111
+ * console.log('DataSourceSelected', payload);
1112
+ * })
1113
+ * ```
1039
1114
  */
1040
1115
  DataSourceSelected = "dataSourceSelected",
1041
1116
  /**
@@ -1043,25 +1118,49 @@ export declare enum EmbedEvent {
1043
1118
  *
1044
1119
  * @returns columnIds - the list of columns
1045
1120
  * @version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
1121
+ * @example
1122
+ * ```js
1123
+ * appEmbed.on(EmbedEvent.AddRemoveColumns, payload => {
1124
+ * console.log('AddRemoveColumns', payload);
1125
+ * })
1126
+ * ```
1046
1127
  */
1047
1128
  AddRemoveColumns = "addRemoveColumns",
1048
1129
  /**
1049
- * A custom action has been triggered
1130
+ * A custom action has been triggered.
1050
1131
  *
1051
- * @returns actionId - The id of the custom action
1052
- * @returns data - The answer or Liveboard data
1132
+ * @returns actionId - ID of the custom action
1133
+ * @returns data - Response payload with the Answer or Liveboard data
1134
+ * @example
1135
+ * ```js
1136
+ * appEmbed.on(EmbedEvent.customAction, payload => {
1137
+ * const data = payload.data;
1138
+ * if (data.id === 'insert Custom Action ID here') {
1139
+ * console.log('Custom Action event:', data.embedAnswerData);
1140
+ * }
1141
+ * })
1142
+ * ```
1053
1143
  */
1054
1144
  CustomAction = "customAction",
1055
1145
  /**
1056
- * Listen to double clicks on a visualization
1146
+ * Listen to double click actions on a visualization.
1057
1147
  *
1058
- * @return ContextMenuInputPoints - data point that is double clicked
1148
+ * @return ContextMenuInputPoints - Data point that is double-clicked
1059
1149
  * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
1150
+ * @example
1151
+ * ```js
1152
+ * livebaordEmbed.on(EmbedEvent.VizPointDoubleClick, payload => {
1153
+ * console.log('VizPointDoubleClick', payload)
1154
+ * })
1155
+ * ```
1060
1156
  */
1061
1157
  VizPointDoubleClick = "vizPointDoubleClick",
1062
1158
  /**
1063
- * Listen to clicks on a visualization in a liveboard or Search result.
1159
+ * Listen to clicks on a visualization in a Liveboard or Search result.
1064
1160
  *
1161
+ * @return viz, clickedPoint - metadata about the point that is clicked
1162
+ * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1163
+ * @important
1065
1164
  * @example
1066
1165
  * ```js
1067
1166
  * embed.on(ThoughtSpotEmbed.Event.VizPointClick, ({data}) => {
@@ -1074,25 +1173,42 @@ export declare enum EmbedEvent {
1074
1173
  * )
1075
1174
  * });
1076
1175
  * ```
1077
- * @return viz, clickedPoint - metadata about point that is clicked
1078
- * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1079
- * @important
1080
1176
  */
1081
1177
  VizPointClick = "vizPointClick",
1082
1178
  /**
1083
1179
  * An error has occurred.
1084
1180
  *
1085
1181
  * @returns error - An error object or message
1182
+ * @example
1183
+ * ```js
1184
+ * SearchEmbed.on(EmbedEvent.Error, showErrorMsg)
1185
+ * //show error messaage
1186
+ * function showErrorMsg() {
1187
+ * document.getElementById("error");
1188
+ * ```
1086
1189
  */
1087
1190
  Error = "Error",
1088
1191
  /**
1089
- * The embedded object has sent an alert
1192
+ * The embedded object has sent an alert.
1090
1193
  *
1091
1194
  * @returns alert - An alert object
1195
+ * @example
1196
+ * ```js
1197
+ * searchEmbed.on(EmbedEvent.Alert)
1198
+ * ```
1092
1199
  */
1093
1200
  Alert = "alert",
1094
1201
  /**
1095
1202
  * The ThoughtSpot auth session has expired.
1203
+ *
1204
+ * @example
1205
+ *```js
1206
+ * appEmbed.on(EmbedEvent.AuthExpire, showAuthExpired)
1207
+ * //show auth expired banner
1208
+ * function showAuthExpired() {
1209
+ * document.getElementById("authExpiredBanner");
1210
+ * }
1211
+ *```
1096
1212
  */
1097
1213
  AuthExpire = "ThoughtspotAuthExpired",
1098
1214
  /**
@@ -1122,14 +1238,27 @@ export declare enum EmbedEvent {
1122
1238
  */
1123
1239
  EmbedIframeCenter = "EmbedIframeCenter",
1124
1240
  /**
1125
- * Emitted when the "Get Data" button in Search Bar embed
1126
- * is clicked.
1241
+ * Emitted when the **Get Data** action is initiated.
1242
+ * Applicable to `SearchBarEmbed` only.
1127
1243
  *
1128
- * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.0.sw
1244
+ * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
1245
+ * @example
1246
+ *```js
1247
+ * searchbarEmbed.on(EmbedEvent.GetDataClick)
1248
+ * .then(data => {
1249
+ * console.log('Answer Data:', data);
1250
+ * })
1251
+ *```
1129
1252
  */
1130
1253
  GetDataClick = "getDataClick",
1131
1254
  /**
1132
1255
  * Detects the route change.
1256
+ *
1257
+ * @example
1258
+ *```js
1259
+ * searchEmbed.on(EmbedEvent.RouteChange, payload =>
1260
+ * console.log('data', payload))
1261
+ *```
1133
1262
  */
1134
1263
  RouteChange = "ROUTE_CHANGE",
1135
1264
  /**
@@ -1139,10 +1268,15 @@ export declare enum EmbedEvent {
1139
1268
  */
1140
1269
  V1Data = "exportVizDataToParent",
1141
1270
  /**
1142
- * Emitted when the embed does not have cookie access. This
1143
- * happens on Safari where third-party cookies are blocked by default.
1271
+ * Emitted when the embed does not have cookie access. This happens
1272
+ * when Safari and other Web browsers block third-party cookies
1273
+ * are blocked by default. `NoCookieAccess` can trigger
1144
1274
  *
1145
- * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
1275
+ * @example
1276
+ *```js
1277
+ * appEmbed.on(EmbedEvent.NoCookieAccess)
1278
+ *```
1279
+ * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1.sw
1146
1280
  */
1147
1281
  NoCookieAccess = "noCookieAccess",
1148
1282
  /**
@@ -1156,12 +1290,24 @@ export declare enum EmbedEvent {
1156
1290
  * Emitted when any modal is opened in the app
1157
1291
  *
1158
1292
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
1293
+ * @example
1294
+ *```js
1295
+ * appEmbed.on(EmbedEvent.DialogOpen, payload => {
1296
+ * console.log('dialog open', payload);
1297
+ * })
1298
+ *```
1159
1299
  */
1160
1300
  DialogOpen = "dialog-open",
1161
1301
  /**
1162
1302
  * Emitted when any modal is closed in the app
1163
1303
  *
1164
1304
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
1305
+ * @example
1306
+ *```js
1307
+ * appEmbed.on(EmbedEvent.DialogClose, payload => {
1308
+ * console.log('dialog close', payload);
1309
+ * })
1310
+ *```
1165
1311
  */
1166
1312
  DialogClose = "dialog-close",
1167
1313
  /**
@@ -1170,6 +1316,21 @@ export declare enum EmbedEvent {
1170
1316
  * other events on the rendered Liveboard.
1171
1317
  *
1172
1318
  * @version SDK: 1.9.1 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
1319
+ * @example
1320
+ *```js
1321
+ * liveboardEmbed.on(EmbedEvent.LiveboardRendered, payload => {
1322
+ console.log('Liveboard is rendered', payload);
1323
+ })
1324
+ *```
1325
+ * The following example shows how to trigger
1326
+ * `SetVisibleVizs` event using LiveboardRendered embed event:
1327
+ * @example
1328
+ *```js
1329
+ * const embedRef = useEmbedRef();
1330
+ * const onLiveboardRendered = () => {
1331
+ * embed.trigger(HostEvent.SetVisibleVizs, ['viz1', 'viz2']);
1332
+ * };
1333
+ *```
1173
1334
  */
1174
1335
  LiveboardRendered = "PinboardRendered",
1175
1336
  /**
@@ -1177,216 +1338,470 @@ export declare enum EmbedEvent {
1177
1338
  * is triggered on all events.
1178
1339
  *
1179
1340
  * @Version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
1341
+ * @example
1342
+ *```js
1343
+ * appEmbed.on(EmbedEvent.ALL, payload => {
1344
+ * console.log('Embed Events', payload)
1345
+ * })
1346
+ *```
1180
1347
  */
1181
1348
  ALL = "*",
1182
1349
  /**
1183
1350
  * Emitted when an Answer is saved in the app
1184
1351
  *
1185
1352
  * @Version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1353
+ * @example
1354
+ *```js
1355
+ * //trigger when action starts
1356
+ * searchEmbed.on(EmbedEvent.Save, payload => {
1357
+ * console.log('Save', payload)
1358
+ * }, {
1359
+ * start: true
1360
+ * })
1361
+ * //trigger when action ends
1362
+ * searchEmbed.on(EmbedEvent.Save, payload => {
1363
+ * console.log('Save', payload)
1364
+ * })
1365
+ *```
1186
1366
  */
1187
1367
  Save = "save",
1188
1368
  /**
1189
1369
  * Emitted when the download action is triggered on an answer
1190
1370
  *
1371
+ * **Note**: This event is deprecated in v1.21.0.
1372
+ * To fire an event when a download action is initiated on a chart or table,
1373
+ * use `EmbedEvent.DownloadAsPng`, `EmbedEvent.DownloadAsPDF`, `EmbedEvent.DownloadAsCSV`,
1374
+ * or `EmbedEvent.DownloadAsXLSX`
1375
+ *
1191
1376
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1377
+ * @example
1378
+ *```js
1379
+ * liveboardEmbed.trigger(HostEvent.Download, {
1380
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'
1381
+ * })
1382
+ *```
1192
1383
  */
1193
1384
  Download = "download",
1194
1385
  /**
1195
1386
  * Emitted when the download action is triggered on an answer
1196
1387
  *
1197
1388
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.0.sw
1389
+ * @example
1390
+ *```js
1391
+ * //trigger when action starts
1392
+ * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
1393
+ * console.log('download PNG', payload)}, {start: true })
1394
+ * //trigger when action ends
1395
+ * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
1396
+ * console.log('download PNG', payload)})
1397
+ *```
1198
1398
  */
1199
1399
  DownloadAsPng = "downloadAsPng",
1200
1400
  /**
1201
1401
  * Emitted when the Download as PDF action is triggered on an answer
1202
1402
  *
1203
1403
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1404
+ * @example
1405
+ *```js
1406
+ * //trigger when action starts
1407
+ * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
1408
+ * console.log('download PDF', payload)}, {start: true })
1409
+ * //trigger when action ends
1410
+ * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
1411
+ * console.log('download PDF', payload)})
1412
+ *```
1204
1413
  */
1205
1414
  DownloadAsPdf = "downloadAsPdf",
1206
1415
  /**
1207
1416
  * Emitted when the Download as CSV action is triggered on an answer
1208
1417
  *
1209
1418
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1419
+ * @example
1420
+ *```js
1421
+ * //trigger when action starts
1422
+ * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
1423
+ * console.log('download CSV', payload)}, {start: true })
1424
+ * //trigger when action ends
1425
+ * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
1426
+ * console.log('download CSV', payload)})
1427
+ *```
1210
1428
  */
1211
1429
  DownloadAsCsv = "downloadAsCsv",
1212
1430
  /**
1213
1431
  * Emitted when the Download as XLSX action is triggered on an answer
1214
1432
  *
1215
1433
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1434
+ * @example
1435
+ *```js
1436
+ * //trigger when action starts
1437
+ * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
1438
+ * console.log('download Xlsx', payload)}, { start: true })
1439
+ * //trigger when action ends
1440
+ * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
1441
+ * console.log('download Xlsx', payload)})
1442
+ *```
1216
1443
  */
1217
1444
  DownloadAsXlsx = "downloadAsXlsx",
1218
1445
  /**
1219
- * Emitted when an answer is deleted in the app
1446
+ * Emitted when an Answer is deleted in the app
1220
1447
  *
1221
1448
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1449
+ * @example
1450
+ *```js
1451
+ * //trigger when action starts
1452
+ * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
1453
+ * console.log('delete answer', payload)}, {start: true })
1454
+ * //trigger when action is completed
1455
+ * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
1456
+ * console.log('delete answer', payload)})
1457
+ *```
1222
1458
  */
1223
1459
  AnswerDelete = "answerDelete",
1224
1460
  /**
1225
1461
  * Emitted when an answer is pinned to a Liveboard
1226
1462
  *
1227
1463
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1464
+ * @example
1465
+ *```js
1466
+ * //trigger when action starts
1467
+ * searchEmbed.on(EmbedEvent.Pin, payload => {
1468
+ * console.log('pin', payload)
1469
+ * }, {
1470
+ * start: true
1471
+ * })
1472
+ * //trigger when action ends
1473
+ * searchEmbed.on(EmbedEvent.Pin, payload => {
1474
+ * console.log('pin', payload)
1475
+ * })
1476
+ *```
1228
1477
  */
1229
1478
  Pin = "pin",
1230
1479
  /**
1231
1480
  * Emitted when SpotIQ analysis is triggered
1232
1481
  *
1233
1482
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1483
+ * @example
1484
+ *```js
1485
+ * //trigger when action starts
1486
+ * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
1487
+ * console.log('SpotIQAnalyze', payload)
1488
+ * }, {
1489
+ * start: true
1490
+ * })
1491
+ * //trigger when action ends
1492
+ * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
1493
+ * console.log('SpotIQ analyze', payload)
1494
+ * })
1495
+ *```
1234
1496
  */
1235
1497
  SpotIQAnalyze = "spotIQAnalyze",
1236
1498
  /**
1237
1499
  * Emitted when a user shares an object with another user or group
1238
1500
  *
1239
1501
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1502
+ * @example
1503
+ *```js
1504
+ * //trigger when action starts
1505
+ * searchEmbed.on(EmbedEvent.Share, payload => {
1506
+ * console.log('Share', payload)
1507
+ * }, {
1508
+ * start: true
1509
+ * })
1510
+ * //trigger when action ends
1511
+ * searchEmbed.on(EmbedEvent.Share, payload => {
1512
+ * console.log('Share', payload)
1513
+ * })
1514
+ *```
1240
1515
  */
1241
1516
  Share = "share",
1242
1517
  /**
1243
- * Emitted when a user clicks the Include action to include a specific value or data
1244
- * on a chart or table
1518
+ * Emitted when a user clicks the **Include** action to include a specific value or
1519
+ * data on a chart or table.
1245
1520
  *
1246
1521
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1522
+ * @example
1523
+ *```js
1524
+ * appEmbed.on(EmbedEvent.DrillInclude, payload => {
1525
+ * console.log('Drill include', payload);
1526
+ * })
1527
+ *```
1247
1528
  */
1248
1529
  DrillInclude = "context-menu-item-include",
1249
1530
  /**
1250
- * Emitted when a user clicks the Exclude action to exclude a specific value or data
1251
- * on a chart or table
1531
+ * Emitted when a user clicks the **Exclude** action to exclude a specific value or
1532
+ * data on a chart or table
1252
1533
  *
1253
1534
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1535
+ * @example
1536
+ *```js
1537
+ * appEmbed.on(EmbedEvent.DrillExclude, payload => {
1538
+ * console.log('Drill exclude', payload);
1539
+ * })
1540
+ *```
1254
1541
  */
1255
1542
  DrillExclude = "context-menu-item-exclude",
1256
1543
  /**
1257
- * Emitted when copied column value on the app
1544
+ * Emitted when a column value is copied in the embedded app.
1258
1545
  *
1259
1546
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1547
+ * @example
1548
+ *```js
1549
+ * seachEmbed.on(EmbedEvent.CopyToClipboard, payload => {
1550
+ * console.log('copy to clipboard', payload);
1551
+ * })
1552
+ *```
1260
1553
  */
1261
1554
  CopyToClipboard = "context-menu-item-copy-to-clipboard",
1262
1555
  /**
1263
- * Emitted when a user clicks the Update TML action
1556
+ * Emitted when a user clicks the **Update TML** action
1264
1557
  *
1265
1558
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1559
+ * @example
1560
+ *```js
1561
+ * liveboardEmbed.on(EmbedEvent.UpdateTML)
1562
+ * })
1563
+ *```
1266
1564
  */
1267
1565
  UpdateTML = "updateTSL",
1268
1566
  /**
1269
- * Emitted when a user clicks the Edit TML action
1567
+ * Emitted when a user clicks the **Edit TML** action
1270
1568
  *
1271
1569
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1570
+ * @example
1571
+ *```js
1572
+ * appEmbed.on(EmbedEvent.EditTML, payload => {
1573
+ * console.log('Edit TML', payload);
1574
+ * })
1575
+ *```
1272
1576
  */
1273
1577
  EditTML = "editTSL",
1274
1578
  /**
1275
- * Emitted when ExportTML trigger in answer on the app
1579
+ * Emitted when the **Export TML** action is triggered on an
1580
+ * an embedded object in the app
1276
1581
  *
1277
1582
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1583
+ * @example
1584
+ *```js
1585
+ * //trigger when action starts
1586
+ * searchEmbed.on(EmbedEvent.ExportTML, payload => {
1587
+ * console.log('Export TML', payload)}, { start: true })
1588
+ * //trigger when action ends
1589
+ * searchEmbed.on(EmbedEvent.ExportTML, payload => {
1590
+ * console.log('Export TML', payload)})
1591
+ *```
1278
1592
  */
1279
1593
  ExportTML = "exportTSL",
1280
1594
  /**
1281
- * Emitted when an answer is saved as a view
1595
+ * Emitted when an Answer is saved as a View.
1282
1596
  *
1283
1597
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1598
+ * @example
1599
+ *```js
1600
+ * appEmbed.on(EmbedEvent.SaveAsView, payload => {
1601
+ * console.log('View', payload);
1602
+ * })
1603
+ *```
1284
1604
  */
1285
1605
  SaveAsView = "saveAsView",
1286
1606
  /**
1287
- * Emitted when copy of existing answer on the app
1607
+ * Emitted when the user creates a copy of an Answer
1288
1608
  *
1289
1609
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1610
+ * @example
1611
+ *```js
1612
+ * //trigger when action starts
1613
+ * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
1614
+ * console.log('Copy and edit', payload)}, {start: true })
1615
+ * //trigger when action ends
1616
+ * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
1617
+ * console.log('Copy and edit', payload)})
1618
+ *```
1290
1619
  */
1291
1620
  CopyAEdit = "copyAEdit",
1292
1621
  /**
1293
- * Emitted when a user clicks Show underlying data on an answe
1622
+ * Emitted when a user clicks Show underlying data on an Answer
1294
1623
  *
1295
1624
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1625
+ * @example
1626
+ *```js
1627
+ * liveboardEmbed.on(EmbedEvent.ShowUnderlyingData, payload => {
1628
+ * console.log('show data', payload);
1629
+ * })
1630
+ *```
1296
1631
  */
1297
1632
  ShowUnderlyingData = "showUnderlyingData",
1298
1633
  /**
1299
- * Emitted when an answer is switched to a chart or table view
1634
+ * Emitted when an answer is switched to a chart or table view.
1300
1635
  *
1301
1636
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1637
+ * @example
1638
+ *```js
1639
+ * searchEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
1640
+ * console.log('switch view', payload);
1641
+ * })
1642
+ *```
1302
1643
  */
1303
1644
  AnswerChartSwitcher = "answerChartSwitcher",
1304
1645
  /**
1305
- * Internal event to communicate the initial settings back to the TS APP
1646
+ * Internal event to communicate the initial settings back to the ThoughtSpot app
1306
1647
  *
1307
1648
  * @hidden
1308
1649
  */
1309
1650
  APP_INIT = "appInit",
1310
1651
  /**
1311
- * Emitted when a user clicks Show Liveboard details on a Liveboard
1652
+ * Emitted when a user clicks **Show Liveboard details** on a Liveboard
1312
1653
  *
1313
1654
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1655
+ * @example
1656
+ *```js
1657
+ * liveboardEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
1658
+ * console.log('Liveboard details', payload);
1659
+ * })
1660
+ *```
1314
1661
  */
1315
1662
  LiveboardInfo = "pinboardInfo",
1316
1663
  /**
1317
1664
  * Emitted when a user clicks on the Favorite icon on a Liveboard
1318
1665
  *
1319
1666
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1667
+ * @example
1668
+ *```js
1669
+ * liveboardEmbed.on(EmbedEvent.AddToFavorites, payload => {
1670
+ * console.log('favorites', payload);
1671
+ * })
1672
+ *```
1320
1673
  */
1321
1674
  AddToFavorites = "addToFavorites",
1322
1675
  /**
1323
- * Emitted when a user clicks Schedule on a Liveboard
1676
+ * Emitted when a user clicks **Schedule** on a Liveboard
1324
1677
  *
1325
1678
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1679
+ * @example
1680
+ *```js
1681
+ * liveboardEmbed.on(EmbedEvent.Schedule, payload => {
1682
+ * console.log(`Liveboard schedule', payload);
1683
+ * })
1684
+ *```
1326
1685
  */
1327
1686
  Schedule = "subscription",
1328
1687
  /**
1329
- * Emitted when a user clicks Edit on a Liveboard or visualization
1688
+ * Emitted when a user clicks **Edit** on a Liveboard or visualization
1330
1689
  *
1331
1690
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1691
+ * @example
1692
+ *```js
1693
+ * liveboardEmbed.on(EmbedEvent.Edit, payload => {
1694
+ * console.log(`Liveboard edit', payload);
1695
+ * })
1696
+ *```
1332
1697
  */
1333
1698
  Edit = "edit",
1334
1699
  /**
1335
- * Emitted when a user clicks Make a copy on a Liveboard
1700
+ * Emitted when a user clicks *Make a copy* on a Liveboard
1336
1701
  *
1337
1702
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1703
+ * @example
1704
+ *```js
1705
+ * liveboardEmbed.on(EmbedEvent.MakeACopy, payload => {
1706
+ * console.log(`Copy', payload);
1707
+ * })
1708
+ *```
1338
1709
  */
1339
1710
  MakeACopy = "makeACopy",
1340
1711
  /**
1341
- * Emitted when a user clicks Present on a Liveboard or visualization
1712
+ * Emitted when a user clicks **Present** on a Liveboard or visualization
1342
1713
  *
1343
1714
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1715
+ * @example
1716
+ *```js
1717
+ * liveboardEmbed.trigger(HostEvent.Present)
1718
+ *```
1719
+ * @example
1720
+ *```js
1721
+ * liveboardEmbed.on(EmbedEvent.Present, {
1722
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1723
+ * })
1724
+ *```
1344
1725
  */
1345
1726
  Present = "present",
1346
1727
  /**
1347
- * Emitted when a user clicks Delete on a Liveboard
1728
+ * Emitted when a user clicks **Delete** on a visualization
1348
1729
  *
1349
1730
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1731
+ * @example
1732
+ *```js
1733
+ * liveboardEmbed.trigger(HostEvent.Delete,
1734
+ * {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1735
+ *```
1350
1736
  */
1351
1737
  Delete = "delete",
1352
1738
  /**
1353
1739
  * Emitted when a user clicks Manage schedules on a Liveboard
1354
1740
  *
1355
1741
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1742
+ * @example
1743
+ *```js
1744
+ * liveboardEmbed.trigger(HostEvent.SchedulesList)
1745
+ *```
1356
1746
  */
1357
1747
  SchedulesList = "schedule-list",
1358
1748
  /**
1359
- * Emitted when a user clicks Cancel in edit mode on a Liveboard
1749
+ * Emitted when a user clicks **Cancel** in edit mode on a Liveboard
1360
1750
  *
1361
1751
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1752
+ * @example
1753
+ *```js
1754
+ * liveboardEmbed.trigger(HostEvent.Cancel)
1755
+ *```
1362
1756
  */
1363
1757
  Cancel = "cancel",
1364
1758
  /**
1365
- * Emitted when a user clicks Explore on a visualization
1759
+ * Emitted when a user clicks **Explore** on a visualization
1366
1760
  *
1367
1761
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1762
+ * @example
1763
+ *```js
1764
+ * liveboardEmbed.trigger(HostEvent.Explore, {
1765
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1766
+ *```
1368
1767
  */
1369
1768
  Explore = "explore",
1370
1769
  /**
1371
- * Emitted when a user clicks Copy link action on a visualization
1770
+ * Emitted when a user clicks **Copy link** action on a visualization
1372
1771
  *
1373
1772
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1773
+ * @example
1774
+ *```js
1775
+ * liveboardEmbed.trigger(HostEvent.CopyLink, {
1776
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1777
+ *```
1374
1778
  */
1375
1779
  CopyLink = "embedDocument",
1376
1780
  /**
1377
- * Emitted when a user interacts with cross filters on a visualization or liveboard
1781
+ * Emitted when a user interacts with cross filters on a visualization or Liveboard
1378
1782
  *
1379
- * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
1783
+ * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
1784
+ * @example
1785
+ *```js
1786
+ * liveboardEmbed.trigger(HostEvent.CrossFilterChanged, {
1787
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1788
+ *```
1380
1789
  */
1381
1790
  CrossFilterChanged = "cross-filter-changed",
1382
1791
  /**
1383
1792
  * Emitted when a user right clicks on a visualization (chart or table)
1384
1793
  *
1385
- * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
1794
+ * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
1795
+ * @example
1796
+ *```js
1797
+ * LiveboardEmbed.on(EmbedEvent.VizPointRightClick, payload => {
1798
+ * console.log('VizPointClick', payload)
1799
+ * })
1800
+ *```
1386
1801
  */
1387
1802
  VizPointRightClick = "vizPointRightClick",
1388
1803
  /**
1389
- * Emitted when a user clicks on Insert to slide on a visualization
1804
+ * Emitted when a user clicks **Insert to slide** on a visualization
1390
1805
  *
1391
1806
  * @hidden
1392
1807
  */
@@ -1394,52 +1809,52 @@ export declare enum EmbedEvent {
1394
1809
  /**
1395
1810
  * @hidden
1396
1811
  * Emitted when a user changes any filter on a Liveboard.
1397
- * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
1812
+ * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.0.sw
1398
1813
  */
1399
1814
  FilterChanged = "filterChanged",
1400
1815
  /**
1401
- * Emitted when a user click on Go button in Sage Embed
1816
+ * Emitted when a user clicks the **Go** button on the Search page
1402
1817
  *
1403
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1818
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1404
1819
  */
1405
1820
  SageEmbedQuery = "sageEmbedQuery",
1406
1821
  /**
1407
- * Emitten when a user select data source in Sage Embed
1822
+ * Emitted when a user selects a data source.
1408
1823
  *
1409
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1824
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1410
1825
  */
1411
1826
  SageWorksheetUpdated = "sageWorksheetUpdated",
1412
1827
  /**
1413
- * Emitted when a user updates a connection in Data tab
1828
+ * Emitted when a user updates a connection on the **Data** page
1414
1829
  *
1415
- * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
1830
+ * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
1416
1831
  */
1417
1832
  UpdateConnection = "updateConnection",
1418
1833
  /**
1419
- * Emitted when a user updates a connection in Data tab
1834
+ * Emitted when a user updates a connection on the **Data** page
1420
1835
  *
1421
- * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
1836
+ * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
1422
1837
  */
1423
1838
  CreateConnection = "createConnection",
1424
1839
  /**
1425
1840
  * Emitted when name, status (private or public) or filter values of a
1426
- * PersonalisedView is updated.
1841
+ * Personalised view is updated.
1427
1842
  *
1428
1843
  * @returns viewName: string
1429
1844
  * @returns viewId: string
1430
1845
  * @returns liveboardId: string
1431
1846
  * @returns isPublic: boolean
1432
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1847
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1433
1848
  */
1434
1849
  UpdatePersonalisedView = "updatePersonalisedView",
1435
1850
  /**
1436
- * Emitted when a PersonalisedView is saved.
1851
+ * Emitted when a Personalised view is saved.
1437
1852
  *
1438
1853
  * @returns viewName: string
1439
1854
  * @returns viewId: string
1440
1855
  * @returns liveboardId: string
1441
1856
  * @returns isPublic: boolean
1442
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1857
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1443
1858
  */
1444
1859
  SavePersonalisedView = "savePersonalisedView",
1445
1860
  /**
@@ -1449,7 +1864,7 @@ export declare enum EmbedEvent {
1449
1864
  * @returns viewId: string
1450
1865
  * @returns liveboardId: string
1451
1866
  * @returns isPublic: boolean
1452
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1867
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1453
1868
  */
1454
1869
  ResetLiveboard = "resetLiveboard",
1455
1870
  /**
@@ -1457,11 +1872,11 @@ export declare enum EmbedEvent {
1457
1872
  *
1458
1873
  * @returns views: string[]
1459
1874
  * @returns liveboardId: string
1460
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1875
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1461
1876
  */
1462
1877
  DeletePersonalisedView = "deletePersonalisedView",
1463
1878
  /**
1464
- * Emitten when a user creates a new worksheet
1879
+ * Emitted when a user creates a new worksheet
1465
1880
  *
1466
1881
  * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
1467
1882
  */
@@ -1491,15 +1906,16 @@ export declare enum EmbedEvent {
1491
1906
  */
1492
1907
  export declare enum HostEvent {
1493
1908
  /**
1494
- * Triggers a search query in AppEmbed and SearchEmbed
1495
- * deployments.
1909
+ * Triggers a search operation with the search tokens specified in
1910
+ * the search query string.
1911
+ * Supported in `AppEmbed` and `SearchEmbed` deployments.
1496
1912
  * Includes the following properties:
1497
1913
  *
1498
- * @param - dataSourceIds - The data source GUID to Search on
1914
+ * @param - `searchQuery` - query string with search tokens
1915
+ * @param - `dataSources` - Data source GUID to Search on
1499
1916
  * - Although an array, only a single source
1500
1917
  * is supported.
1501
- * @param - searchQuery - Query string with search tokens
1502
- * @param - execute - executes the existing / updated query
1918
+ * @param - `execute` - executes search and updates the existing query
1503
1919
  * @example
1504
1920
  * ```js
1505
1921
  * searchembed.trigger(HostEvent.Search, {
@@ -1519,6 +1935,10 @@ export declare enum HostEvent {
1519
1935
  * @param - columnGuid - Optional. GUID of the column to drill
1520
1936
  * by. If not provided it will auto drill by the configured
1521
1937
  * column.
1938
+ * @param - autoDrillDown - Optional. If true, the drill down will be
1939
+ * done automatically on the most popular column.
1940
+ * @param - vizId [TS >= 9.8.0] - Optional. The GUID of the visualization to drill
1941
+ * in case of a liveboard.
1522
1942
  * @example
1523
1943
  * ```js
1524
1944
  * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
@@ -1535,6 +1955,25 @@ export declare enum HostEvent {
1535
1955
  * });
1536
1956
  * })
1537
1957
  * ```
1958
+ * @example
1959
+ * ```js
1960
+ * // Works with TS 9.8.0 and above
1961
+ *
1962
+ * liveboardEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
1963
+ * console.log(payload);
1964
+ * const clickedPoint = payload.data.clickedPoint;
1965
+ * const selectedPoint = payload.data.selectedPoints;
1966
+ * console.log('>>> called', clickedPoint);
1967
+ * liveboardEmbed.trigger(HostEvent.DrillDown, {
1968
+ * points: {
1969
+ * clickedPoint,
1970
+ * selectedPoints: selectedPoint
1971
+ * },
1972
+ * autoDrillDown: true,
1973
+ * vizId: payload.data.vizId
1974
+ * });
1975
+ * })
1976
+ * ```
1538
1977
  * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
1539
1978
  */
1540
1979
  DrillDown = "triggerDrillDown",
@@ -1551,7 +1990,7 @@ export declare enum HostEvent {
1551
1990
  */
1552
1991
  Reload = "reload",
1553
1992
  /**
1554
- * Sets the visible visualizations on a Liveboard.
1993
+ * Display specific visualizations on a Liveboard.
1555
1994
  *
1556
1995
  * @param - An array of GUIDs of the visualization to show. The visualization IDs not passed
1557
1996
  * in this parameter will be hidden.
@@ -1565,7 +2004,7 @@ export declare enum HostEvent {
1565
2004
  */
1566
2005
  SetVisibleVizs = "SetPinboardVisibleVizs",
1567
2006
  /**
1568
- * Set the Active Tab of a Liveboard.
2007
+ * Set a Liveboard tab as an active tab.
1569
2008
  *
1570
2009
  * @param - tabId - string of id of Tab to show
1571
2010
  * @example
@@ -1578,7 +2017,7 @@ export declare enum HostEvent {
1578
2017
  */
1579
2018
  SetActiveTab = "SetActiveTab",
1580
2019
  /**
1581
- * Updates runtime filters applied on a Saved Answer or Liveboard. The
2020
+ * Update runtime filters applied on a Saved Answer or Liveboard. The
1582
2021
  * runtime filters passed here are appended to the existing runtime
1583
2022
  * filters.
1584
2023
  * Pass an array of runtime filters with the following attributes:
@@ -1604,10 +2043,11 @@ export declare enum HostEvent {
1604
2043
  */
1605
2044
  UpdateRuntimeFilters = "UpdateRuntimeFilters",
1606
2045
  /**
1607
- * Navigate to a specific page in the embedded application without reloading the page.
2046
+ * Navigate to a specific page in the embedded ThoughtSpot application.
1608
2047
  * This is the same as calling `appEmbed.navigateToPage(path, true)`
1609
2048
  *
1610
- * @param - path - the path to navigate to (can be a number[1/-1] to go forward/back)
2049
+ * @param - `path` - the path to navigate to to go forward or back. The path value can
2050
+ * be a number; for example, `1`, `-1`.
1611
2051
  * @example
1612
2052
  * ```js
1613
2053
  * appEmbed.navigateToPage(-1)
@@ -1616,7 +2056,7 @@ export declare enum HostEvent {
1616
2056
  */
1617
2057
  Navigate = "Navigate",
1618
2058
  /**
1619
- * Opens the filter panel for a particular column.
2059
+ * Open the filter panel for a particular column.
1620
2060
  * Works with Search and Liveboard embed.
1621
2061
  *
1622
2062
  * @param - { columnId: string,
@@ -1634,7 +2074,7 @@ export declare enum HostEvent {
1634
2074
  */
1635
2075
  OpenFilter = "openFilter",
1636
2076
  /**
1637
- * Adds columns to the current search query.
2077
+ * Add columns to the current search query.
1638
2078
  *
1639
2079
  * @param - { columnIds: string[] }
1640
2080
  * @example
@@ -1645,7 +2085,7 @@ export declare enum HostEvent {
1645
2085
  */
1646
2086
  AddColumns = "addColumns",
1647
2087
  /**
1648
- * Removes a column from the current search query.
2088
+ * Remove a column from the current search query.
1649
2089
  *
1650
2090
  * @param - { columnId: string }
1651
2091
  * @example
@@ -1656,27 +2096,29 @@ export declare enum HostEvent {
1656
2096
  */
1657
2097
  RemoveColumn = "removeColumn",
1658
2098
  /**
1659
- * Gets the current Liveboard content.
2099
+ * Get the transient state of a Liveboard as encoded content.
2100
+ * This includes unsaved and ad hoc changes such as
2101
+ * Liveboard filters, runtime filters applied on visualizations on a
2102
+ * Liveboard, and Liveboard layout, changes to visualizations such as
2103
+ * sorting, toggling of legends, and data drill down.
1660
2104
  *
1661
2105
  * @example
1662
2106
  * ```js
1663
- * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard)
2107
+ * liveboardEmbed.trigger(HostEvent.getexportrequestforcurrentpinboard).then(
2108
+ * data=>console.log(data))
1664
2109
  * ```
1665
2110
  * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1.sw
1666
2111
  */
1667
2112
  getExportRequestForCurrentPinboard = "getExportRequestForCurrentPinboard",
1668
2113
  /**
1669
- * Triggers the **Pin** action on an embedded object
2114
+ * Trigger the **Pin** action on an embedded object
1670
2115
  *
1671
2116
  * @param - Liveboard embed takes the `vizId` as a
1672
- * key. Can be left undefined when embedding Search, full app or
2117
+ * key. Can be left undefined when embedding Search, full app, or
1673
2118
  * a visualization.
1674
2119
  * @example
1675
2120
  * ```js
1676
- * liveboardEmbed.trigger(HostEvent.Pin, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1677
- * ```
1678
- * ```js
1679
- * vizEmbed.trigger(HostEvent.Pin)
2121
+ * appEmbed.trigger(HostEvent.Pin)
1680
2122
  * ```
1681
2123
  * ```js
1682
2124
  * searchEmbed.trigger(HostEvent.Pin)
@@ -1685,17 +2127,18 @@ export declare enum HostEvent {
1685
2127
  */
1686
2128
  Pin = "pin",
1687
2129
  /**
1688
- * Triggers the **Show Liveboard details** action on a Liveboard
2130
+ * Trigger the **Show Liveboard details** action
2131
+ * on an embedded Liveboard.
1689
2132
  *
1690
2133
  * @example
1691
- * ```js
1692
- * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
1693
- * ```
2134
+ *```js
2135
+ * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
2136
+ *```
1694
2137
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1695
2138
  */
1696
2139
  LiveboardInfo = "pinboardInfo",
1697
2140
  /**
1698
- * Triggers the **Schedule** action on a Liveboard
2141
+ * Trigger the **Schedule** action on an embedded Liveboard.
1699
2142
  *
1700
2143
  * @example
1701
2144
  * ```js
@@ -1705,7 +2148,7 @@ export declare enum HostEvent {
1705
2148
  */
1706
2149
  Schedule = "subscription",
1707
2150
  /**
1708
- * Triggers the **Manage schedule** action on a Liveboard
2151
+ * Trigger the **Manage schedule** action on an embedded Liveboard
1709
2152
  *
1710
2153
  * @example
1711
2154
  * ```js
@@ -1715,7 +2158,7 @@ export declare enum HostEvent {
1715
2158
  */
1716
2159
  SchedulesList = "schedule-list",
1717
2160
  /**
1718
- * Triggers the **Export TML** action on a Liveboard
2161
+ * Trigger the **Export TML** action on an embedded Liveboard.
1719
2162
  *
1720
2163
  * @example
1721
2164
  * ```js
@@ -1725,7 +2168,7 @@ export declare enum HostEvent {
1725
2168
  */
1726
2169
  ExportTML = "exportTSL",
1727
2170
  /**
1728
- * Triggers the **Edit TML** action on a Liveboard
2171
+ * Trigger the **Edit TML** action on an embedded Liveboard.
1729
2172
  *
1730
2173
  * @example
1731
2174
  * ```js
@@ -1735,7 +2178,7 @@ export declare enum HostEvent {
1735
2178
  */
1736
2179
  EditTML = "editTSL",
1737
2180
  /**
1738
- * Triggers the **Update TML** action on a Liveboard
2181
+ * Trigger the **Update TML** action on an embedded Liveboard.
1739
2182
  *
1740
2183
  * @example
1741
2184
  * ```js
@@ -1745,7 +2188,7 @@ export declare enum HostEvent {
1745
2188
  */
1746
2189
  UpdateTML = "updateTSL",
1747
2190
  /**
1748
- * Triggers the **Download PDF** action on a Liveboard
2191
+ * Trigger the **Download PDF** action on an embedded Liveboard.
1749
2192
  *
1750
2193
  * @example
1751
2194
  * ```js
@@ -1755,8 +2198,8 @@ export declare enum HostEvent {
1755
2198
  */
1756
2199
  DownloadAsPdf = "downloadAsPdf",
1757
2200
  /**
1758
- * Triggers the **Make a copy** action on a Liveboard, Search, or
1759
- * visualization page
2201
+ * Trigger the **Make a copy** action on a Liveboard, Search, or
2202
+ * visualization page.
1760
2203
  *
1761
2204
  * @example
1762
2205
  * ```js
@@ -1772,7 +2215,7 @@ export declare enum HostEvent {
1772
2215
  */
1773
2216
  MakeACopy = "makeACopy",
1774
2217
  /**
1775
- * Triggers the **Delete** action on a Liveboard
2218
+ * Trigger the **Delete** action for a Liveboard.
1776
2219
  *
1777
2220
  * @example
1778
2221
  * ```js
@@ -1782,7 +2225,7 @@ export declare enum HostEvent {
1782
2225
  */
1783
2226
  Remove = "delete",
1784
2227
  /**
1785
- * Triggers the **Explore* action on a visualization
2228
+ * Trigger the **Explore** action on a visualization.
1786
2229
  *
1787
2230
  * @param - an object with `vizId` as a key
1788
2231
  * @example
@@ -1793,7 +2236,7 @@ export declare enum HostEvent {
1793
2236
  */
1794
2237
  Explore = "explore",
1795
2238
  /**
1796
- * Triggers the **Create alert** action on a visualization
2239
+ * Trigger the **Create alert** action on a visualization
1797
2240
  *
1798
2241
  * @param - an object with `vizId` as a key
1799
2242
  * @example
@@ -1806,7 +2249,7 @@ export declare enum HostEvent {
1806
2249
  */
1807
2250
  CreateMonitor = "createMonitor",
1808
2251
  /**
1809
- * Triggers the **Manage alerts** action on a visualization
2252
+ * Trigger the **Manage alerts** action on a visualization
1810
2253
  *
1811
2254
  * @param - an object with `vizId` as a key
1812
2255
  * @example
@@ -1819,7 +2262,7 @@ export declare enum HostEvent {
1819
2262
  */
1820
2263
  ManageMonitor = "manageMonitor",
1821
2264
  /**
1822
- * Triggers the **Edit** action on a Liveboard or visualization
2265
+ * Trigger the **Edit** action on a Liveboard or visualization
1823
2266
  *
1824
2267
  * @param - object - To trigger the action for a specific visualization
1825
2268
  * in Liveboard embed, pass in `vizId` as a key.
@@ -1840,7 +2283,7 @@ export declare enum HostEvent {
1840
2283
  */
1841
2284
  Edit = "edit",
1842
2285
  /**
1843
- * Triggers the **Copy link** action on a Liveboard or visualization
2286
+ * Trigger the **Copy link** action on a Liveboard or visualization
1844
2287
  *
1845
2288
  * @param - object - to trigger the action for a
1846
2289
  * specific visualization in Liveboard embed, pass in `vizId` as a key
@@ -1858,7 +2301,7 @@ export declare enum HostEvent {
1858
2301
  */
1859
2302
  CopyLink = "embedDocument",
1860
2303
  /**
1861
- * Triggers the **Present** action on a Liveboard or visualization
2304
+ * Trigger the **Present** action on a Liveboard or visualization
1862
2305
  *
1863
2306
  * @param - object - to trigger the action for a specific visualization
1864
2307
  * in Liveboard embed, pass in `vizId` as a key
@@ -1876,7 +2319,7 @@ export declare enum HostEvent {
1876
2319
  */
1877
2320
  Present = "present",
1878
2321
  /**
1879
- * Gets TML for the current search.
2322
+ * Get TML for the current search.
1880
2323
  *
1881
2324
  * @example
1882
2325
  * ```js
@@ -1891,7 +2334,7 @@ export declare enum HostEvent {
1891
2334
  */
1892
2335
  GetTML = "getTML",
1893
2336
  /**
1894
- * Triggers the **Show underlying data** action on visualization or search
2337
+ * Trigger the **Show underlying data** action on visualization or search
1895
2338
  *
1896
2339
  * @param - an object with vizId as a key
1897
2340
  * @example
@@ -1909,7 +2352,9 @@ export declare enum HostEvent {
1909
2352
  */
1910
2353
  ShowUnderlyingData = "showUnderlyingData",
1911
2354
  /**
1912
- * Triggers the **Delete** action on visualization or search
2355
+ * Trigger the **Delete** action for a visualization
2356
+ * in an embedded Liveboard, or a chart or table
2357
+ * generated from Search.
1913
2358
  *
1914
2359
  * @param - Liveboard embed takes an object with `vizId` as a key.
1915
2360
  * Can be left empty if embedding Search or visualization.
@@ -1919,16 +2364,13 @@ export declare enum HostEvent {
1919
2364
  * '730496d6-6903-4601-937e-2c691821af3c'})
1920
2365
  * ```
1921
2366
  * ```js
1922
- * vizEmbed.trigger(HostEvent.Delete)
1923
- * ```
1924
- * ```js
1925
2367
  * searchEmbed.trigger(HostEvent.Delete)
1926
2368
  * ```
1927
2369
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
1928
2370
  */
1929
2371
  Delete = "onDeleteAnswer",
1930
2372
  /**
1931
- * Triggers the **SpotIQ analyze** action on visualization
2373
+ * Trigger the **SpotIQ analyze** action on visualization
1932
2374
  * or search.
1933
2375
  *
1934
2376
  * @param - Liveboard embed takes `vizId` as a
@@ -1949,7 +2391,7 @@ export declare enum HostEvent {
1949
2391
  */
1950
2392
  SpotIQAnalyze = "spotIQAnalyze",
1951
2393
  /**
1952
- * Triggers the **Download** action on charts in
2394
+ * Trigger the **Download** action on charts in
1953
2395
  * the embedded view.
1954
2396
  *
1955
2397
  * @example
@@ -1958,17 +2400,15 @@ export declare enum HostEvent {
1958
2400
  * '730496d6-6903-4601-937e-2c691821af3c'})
1959
2401
  * ```
1960
2402
  * ```js
1961
- * vizEmbed.trigger(HostEvent.Download)
1962
- * ```
1963
- * ```js
1964
- * searchEmbed.trigger(HostEvent.Download)
2403
+ * embed.trigger(HostEvent.Download)
1965
2404
  * ```
1966
- * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw ,Use {@link DownloadAsPng}
2405
+ * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw
2406
+ * Use {@link DownloadAsPng}
1967
2407
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
1968
2408
  */
1969
2409
  Download = "downloadAsPng",
1970
2410
  /**
1971
- * Triggers the **Download** > **PNG** action on
2411
+ * Trigger the **Download** > **PNG** action on
1972
2412
  * charts in the embedded view.
1973
2413
  *
1974
2414
  * @example
@@ -1984,7 +2424,7 @@ export declare enum HostEvent {
1984
2424
  */
1985
2425
  DownloadAsPng = "downloadAsPng",
1986
2426
  /**
1987
- * Triggers the **Download** > **CSV** action on tables in
2427
+ * Trigger the **Download** > **CSV** action on tables in
1988
2428
  * the embedded view.
1989
2429
  *
1990
2430
  * @example
@@ -2002,7 +2442,7 @@ export declare enum HostEvent {
2002
2442
  */
2003
2443
  DownloadAsCsv = "downloadAsCSV",
2004
2444
  /**
2005
- * Triggers the **Download** > **XLSX** action on tables
2445
+ * Trigger the **Download** > **XLSX** action on tables
2006
2446
  * in the embedded view.
2007
2447
  *
2008
2448
  * @example
@@ -2020,7 +2460,7 @@ export declare enum HostEvent {
2020
2460
  */
2021
2461
  DownloadAsXlsx = "downloadAsXLSX",
2022
2462
  /**
2023
- * Triggers the **Share** action on an embedded
2463
+ * Trigger the **Share** action on an embedded
2024
2464
  * Liveboard or Answer.
2025
2465
  *
2026
2466
  * @example
@@ -2034,7 +2474,7 @@ export declare enum HostEvent {
2034
2474
  */
2035
2475
  Share = "share",
2036
2476
  /**
2037
- * Triggers the **Save** action on a Liveboard or Answer.
2477
+ * Trigger the **Save** action on a Liveboard or Answer.
2038
2478
  * Saves the changes.
2039
2479
  *
2040
2480
  * @example
@@ -2048,7 +2488,7 @@ export declare enum HostEvent {
2048
2488
  */
2049
2489
  Save = "save",
2050
2490
  /**
2051
- * Triggers the **Sync to Sheets** action on an embedded visualization or Answer
2491
+ * Trigger the **Sync to Sheets** action on an embedded visualization or Answer
2052
2492
  * Sends data from an Answer or Liveboard visualization to a Google sheet.
2053
2493
  *
2054
2494
  * @param - an object with `vizId` as a key
@@ -2064,7 +2504,7 @@ export declare enum HostEvent {
2064
2504
  */
2065
2505
  SyncToSheets = "sync-to-sheets",
2066
2506
  /**
2067
- * Triggers the **Sync to Other Apps** action on an embedded visualization or Answer
2507
+ * Trigger the **Sync to Other Apps** action on an embedded visualization or Answer
2068
2508
  * Sends data from an Answer or Liveboard visualization to third-party apps such
2069
2509
  * as Slack, Salesforce, Microsoft Teams, ServiceNow and so on.
2070
2510
  *
@@ -2081,7 +2521,7 @@ export declare enum HostEvent {
2081
2521
  */
2082
2522
  SyncToOtherApps = "sync-to-other-apps",
2083
2523
  /**
2084
- * Triggers the **Manage pipelines** action on an embedded
2524
+ * Trigger the **Manage pipelines** action on an embedded
2085
2525
  * visualization or Answer.
2086
2526
  * Allows users to manage ThoughtSpot Sync pipelines.
2087
2527
  *
@@ -2098,18 +2538,21 @@ export declare enum HostEvent {
2098
2538
  */
2099
2539
  ManagePipelines = "manage-pipeline",
2100
2540
  /**
2101
- * Triggers the Reset search on the Search page
2541
+ * Reset search operation on the Search or Answer page.
2102
2542
  *
2103
2543
  * @example
2104
2544
  * ```js
2105
2545
  * searchEmbed.trigger(HostEvent.ResetSearch)
2106
2546
  * ```
2547
+ * ```js
2548
+ * appEmbed.trigger(HostEvent.ResetSearch)
2549
+ * ```
2107
2550
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.0.1.sw
2108
2551
  */
2109
2552
  ResetSearch = "resetSearch",
2110
2553
  /**
2111
2554
  * @hidden
2112
- * Gets the currents visible and runtime filters applied on a Liveboard
2555
+ * Get the currents visible and runtime filters applied on a Liveboard
2113
2556
  * @example
2114
2557
  * liveboardEmbed.trigger(HostEvent.GetFilters)
2115
2558
  * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
@@ -2117,7 +2560,7 @@ export declare enum HostEvent {
2117
2560
  GetFilters = "getFilters",
2118
2561
  /**
2119
2562
  * @hidden
2120
- * Updates the visible filters on the Liveboard.
2563
+ * Update the visible filters on the Liveboard.
2121
2564
  * @param - filter: filter object containing column name and filter operation and values
2122
2565
  * @example
2123
2566
  *
@@ -2130,7 +2573,7 @@ export declare enum HostEvent {
2130
2573
  */
2131
2574
  UpdateFilters = "updateFilters",
2132
2575
  /**
2133
- * Get Tab for the current Liveboard.
2576
+ * Get tab details for the current Liveboard.
2134
2577
  *
2135
2578
  * @example
2136
2579
  * ```js
@@ -2144,9 +2587,9 @@ export declare enum HostEvent {
2144
2587
  */
2145
2588
  GetTabs = "getTabs",
2146
2589
  /**
2147
- * Set the visible Tabs on a Liveboard.
2590
+ * Set the visible tabs on a Liveboard.
2148
2591
  *
2149
- * @param - an array of ids of Tabs to show, the ids not passed
2592
+ * @param - an array of ids of tabs to show, the IDs not passed
2150
2593
  * will be hidden.
2151
2594
  * @example
2152
2595
  * ```js
@@ -2160,8 +2603,8 @@ export declare enum HostEvent {
2160
2603
  /**
2161
2604
  * Set the hidden tabs on a Liveboard.
2162
2605
  *
2163
- * @param - an array of ids of Tabs to hide, the ids not passed
2164
- * will be shown.
2606
+ * @param - an array of the IDs of the tabs to hide.
2607
+ * The IDs not passed will be shown.
2165
2608
  * @example
2166
2609
  * ```js
2167
2610
  * liveboardEmbed.trigger(HostEvent.SetHiddenTabs, [
@@ -2172,9 +2615,10 @@ export declare enum HostEvent {
2172
2615
  */
2173
2616
  SetHiddenTabs = "SetPinboardHiddenTabs",
2174
2617
  /**
2175
- * Updates the search query for sage embed.
2618
+ * Updates the search query string for Natural Language Search operations.
2176
2619
  *
2177
- * @param - searchOptions: an object queryString and option to execute the query.
2620
+ * @param - `queryString`: Text string in Natural Language format
2621
+ * @param - `executeSearch`: Boolean to execute search and update search query
2178
2622
  * @example
2179
2623
  * ```js
2180
2624
  * sageEmbed.trigger(HostEvent.UpdateSageQuery, {
@@ -2182,7 +2626,7 @@ export declare enum HostEvent {
2182
2626
  * executeSearch: true,
2183
2627
  * })
2184
2628
  * ```
2185
- * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
2629
+ * @version SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
2186
2630
  */
2187
2631
  UpdateSageQuery = "updateSageQuery",
2188
2632
  /**
@@ -2195,24 +2639,25 @@ export declare enum HostEvent {
2195
2639
  * vizId: '123', // For Liveboard Visualization.
2196
2640
  * })
2197
2641
  * ```
2642
+ * @version SDK: 1.26.0 | Thoughtspot: 9.10.0.cl
2198
2643
  */
2199
2644
  GetAnswerSession = "getAnswerSession"
2200
2645
  }
2201
2646
  /**
2202
2647
  * The different visual modes that the data sources panel within
2203
- * search could appear in, i.e., hidden, collapsed, or expanded.
2648
+ * search could appear in, such as hidden, collapsed, or expanded.
2204
2649
  */
2205
2650
  export declare enum DataSourceVisualMode {
2206
2651
  /**
2207
- * Data source panel is hidden.
2652
+ * The data source panel is hidden.
2208
2653
  */
2209
2654
  Hidden = "hide",
2210
2655
  /**
2211
- * Data source panel is collapsed, but the user can manually expand it.
2656
+ * The data source panel is collapsed, but the user can manually expand it.
2212
2657
  */
2213
2658
  Collapsed = "collapse",
2214
2659
  /**
2215
- * Data source panel is expanded, but the user can manually collapse it.
2660
+ * The data source panel is expanded, but the user can manually collapse it.
2216
2661
  */
2217
2662
  Expanded = "expand"
2218
2663
  }
@@ -2288,7 +2733,8 @@ export declare enum Param {
2288
2733
  LiveboardHeaderSticky = "isLiveboardHeaderSticky",
2289
2734
  IsProductTour = "isProductTour",
2290
2735
  HideSearchBarTitle = "hideSearchBarTitle",
2291
- HideSageAnswerHeader = "hideSageAnswerHeader"
2736
+ HideSageAnswerHeader = "hideSageAnswerHeader",
2737
+ HideSearchBar = "hideSearchBar"
2292
2738
  }
2293
2739
  /**
2294
2740
  * ThoughtSpot application pages include actions and menu commands
@@ -2348,9 +2794,11 @@ export declare enum Action {
2348
2794
  SaveAsView = "saveAsView",
2349
2795
  /**
2350
2796
  * The **Make a copy** action on a Liveboard or Answer
2351
- * page.
2352
- * Creates a copy of the Liveboard, visualization,
2353
- * or Answer.
2797
+ * page. Creates a copy of the Liveboard.
2798
+ * In LiveboardEmbed, the **Make a copy** action is not available for
2799
+ * visualizations in the embedded Liveboard view.
2800
+ * In AppEmbed, the **Make a copy** action is available on both
2801
+ * Liveboards and visualizations.
2354
2802
  *
2355
2803
  * @example
2356
2804
  * ```js
@@ -2534,7 +2982,7 @@ export declare enum Action {
2534
2982
  */
2535
2983
  DownloadAsPdf = "downloadAsPdf",
2536
2984
  /**
2537
- * The **Download** > **CSV** menu action for tables on a Liveboard
2985
+ * The **Download** > **CSV** menu action for tables on a Liveboard
2538
2986
  * or Answer page.
2539
2987
  * Downloads a visualization or Answer in the XLSX format.
2540
2988
  *
@@ -3065,6 +3513,7 @@ export declare enum Action {
3065
3513
  */
3066
3514
  RenameModalTitleDescription = "renameModalTitleDescription",
3067
3515
  /**
3516
+ *
3068
3517
  * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
3069
3518
  */
3070
3519
  RequestVerification = "requestVerification",