@thoughtspot/visual-embed-sdk 1.20.0 → 1.21.0-alpha.0

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 (185) hide show
  1. package/README.md +1 -1
  2. package/dist/src/auth.d.ts +84 -5
  3. package/dist/src/auth.d.ts.map +1 -1
  4. package/dist/src/config.d.ts +1 -0
  5. package/dist/src/config.d.ts.map +1 -1
  6. package/dist/src/embed/app.d.ts +19 -7
  7. package/dist/src/embed/app.d.ts.map +1 -1
  8. package/dist/src/embed/base.d.ts +39 -19
  9. package/dist/src/embed/base.d.ts.map +1 -1
  10. package/dist/src/embed/liveboard.d.ts +19 -7
  11. package/dist/src/embed/liveboard.d.ts.map +1 -1
  12. package/dist/src/embed/search-bar.d.ts +7 -1
  13. package/dist/src/embed/search-bar.d.ts.map +1 -1
  14. package/dist/src/embed/search.d.ts +11 -7
  15. package/dist/src/embed/search.d.ts.map +1 -1
  16. package/dist/src/embed/ts-embed.d.ts +97 -5
  17. package/dist/src/embed/ts-embed.d.ts.map +1 -1
  18. package/dist/src/errors.d.ts.map +1 -1
  19. package/dist/src/index.d.ts +3 -3
  20. package/dist/src/index.d.ts.map +1 -1
  21. package/dist/src/mixpanel-service.d.ts +8 -0
  22. package/dist/src/mixpanel-service.d.ts.map +1 -1
  23. package/dist/src/react/index.d.ts.map +1 -1
  24. package/dist/src/react/util.d.ts +4 -0
  25. package/dist/src/react/util.d.ts.map +1 -1
  26. package/dist/src/test/test-utils.d.ts +11 -2
  27. package/dist/src/test/test-utils.d.ts.map +1 -1
  28. package/dist/src/types.d.ts +430 -98
  29. package/dist/src/types.d.ts.map +1 -1
  30. package/dist/src/utils/answerService.d.ts +7 -0
  31. package/dist/src/utils/answerService.d.ts.map +1 -1
  32. package/dist/src/utils/authService.d.ts +30 -0
  33. package/dist/src/utils/authService.d.ts.map +1 -1
  34. package/dist/src/utils/processData.d.ts +12 -0
  35. package/dist/src/utils/processData.d.ts.map +1 -1
  36. package/dist/src/utils/processTrigger.d.ts +7 -0
  37. package/dist/src/utils/processTrigger.d.ts.map +1 -1
  38. package/dist/src/utils.d.ts +12 -0
  39. package/dist/src/utils.d.ts.map +1 -1
  40. package/dist/tsembed.es.js +849 -288
  41. package/dist/tsembed.js +822 -287
  42. package/lib/package.json +4 -10
  43. package/lib/src/auth.d.ts +84 -5
  44. package/lib/src/auth.d.ts.map +1 -1
  45. package/lib/src/auth.js +86 -26
  46. package/lib/src/auth.js.map +1 -1
  47. package/lib/src/auth.spec.js +14 -5
  48. package/lib/src/auth.spec.js.map +1 -1
  49. package/lib/src/config.d.ts +1 -0
  50. package/lib/src/config.d.ts.map +1 -1
  51. package/lib/src/config.js +5 -3
  52. package/lib/src/config.js.map +1 -1
  53. package/lib/src/config.spec.js.map +1 -1
  54. package/lib/src/embed/app.d.ts +19 -7
  55. package/lib/src/embed/app.d.ts.map +1 -1
  56. package/lib/src/embed/app.js +26 -16
  57. package/lib/src/embed/app.js.map +1 -1
  58. package/lib/src/embed/app.spec.js +12 -12
  59. package/lib/src/embed/app.spec.js.map +1 -1
  60. package/lib/src/embed/base.d.ts +39 -19
  61. package/lib/src/embed/base.d.ts.map +1 -1
  62. package/lib/src/embed/base.js +49 -15
  63. package/lib/src/embed/base.js.map +1 -1
  64. package/lib/src/embed/base.spec.js +2 -2
  65. package/lib/src/embed/base.spec.js.map +1 -1
  66. package/lib/src/embed/embed.spec.js +1 -1
  67. package/lib/src/embed/embed.spec.js.map +1 -1
  68. package/lib/src/embed/liveboard.d.ts +19 -7
  69. package/lib/src/embed/liveboard.d.ts.map +1 -1
  70. package/lib/src/embed/liveboard.js +50 -38
  71. package/lib/src/embed/liveboard.js.map +1 -1
  72. package/lib/src/embed/liveboard.spec.js +37 -30
  73. package/lib/src/embed/liveboard.spec.js.map +1 -1
  74. package/lib/src/embed/pinboard.spec.js +14 -26
  75. package/lib/src/embed/pinboard.spec.js.map +1 -1
  76. package/lib/src/embed/search-bar.d.ts +7 -1
  77. package/lib/src/embed/search-bar.d.ts.map +1 -1
  78. package/lib/src/embed/search-bar.js +6 -7
  79. package/lib/src/embed/search-bar.js.map +1 -1
  80. package/lib/src/embed/search.d.ts +11 -7
  81. package/lib/src/embed/search.d.ts.map +1 -1
  82. package/lib/src/embed/search.js +19 -15
  83. package/lib/src/embed/search.js.map +1 -1
  84. package/lib/src/embed/search.spec.js +16 -19
  85. package/lib/src/embed/search.spec.js.map +1 -1
  86. package/lib/src/embed/searchEmbed-basic-auth.spec.js +4 -0
  87. package/lib/src/embed/searchEmbed-basic-auth.spec.js.map +1 -1
  88. package/lib/src/embed/ts-embed.d.ts +97 -5
  89. package/lib/src/embed/ts-embed.d.ts.map +1 -1
  90. package/lib/src/embed/ts-embed.js +180 -74
  91. package/lib/src/embed/ts-embed.js.map +1 -1
  92. package/lib/src/embed/ts-embed.spec.js +46 -24
  93. package/lib/src/embed/ts-embed.spec.js.map +1 -1
  94. package/lib/src/errors.d.ts.map +1 -1
  95. package/lib/src/errors.js.map +1 -1
  96. package/lib/src/index.d.ts +3 -3
  97. package/lib/src/index.d.ts.map +1 -1
  98. package/lib/src/index.js +3 -3
  99. package/lib/src/index.js.map +1 -1
  100. package/lib/src/mixpanel-service.d.ts +8 -0
  101. package/lib/src/mixpanel-service.d.ts.map +1 -1
  102. package/lib/src/mixpanel-service.js +13 -1
  103. package/lib/src/mixpanel-service.js.map +1 -1
  104. package/lib/src/mixpanel-service.spec.js.map +1 -1
  105. package/lib/src/react/index.d.ts.map +1 -1
  106. package/lib/src/react/index.js +9 -7
  107. package/lib/src/react/index.js.map +1 -1
  108. package/lib/src/react/index.spec.js +29 -8
  109. package/lib/src/react/index.spec.js.map +1 -1
  110. package/lib/src/react/util.d.ts +4 -0
  111. package/lib/src/react/util.d.ts.map +1 -1
  112. package/lib/src/react/util.js +4 -0
  113. package/lib/src/react/util.js.map +1 -1
  114. package/lib/src/test/test-utils.d.ts +11 -2
  115. package/lib/src/test/test-utils.d.ts.map +1 -1
  116. package/lib/src/test/test-utils.js +36 -25
  117. package/lib/src/test/test-utils.js.map +1 -1
  118. package/lib/src/types.d.ts +430 -98
  119. package/lib/src/types.d.ts.map +1 -1
  120. package/lib/src/types.js +311 -73
  121. package/lib/src/types.js.map +1 -1
  122. package/lib/src/utils/answerService.d.ts +7 -0
  123. package/lib/src/utils/answerService.d.ts.map +1 -1
  124. package/lib/src/utils/answerService.js +7 -0
  125. package/lib/src/utils/answerService.js.map +1 -1
  126. package/lib/src/utils/answerService.spec.js.map +1 -1
  127. package/lib/src/utils/authService.d.ts +30 -0
  128. package/lib/src/utils/authService.d.ts.map +1 -1
  129. package/lib/src/utils/authService.js +39 -2
  130. package/lib/src/utils/authService.js.map +1 -1
  131. package/lib/src/utils/authService.spec.js.map +1 -1
  132. package/lib/src/utils/processData.d.ts +12 -0
  133. package/lib/src/utils/processData.d.ts.map +1 -1
  134. package/lib/src/utils/processData.js +33 -5
  135. package/lib/src/utils/processData.js.map +1 -1
  136. package/lib/src/utils/processData.spec.js.map +1 -1
  137. package/lib/src/utils/processTrigger.d.ts +7 -0
  138. package/lib/src/utils/processTrigger.d.ts.map +1 -1
  139. package/lib/src/utils/processTrigger.js +17 -3
  140. package/lib/src/utils/processTrigger.js.map +1 -1
  141. package/lib/src/utils/processTrigger.spec.js.map +1 -1
  142. package/lib/src/utils.d.ts +12 -0
  143. package/lib/src/utils.d.ts.map +1 -1
  144. package/lib/src/utils.js +24 -19
  145. package/lib/src/utils.js.map +1 -1
  146. package/lib/src/utils.spec.js.map +1 -1
  147. package/lib/src/visual-embed-sdk.d.ts +695 -146
  148. package/package.json +4 -10
  149. package/src/auth.spec.ts +68 -150
  150. package/src/auth.ts +153 -101
  151. package/src/config.spec.ts +2 -4
  152. package/src/config.ts +5 -3
  153. package/src/embed/app.spec.ts +25 -14
  154. package/src/embed/app.ts +49 -37
  155. package/src/embed/base.spec.ts +6 -12
  156. package/src/embed/base.ts +74 -57
  157. package/src/embed/embed.spec.ts +5 -6
  158. package/src/embed/liveboard.spec.ts +56 -37
  159. package/src/embed/liveboard.ts +68 -66
  160. package/src/embed/pinboard.spec.ts +26 -29
  161. package/src/embed/search-bar.tsx +14 -9
  162. package/src/embed/search.spec.ts +31 -21
  163. package/src/embed/search.ts +28 -27
  164. package/src/embed/searchEmbed-basic-auth.spec.ts +22 -28
  165. package/src/embed/ts-embed.spec.ts +99 -144
  166. package/src/embed/ts-embed.ts +214 -159
  167. package/src/errors.ts +3 -6
  168. package/src/index.ts +23 -7
  169. package/src/mixpanel-service.spec.ts +1 -3
  170. package/src/mixpanel-service.ts +13 -1
  171. package/src/react/index.spec.tsx +72 -15
  172. package/src/react/index.tsx +43 -54
  173. package/src/react/util.ts +8 -4
  174. package/src/test/test-utils.ts +43 -39
  175. package/src/types.ts +428 -99
  176. package/src/utils/answerService.spec.ts +3 -5
  177. package/src/utils/answerService.ts +21 -17
  178. package/src/utils/authService.spec.ts +26 -41
  179. package/src/utils/authService.ts +47 -21
  180. package/src/utils/processData.spec.ts +26 -59
  181. package/src/utils/processData.ts +36 -14
  182. package/src/utils/processTrigger.spec.ts +1 -6
  183. package/src/utils/processTrigger.ts +18 -9
  184. package/src/utils.spec.ts +8 -12
  185. package/src/utils.ts +25 -26
package/src/types.ts CHANGED
@@ -10,27 +10,34 @@
10
10
  /**
11
11
  * The authentication mechanism for allowing access to the
12
12
  * the embedded app
13
+ *
14
+ * @group Authentication / Init
13
15
  */
14
16
  // eslint-disable-next-line no-shadow
15
17
  export enum AuthType {
16
18
  /**
17
- * No authentication on the SDK. Passthrough to the embedded App. Alias for `Passthrough`.
19
+ * No authentication on the SDK. Passthrough to the embedded App. Alias for
20
+ * `Passthrough`.
18
21
  */
19
22
  None = 'None',
20
23
  /**
21
- * Passthrough SSO to the embedded App within the iframe. Requires least configuration, but may not
22
- * be supported by all IDPs. This will behave like `None` if SSO is not configured on ThoughtSpot.
24
+ * Passthrough SSO to the embedded App within the iframe. Requires least
25
+ * configuration, but may not be supported by all IDPs. This will behave like `None`
26
+ * if SSO is not configured on ThoughtSpot.
27
+ *
23
28
  * @version: SDK: 1.15.0 | ThouhgtSpot: 8.8.0.cl
24
29
  */
25
30
  EmbeddedSSO = 'EmbeddedSSO',
26
31
  /**
27
32
  * SSO using SAML
33
+ *
28
34
  * @deprecated Use {@link SAMLRedirect} instead
29
35
  * @hidden
30
36
  */
31
37
  SSO = 'SSO_SAML',
32
38
  /**
33
39
  * SSO using SAML
40
+ *
34
41
  * @deprecated Use {@link SAMLRedirect} instead
35
42
  * @hidden
36
43
  */
@@ -38,10 +45,21 @@ export enum AuthType {
38
45
  /**
39
46
  * SSO using SAML
40
47
  * Will make the host application redirect to the SAML Idp.
48
+ *
49
+ * @example
50
+ * ```js
51
+ * init({
52
+ * // ...
53
+ * authType: AuthType.SAMLRedirect,
54
+ * authTriggerText: 'Login with SAML',
55
+ * authTriggerContainer: '#embed-container',
56
+ * });
57
+ * ```
41
58
  */
42
59
  SAMLRedirect = 'SSO_SAML',
43
60
  /**
44
61
  * SSO using OIDC
62
+ *
45
63
  * @hidden
46
64
  * @deprecated Use {@link OIDCRedirect} instead
47
65
  */
@@ -53,21 +71,35 @@ export enum AuthType {
53
71
  OIDCRedirect = 'SSO_OIDC',
54
72
  /**
55
73
  * Trusted authentication server
74
+ *
56
75
  * @hidden
57
76
  * @deprecated Use {@link TrustedAuth} instead
58
77
  */
59
78
  AuthServer = 'AuthServer',
60
79
  /**
61
80
  * Trusted authentication server, Use your own authentication server
62
- * which returns a bearer token, generated using the secret_key obtained from
63
- * ThoughtSpot.
81
+ * which returns a bearer token, generated using the secret_key obtained
82
+ * from ThoughtSpot.
83
+ *
84
+ * @example
85
+ * ```js
86
+ * init({
87
+ * // ...
88
+ * authType: AuthType.TrustedAuthToken,
89
+ * getAuthToken: () => {
90
+ * return fetch('https://my-backend.app/ts-token')
91
+ * .then((response) => response.json())
92
+ * .then((data) => data.token);
93
+ * }
94
+ * ```
64
95
  */
65
96
  TrustedAuthToken = 'AuthServer',
66
97
  /**
67
- * Trusted authentication server Cookieless, Use you own authentication server
68
- * which returns a bearer token, generated using the secret_key obtained from
69
- * ThoughtSpot. This uses a cookieless authentication approach, recommended
70
- * to by pass third-party cookie-blocking restriction implemented by some browsers
98
+ * Trusted authentication server Cookieless, Use you own authentication
99
+ * server which returns a bearer token, generated using the secret_key
100
+ * obtained from ThoughtSpot. This uses a cookieless authentication
101
+ * approach, recommended to by pass third-party cookie-blocking restriction
102
+ * implemented by some browsers
71
103
  */
72
104
  TrustedAuthTokenCookieless = 'AuthServerCookieless',
73
105
  /**
@@ -81,7 +113,10 @@ export enum AuthType {
81
113
 
82
114
  export type DOMSelector = string | HTMLElement;
83
115
 
84
- interface customCssInterface {
116
+ /**
117
+ * inline customCSS within the {@link CustomisationsInterface}.
118
+ */
119
+ export interface customCssInterface {
85
120
  variables?: {
86
121
  [variableName: string]: string;
87
122
  };
@@ -92,10 +127,39 @@ interface customCssInterface {
92
127
  };
93
128
  };
94
129
  }
95
- interface CustomStyles {
130
+ /**
131
+ * Styles within the {@link CustomisationsInterface}.
132
+ */
133
+ export interface CustomStyles {
96
134
  customCSSUrl?: string;
97
135
  customCSS?: customCssInterface;
98
136
  }
137
+
138
+ /**
139
+ * Configuration to define the customization on the Embedded
140
+ * Thoughtspot components.
141
+ *
142
+ * @example
143
+ * ```js
144
+ * init({
145
+ * // ...
146
+ * customizations: {
147
+ * style: {
148
+ * customCSS: {
149
+ * variables: {},
150
+ * rules_UNSTABLE: {}
151
+ * }
152
+ * },
153
+ * content: {
154
+ * strings: {
155
+ * 'LIVEBOARDS': 'Dashboards'
156
+ * }
157
+ * },
158
+ * iconSpriteUrl: 'https://my-custom-icon-sprite.svg'
159
+ * }
160
+ * })
161
+ * ```
162
+ */
99
163
  export interface CustomisationsInterface {
100
164
  style?: CustomStyles;
101
165
  content?: {
@@ -110,6 +174,8 @@ export interface CustomisationsInterface {
110
174
  * It includes the ThoughtSpot hostname or IP address,
111
175
  * the type of authentication, and the authentication endpoint
112
176
  * if a trusted authentication server is used.
177
+ *
178
+ * @group Authentication / Init
113
179
  */
114
180
  export interface EmbedConfig {
115
181
  /**
@@ -141,8 +207,8 @@ export interface EmbedConfig {
141
207
  */
142
208
  getAuthToken?: () => Promise<string>;
143
209
  /**
144
- * [AuthServer / Basic] The user name of the ThoughtSpot user. This attribute is
145
- * required for trusted authentication.
210
+ * [AuthServer / Basic] The user name of the ThoughtSpot user. This
211
+ * attribute is required for trusted authentication.
146
212
  */
147
213
  username?: string;
148
214
 
@@ -155,8 +221,9 @@ export interface EmbedConfig {
155
221
  password?: string;
156
222
 
157
223
  /**
158
- * [SSO] For SSO Authentication, if `noRedirect` is set to true, it will open the SAML auth
159
- * flow in a popup, instead of redirecting browser in place.
224
+ * [SSO] For SSO Authentication, if `noRedirect` is set to true, it will
225
+ * open the SAML auth flow in a popup, instead of redirecting browser in
226
+ * place.
160
227
  *
161
228
  * @default false
162
229
  * @deprecated
@@ -164,8 +231,8 @@ export interface EmbedConfig {
164
231
  noRedirect?: boolean;
165
232
 
166
233
  /**
167
- * [SSO] For SSO Authentication, if `inPopup` is set to true, it will open the SAML auth
168
- * flow in a popup, instead of redirecting browser in place.
234
+ * [SSO] For SSO Authentication, if `inPopup` is set to true, it will open
235
+ * the SAML auth flow in a popup, instead of redirecting browser in place.
169
236
  *
170
237
  * @default false
171
238
  * @version SDK: 1.18.0
@@ -178,6 +245,7 @@ export interface EmbedConfig {
178
245
  * terminated.
179
246
  *
180
247
  * Eg: "/dashboard", "#/foo" [Do not include the host]
248
+ *
181
249
  * @version SDK: 1.10.2 | 8.2.0.cl, 8.4.1-sw
182
250
  */
183
251
  redirectPath?: string;
@@ -189,28 +257,34 @@ export interface EmbedConfig {
189
257
  * Should we encode URL Query Params using base64 encoding which thoughtspot
190
258
  * will generate for embedding. This provides additional security to
191
259
  * thoughtspot clusters against Cross site scripting attacks.
260
+ *
192
261
  * @default false
193
262
  */
194
263
  shouldEncodeUrlQueryParams?: boolean;
195
264
 
196
265
  /**
197
- * Suppress cookie access alert when third party cookies are blocked by the user's browser.
198
- * Third party cookie blocking is the default behaviour on Safari and opt-in for Firefox/Chrome.
199
- * If you set this to `true`, you are encouraged to handle `noCookieAccess` event, to show your own treatment
266
+ * Suppress cookie access alert when third party cookies are blocked by the
267
+ * user's browser. Third party cookie blocking is the default behaviour on
268
+ * Safari and opt-in for Firefox/Chrome. If you set this to `true`, you are
269
+ * encouraged to handle `noCookieAccess` event, to show your own treatment
200
270
  * in this case.
271
+ *
201
272
  * @default false
202
273
  */
203
274
  suppressNoCookieAccessAlert?: boolean;
204
275
 
205
276
  /**
206
277
  * Re-login when session expires with the previous login options
278
+ *
207
279
  * @default false
208
280
  */
209
281
  autoLogin?: boolean;
210
282
 
211
283
  /**
212
284
  * Disable redirection to the login page when the embedded session expires
213
- * This flag is typically used alongside the combination of auth modes such as {@link AuthType.AuthServer} and auto login behavior {@link EmbedConfig.autoLogin}
285
+ * This flag is typically used alongside the combination of auth modes such as {@link
286
+ * AuthType.AuthServer} and auto login behavior {@link EmbedConfig.autoLogin}
287
+ *
214
288
  * @version SDK: 1.9.3 | ThoughtSpot: 8.1.0.cl, 8.4.1-sw
215
289
  * @default false
216
290
  */
@@ -218,20 +292,23 @@ export interface EmbedConfig {
218
292
 
219
293
  /**
220
294
  * This message is displayed on the embed view when the login fails.
295
+ *
221
296
  * @version SDK: 1.10.1 | ThoughtSpot: 8.2.0.cl, 8.4.1-sw
222
297
  */
223
298
  loginFailedMessage?: string;
224
299
 
225
300
  /**
226
301
  * Calls the prefetch method internally when set to true
302
+ *
227
303
  * @default false
228
304
  */
229
305
  callPrefetch?: boolean;
230
306
 
231
307
  /**
232
308
  * When there are multiple embeds, queue the render of embed to start
233
- * after the previous embed's render is complete. This helps in the load performance
234
- * by decreasing the load on the browser.
309
+ * after the previous embed's render is complete. This helps in the load
310
+ * performance by decreasing the load on the browser.
311
+ *
235
312
  * @Version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
236
313
  * @default false
237
314
  */
@@ -240,15 +317,19 @@ export interface EmbedConfig {
240
317
  /**
241
318
  * Dynamic CSS Url to be injected in the loaded application.
242
319
  * You would also need to set `style-src` in the CSP settings.
320
+ *
243
321
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1-sw
244
322
  * @default ''
245
323
  */
246
324
  customCssUrl?: string;
247
325
  /**
248
- * [AuthServer|Basic] Detect if 3rd party cookies are enabled by doing an additional call. This is slower
249
- * and should be avoided. Listen to the NO_COOKIE_ACCESS event to handle the situation.
326
+ * [AuthServer|Basic] Detect if 3rd party cookies are enabled by doing an
327
+ * additional call. This is slower and should be avoided. Listen to the
328
+ * NO_COOKIE_ACCESS event to handle the situation.
329
+ *
330
+ * This is slightly slower than letting the browser handle the cookie check, as it
331
+ * involves an extra network call.
250
332
  *
251
- * This is slightly slower than letting the browser handle the cookie check, as it involves an extra network call.
252
333
  * @version SDK: 1.10.4 | ThoughtSpot: 8.2.0.cl, 8.4.1-sw
253
334
  */
254
335
  detectCookieAccessSlow?: boolean;
@@ -258,7 +339,6 @@ export interface EmbedConfig {
258
339
  * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1-sw*
259
340
  */
260
341
  suppressSearchEmbedBetaWarning?: boolean;
261
-
262
342
  /**
263
343
  * Custom style params for embed Config.
264
344
  *
@@ -276,16 +356,19 @@ export interface EmbedConfig {
276
356
  /**
277
357
  * Text to show in the button which triggers the popup auth flow.
278
358
  * Default: "Authorize".
359
+ *
279
360
  * @version SDK: 1.17.0 | ThoughtSpot: *
280
361
  */
281
362
  authTriggerText?: string;
282
363
  }
283
364
 
284
365
  // eslint-disable-next-line @typescript-eslint/no-empty-interface
285
- export interface LayoutConfig {}
366
+ export interface LayoutConfig { }
286
367
 
287
368
  /**
288
369
  * Embedded iFrame configuration
370
+ *
371
+ * @group Embed components
289
372
  */
290
373
  export interface FrameParams {
291
374
  /**
@@ -296,6 +379,12 @@ export interface FrameParams {
296
379
  * The height of the iFrame (unit is pixels if numeric).
297
380
  */
298
381
  height?: number | string;
382
+ /**
383
+ * Set to 'lazy' to enable lazy loading of the embedded TS frame.
384
+ * This will defer loading of the frame until it comes into the
385
+ * viewport. This is useful for performance optimization.
386
+ */
387
+ loading?: 'lazy' | 'eager' | 'auto';
299
388
  /**
300
389
  * This parameters will be passed on the iframe
301
390
  * as is.
@@ -312,7 +401,8 @@ export interface ViewConfig {
312
401
  */
313
402
  layoutConfig?: LayoutConfig;
314
403
  /**
315
- * The <b>width</b> and <b>height</b> dimensions to render an embedded object inside your app. Specify the values in pixels or percentage.
404
+ * The <b>width</b> and <b>height</b> dimensions to render an embedded
405
+ * object inside your app. Specify the values in pixels or percentage.
316
406
  */
317
407
  frameParams?: FrameParams;
318
408
  /**
@@ -341,11 +431,13 @@ export interface ViewConfig {
341
431
  /**
342
432
  * The list of actions to display from the primary menu, more menu
343
433
  * (...), and the contextual menu.
434
+ *
344
435
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1-sw
345
436
  */
346
437
  visibleActions?: Action[];
347
438
  /**
348
439
  * Show alert messages and toast messages in the embedded view.
440
+ *
349
441
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
350
442
  */
351
443
  showAlerts?: boolean;
@@ -356,6 +448,7 @@ export interface ViewConfig {
356
448
  runtimeFilters?: RuntimeFilter[];
357
449
  /**
358
450
  * The locale/language to use for the embedded view.
451
+ *
359
452
  * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1-sw
360
453
  */
361
454
  locale?: string;
@@ -366,40 +459,55 @@ export interface ViewConfig {
366
459
  * Warning: This option is for advanced use only and is used internally
367
460
  * to control embed behavior in non-regular ways. We do not publish the
368
461
  * list of supported keys and values associated with each.
462
+ *
369
463
  * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1-sw
370
464
  */
371
465
  additionalFlags?: { [key: string]: string | number | boolean };
372
466
  /**
373
467
  * Dynamic CSSUrl and customCSS to be injected in the loaded application.
374
468
  * You would also need to set `style-src` in the CSP settings.
469
+ *
375
470
  * @version SDK: 1.17.2 | ThoughtSpot: 8.4.1-sw, 8.4.0.cl
376
471
  * @default ''
377
472
  */
378
473
  customizations?: CustomisationsInterface;
379
474
  /**
380
- * Insert as a sibling of the target container, instead of appending to a child inside it.
475
+ * Insert as a sibling of the target container, instead of appending to a
476
+ * child inside it.
381
477
  */
382
478
  insertAsSibling?: boolean;
383
479
  /**
384
480
  * flag to set ContextMenu Trigger to either left or right click.
481
+ *
385
482
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
386
483
  */
387
484
  contextMenuTrigger?: ContextMenuTriggerOptions;
388
485
  /**
389
486
  * flag to override openNew tab context menu link
487
+ *
390
488
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
391
489
  */
392
490
  linkOverride?: boolean;
393
491
  /**
394
492
  * flag to enable insert into slides action
493
+ *
395
494
  * @hidden
396
495
  * @private
397
496
  */
398
497
  insertInToSlide?: boolean;
498
+ /**
499
+ * Use a pre-rendered iframe from a pool of pre-rendered iframes
500
+ * if available and matches the configuration.
501
+ *
502
+ * See [docs]() on how to create a prerender pool.
503
+ */
504
+ usePrerenderedIfAvailable?: boolean;
399
505
  }
400
506
 
401
507
  /**
402
508
  * MessagePayload: Embed event payload: message type, data and status (start/end)
509
+ *
510
+ * @group Events
403
511
  */
404
512
  export type MessagePayload = {
405
513
  /* type: message type eg: 'save' */
@@ -410,26 +518,40 @@ export type MessagePayload = {
410
518
  status?: string;
411
519
  };
412
520
  /**
413
- * MessageOptions: By Providing options, getting specific event start / end based on option
521
+ * MessageOptions: By Providing options, getting specific event start / end based on
522
+ * option
523
+ *
524
+ * @group Events
414
525
  */
415
526
  export type MessageOptions = {
416
- /* A boolean value indicating that start status events of this type will be dispatched */
527
+ /**
528
+ * A boolean value indicating that start status events of this type
529
+ * will be dispatched
530
+ */
417
531
  start?: boolean;
418
532
  };
419
533
  /**
420
534
  * MessageCallback: Embed event message callback
535
+ *
536
+ * @group Events
421
537
  */
422
538
  export type MessageCallback = (
423
539
  /* payload: Message payload contain type, data and status */
424
540
  payload: MessagePayload,
425
- /* responder: Message callback function triggered when embed event initiated */
541
+ /**
542
+ * responder: Message callback function triggered when embed event
543
+ * initiated
544
+ */
426
545
  responder?: (data: any) => void,
427
546
  ) => void;
428
547
  /**
429
548
  * MessageCallbackObj: contains message options & callback function
430
549
  */
431
550
  export type MessageCallbackObj = {
432
- /* options: It contains start, A boolean value indicating that start status events of this type will be dispatched */
551
+ /**
552
+ * options: It contains start, A boolean value indicating that start
553
+ * status events of this type will be dispatched
554
+ */
433
555
  /* callback: Embed event message callback */
434
556
  options: MessageOptions;
435
557
  callback: MessageCallback;
@@ -519,38 +641,49 @@ export interface RuntimeFilter {
519
641
  operator: RuntimeFilterOp;
520
642
  /**
521
643
  * The list of operands. Some operators like EQ, LE accept
522
- * a single operand, whereas other operators like BW and IN accept multiple operands.
644
+ * a single operand, whereas other operators like BW and IN accept multiple
645
+ * operands.
523
646
  */
524
647
  values: (number | boolean | string)[];
525
648
  }
526
649
 
527
650
  /**
528
651
  * Event types emitted by the embedded ThoughtSpot application.
652
+ *
653
+ * To add an event listener use the corresponding
654
+ * {@link LiveboardEmbed.on} or {@link AppEmbed.on} or {@link SearchEmbed.on} method.
655
+ *
656
+ * @group Events
529
657
  */
530
658
  // eslint-disable-next-line no-shadow
531
659
  export enum EmbedEvent {
532
660
  /**
533
661
  * Rendering has initialized.
534
- * @return timestamp - The timestamp when the event was generated.
662
+ *
663
+ * @returns timestamp - The timestamp when the event was generated.
535
664
  */
536
665
  Init = 'init',
537
666
  /**
538
667
  * Authentication has either succeeded or failed.
539
- * @return isLoggedIn - A Boolean specifying whether authentication was successful.
668
+ *
669
+ * @returns isLoggedIn - A Boolean specifying whether authentication was successful.
540
670
  */
541
671
  AuthInit = 'authInit',
542
672
  /**
543
673
  * The embed object container has loaded.
544
- * @return timestamp - The timestamp when the event was generated.
674
+ *
675
+ * @returns timestamp - The timestamp when the event was generated.
545
676
  */
546
677
  Load = 'load',
547
678
  /**
548
679
  * Data pertaining to answer or Liveboard is received
549
- * @return data - The answer or Liveboard data
680
+ *
681
+ * @returns data - The answer or Liveboard data
550
682
  */
551
683
  Data = 'data',
552
684
  /**
553
685
  * Search/answer/Liveboard filters have been applied/updated
686
+ *
554
687
  * @hidden
555
688
  */
556
689
  FiltersChanged = 'filtersChanged',
@@ -560,48 +693,56 @@ export enum EmbedEvent {
560
693
  QueryChanged = 'queryChanged',
561
694
  /**
562
695
  * A drill down operation has been performed.
563
- * @return additionalFilters - Any additional filters applied
564
- * @return drillDownColumns - The columns on which drill down was performed
565
- * @return nonFilteredColumns - The columns that were not filtered
696
+ *
697
+ * @returns additionalFilters - Any additional filters applied
698
+ * @returns drillDownColumns - The columns on which drill down was performed
699
+ * @returns nonFilteredColumns - The columns that were not filtered
566
700
  */
567
701
  Drilldown = 'drillDown',
568
702
  /**
569
703
  * One or more data sources have been selected.
570
- * @return dataSourceIds - the list of data sources
704
+ *
705
+ * @returns dataSourceIds - the list of data sources
571
706
  */
572
707
  DataSourceSelected = 'dataSourceSelected',
573
708
  /**
574
709
  * One or more data columns have been selected.
575
- * @return columnIds - the list of columns
710
+ *
711
+ * @returns columnIds - the list of columns
576
712
  * @version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1-sw
577
713
  */
578
714
  AddRemoveColumns = 'addRemoveColumns',
579
715
  /**
580
716
  * A custom action has been triggered
581
- * @return actionId - The id of the custom action
582
- * @return data - The answer or Liveboard data
717
+ *
718
+ * @returns actionId - The id of the custom action
719
+ * @returns data - The answer or Liveboard data
583
720
  */
584
721
  CustomAction = 'customAction',
585
722
  /**
586
723
  * A double click has been triggered on table/chart
587
- * @return ContextMenuInputPoints - data point that is double clicked
724
+ *
725
+ * @returns ContextMenuInputPoints - data point that is double clicked
588
726
  * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
589
727
  */
590
728
  VizPointDoubleClick = 'vizPointDoubleClick',
591
729
  /**
592
730
  * A click has been triggered on table/chart
593
- * @return ContextMenuInputPoints - data point that is clicked
731
+ *
732
+ * @returns ContextMenuInputPoints - data point that is clicked
594
733
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
595
734
  */
596
735
  VizPointClick = 'vizPointClick',
597
736
  /**
598
737
  * An error has occurred.
599
- * @return error - An error object or message
738
+ *
739
+ * @returns error - An error object or message
600
740
  */
601
741
  Error = 'Error',
602
742
  /**
603
743
  * The embedded object has sent an alert
604
- * @return alert - An alert object
744
+ *
745
+ * @returns alert - An alert object
605
746
  */
606
747
  Alert = 'alert',
607
748
  /**
@@ -610,29 +751,34 @@ export enum EmbedEvent {
610
751
  AuthExpire = 'ThoughtspotAuthExpired',
611
752
  /**
612
753
  * ThoughtSpot failed to validate the auth session.
754
+ *
613
755
  * @hidden
614
756
  */
615
757
  AuthFailure = 'ThoughtspotAuthFailure',
616
758
  /**
617
759
  * ThoughtSpot failed to validate the auth session.
760
+ *
618
761
  * @hidden
619
762
  */
620
763
  AuthLogout = 'ThoughtspotAuthLogout',
621
764
  /**
622
765
  * The height of the embedded Liveboard or visualization has been computed.
623
- * @return data - The height of the embedded Liveboard or visualization
766
+ *
767
+ * @returns data - The height of the embedded Liveboard or visualization
624
768
  * @hidden
625
769
  */
626
770
  EmbedHeight = 'EMBED_HEIGHT',
627
771
  /**
628
772
  * The center of visible iframe viewport is calculated.
629
- * @return data - The center of the visible Iframe viewport.
773
+ *
774
+ * @returns data - The center of the visible Iframe viewport.
630
775
  * @hidden
631
776
  */
632
777
  EmbedIframeCenter = 'EmbedIframeCenter',
633
778
  /**
634
779
  * Emitted when the "Get Data" button in Search Bar embed
635
780
  * is clicked.
781
+ *
636
782
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.0-sw
637
783
  */
638
784
  GetDataClick = 'getDataClick',
@@ -642,6 +788,7 @@ export enum EmbedEvent {
642
788
  RouteChange = 'ROUTE_CHANGE',
643
789
  /**
644
790
  * The v1 event type for Data
791
+ *
645
792
  * @hidden
646
793
  */
647
794
  V1Data = 'exportVizDataToParent',
@@ -654,17 +801,20 @@ export enum EmbedEvent {
654
801
  NoCookieAccess = 'noCookieAccess',
655
802
  /**
656
803
  * Emitted when SAML is complete
804
+ *
657
805
  * @private
658
806
  * @hidden
659
807
  */
660
808
  SAMLComplete = 'samlComplete',
661
809
  /**
662
810
  * Emitted when any modal is opened in the app
811
+ *
663
812
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1-sw
664
813
  */
665
814
  DialogOpen = 'dialog-open',
666
815
  /**
667
816
  * Emitted when any modal is closed in the app
817
+ *
668
818
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1-sw
669
819
  */
670
820
  DialogClose = 'dialog-close',
@@ -672,180 +822,223 @@ export enum EmbedEvent {
672
822
  * Emitted when the Liveboard shell loads.
673
823
  * You can use this event as a hook to trigger
674
824
  * other events on the rendered Liveboard.
825
+ *
675
826
  * @version SDK: 1.9.1 | ThoughtSpot: 8.1.0.cl, 8.4.1-sw
676
827
  */
677
828
  LiveboardRendered = 'PinboardRendered',
678
829
  /**
679
830
  * This can be used to register an event listener which
680
831
  * is triggered on all events.
832
+ *
681
833
  * @Version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1-sw
682
834
  */
683
835
  ALL = '*',
684
836
  /**
685
837
  * Emitted when answer is saved in the app
838
+ *
686
839
  * @Version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
687
840
  */
688
841
  Save = 'save',
689
842
  /**
690
843
  * Emitted when the download action is triggered on an answer
844
+ *
691
845
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
692
846
  */
693
847
  Download = 'download',
694
848
  /**
695
849
  * Emitted when the Download as PDF action is triggered on an answer
850
+ *
696
851
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
697
852
  */
698
853
  DownloadAsPdf = 'downloadAsPdf',
699
854
  /**
700
855
  * Emitted when the Download as CSV action is triggered on an answer
856
+ *
701
857
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
702
858
  */
703
859
  DownloadAsCsv = 'downloadAsCsv',
704
860
  /**
705
861
  * Emitted when the Download as XLSX action is triggered on an answer
862
+ *
706
863
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
707
864
  */
708
865
  DownloadAsXlsx = 'downloadAsXlsx',
709
866
  /**
710
867
  * Emitted when an answer is deleted in the app
868
+ *
711
869
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
712
870
  */
713
871
  AnswerDelete = 'answerDelete',
714
872
  /**
715
873
  * Emitted when an answer is pinned to a Liveboard
874
+ *
716
875
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
717
876
  */
718
877
  Pin = 'pin',
719
878
  /**
720
879
  * Emitted when SpotIQ analysis is triggered
880
+ *
721
881
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
722
882
  */
723
883
  SpotIQAnalyze = 'spotIQAnalyze',
724
884
  /**
725
885
  * Emitted when a user shares an object with another user or group
886
+ *
726
887
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
727
888
  */
728
889
  Share = 'share',
729
890
  /**
730
- * Emitted when a user clicks the Include action to include a specific value or data on a chart or table
891
+ * Emitted when a user clicks the Include action to include a specific value or data
892
+ * on a chart or table
893
+ *
731
894
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
732
895
  */
733
896
  DrillInclude = 'context-menu-item-include',
734
897
  /**
735
- * Emitted when a user clicks the Exclude action to exclude a specific value or data on a chart or table
898
+ * Emitted when a user clicks the Exclude action to exclude a specific value or data
899
+ * on a chart or table
900
+ *
736
901
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
737
902
  */
738
903
  DrillExclude = 'context-menu-item-exclude',
739
904
  /**
740
905
  * Emitted when copied column value on the app
906
+ *
741
907
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
742
908
  */
743
909
  CopyToClipboard = 'context-menu-item-copy-to-clipboard',
744
910
  /**
745
911
  * Emitted when a user clicks the Update TML action
912
+ *
746
913
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
747
914
  */
748
915
  UpdateTML = 'updateTSL',
749
916
  /**
750
917
  * Emitted when a user clicks the Edit TML action
918
+ *
751
919
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
752
920
  */
753
921
  EditTML = 'editTSL',
754
922
  /**
755
923
  * Emitted when ExportTML trigger in answer on the app
924
+ *
756
925
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
757
926
  */
758
927
  ExportTML = 'exportTSL',
759
928
  /**
760
929
  * Emitted when an answer is saved as a view
930
+ *
761
931
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
762
932
  */
763
933
  SaveAsView = 'saveAsView',
764
934
  /**
765
935
  * Emitted when copy of existing answer on the app
936
+ *
766
937
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
767
938
  */
768
939
  CopyAEdit = 'copyAEdit',
769
940
  /**
770
941
  * Emitted when a user clicks Show underlying data on an answe
942
+ *
771
943
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
772
944
  */
773
945
  ShowUnderlyingData = 'showUnderlyingData',
774
946
  /**
775
947
  * Emitted when an answer is switched to a chart or table view
948
+ *
776
949
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
777
950
  */
778
951
  AnswerChartSwitcher = 'answerChartSwitcher',
779
952
  /**
780
953
  * Internal event to communicate the initial settings back to the TS APP
954
+ *
781
955
  * @hidden
782
956
  */
783
957
  APP_INIT = 'appInit',
784
958
  /**
785
959
  * Emitted when a user clicks Show Liveboard details on a Liveboard
960
+ *
786
961
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
787
962
  */
788
963
  LiveboardInfo = 'pinboardInfo',
789
964
  /**
790
965
  * Emitted when a user clicks on the Favorite icon on a Liveboard
966
+ *
791
967
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
792
968
  */
793
969
  AddToFavorites = 'addToFavorites',
794
970
  /**
795
971
  * Emitted when a user clicks Schedule on a Liveboard
972
+ *
796
973
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
797
974
  */
798
975
  Schedule = 'subscription',
799
976
  /**
800
977
  * Emitted when a user clicks Edit on a Liveboard or visualization
978
+ *
801
979
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
802
980
  */
803
981
  Edit = 'edit',
804
982
  /**
805
983
  * Emitted when a user clicks Make a copy on a Liveboard
984
+ *
806
985
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
807
986
  */
808
987
  MakeACopy = 'makeACopy',
809
988
  /**
810
989
  * Emitted when a user clicks Present on a Liveboard or visualization
990
+ *
811
991
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
812
992
  */
813
993
  Present = 'present',
814
994
  /**
815
995
  * Emitted when a user clicks Delete on a Liveboard
996
+ *
816
997
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
817
998
  */
818
999
  Delete = 'delete',
819
1000
  /**
820
1001
  * Emitted when a user clicks Manage schedules on a Liveboard
1002
+ *
821
1003
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
822
1004
  */
823
1005
  SchedulesList = 'schedule-list',
824
1006
  /**
825
1007
  * Emitted when a user clicks Cancel in edit mode on a Liveboard
1008
+ *
826
1009
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
827
1010
  */
828
1011
  Cancel = 'cancel',
829
1012
  /**
830
1013
  * Emitted when a user clicks Explore on a visualization
1014
+ *
831
1015
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
832
1016
  */
833
1017
  Explore = 'explore',
834
1018
  /**
835
1019
  * Emitted when a user clicks Copy link action on a visualization
1020
+ *
836
1021
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
837
1022
  */
838
1023
  CopyLink = 'embedDocument',
839
1024
  /**
840
1025
  * Emitted when a user interacts with cross filters on a visualization or liveboard
1026
+ *
841
1027
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
842
1028
  */
843
1029
  CrossFilterChanged = 'cross-filter-changed',
844
1030
  /**
845
1031
  * Emitted when a user right clicks on chart or table
1032
+ *
846
1033
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
847
1034
  */
848
1035
  VizPointRightClick = 'vizPointRightClick',
1036
+ /**
1037
+ * Emitted when a user clicks on Insert to slide on a visualization
1038
+ *
1039
+ * @hidden
1040
+ */
1041
+ InsertIntoSlide = 'insertInToSlide',
849
1042
  }
850
1043
 
851
1044
  /**
@@ -853,235 +1046,347 @@ export enum EmbedEvent {
853
1046
  * to the embedded ThoughtSpot app
854
1047
  *
855
1048
  * To trigger an event use the corresponding
856
- * {@link LiveboardEmbed.trigger} or {@link AppEmbed.trigger} or {@link SearchEmbed.trigger} method.
1049
+ * {@link LiveboardEmbed.trigger} or {@link AppEmbed.trigger} or {@link
1050
+ * SearchEmbed.trigger} method.
1051
+ *
1052
+ * @group Events
857
1053
  */
858
1054
  // eslint-disable-next-line no-shadow
859
1055
  export enum HostEvent {
860
1056
  /**
861
1057
  * Trigger a search
1058
+ *
862
1059
  * @param - dataSourceIds - The data source GUID to Search on
863
1060
  * - Although an array, only a single source
864
1061
  * is supported at this time.
865
1062
  * @param - searchQuery - The search query
866
1063
  * @param - execute - execute the existing / updated query
867
1064
  * @example
1065
+ * ```js
868
1066
  * searchEmbed.trigger(HostEvent.Search, {
869
- * searchQuery: "[sales] by [item type],
870
- * "dataSourceIds: ["cd252e5c-b552-49a8-821d-3eadaa049cca"]
871
- * "execute": true
1067
+ * searchQuery: "[sales] by [item type],
1068
+ * dataSourceIds: ["cd252e5c-b552-49a8-821d-3eadaa049cca"]
1069
+ * execute: true
872
1070
  * })
1071
+ * ```
873
1072
  */
874
1073
  Search = 'search',
875
1074
  /**
876
1075
  * Trigger a drill on certain points by certain column
1076
+ *
877
1077
  * @param - points - an object containing selectedPoints/clickedPoints
878
1078
  * eg. { selectedPoints: []}
879
1079
  * @param - columnGuid - a string guid of the column to drill by. This is optional,
880
- * if not provided it will auto drill by the configured column.
881
- * @example searchEmbed.trigger(HostEvent.DrillDown, {
882
- * points: clickedPointData,
883
- * autoDrillDown: true,
1080
+ * if not provided it will auto drill by the configured
1081
+ * column.
1082
+ * @example
1083
+ * ```js
1084
+ * searchEmbed.trigger(HostEvent.DrillDown, {
1085
+ * points: clickedPointData,
1086
+ * autoDrillDown: true,
884
1087
  * })
1088
+ * ```
885
1089
  * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
886
1090
  */
887
1091
  DrillDown = 'triggerDrillDown',
888
1092
  /**
889
1093
  * Apply filters
1094
+ *
890
1095
  * @hidden
891
1096
  */
892
1097
  Filter = 'filter',
893
1098
  /**
894
1099
  * Reload the answer or visualization
1100
+ *
895
1101
  * @hidden
896
1102
  */
897
1103
  Reload = 'reload',
898
1104
  /**
899
1105
  * Set the visible visualizations on a Liveboard.
1106
+ *
900
1107
  * @param - an array of ids of visualizations to show, the ids not passed
901
1108
  * will be hidden.
902
1109
  * @example
903
- * liveboardEmbed.trigger(HostEvent.SetVisibleVizs, ['730496d6-6903-4601-937e-2c691821af3c', 'd547ec54-2a37-4516-a222-2b06719af726'])
1110
+ * liveboardEmbed.trigger(HostEvent.SetVisibleVizs, [
1111
+ * '730496d6-6903-4601-937e-2c691821af3c',
1112
+ * 'd547ec54-2a37-4516-a222-2b06719af726'])
904
1113
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1-sw
905
1114
  */
906
1115
  SetVisibleVizs = 'SetPinboardVisibleVizs',
907
1116
  /**
908
1117
  * Update the runtime filters. The runtime filters passed here are extended
909
1118
  * on to the existing runtime filters if they exist.
1119
+ *
910
1120
  * @param - {@link RuntimeFilter}[] an array of {@link RuntimeFilter} Types.
911
1121
  * @example
912
1122
  * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
913
1123
  * {columnName: "state",operator: RuntimeFilterOp.EQ,values: ["michigan"]},
914
- * {columnName: "item type",operator: RuntimeFilterOp.EQ,values: ["Jackets"]}
915
- * ])
1124
+ * {columnName: "item type",operator: RuntimeFilterOp.EQ,values:
1125
+ * ["Jackets"]} ])
916
1126
  * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1-sw
917
1127
  */
918
1128
  UpdateRuntimeFilters = 'UpdateRuntimeFilters',
919
1129
  /**
920
1130
  * Navigate to a specific page in App embed without any reload.
921
1131
  * This is the same as calling `appEmbed.navigateToPage(path, true)`
1132
+ *
922
1133
  * @param - path - the path to navigate to (can be a number[1/-1] to go forward/back)
923
- * @example appEmbed.navigateToPage(-1)
1134
+ * @example
1135
+ * ```js
1136
+ * appEmbed.navigateToPage(-1)
1137
+ * ```
924
1138
  * @version SDK: 1.12.0 | ThoughtSpot 8.4.0.cl, 8.4.1-sw
925
1139
  */
926
1140
  Navigate = 'Navigate',
927
1141
  /**
928
1142
  * Opens the filter panel for a particular column.
929
1143
  * Works with Search embed.
930
- * @param - { columnId: string, name: string, type: INT64/CHAR/DATE, dataType: ATTRIBUTE/MEASURE }
931
- * @example searchEmbed.trigger(HostEvent.OpenFilter, { columnId: '123', name: 'column name', type: 'INT64', dataType: 'ATTRIBUTE' })
1144
+ *
1145
+ * @param - { columnId: string,
1146
+ * name: string,
1147
+ * type: INT64/CHAR/DATE,
1148
+ * dataType: ATTRIBUTE/MEASURE }
1149
+ * @example
1150
+ * ```js
1151
+ * searchEmbed.trigger(HostEvent.OpenFilter,
1152
+ * { columnId: '123', name: 'column name', type: 'INT64', dataType: 'ATTRIBUTE' })
1153
+ * ```
932
1154
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
933
1155
  */
934
1156
  OpenFilter = 'openFilter',
935
1157
  /**
936
1158
  * Adds the columns to the current Search.
1159
+ *
937
1160
  * @param - { columnIds: string[] }
938
- * @example searchEmbed.trigger(HostEvent.AddColumns, { columnIds: ['123', '456'] })
1161
+ * @example
1162
+ * ```js
1163
+ * searchEmbed.trigger(HostEvent.AddColumns, { columnIds: ['123', '456'] })
1164
+ * ```
939
1165
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
940
1166
  */
941
1167
  AddColumns = 'addColumns',
942
1168
  /**
943
1169
  * Removes a column from the current Search.
1170
+ *
944
1171
  * @param - { columnId: string }
945
- * @example - searchEmbed.trigger(HostEvent.RemoveColumn, { columnId: '123' })
1172
+ * @example
1173
+ * ```js
1174
+ * searchEmbed.trigger(HostEvent.RemoveColumn, { columnId: '123' })
1175
+ * ```
946
1176
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
947
1177
  */
948
1178
  RemoveColumn = 'removeColumn',
949
1179
  /**
950
1180
  * Gets the current pinboard content.
951
- * @example liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard)
1181
+ *
1182
+ * @example
1183
+ * ```js
1184
+ * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard)
1185
+ * ```
952
1186
  * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1-sw
953
1187
  */
954
1188
  getExportRequestForCurrentPinboard = 'getExportRequestForCurrentPinboard',
955
1189
  /**
956
1190
  * Triggers the Pin action on an embedded object
1191
+ *
957
1192
  * @param - incase of Liveboard embed, takes in an object with vizId as a key
958
1193
  * can be left empty for search and visualization embeds
959
1194
  * @example
1195
+ * ```js
960
1196
  * liveboardEmbed.trigger(HostEvent.Pin, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
961
1197
  * vizEmbed.trigger(HostEvent.Pin)
962
1198
  * searchEmbed.trigger(HostEvent.Pin)
1199
+ * ```
963
1200
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
964
1201
  */
965
1202
  Pin = 'pin',
966
1203
  /**
967
1204
  * Triggers the Show Liveboard details action on a Liveboard
968
- * @example liveboardEmbed.trigger(HostEvent.LiveboardInfo)
1205
+ *
1206
+ * @example
1207
+ * ```js
1208
+ * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
1209
+ * ```
969
1210
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
970
1211
  */
971
1212
  LiveboardInfo = 'pinboardInfo',
972
1213
  /**
973
1214
  * Triggers the Schedule action on a Liveboard
974
- * @example liveboardEmbed.trigger(HostEvent.Schedule)
1215
+ *
1216
+ * @example
1217
+ * ```js
1218
+ * liveboardEmbed.trigger(HostEvent.Schedule)
1219
+ * ```
975
1220
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
976
1221
  */
977
1222
  Schedule = 'subscription',
978
1223
  /**
979
1224
  * Triggers the Manage schedule action on a Liveboard
980
- * @example liveboardEmbed.trigger(HostEvent.ScheduleList)
1225
+ *
1226
+ * @example
1227
+ * ```js
1228
+ * liveboardEmbed.trigger(HostEvent.ScheduleList)
1229
+ * ```
981
1230
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
982
1231
  */
983
1232
  SchedulesList = 'schedule-list',
984
1233
  /**
985
1234
  * Triggers the Export TML action on a Liveboard
986
- * @example liveboardEmbed.trigger(HostEvent.ExportTML)
1235
+ *
1236
+ * @example
1237
+ * ```js
1238
+ * liveboardEmbed.trigger(HostEvent.ExportTML)
1239
+ * ```
987
1240
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
988
1241
  */
989
1242
  ExportTML = 'exportTSL',
990
1243
  /**
991
1244
  * Triggers the Edit TML action on a Liveboard
992
- * @example liveboardEmbed.trigger(HostEvent.EditTML)
1245
+ *
1246
+ * @example
1247
+ * ```js
1248
+ * liveboardEmbed.trigger(HostEvent.EditTML)
1249
+ * ```
993
1250
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
994
1251
  */
995
1252
  EditTML = 'editTSL',
996
1253
  /**
997
1254
  * Triggers the Update TML action on a Liveboard
998
- * @example liveboardEmbed.trigger(HostEvent.UpdateTML)
1255
+ *
1256
+ * @example
1257
+ * ```js
1258
+ * liveboardEmbed.trigger(HostEvent.UpdateTML)
1259
+ * ```
999
1260
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1000
1261
  */
1001
1262
  UpdateTML = 'updateTSL',
1002
1263
  /**
1003
1264
  * Triggers the Download PDF action on a Liveboard
1004
- * @example liveboardEmbed.trigger(HostEvent.DownloadAsPDF)
1265
+ *
1266
+ * @example
1267
+ * ```js
1268
+ * liveboardEmbed.trigger(HostEvent.DownloadAsPDF)
1269
+ * ```
1005
1270
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1006
1271
  */
1007
1272
  DownloadAsPdf = 'downloadAsPdf',
1008
1273
  /**
1009
1274
  * Triggers the Make a copy action on a Liveboard, search or visualization
1275
+ *
1010
1276
  * @example
1277
+ * ```js
1011
1278
  * liveboardEmbed.trigger(HostEvent.MakeACopy, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1012
1279
  * vizEmbed.trigger(HostEvent.MakeACopy)
1013
1280
  * searchEmbed.trigger(HostEvent.MakeACopy)
1281
+ * ```
1014
1282
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1015
1283
  */
1016
1284
  MakeACopy = 'makeACopy',
1017
1285
  /**
1018
1286
  * Triggers the Delete action on a Liveboard
1019
- * @example appEmbed.trigger(HostEvent.Remove)
1287
+ *
1288
+ * @example
1289
+ * ```js
1290
+ * appEmbed.trigger(HostEvent.Remove)
1291
+ * ```
1020
1292
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1021
1293
  */
1022
1294
  Remove = 'delete',
1023
1295
  /**
1024
1296
  * Triggers the Explore action on a visualization
1297
+ *
1025
1298
  * @param - an object with vizId as a key
1026
- * @example liveboardEmbed.trigger(HostEvent.Explore, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1299
+ * @example
1300
+ * ```js
1301
+ * liveboardEmbed.trigger(HostEvent.Explore, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1302
+ * ```
1027
1303
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1028
1304
  */
1029
1305
  Explore = 'explore',
1030
1306
  /**
1031
1307
  * Triggers the Create alert action on a visualization
1308
+ *
1032
1309
  * @param - an object with vizId as a key
1033
- * @example liveboardEmbed.trigger(HostEvent.CreateMonitor {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1310
+ * @example
1311
+ * ```js
1312
+ * liveboardEmbed.trigger(HostEvent.CreateMonitor {
1313
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'
1314
+ * })
1315
+ * ```
1034
1316
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1035
1317
  */
1036
1318
  CreateMonitor = 'createMonitor',
1037
1319
  /**
1038
1320
  * Triggers the Manage alert action on a visualization
1321
+ *
1039
1322
  * @param - an object with vizId as a key
1040
- * @example liveboardEmbed.trigger(HostEvent.ManageMonitor, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1323
+ * @example
1324
+ * ```js
1325
+ * liveboardEmbed.trigger(HostEvent.ManageMonitor, {
1326
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'
1327
+ * })
1328
+ * ```
1041
1329
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1042
1330
  */
1043
1331
  ManageMonitor = 'manageMonitor',
1044
1332
  /**
1045
1333
  * Triggers the Edit action on a Liveboard or visualization
1046
- * @param - object - to trigger the action for a specfic visualization in Liveboard embed, pass in vizId as a key
1334
+ *
1335
+ * @param - object - to trigger the action for a specfic visualization
1336
+ * in Liveboard embed, pass in vizId as a key
1047
1337
  * @example
1048
1338
  * liveboardEmbed.trigger(HostEvent.Edit)
1049
- * liveboardEmbed.trigger(HostEvent.Edit, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1339
+ * liveboardEmbed.trigger(HostEvent.Edit, {vizId:
1340
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1050
1341
  * vizEmbed.trigger((HostEvent.Edit)
1051
1342
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1052
1343
  */
1053
1344
  Edit = 'edit',
1054
1345
  /**
1055
1346
  * Triggers the Copy link action on a Liveboard or visualization
1056
- * @param - object - to trigger the action for a specfic visualization in Liveboard embed, pass in vizId as a key
1347
+ *
1348
+ * @param - object - to trigger the action for a s
1349
+ * pecfic visualization in Liveboard embed, pass in vizId as a key
1057
1350
  * @example
1351
+ * ```js
1058
1352
  * liveboardEmbed.trigger(HostEvent.CopyLink)
1059
1353
  * liveboardEmbed.trigger(HostEvent.CopyLink, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1060
1354
  * vizEmbed.trigger((HostEvent.CopyLink)
1355
+ * ```
1061
1356
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1062
1357
  */
1063
1358
  CopyLink = 'embedDocument',
1064
1359
  /**
1065
1360
  * Triggers the Present action on a Liveboard or visualization
1066
- * @param - object - to trigger the action for a specfic visualization in Liveboard embed, pass in vizId as a key
1361
+ *
1362
+ * @param - object - to trigger the action for a specfic visualization
1363
+ * in Liveboard embed, pass in vizId as a key
1067
1364
  * @example
1365
+ * ```js
1068
1366
  * liveboardEmbed.trigger(HostEvent.Present)
1069
1367
  * liveboardEmbed.trigger(HostEvent.Present, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1070
1368
  * vizEmbed.trigger((HostEvent.Present)
1369
+ * ```
1071
1370
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
1072
1371
  */
1073
1372
  Present = 'present',
1074
1373
  /**
1075
1374
  * Get TML for the current search.
1076
- * @example searchEmbed.trigger(HostEvent.GetTML)
1077
- * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1-sw
1375
+ *
1376
+ * @example
1377
+ * ```js
1378
+ * searchEmbed.trigger(HostEvent.GetTML)
1379
+ * ```
1380
+ * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl
1078
1381
  */
1079
1382
  GetTML = 'getTML',
1080
1383
  /**
1081
1384
  * Triggers the ShowUnderlyingData action on visualization or search
1385
+ *
1082
1386
  * @param - an object with vizId as a key
1083
1387
  * @example
1084
- * liveboardEmbed.trigger(HostEvent.ShowUnderlyingData, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1388
+ * liveboardEmbed.trigger(HostEvent.ShowUnderlyingData, {vizId:
1389
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1085
1390
  * vizEmbed.trigger(HostEvent.ShowUnderlyingData)
1086
1391
  * searchEmbed.trigger(HostEvent.ShowUnderlyingData)
1087
1392
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
@@ -1089,10 +1394,12 @@ export enum HostEvent {
1089
1394
  ShowUnderlyingData = 'showUnderlyingData',
1090
1395
  /**
1091
1396
  * Triggers the Delete action on visualization or search
1397
+ *
1092
1398
  * @param - incase of Liveboard embed, takes in an object with vizId as a key
1093
1399
  * can be left empty for search and visualization embeds
1094
1400
  * @example
1095
- * liveboardEmbed.trigger(HostEvent.Delete, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1401
+ * liveboardEmbed.trigger(HostEvent.Delete, {vizId:
1402
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1096
1403
  * vizEmbed.trigger(HostEvent.Delete)
1097
1404
  * searchEmbed.trigger(HostEvent.Delete)
1098
1405
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
@@ -1100,10 +1407,12 @@ export enum HostEvent {
1100
1407
  Delete = 'delete',
1101
1408
  /**
1102
1409
  * Triggers the SpotIQAnalyze action on visualization or search
1410
+ *
1103
1411
  * @param - incase of Liveboard embed, takes in an object with vizId as a key
1104
1412
  * can be left empty for search and visualization embeds
1105
1413
  * @example
1106
- * liveboardEmbed.trigger(HostEvent.SpotIQAnalyze, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1414
+ * liveboardEmbed.trigger(HostEvent.SpotIQAnalyze, {vizId:
1415
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1107
1416
  * vizEmbed.trigger(HostEvent.SpotIQAnalyze)
1108
1417
  * searchEmbed.trigger(HostEvent.SpotIQAnalyze)
1109
1418
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
@@ -1111,26 +1420,34 @@ export enum HostEvent {
1111
1420
  SpotIQAnalyze = 'spotIQAnalyze',
1112
1421
  /**
1113
1422
  * Triggers the Download action on visualization or search when Displaymode is Chart
1423
+ *
1114
1424
  * @example
1115
- * liveboardEmbed.trigger(HostEvent.Download, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1425
+ * liveboardEmbed.trigger(HostEvent.Download, {vizId:
1426
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1116
1427
  * vizEmbed.trigger(HostEvent.Download)
1117
1428
  * searchEmbed.trigger(HostEvent.Download)
1118
1429
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
1119
1430
  */
1120
1431
  Download = 'download',
1121
1432
  /**
1122
- * Triggers the downloadAsCSV action on visualization or search when Displaymode is Table
1433
+ * Triggers the downloadAsCSV action on visualization or search when Displaymode is
1434
+ * Table
1435
+ *
1123
1436
  * @example
1124
- * liveboardEmbed.trigger(HostEvent.DownloadAsCsv, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1437
+ * liveboardEmbed.trigger(HostEvent.DownloadAsCsv, {vizId:
1438
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1125
1439
  * vizEmbed.trigger(HostEvent.DownloadAsCsv)
1126
1440
  * searchEmbed.trigger(HostEvent.DownloadAsCsv)
1127
1441
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
1128
1442
  */
1129
1443
  DownloadAsCsv = 'downloadAsCSV',
1130
1444
  /**
1131
- * Triggers the downloadAsXLSX action on visualization or search when Displaymode is Table
1445
+ * Triggers the downloadAsXLSX action on visualization or search when Displaymode is
1446
+ * Table
1447
+ *
1132
1448
  * @example
1133
- * liveboardEmbed.trigger(HostEvent.DownloadAsXlsx, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1449
+ * liveboardEmbed.trigger(HostEvent.DownloadAsXlsx, {vizId:
1450
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1134
1451
  * vizEmbed.trigger(HostEvent.DownloadAsXlsx)
1135
1452
  * searchEmbed.trigger(HostEvent.DownloadAsXlsx)
1136
1453
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
@@ -1138,6 +1455,7 @@ export enum HostEvent {
1138
1455
  DownloadAsXlsx = 'downloadAsXLSX',
1139
1456
  /**
1140
1457
  * Triggers the Share action on a liveboard or answer
1458
+ *
1141
1459
  * @example
1142
1460
  * liveboardEmbed.trigger(HostEvent.Share)
1143
1461
  * searchEmbed.trigger(HostEvent.Share)
@@ -1146,6 +1464,7 @@ export enum HostEvent {
1146
1464
  Share = 'share',
1147
1465
  /**
1148
1466
  * Trigger the Save action on a liveboard or answer
1467
+ *
1149
1468
  * @example
1150
1469
  * liveboardEmbed.trigger(HostEvent.Save)
1151
1470
  * searchEmbed.trigger(HostEvent.Save)
@@ -1154,33 +1473,40 @@ export enum HostEvent {
1154
1473
  Save = 'save',
1155
1474
  /**
1156
1475
  * Triggers the SyncToSheets action on visualization
1476
+ *
1157
1477
  * @param - an object with vizId as a key
1158
1478
  * @example
1159
- * liveboardEmbed.trigger(HostEvent.SyncToSheets, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1479
+ * liveboardEmbed.trigger(HostEvent.SyncToSheets, {vizId:
1480
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1160
1481
  * vizEmbed.trigger(HostEvent.SyncToSheets)
1161
1482
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
1162
1483
  */
1163
1484
  SyncToSheets = 'sync-to-sheets',
1164
1485
  /**
1165
1486
  * Triggers the SyncToOtherApps action on visualization
1487
+ *
1166
1488
  * @param - an object with vizId as a key
1167
1489
  * @example
1168
- * liveboardEmbed.trigger(HostEvent.SyncToOtherApps, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1490
+ * liveboardEmbed.trigger(HostEvent.SyncToOtherApps, {vizId:
1491
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1169
1492
  * vizEmbed.trigger(HostEvent.SyncToOtherApps)
1170
1493
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
1171
1494
  */
1172
1495
  SyncToOtherApps = 'sync-to-other-apps',
1173
1496
  /**
1174
1497
  * Triggers the ManagePipelines action on visualization
1498
+ *
1175
1499
  * @param - an object with vizId as a key
1176
1500
  * @example
1177
- * liveboardEmbed.trigger(HostEvent.ManagePipelines, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1501
+ * liveboardEmbed.trigger(HostEvent.ManagePipelines, {vizId:
1502
+ * '730496d6-6903-4601-937e-2c691821af3c'})
1178
1503
  * vizEmbed.trigger(HostEvent.ManagePipelines)
1179
1504
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
1180
1505
  */
1181
1506
  ManagePipelines = 'manage-pipeline',
1182
1507
  /**
1183
1508
  * Triggers the Reset search in answer
1509
+ *
1184
1510
  * @example
1185
1511
  * searchEmbed.trigger(HostEvent.SearchReset
1186
1512
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.0.1-sw
@@ -1214,6 +1540,7 @@ export enum DataSourceVisualMode {
1214
1540
  */
1215
1541
  // eslint-disable-next-line no-shadow
1216
1542
  export enum Param {
1543
+ EmbedApp = 'embedApp',
1217
1544
  DataSources = 'dataSources',
1218
1545
  DataSourceMode = 'dataSourceMode',
1219
1546
  DisableActions = 'disableAction',
@@ -1254,6 +1581,8 @@ export enum Param {
1254
1581
  ContextMenuTrigger = 'isContextMenuEnabledOnLeftClick',
1255
1582
  LinkOverride = 'linkOverride',
1256
1583
  ShowInsertToSlide = 'insertInToSlide',
1584
+ PrimaryNavHidden = 'primaryNavHidden',
1585
+ HideProfleAndHelp = 'profileAndHelpInNavBarHidden',
1257
1586
  }
1258
1587
 
1259
1588
  /**