@thoughtspot/visual-embed-sdk 1.26.2 → 1.27.0-logger

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 (304) hide show
  1. package/README.md +1 -1
  2. package/cjs/package.json +1 -1
  3. package/cjs/src/auth.d.ts +4 -4
  4. package/cjs/src/auth.d.ts.map +1 -1
  5. package/cjs/src/auth.js +15 -8
  6. package/cjs/src/auth.js.map +1 -1
  7. package/cjs/src/embed/app.d.ts +14 -14
  8. package/cjs/src/embed/app.d.ts.map +1 -1
  9. package/cjs/src/embed/app.js +4 -3
  10. package/cjs/src/embed/app.js.map +1 -1
  11. package/cjs/src/embed/app.spec.js +5 -4
  12. package/cjs/src/embed/app.spec.js.map +1 -1
  13. package/cjs/src/embed/base.d.ts.map +1 -1
  14. package/cjs/src/embed/base.js +5 -2
  15. package/cjs/src/embed/base.js.map +1 -1
  16. package/cjs/src/embed/base.spec.js +3 -2
  17. package/cjs/src/embed/base.spec.js.map +1 -1
  18. package/cjs/src/embed/embed.spec.js +2 -1
  19. package/cjs/src/embed/embed.spec.js.map +1 -1
  20. package/cjs/src/embed/embedConfig.d.ts +2 -1
  21. package/cjs/src/embed/embedConfig.d.ts.map +1 -1
  22. package/cjs/src/embed/embedConfig.js +2 -0
  23. package/cjs/src/embed/embedConfig.js.map +1 -1
  24. package/cjs/src/embed/events.spec.js +3 -2
  25. package/cjs/src/embed/events.spec.js.map +1 -1
  26. package/cjs/src/embed/liveboard.d.ts +28 -23
  27. package/cjs/src/embed/liveboard.d.ts.map +1 -1
  28. package/cjs/src/embed/liveboard.js +4 -3
  29. package/cjs/src/embed/liveboard.js.map +1 -1
  30. package/cjs/src/embed/sage.d.ts +47 -29
  31. package/cjs/src/embed/sage.d.ts.map +1 -1
  32. package/cjs/src/embed/sage.js +1 -1
  33. package/cjs/src/embed/sage.js.map +1 -1
  34. package/cjs/src/embed/search-bar.d.ts +22 -6
  35. package/cjs/src/embed/search-bar.d.ts.map +1 -1
  36. package/cjs/src/embed/search-bar.js.map +1 -1
  37. package/cjs/src/embed/search.d.ts +33 -18
  38. package/cjs/src/embed/search.d.ts.map +1 -1
  39. package/cjs/src/embed/search.js +4 -1
  40. package/cjs/src/embed/search.js.map +1 -1
  41. package/cjs/src/embed/search.spec.js +10 -0
  42. package/cjs/src/embed/search.spec.js.map +1 -1
  43. package/cjs/src/embed/ts-embed.d.ts.map +1 -1
  44. package/cjs/src/embed/ts-embed.js +37 -17
  45. package/cjs/src/embed/ts-embed.js.map +1 -1
  46. package/cjs/src/embed/ts-embed.spec.js +141 -26
  47. package/cjs/src/embed/ts-embed.spec.js.map +1 -1
  48. package/cjs/src/index.d.ts +2 -2
  49. package/cjs/src/index.d.ts.map +1 -1
  50. package/cjs/src/index.js +2 -1
  51. package/cjs/src/index.js.map +1 -1
  52. package/cjs/src/mixpanel-service.d.ts.map +1 -1
  53. package/cjs/src/mixpanel-service.js +2 -1
  54. package/cjs/src/mixpanel-service.js.map +1 -1
  55. package/cjs/src/react/index.spec.js +2 -14
  56. package/cjs/src/react/index.spec.js.map +1 -1
  57. package/cjs/src/types.d.ts +751 -242
  58. package/cjs/src/types.d.ts.map +1 -1
  59. package/cjs/src/types.js +665 -176
  60. package/cjs/src/types.js.map +1 -1
  61. package/cjs/src/utils/authService/authService.d.ts.map +1 -1
  62. package/cjs/src/utils/authService/authService.js +3 -2
  63. package/cjs/src/utils/authService/authService.js.map +1 -1
  64. package/cjs/src/utils/authService/authService.spec.js +3 -2
  65. package/cjs/src/utils/authService/authService.spec.js.map +1 -1
  66. package/cjs/src/utils/authService/tokenizedAuthService.d.ts.map +1 -1
  67. package/cjs/src/utils/authService/tokenizedAuthService.js +2 -1
  68. package/cjs/src/utils/authService/tokenizedAuthService.js.map +1 -1
  69. package/cjs/src/utils/graphql/answerService/answerService.d.ts +2 -4
  70. package/cjs/src/utils/graphql/answerService/answerService.d.ts.map +1 -1
  71. package/cjs/src/utils/graphql/answerService/answerService.js +2 -4
  72. package/cjs/src/utils/graphql/answerService/answerService.js.map +1 -1
  73. package/cjs/src/utils/logger.d.ts +4 -14
  74. package/cjs/src/utils/logger.d.ts.map +1 -1
  75. package/cjs/src/utils/logger.js +37 -41
  76. package/cjs/src/utils/logger.js.map +1 -1
  77. package/cjs/src/utils/logger.spec.d.ts +25 -0
  78. package/cjs/src/utils/logger.spec.d.ts.map +1 -0
  79. package/cjs/src/utils/logger.spec.js +80 -0
  80. package/cjs/src/utils/logger.spec.js.map +1 -0
  81. package/cjs/src/utils/processData.d.ts +6 -0
  82. package/cjs/src/utils/processData.d.ts.map +1 -1
  83. package/cjs/src/utils/processData.js +5 -1
  84. package/cjs/src/utils/processData.js.map +1 -1
  85. package/cjs/src/utils/processTrigger.js +1 -1
  86. package/dist/src/auth.d.ts +4 -4
  87. package/dist/src/auth.d.ts.map +1 -1
  88. package/dist/src/embed/app.d.ts +14 -14
  89. package/dist/src/embed/app.d.ts.map +1 -1
  90. package/dist/src/embed/base.d.ts.map +1 -1
  91. package/dist/src/embed/embedConfig.d.ts +2 -1
  92. package/dist/src/embed/embedConfig.d.ts.map +1 -1
  93. package/dist/src/embed/liveboard.d.ts +28 -23
  94. package/dist/src/embed/liveboard.d.ts.map +1 -1
  95. package/dist/src/embed/sage.d.ts +47 -29
  96. package/dist/src/embed/sage.d.ts.map +1 -1
  97. package/dist/src/embed/search-bar.d.ts +22 -6
  98. package/dist/src/embed/search-bar.d.ts.map +1 -1
  99. package/dist/src/embed/search.d.ts +33 -18
  100. package/dist/src/embed/search.d.ts.map +1 -1
  101. package/dist/src/embed/ts-embed.d.ts.map +1 -1
  102. package/dist/src/index.d.ts +2 -2
  103. package/dist/src/index.d.ts.map +1 -1
  104. package/dist/src/mixpanel-service.d.ts.map +1 -1
  105. package/dist/src/types.d.ts +751 -242
  106. package/dist/src/types.d.ts.map +1 -1
  107. package/dist/src/utils/authService/authService.d.ts.map +1 -1
  108. package/dist/src/utils/authService/tokenizedAuthService.d.ts.map +1 -1
  109. package/dist/src/utils/graphql/answerService/answerService.d.ts +2 -4
  110. package/dist/src/utils/graphql/answerService/answerService.d.ts.map +1 -1
  111. package/dist/src/utils/logger.d.ts +4 -14
  112. package/dist/src/utils/logger.d.ts.map +1 -1
  113. package/dist/src/utils/logger.spec.d.ts +25 -0
  114. package/dist/src/utils/logger.spec.d.ts.map +1 -0
  115. package/dist/src/utils/processData.d.ts +6 -0
  116. package/dist/src/utils/processData.d.ts.map +1 -1
  117. package/dist/tsembed-react.es.js +18186 -404
  118. package/dist/tsembed-react.js +18185 -403
  119. package/dist/tsembed.es.js +18336 -545
  120. package/dist/tsembed.js +32457 -14667
  121. package/dist/visual-embed-sdk-react-full.d.ts +903 -341
  122. package/dist/visual-embed-sdk-react.d.ts +903 -341
  123. package/dist/visual-embed-sdk.d.ts +903 -341
  124. package/lib/package.json +1 -1
  125. package/lib/src/auth.d.ts +4 -4
  126. package/lib/src/auth.d.ts.map +1 -1
  127. package/lib/src/auth.js +15 -8
  128. package/lib/src/auth.js.map +1 -1
  129. package/lib/src/embed/app.d.ts +14 -14
  130. package/lib/src/embed/app.d.ts.map +1 -1
  131. package/lib/src/embed/app.js +4 -3
  132. package/lib/src/embed/app.js.map +1 -1
  133. package/lib/src/embed/app.spec.js +5 -4
  134. package/lib/src/embed/app.spec.js.map +1 -1
  135. package/lib/src/embed/base.d.ts.map +1 -1
  136. package/lib/src/embed/base.js +6 -3
  137. package/lib/src/embed/base.js.map +1 -1
  138. package/lib/src/embed/base.spec.js +3 -2
  139. package/lib/src/embed/base.spec.js.map +1 -1
  140. package/lib/src/embed/embed.spec.js +2 -1
  141. package/lib/src/embed/embed.spec.js.map +1 -1
  142. package/lib/src/embed/embedConfig.d.ts +2 -1
  143. package/lib/src/embed/embedConfig.d.ts.map +1 -1
  144. package/lib/src/embed/embedConfig.js +2 -0
  145. package/lib/src/embed/embedConfig.js.map +1 -1
  146. package/lib/src/embed/events.spec.js +3 -2
  147. package/lib/src/embed/events.spec.js.map +1 -1
  148. package/lib/src/embed/liveboard.d.ts +28 -23
  149. package/lib/src/embed/liveboard.d.ts.map +1 -1
  150. package/lib/src/embed/liveboard.js +4 -3
  151. package/lib/src/embed/liveboard.js.map +1 -1
  152. package/lib/src/embed/sage.d.ts +47 -29
  153. package/lib/src/embed/sage.d.ts.map +1 -1
  154. package/lib/src/embed/sage.js +1 -1
  155. package/lib/src/embed/sage.js.map +1 -1
  156. package/lib/src/embed/search-bar.d.ts +22 -6
  157. package/lib/src/embed/search-bar.d.ts.map +1 -1
  158. package/lib/src/embed/search-bar.js.map +1 -1
  159. package/lib/src/embed/search.d.ts +33 -18
  160. package/lib/src/embed/search.d.ts.map +1 -1
  161. package/lib/src/embed/search.js +4 -1
  162. package/lib/src/embed/search.js.map +1 -1
  163. package/lib/src/embed/search.spec.js +10 -0
  164. package/lib/src/embed/search.spec.js.map +1 -1
  165. package/lib/src/embed/ts-embed.d.ts.map +1 -1
  166. package/lib/src/embed/ts-embed.js +38 -18
  167. package/lib/src/embed/ts-embed.js.map +1 -1
  168. package/lib/src/embed/ts-embed.spec.js +141 -26
  169. package/lib/src/embed/ts-embed.spec.js.map +1 -1
  170. package/lib/src/index.d.ts +2 -2
  171. package/lib/src/index.d.ts.map +1 -1
  172. package/lib/src/index.js +2 -2
  173. package/lib/src/index.js.map +1 -1
  174. package/lib/src/mixpanel-service.d.ts.map +1 -1
  175. package/lib/src/mixpanel-service.js +2 -1
  176. package/lib/src/mixpanel-service.js.map +1 -1
  177. package/lib/src/react/index.spec.js +2 -14
  178. package/lib/src/react/index.spec.js.map +1 -1
  179. package/lib/src/types.d.ts +751 -242
  180. package/lib/src/types.d.ts.map +1 -1
  181. package/lib/src/types.js +664 -175
  182. package/lib/src/types.js.map +1 -1
  183. package/lib/src/utils/authService/authService.d.ts.map +1 -1
  184. package/lib/src/utils/authService/authService.js +3 -2
  185. package/lib/src/utils/authService/authService.js.map +1 -1
  186. package/lib/src/utils/authService/authService.spec.js +3 -2
  187. package/lib/src/utils/authService/authService.spec.js.map +1 -1
  188. package/lib/src/utils/authService/tokenizedAuthService.d.ts.map +1 -1
  189. package/lib/src/utils/authService/tokenizedAuthService.js +2 -1
  190. package/lib/src/utils/authService/tokenizedAuthService.js.map +1 -1
  191. package/lib/src/utils/graphql/answerService/answerService.d.ts +2 -4
  192. package/lib/src/utils/graphql/answerService/answerService.d.ts.map +1 -1
  193. package/lib/src/utils/graphql/answerService/answerService.js +2 -4
  194. package/lib/src/utils/graphql/answerService/answerService.js.map +1 -1
  195. package/lib/src/utils/logger.d.ts +4 -14
  196. package/lib/src/utils/logger.d.ts.map +1 -1
  197. package/lib/src/utils/logger.js +23 -25
  198. package/lib/src/utils/logger.js.map +1 -1
  199. package/lib/src/utils/logger.spec.d.ts +25 -0
  200. package/lib/src/utils/logger.spec.d.ts.map +1 -0
  201. package/lib/src/utils/logger.spec.js +57 -0
  202. package/lib/src/utils/logger.spec.js.map +1 -0
  203. package/lib/src/utils/processData.d.ts +6 -0
  204. package/lib/src/utils/processData.d.ts.map +1 -1
  205. package/lib/src/utils/processData.js +4 -1
  206. package/lib/src/utils/processData.js.map +1 -1
  207. package/lib/src/utils/processTrigger.js +1 -1
  208. package/lib/src/visual-embed-sdk.d.ts +904 -342
  209. package/package.json +1 -1
  210. package/src/auth.ts +15 -8
  211. package/src/embed/app.spec.ts +5 -4
  212. package/src/embed/app.ts +22 -21
  213. package/src/embed/base.spec.ts +3 -2
  214. package/src/embed/base.ts +10 -3
  215. package/src/embed/embed.spec.ts +2 -1
  216. package/src/embed/embedConfig.ts +2 -0
  217. package/src/embed/events.spec.ts +3 -2
  218. package/src/embed/liveboard.ts +28 -23
  219. package/src/embed/sage.ts +47 -29
  220. package/src/embed/search-bar.tsx +22 -6
  221. package/src/embed/search.spec.ts +13 -0
  222. package/src/embed/search.ts +38 -19
  223. package/src/embed/ts-embed.spec.ts +159 -26
  224. package/src/embed/ts-embed.ts +37 -19
  225. package/src/index.ts +2 -0
  226. package/src/mixpanel-service.ts +2 -1
  227. package/src/react/index.spec.tsx +2 -31
  228. package/src/types.ts +753 -243
  229. package/src/utils/authService/authService.spec.ts +3 -2
  230. package/src/utils/authService/authService.ts +4 -2
  231. package/src/utils/authService/tokenizedAuthService.ts +2 -1
  232. package/src/utils/graphql/answerService/answerService.ts +2 -4
  233. package/src/utils/logger.spec.ts +67 -0
  234. package/src/utils/logger.ts +87 -0
  235. package/src/utils/processData.ts +4 -1
  236. package/src/utils/processTrigger.ts +1 -1
  237. package/cjs/src/embed/TsEmbed.d.ts +0 -302
  238. package/cjs/src/embed/TsEmbed.d.ts.map +0 -1
  239. package/cjs/src/embed/TsEmbed.js +0 -851
  240. package/cjs/src/embed/TsEmbed.js.map +0 -1
  241. package/cjs/src/utils/answerService.d.ts +0 -10
  242. package/cjs/src/utils/answerService.d.ts.map +0 -1
  243. package/cjs/src/utils/answerService.js +0 -61
  244. package/cjs/src/utils/answerService.js.map +0 -1
  245. package/cjs/src/utils/answerService.spec.d.ts +0 -2
  246. package/cjs/src/utils/answerService.spec.d.ts.map +0 -1
  247. package/cjs/src/utils/answerService.spec.js +0 -31
  248. package/cjs/src/utils/answerService.spec.js.map +0 -1
  249. package/cjs/src/utils/authService/tokenisedAuthSerice.d.ts +0 -11
  250. package/cjs/src/utils/authService/tokenisedAuthSerice.d.ts.map +0 -1
  251. package/cjs/src/utils/authService/tokenisedAuthSerice.js +0 -44
  252. package/cjs/src/utils/authService/tokenisedAuthSerice.js.map +0 -1
  253. package/cjs/src/utils/authService.d.ts +0 -55
  254. package/cjs/src/utils/authService.d.ts.map +0 -1
  255. package/cjs/src/utils/authService.js +0 -139
  256. package/cjs/src/utils/authService.js.map +0 -1
  257. package/cjs/src/utils/authService.spec.d.ts +0 -2
  258. package/cjs/src/utils/authService.spec.d.ts.map +0 -1
  259. package/cjs/src/utils/authService.spec.js +0 -82
  260. package/cjs/src/utils/authService.spec.js.map +0 -1
  261. package/cjs/src/utils/graphql/graphql-request.spec.d.ts +0 -2
  262. package/cjs/src/utils/graphql/graphql-request.spec.d.ts.map +0 -1
  263. package/cjs/src/utils/graphql/graphql-request.spec.js +0 -39
  264. package/cjs/src/utils/graphql/graphql-request.spec.js.map +0 -1
  265. package/dist/src/utils/answerService.d.ts +0 -10
  266. package/dist/src/utils/answerService.d.ts.map +0 -1
  267. package/dist/src/utils/answerService.spec.d.ts +0 -2
  268. package/dist/src/utils/answerService.spec.d.ts.map +0 -1
  269. package/dist/src/utils/authService/tokenisedAuthSerice.d.ts +0 -11
  270. package/dist/src/utils/authService/tokenisedAuthSerice.d.ts.map +0 -1
  271. package/dist/src/utils/authService.d.ts +0 -55
  272. package/dist/src/utils/authService.d.ts.map +0 -1
  273. package/dist/src/utils/authService.spec.d.ts +0 -2
  274. package/dist/src/utils/authService.spec.d.ts.map +0 -1
  275. package/dist/src/utils/graphql/graphql-request.spec.d.ts +0 -2
  276. package/dist/src/utils/graphql/graphql-request.spec.d.ts.map +0 -1
  277. package/lib/src/embed/TsEmbed.d.ts +0 -302
  278. package/lib/src/embed/TsEmbed.d.ts.map +0 -1
  279. package/lib/src/embed/TsEmbed.js +0 -847
  280. package/lib/src/embed/TsEmbed.js.map +0 -1
  281. package/lib/src/utils/answerService.d.ts +0 -10
  282. package/lib/src/utils/answerService.d.ts.map +0 -1
  283. package/lib/src/utils/answerService.js +0 -57
  284. package/lib/src/utils/answerService.js.map +0 -1
  285. package/lib/src/utils/answerService.spec.d.ts +0 -2
  286. package/lib/src/utils/answerService.spec.d.ts.map +0 -1
  287. package/lib/src/utils/answerService.spec.js +0 -29
  288. package/lib/src/utils/answerService.spec.js.map +0 -1
  289. package/lib/src/utils/authService/tokenisedAuthSerice.d.ts +0 -11
  290. package/lib/src/utils/authService/tokenisedAuthSerice.d.ts.map +0 -1
  291. package/lib/src/utils/authService/tokenisedAuthSerice.js +0 -39
  292. package/lib/src/utils/authService/tokenisedAuthSerice.js.map +0 -1
  293. package/lib/src/utils/authService.d.ts +0 -55
  294. package/lib/src/utils/authService.d.ts.map +0 -1
  295. package/lib/src/utils/authService.js +0 -129
  296. package/lib/src/utils/authService.js.map +0 -1
  297. package/lib/src/utils/authService.spec.d.ts +0 -2
  298. package/lib/src/utils/authService.spec.d.ts.map +0 -1
  299. package/lib/src/utils/authService.spec.js +0 -80
  300. package/lib/src/utils/authService.spec.js.map +0 -1
  301. package/lib/src/utils/graphql/graphql-request.spec.d.ts +0 -2
  302. package/lib/src/utils/graphql/graphql-request.spec.d.ts.map +0 -1
  303. package/lib/src/utils/graphql/graphql-request.spec.js +0 -36
  304. package/lib/src/utils/graphql/graphql-request.spec.js.map +0 -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
  */
@@ -512,21 +521,35 @@ export interface EmbedConfig {
512
521
  * @version SDK: 1.26.2 | ThoughtSpot: *
513
522
  */
514
523
  suppressErrorAlerts?: boolean;
524
+ /**
525
+ * Log level for the SDK.
526
+ * @default LogLevel.ERROR
527
+ *
528
+ * @example
529
+ * ```js
530
+ * init({
531
+ * ...embedConfig,
532
+ * logLevel: LogLevel.SILENT
533
+ * })
534
+ * ```
535
+ * @version SDK: 1.26.3 | ThoughtSpot: 9.10.0.cl
536
+ */
537
+ logLevel?: LogLevel;
515
538
  }
516
539
  export interface LayoutConfig {
517
540
  }
518
541
  /**
519
- * Embedded iFrame configuration
542
+ * Embedded iframe configuration
520
543
  *
521
544
  * @group Embed components
522
545
  */
523
546
  export interface FrameParams {
524
547
  /**
525
- * The width of the iFrame (unit is pixels if numeric).
548
+ * The width of the iframe (unit is pixels if numeric).
526
549
  */
527
550
  width?: number | string;
528
551
  /**
529
- * The height of the iFrame (unit is pixels if numeric).
552
+ * The height of the iframe (unit is pixels if numeric).
530
553
  */
531
554
  height?: number | string;
532
555
  /**
@@ -627,7 +650,6 @@ export interface ViewConfig {
627
650
  */
628
651
  runtimeParameters?: RuntimeParameter[];
629
652
  /**
630
- /**
631
653
  * The locale/language to use for the embedded view.
632
654
  *
633
655
  * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
@@ -727,31 +749,29 @@ export interface ViewConfig {
727
749
  */
728
750
  reorderedHomepageModules?: HomepageModule[];
729
751
  /**
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.
752
+ * The list of tab IDs to show in the embedded Liveboard.
753
+ * Only the tabs specified in the array will be shown in the Liveboard.
733
754
  *
734
- * Use either this or hiddenTabs.
755
+ * Use either `visibleTabs` or `hiddenTabs`.
735
756
  *
736
757
  * @example
737
758
  * ```js
738
- * const embed = new LiveboardEmbed('#embed', {
739
- * ... // other liveboard view config
740
- * visibleTabs: [
759
+ * visibleTabs: [
741
760
  * '430496d6-6903-4601-937e-2c691821af3c',
742
- * 'f547ec54-2a37-4516-a222-2b06719af726']
743
- * });
761
+ * 'f547ec54-2a37-4516-a222-2b06719af726']
744
762
  * ```
745
763
  * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
746
764
  */
747
765
  visibleTabs?: string[];
748
766
  /**
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.
767
+ * homepageLeftNavItems : Show or hide the left navigation bar items.
768
+ * There are 8 eight home navigation list items.
769
+ * To hide these items, specify the string in the array.
753
770
  *
754
- * @version SDK: 1.27.0 | Thoughtspot: 9.8.0.cl
771
+ * ```js
772
+ * hiddenHomeLeftNavItems = [HomeLeftNavItem.Home]
773
+ * ```
774
+ * @version SDK: 1.27.0 | Thoughtspot: 9.10.0.cl
755
775
  */
756
776
  hiddenHomeLeftNavItems?: HomeLeftNavItem[];
757
777
  /**
@@ -767,7 +787,7 @@ export interface ViewConfig {
767
787
  * });
768
788
  * embed.showPreRender();
769
789
  * ```
770
- * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
790
+ * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl, 9.8.0.sw
771
791
  */
772
792
  preRenderId?: string;
773
793
  /**
@@ -800,7 +820,7 @@ export type MessagePayload = {
800
820
  status?: string;
801
821
  };
802
822
  /**
803
- * MessageOptions: By Providing options, getting specific event start / end based on
823
+ * MessageOptions: By providing options, getting specific event start / end based on
804
824
  * option
805
825
  *
806
826
  * @group Events
@@ -808,7 +828,7 @@ export type MessagePayload = {
808
828
  export type MessageOptions = {
809
829
  /**
810
830
  * A boolean value indicating that start status events of this type
811
- * will be dispatched
831
+ * will be dispatched.
812
832
  */
813
833
  start?: boolean;
814
834
  };
@@ -828,7 +848,7 @@ responder?: (data: any) => void) => void;
828
848
  */
829
849
  export type MessageCallbackObj = {
830
850
  /**
831
- * options: It contains start, A boolean value indicating that start
851
+ * options: It contains start, a boolean value indicating that start
832
852
  * status events of this type will be dispatched
833
853
  */
834
854
  options: MessageOptions;
@@ -900,7 +920,7 @@ export declare enum RuntimeFilterOp {
900
920
  IN = "IN"
901
921
  }
902
922
  /**
903
- * Home page module that can be hide
923
+ * Home page module that can be hidden
904
924
  */
905
925
  export declare enum HomepageModule {
906
926
  /**
@@ -916,7 +936,7 @@ export declare enum HomepageModule {
916
936
  */
917
937
  Favorite = "FAVORITE",
918
938
  /**
919
- * List of answers and liveboards
939
+ * List of answers and Liveboards
920
940
  */
921
941
  MyLibrary = "MY_LIBRARY",
922
942
  /**
@@ -949,7 +969,7 @@ export interface RuntimeFilter {
949
969
  values: (number | boolean | string)[];
950
970
  }
951
971
  /**
952
- * A filter that can be applied to ThoughtSpot answers, Liveboards, or
972
+ * A filter that can be applied to ThoughtSpot Answers, Liveboards, or
953
973
  * visualizations at runtime.
954
974
  */
955
975
  export interface RuntimeParameter {
@@ -985,6 +1005,14 @@ export interface RuntimeParameter {
985
1005
  export declare enum EmbedEvent {
986
1006
  /**
987
1007
  * Rendering has initialized.
1008
+ * @example
1009
+ *```js
1010
+ * liveboardEmbed.on(EmbedEvent.Init, showLoader)
1011
+ * //show a loader
1012
+ * function showLoader() {
1013
+ * document.getElementById("loader");
1014
+ * }
1015
+ *```
988
1016
  *
989
1017
  * @returns timestamp - The timestamp when the event was generated.
990
1018
  */
@@ -992,69 +1020,162 @@ export declare enum EmbedEvent {
992
1020
  /**
993
1021
  * Authentication has either succeeded or failed.
994
1022
  *
1023
+ * @example
1024
+ *```js
1025
+ * appEmbed.on(EmbedEvent.AuthInit, payload => {
1026
+ * console.log('AuthInit', payload);
1027
+ * })
1028
+ *```
1029
+ *
995
1030
  * @returns isLoggedIn - A Boolean specifying whether authentication was successful.
996
1031
  */
997
1032
  AuthInit = "authInit",
998
1033
  /**
999
1034
  * The embed object container has loaded.
1000
- *
1001
1035
  * @returns timestamp - The timestamp when the event was generated.
1036
+ * @example
1037
+ *```js
1038
+ * liveboardEmbed.on(EmbedEvent.Load, hideLoader)
1039
+ * //hide loader
1040
+ * function hideLoader() {
1041
+ * document.getElementById("loader");
1042
+ * }
1043
+ *```
1002
1044
  */
1003
1045
  Load = "load",
1004
1046
  /**
1005
1047
  * Data pertaining to answer or Liveboard is received
1006
- *
1007
1048
  * @return data - The answer or Liveboard data
1049
+ * @example
1050
+ *```js
1051
+ * liveboardEmbed.on(EmbedEvent.Data, payload => {
1052
+ * console.log('data', payload);
1053
+ * })
1054
+ *```
1008
1055
  * @important
1009
1056
  */
1010
1057
  Data = "data",
1011
1058
  /**
1012
- * Search/answer/Liveboard filters have been applied/updated by the user.
1059
+ * Search/Answer/Liveboard filters have been applied/updated by the user.
1013
1060
  *
1014
1061
  * @hidden
1015
1062
  */
1016
1063
  FiltersChanged = "filtersChanged",
1017
1064
  /**
1018
1065
  * Search query has been updated by the user.
1066
+ *
1067
+ * @example
1068
+ *```js
1069
+ * searchEmbed.on(EmbedEvent.QueryChanged, payload => console.log('data', payload))
1070
+ *```
1071
+ *
1019
1072
  */
1020
1073
  QueryChanged = "queryChanged",
1021
1074
  /**
1022
- * A drill down operation has been performed.
1075
+ * A drill-down operation has been performed.
1023
1076
  *
1024
1077
  * @returns additionalFilters - Any additional filters applied
1025
1078
  * @returns drillDownColumns - The columns on which drill down was performed
1026
1079
  * @returns nonFilteredColumns - The columns that were not filtered
1080
+ *
1081
+ * @example
1082
+ *```js
1083
+ * searchEmbed.trigger(HostEvent.DrillDown, {
1084
+ * points: {
1085
+ * clickedPoint,
1086
+ * selectedPoints: selectedPoint
1087
+ * },
1088
+ * autoDrillDown: true,
1089
+ * })
1090
+ *```
1091
+ * In this example, `VizPointDoubleClick` event is used for
1092
+ * triggering the `DrillDown` event when an area or specific
1093
+ * data point on a table or chart is double-clicked.
1094
+ *
1095
+ * @example
1096
+ *```js
1097
+ * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
1098
+ * console.log(payload);
1099
+ * const clickedPoint = payload.data.clickedPoint;
1100
+ * const selectedPoint = payload.data.selectedPoints;
1101
+ * console.log('>>> called', clickedPoint);
1102
+ * embed.trigger(HostEvent.DrillDown, {
1103
+ * points: {
1104
+ * clickedPoint,
1105
+ * selectedPoints: selectedPoint
1106
+ * },
1107
+ * autoDrillDown: true,
1108
+ * })
1109
+ * })
1110
+ *```
1111
+ *
1027
1112
  */
1028
1113
  Drilldown = "drillDown",
1029
1114
  /**
1030
1115
  * One or more data sources have been selected.
1031
- *
1032
1116
  * @returns dataSourceIds - the list of data sources
1117
+ *
1118
+ * @example
1119
+ * ```js
1120
+ * searchEmbed.on(EmbedEvent.DataSourceSelected, payload => {
1121
+ * console.log('DataSourceSelected', payload);
1122
+ * })
1123
+ * ```
1124
+ *
1033
1125
  */
1034
1126
  DataSourceSelected = "dataSourceSelected",
1035
1127
  /**
1036
1128
  * One or more data columns have been selected.
1037
- *
1038
1129
  * @returns columnIds - the list of columns
1039
1130
  * @version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
1131
+ *
1132
+ * @example
1133
+ * ```js
1134
+ * appEmbed.on(EmbedEvent.AddRemoveColumns, payload => {
1135
+ * console.log('AddRemoveColumns', payload);
1136
+ * })
1137
+ * ```
1138
+ *
1040
1139
  */
1041
1140
  AddRemoveColumns = "addRemoveColumns",
1042
1141
  /**
1043
- * A custom action has been triggered
1142
+ * A custom action has been triggered.
1143
+ *
1144
+ * @returns actionId - ID of the custom action
1145
+ * @returns data - Response payload with the Answer or Liveboard data
1044
1146
  *
1045
- * @returns actionId - The id of the custom action
1046
- * @returns data - The answer or Liveboard data
1147
+ * @example
1148
+ * ```js
1149
+ * appEmbed.on(EmbedEvent.customAction, payload => {
1150
+ * const data = payload.data;
1151
+ * if (data.id === 'insert Custom Action ID here') {
1152
+ * console.log('Custom Action event:', data.embedAnswerData);
1153
+ * }
1154
+ * })
1155
+ * ```
1047
1156
  */
1048
1157
  CustomAction = "customAction",
1049
1158
  /**
1050
- * Listen to double clicks on a visualization
1159
+ * Listen to double click actions on a visualization.
1160
+ *
1161
+ * @return ContextMenuInputPoints - Data point that is double-clicked
1051
1162
  *
1052
- * @return ContextMenuInputPoints - data point that is double clicked
1053
1163
  * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
1164
+ *
1165
+ * @example
1166
+ * ```js
1167
+ * livebaordEmbed.on(EmbedEvent.VizPointDoubleClick, payload => {
1168
+ * console.log('VizPointDoubleClick', payload)
1169
+ * })
1170
+ * ```
1054
1171
  */
1055
1172
  VizPointDoubleClick = "vizPointDoubleClick",
1056
1173
  /**
1057
- * Listen to clicks on a visualization in a liveboard or Search result.
1174
+ * Listen to clicks on a visualization in a Liveboard or Search result.
1175
+ *
1176
+ * @return viz, clickedPoint - metadata about the point that is clicked
1177
+ * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1178
+ * @important
1058
1179
  *
1059
1180
  * @example
1060
1181
  * ```js
@@ -1068,25 +1189,46 @@ export declare enum EmbedEvent {
1068
1189
  * )
1069
1190
  * });
1070
1191
  * ```
1071
- * @return viz, clickedPoint - metadata about point that is clicked
1072
- * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1073
- * @important
1074
1192
  */
1075
1193
  VizPointClick = "vizPointClick",
1076
1194
  /**
1077
1195
  * An error has occurred.
1078
1196
  *
1079
1197
  * @returns error - An error object or message
1198
+ *
1199
+ * @example
1200
+ * ```js
1201
+ * SearchEmbed.on(EmbedEvent.Error, showErrorMsg)
1202
+ * //show error messaage
1203
+ * function showErrorMsg() {
1204
+ * document.getElementById("error");
1205
+ * ```
1206
+ *
1080
1207
  */
1081
1208
  Error = "Error",
1082
1209
  /**
1083
- * The embedded object has sent an alert
1210
+ * The embedded object has sent an alert.
1084
1211
  *
1085
1212
  * @returns alert - An alert object
1213
+ *
1214
+ * @example
1215
+ * ```js
1216
+ * searchEmbed.on(EmbedEvent.Alert)
1217
+ * ```
1218
+ *
1086
1219
  */
1087
1220
  Alert = "alert",
1088
1221
  /**
1089
1222
  * The ThoughtSpot auth session has expired.
1223
+ *
1224
+ * @example
1225
+ *```js
1226
+ * appEmbed.on(EmbedEvent.AuthExpire, showAuthExpired)
1227
+ * //show auth expired banner
1228
+ * function showAuthExpired() {
1229
+ * document.getElementById("authExpiredBanner");
1230
+ * }
1231
+ *```
1090
1232
  */
1091
1233
  AuthExpire = "ThoughtspotAuthExpired",
1092
1234
  /**
@@ -1116,14 +1258,28 @@ export declare enum EmbedEvent {
1116
1258
  */
1117
1259
  EmbedIframeCenter = "EmbedIframeCenter",
1118
1260
  /**
1119
- * Emitted when the "Get Data" button in Search Bar embed
1120
- * is clicked.
1261
+ * Emitted when the **Get Data** action is initiated.
1262
+ * Applicable to `SearchBarEmbed` only.
1121
1263
  *
1122
- * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.0.sw
1264
+ * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
1265
+ *
1266
+ * @example
1267
+ *```js
1268
+ * searchbarEmbed.on(EmbedEvent.GetDataClick)
1269
+ * .then(data => {
1270
+ * console.log('Answer Data:', data);
1271
+ * })
1272
+ *```
1123
1273
  */
1124
1274
  GetDataClick = "getDataClick",
1125
1275
  /**
1126
1276
  * Detects the route change.
1277
+ *
1278
+ * @example
1279
+ *```js
1280
+ * searchEmbed.on(EmbedEvent.RouteChange, payload =>
1281
+ * console.log('data', payload))
1282
+ *```
1127
1283
  */
1128
1284
  RouteChange = "ROUTE_CHANGE",
1129
1285
  /**
@@ -1133,10 +1289,15 @@ export declare enum EmbedEvent {
1133
1289
  */
1134
1290
  V1Data = "exportVizDataToParent",
1135
1291
  /**
1136
- * Emitted when the embed does not have cookie access. This
1137
- * happens on Safari where third-party cookies are blocked by default.
1292
+ * Emitted when the embed does not have cookie access. This happens
1293
+ * when Safari and other Web browsers block third-party cookies
1294
+ * are blocked by default. `NoCookieAccess` can trigger
1138
1295
  *
1139
- * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
1296
+ * @example
1297
+ *```js
1298
+ * appEmbed.on(EmbedEvent.NoCookieAccess)
1299
+ *```
1300
+ * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1.sw
1140
1301
  */
1141
1302
  NoCookieAccess = "noCookieAccess",
1142
1303
  /**
@@ -1148,239 +1309,539 @@ export declare enum EmbedEvent {
1148
1309
  SAMLComplete = "samlComplete",
1149
1310
  /**
1150
1311
  * Emitted when any modal is opened in the app
1151
- *
1152
1312
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
1313
+ *
1314
+ * @example
1315
+ *```js
1316
+ * appEmbed.on(EmbedEvent.DialogOpen, payload => {
1317
+ * console.log('dialog open', payload);
1318
+ * })
1319
+ *```
1153
1320
  */
1154
1321
  DialogOpen = "dialog-open",
1155
1322
  /**
1156
1323
  * Emitted when any modal is closed in the app
1157
- *
1158
1324
  * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
1325
+ *
1326
+ * @example
1327
+ *```js
1328
+ * appEmbed.on(EmbedEvent.DialogClose, payload => {
1329
+ * console.log('dialog close', payload);
1330
+ * })
1331
+ *```
1159
1332
  */
1160
1333
  DialogClose = "dialog-close",
1161
1334
  /**
1162
1335
  * Emitted when the Liveboard shell loads.
1163
1336
  * You can use this event as a hook to trigger
1164
1337
  * other events on the rendered Liveboard.
1165
- *
1166
1338
  * @version SDK: 1.9.1 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
1339
+ *
1340
+ * @example
1341
+ *```js
1342
+ * liveboardEmbed.on(EmbedEvent.LiveboardRendered, payload => {
1343
+ console.log('Liveboard is rendered', payload);
1344
+ })
1345
+ *```
1346
+ * The following example shows how to trigger
1347
+ * `SetVisibleVizs` event using LiveboardRendered embed event:
1348
+ *
1349
+ * @example
1350
+ *```js
1351
+ * const embedRef = useEmbedRef();
1352
+ * const onLiveboardRendered = () => {
1353
+ * embed.trigger(HostEvent.SetVisibleVizs, ['viz1', 'viz2']);
1354
+ * };
1355
+ *```
1167
1356
  */
1168
1357
  LiveboardRendered = "PinboardRendered",
1169
1358
  /**
1170
1359
  * This can be used to register an event listener which
1171
1360
  * is triggered on all events.
1172
- *
1173
1361
  * @Version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
1362
+ *
1363
+ * @example
1364
+ *```js
1365
+ * appEmbed.on(EmbedEvent.ALL, payload => {
1366
+ * console.log('Embed Events', payload)
1367
+ * })
1368
+ *```
1174
1369
  */
1175
1370
  ALL = "*",
1176
1371
  /**
1177
1372
  * Emitted when an Answer is saved in the app
1178
- *
1179
1373
  * @Version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1374
+ * @example
1375
+ *```js
1376
+ * //trigger when action starts
1377
+ * searchEmbed.on(EmbedEvent.Save, payload => {
1378
+ * console.log('Save', payload)
1379
+ * }, {
1380
+ * start: true
1381
+ * })
1382
+ * //trigger when action ends
1383
+ * searchEmbed.on(EmbedEvent.Save, payload => {
1384
+ * console.log('Save', payload)
1385
+ * })
1386
+ *```
1180
1387
  */
1181
1388
  Save = "save",
1182
1389
  /**
1183
1390
  * Emitted when the download action is triggered on an answer
1184
1391
  *
1392
+ * **Note**: This event is deprecated in v1.21.0.
1393
+ * To fire an event when a download action is initiated on a chart or table,
1394
+ * use `EmbedEvent.DownloadAsPng`, `EmbedEvent.DownloadAsPDF`, `EmbedEvent.DownloadAsCSV`,
1395
+ * or `EmbedEvent.DownloadAsXLSX`
1396
+ *
1185
1397
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1398
+ *
1399
+ * @example
1400
+ *```js
1401
+ * liveboardEmbed.trigger(HostEvent.Download, {
1402
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'
1403
+ * })
1404
+ *```
1186
1405
  */
1187
1406
  Download = "download",
1188
1407
  /**
1189
1408
  * Emitted when the download action is triggered on an answer
1190
- *
1191
1409
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.0.sw
1410
+ *
1411
+ * @example
1412
+ *```js
1413
+ * //trigger when action starts
1414
+ * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
1415
+ * console.log('download PNG', payload)}, {start: true })
1416
+ * //trigger when action ends
1417
+ * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
1418
+ * console.log('download PNG', payload)})
1419
+ *```
1420
+ *
1192
1421
  */
1193
1422
  DownloadAsPng = "downloadAsPng",
1194
1423
  /**
1195
1424
  * Emitted when the Download as PDF action is triggered on an answer
1196
1425
  *
1197
1426
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1427
+ *
1428
+ * @example
1429
+ *```js
1430
+ * //trigger when action starts
1431
+ * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
1432
+ * console.log('download PDF', payload)}, {start: true })
1433
+ * //trigger when action ends
1434
+ * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
1435
+ * console.log('download PDF', payload)})
1436
+ *```
1437
+ *
1198
1438
  */
1199
1439
  DownloadAsPdf = "downloadAsPdf",
1200
1440
  /**
1201
1441
  * Emitted when the Download as CSV action is triggered on an answer
1202
1442
  *
1203
1443
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1444
+ * @example
1445
+ *```js
1446
+ * //trigger when action starts
1447
+ * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
1448
+ * console.log('download CSV', payload)}, {start: true })
1449
+ * //trigger when action ends
1450
+ * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
1451
+ * console.log('download CSV', payload)})
1452
+ *```
1204
1453
  */
1205
1454
  DownloadAsCsv = "downloadAsCsv",
1206
1455
  /**
1207
1456
  * Emitted when the Download as XLSX action is triggered on an answer
1208
1457
  *
1209
1458
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1459
+ *
1460
+ * @example
1461
+ *```js
1462
+ * //trigger when action starts
1463
+ * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
1464
+ * console.log('download Xlsx', payload)}, { start: true })
1465
+ * //trigger when action ends
1466
+ * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
1467
+ * console.log('download Xlsx', payload)})
1468
+ *```
1210
1469
  */
1211
1470
  DownloadAsXlsx = "downloadAsXlsx",
1212
1471
  /**
1213
- * Emitted when an answer is deleted in the app
1472
+ * Emitted when an Answer is deleted in the app
1214
1473
  *
1215
1474
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1475
+ *
1476
+ * @example
1477
+ *```js
1478
+ * //trigger when action starts
1479
+ * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
1480
+ * console.log('delete answer', payload)}, {start: true })
1481
+ * //trigger when action is completed
1482
+ * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
1483
+ * console.log('delete answer', payload)})
1484
+ *```
1216
1485
  */
1217
1486
  AnswerDelete = "answerDelete",
1218
1487
  /**
1219
1488
  * Emitted when an answer is pinned to a Liveboard
1220
1489
  *
1221
1490
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1491
+ * @example
1492
+ *```js
1493
+ * //trigger when action starts
1494
+ * searchEmbed.on(EmbedEvent.Pin, payload => {
1495
+ * console.log('pin', payload)
1496
+ * }, {
1497
+ * start: true
1498
+ * })
1499
+ * //trigger when action ends
1500
+ * searchEmbed.on(EmbedEvent.Pin, payload => {
1501
+ * console.log('pin', payload)
1502
+ * })
1503
+ *```
1222
1504
  */
1223
1505
  Pin = "pin",
1224
1506
  /**
1225
1507
  * Emitted when SpotIQ analysis is triggered
1226
1508
  *
1227
1509
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1510
+ * @example
1511
+ *```js
1512
+ * //trigger when action starts
1513
+ * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
1514
+ * console.log('SpotIQAnalyze', payload)
1515
+ * }, {
1516
+ * start: true
1517
+ * })
1518
+ * //trigger when action ends
1519
+ * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
1520
+ * console.log('SpotIQ analyze', payload)
1521
+ * })
1522
+ *```
1228
1523
  */
1229
1524
  SpotIQAnalyze = "spotIQAnalyze",
1230
1525
  /**
1231
1526
  * Emitted when a user shares an object with another user or group
1232
1527
  *
1233
1528
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1529
+ *
1530
+ * @example
1531
+ *```js
1532
+ * //trigger when action starts
1533
+ * searchEmbed.on(EmbedEvent.Share, payload => {
1534
+ * console.log('Share', payload)
1535
+ * }, {
1536
+ * start: true
1537
+ * })
1538
+ * //trigger when action ends
1539
+ * searchEmbed.on(EmbedEvent.Share, payload => {
1540
+ * console.log('Share', payload)
1541
+ * })
1542
+ *```
1234
1543
  */
1235
1544
  Share = "share",
1236
1545
  /**
1237
- * Emitted when a user clicks the Include action to include a specific value or data
1238
- * on a chart or table
1546
+ * Emitted when a user clicks the **Include** action to include a specific value or
1547
+ * data on a chart or table.
1239
1548
  *
1240
1549
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1550
+ * @example
1551
+ *```js
1552
+ * appEmbed.on(EmbedEvent.DrillInclude, payload => {
1553
+ * console.log('Drill include', payload);
1554
+ * })
1555
+ *```
1241
1556
  */
1242
1557
  DrillInclude = "context-menu-item-include",
1243
1558
  /**
1244
- * Emitted when a user clicks the Exclude action to exclude a specific value or data
1245
- * on a chart or table
1559
+ * Emitted when a user clicks the **Exclude** action to exclude a specific value or
1560
+ * data on a chart or table
1246
1561
  *
1247
1562
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1563
+ * @example
1564
+ *```js
1565
+ * appEmbed.on(EmbedEvent.DrillExclude, payload => {
1566
+ * console.log('Drill exclude', payload);
1567
+ * })
1568
+ *```
1248
1569
  */
1249
1570
  DrillExclude = "context-menu-item-exclude",
1250
1571
  /**
1251
- * Emitted when copied column value on the app
1572
+ * Emitted when a column value is copied in the embedded app.
1252
1573
  *
1253
1574
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1575
+ * @example
1576
+ *```js
1577
+ * seachEmbed.on(EmbedEvent.CopyToClipboard, payload => {
1578
+ * console.log('copy to clipboard', payload);
1579
+ * })
1580
+ *```
1254
1581
  */
1255
1582
  CopyToClipboard = "context-menu-item-copy-to-clipboard",
1256
1583
  /**
1257
- * Emitted when a user clicks the Update TML action
1584
+ * Emitted when a user clicks the **Update TML** action
1258
1585
  *
1259
1586
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1587
+ * @example
1588
+ *```js
1589
+ * liveboardEmbed.on(EmbedEvent.UpdateTML)
1590
+ * })
1591
+ *```
1260
1592
  */
1261
1593
  UpdateTML = "updateTSL",
1262
1594
  /**
1263
- * Emitted when a user clicks the Edit TML action
1595
+ * Emitted when a user clicks the **Edit TML** action
1264
1596
  *
1265
1597
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1598
+ * @example
1599
+ *```js
1600
+ * appEmbed.on(EmbedEvent.EditTML, payload => {
1601
+ * console.log('Edit TML', payload);
1602
+ * })
1603
+ *```
1266
1604
  */
1267
1605
  EditTML = "editTSL",
1268
1606
  /**
1269
- * Emitted when ExportTML trigger in answer on the app
1270
- *
1607
+ * Emitted when the **Export TML** action is triggered on an
1608
+ * an embedded object in the app
1271
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
+ * searchEmbed.on(EmbedEvent.ExportTML, payload => {
1614
+ * console.log('Export TML', payload)}, { start: true })
1615
+ * //trigger when action ends
1616
+ * searchEmbed.on(EmbedEvent.ExportTML, payload => {
1617
+ * console.log('Export TML', payload)})
1618
+ *```
1272
1619
  */
1273
1620
  ExportTML = "exportTSL",
1274
1621
  /**
1275
- * Emitted when an answer is saved as a view
1622
+ * Emitted when an Answer is saved as a View.
1276
1623
  *
1277
1624
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1625
+ * @example
1626
+ *```js
1627
+ * appEmbed.on(EmbedEvent.SaveAsView, payload => {
1628
+ * console.log('View', payload);
1629
+ * })
1630
+ *```
1278
1631
  */
1279
1632
  SaveAsView = "saveAsView",
1280
1633
  /**
1281
- * Emitted when copy of existing answer on the app
1634
+ * Emitted when the user creates a copy of an Answer
1282
1635
  *
1283
1636
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1637
+ * @example
1638
+ *```js
1639
+ * //trigger when action starts
1640
+ * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
1641
+ * console.log('Copy and edit', payload)}, {start: true })
1642
+ * //trigger when action ends
1643
+ * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
1644
+ * console.log('Copy and edit', payload)})
1645
+ *```
1284
1646
  */
1285
1647
  CopyAEdit = "copyAEdit",
1286
1648
  /**
1287
- * Emitted when a user clicks Show underlying data on an answe
1649
+ * Emitted when a user clicks Show underlying data on an Answer
1288
1650
  *
1289
1651
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1652
+ * @example
1653
+ *```js
1654
+ * liveboardEmbed.on(EmbedEvent.ShowUnderlyingData, payload => {
1655
+ * console.log('show data', payload);
1656
+ * })
1657
+ *```
1290
1658
  */
1291
1659
  ShowUnderlyingData = "showUnderlyingData",
1292
1660
  /**
1293
- * Emitted when an answer is switched to a chart or table view
1661
+ * Emitted when an answer is switched to a chart or table view.
1294
1662
  *
1295
1663
  * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
1664
+ * @example
1665
+ *```js
1666
+ * searchEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
1667
+ * console.log('switch view', payload);
1668
+ * })
1669
+ *```
1296
1670
  */
1297
1671
  AnswerChartSwitcher = "answerChartSwitcher",
1298
1672
  /**
1299
- * Internal event to communicate the initial settings back to the TS APP
1673
+ * Internal event to communicate the initial settings back to the ThoughtSpot app
1300
1674
  *
1301
1675
  * @hidden
1302
1676
  */
1303
1677
  APP_INIT = "appInit",
1304
1678
  /**
1305
- * Emitted when a user clicks Show Liveboard details on a Liveboard
1679
+ * Emitted when a user clicks **Show Liveboard details** on a Liveboard
1306
1680
  *
1307
1681
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1682
+ * @example
1683
+ *```js
1684
+ * liveboardEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
1685
+ * console.log('Liveboard details', payload);
1686
+ * })
1687
+ *```
1308
1688
  */
1309
1689
  LiveboardInfo = "pinboardInfo",
1310
1690
  /**
1311
1691
  * Emitted when a user clicks on the Favorite icon on a Liveboard
1312
1692
  *
1313
1693
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1694
+ * @example
1695
+ *```js
1696
+ * liveboardEmbed.on(EmbedEvent.AddToFavorites, payload => {
1697
+ * console.log('favorites', payload);
1698
+ * })
1699
+ *```
1314
1700
  */
1315
1701
  AddToFavorites = "addToFavorites",
1316
1702
  /**
1317
- * Emitted when a user clicks Schedule on a Liveboard
1703
+ * Emitted when a user clicks **Schedule** on a Liveboard
1318
1704
  *
1319
1705
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1706
+ * @example
1707
+ *```js
1708
+ * liveboardEmbed.on(EmbedEvent.Schedule, payload => {
1709
+ * console.log(`Liveboard schedule', payload);
1710
+ * })
1711
+ *```
1320
1712
  */
1321
1713
  Schedule = "subscription",
1322
1714
  /**
1323
- * Emitted when a user clicks Edit on a Liveboard or visualization
1715
+ * Emitted when a user clicks **Edit** on a Liveboard or visualization
1324
1716
  *
1325
1717
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1718
+ * @example
1719
+ *```js
1720
+ * liveboardEmbed.on(EmbedEvent.Edit, payload => {
1721
+ * console.log(`Liveboard edit', payload);
1722
+ * })
1723
+ *```
1326
1724
  */
1327
1725
  Edit = "edit",
1328
1726
  /**
1329
- * Emitted when a user clicks Make a copy on a Liveboard
1727
+ * Emitted when a user clicks *Make a copy* on a Liveboard
1330
1728
  *
1331
1729
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1730
+ * @example
1731
+ *```js
1732
+ * liveboardEmbed.on(EmbedEvent.MakeACopy, payload => {
1733
+ * console.log(`Copy', payload);
1734
+ * })
1735
+ *```
1332
1736
  */
1333
1737
  MakeACopy = "makeACopy",
1334
1738
  /**
1335
- * Emitted when a user clicks Present on a Liveboard or visualization
1739
+ * Emitted when a user clicks **Present** on a Liveboard or visualization
1336
1740
  *
1337
1741
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1742
+ * @example
1743
+ *```js
1744
+ * liveboardEmbed.trigger(HostEvent.Present)
1745
+ *```
1746
+ *
1747
+ * @example
1748
+ *```js
1749
+ * liveboardEmbed.on(EmbedEvent.Present, {
1750
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1751
+ * })
1752
+ *```
1338
1753
  */
1339
1754
  Present = "present",
1340
1755
  /**
1341
- * Emitted when a user clicks Delete on a Liveboard
1756
+ * Emitted when a user clicks **Delete** on a visualization
1342
1757
  *
1343
1758
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1759
+ * @example
1760
+ *```js
1761
+ * liveboardEmbed.trigger(HostEvent.Delete,
1762
+ * {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1763
+ *```
1764
+ *
1344
1765
  */
1345
1766
  Delete = "delete",
1346
1767
  /**
1347
1768
  * Emitted when a user clicks Manage schedules on a Liveboard
1348
1769
  *
1349
1770
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1771
+ *
1772
+ * @example
1773
+ *```js
1774
+ * liveboardEmbed.trigger(HostEvent.SchedulesList)
1775
+ *```
1776
+ *
1350
1777
  */
1351
1778
  SchedulesList = "schedule-list",
1352
1779
  /**
1353
- * Emitted when a user clicks Cancel in edit mode on a Liveboard
1780
+ * Emitted when a user clicks **Cancel** in edit mode on a Liveboard
1354
1781
  *
1355
1782
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1783
+ *
1784
+ * @example
1785
+ *```js
1786
+ * liveboardEmbed.trigger(HostEvent.Cancel)
1787
+ *```
1788
+ *
1356
1789
  */
1357
1790
  Cancel = "cancel",
1358
1791
  /**
1359
- * Emitted when a user clicks Explore on a visualization
1792
+ * Emitted when a user clicks **Explore** on a visualization
1360
1793
  *
1361
1794
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1795
+ *
1796
+ * @example
1797
+ *```js
1798
+ * liveboardEmbed.trigger(HostEvent.Explore, {
1799
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1800
+ *```
1801
+ *
1362
1802
  */
1363
1803
  Explore = "explore",
1364
1804
  /**
1365
- * Emitted when a user clicks Copy link action on a visualization
1805
+ * Emitted when a user clicks **Copy link** action on a visualization
1366
1806
  *
1367
1807
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1808
+ *
1809
+ * @example
1810
+ *```js
1811
+ * liveboardEmbed.trigger(HostEvent.CopyLink, {
1812
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1813
+ *```
1814
+ *
1368
1815
  */
1369
1816
  CopyLink = "embedDocument",
1370
1817
  /**
1371
- * Emitted when a user interacts with cross filters on a visualization or liveboard
1818
+ * Emitted when a user interacts with cross filters on a visualization or Liveboard
1819
+ *
1820
+ * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
1821
+ *
1822
+ * @example
1823
+ *```js
1824
+ * liveboardEmbed.trigger(HostEvent.CrossFilterChanged, {
1825
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1826
+ *```
1372
1827
  *
1373
- * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
1374
1828
  */
1375
1829
  CrossFilterChanged = "cross-filter-changed",
1376
1830
  /**
1377
1831
  * Emitted when a user right clicks on a visualization (chart or table)
1378
1832
  *
1379
- * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
1833
+ * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
1834
+ *
1835
+ * @example
1836
+ *```js
1837
+ * LiveboardEmbed.on(EmbedEvent.VizPointRightClick, payload => {
1838
+ * console.log('VizPointClick', payload)
1839
+ * })
1840
+ *```
1380
1841
  */
1381
1842
  VizPointRightClick = "vizPointRightClick",
1382
1843
  /**
1383
- * Emitted when a user clicks on Insert to slide on a visualization
1844
+ * Emitted when a user clicks **Insert to slide** on a visualization
1384
1845
  *
1385
1846
  * @hidden
1386
1847
  */
@@ -1388,52 +1849,53 @@ export declare enum EmbedEvent {
1388
1849
  /**
1389
1850
  * @hidden
1390
1851
  * Emitted when a user changes any filter on a Liveboard.
1391
- * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
1852
+ * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.0.sw
1392
1853
  */
1393
1854
  FilterChanged = "filterChanged",
1394
1855
  /**
1395
- * Emitted when a user click on Go button in Sage Embed
1856
+ * Emitted when a user clicks the **Go** button on the Search page
1396
1857
  *
1397
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1858
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1398
1859
  */
1399
1860
  SageEmbedQuery = "sageEmbedQuery",
1400
1861
  /**
1401
- * Emitten when a user select data source in Sage Embed
1862
+ * Emitted when a user selects a data source.
1863
+ *
1864
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1402
1865
  *
1403
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1404
1866
  */
1405
1867
  SageWorksheetUpdated = "sageWorksheetUpdated",
1406
1868
  /**
1407
- * Emitted when a user updates a connection in Data tab
1869
+ * Emitted when a user updates a connection on the **Data** page
1408
1870
  *
1409
- * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
1871
+ * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
1410
1872
  */
1411
1873
  UpdateConnection = "updateConnection",
1412
1874
  /**
1413
- * Emitted when a user updates a connection in Data tab
1875
+ * Emitted when a user updates a connection on the **Data** page
1414
1876
  *
1415
- * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
1877
+ * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
1416
1878
  */
1417
1879
  CreateConnection = "createConnection",
1418
1880
  /**
1419
1881
  * Emitted when name, status (private or public) or filter values of a
1420
- * PersonalisedView is updated.
1882
+ * Personalised view is updated.
1421
1883
  *
1422
1884
  * @returns viewName: string
1423
1885
  * @returns viewId: string
1424
1886
  * @returns liveboardId: string
1425
1887
  * @returns isPublic: boolean
1426
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1888
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1427
1889
  */
1428
1890
  UpdatePersonalisedView = "updatePersonalisedView",
1429
1891
  /**
1430
- * Emitted when a PersonalisedView is saved.
1892
+ * Emitted when a Personalised view is saved.
1431
1893
  *
1432
1894
  * @returns viewName: string
1433
1895
  * @returns viewId: string
1434
1896
  * @returns liveboardId: string
1435
1897
  * @returns isPublic: boolean
1436
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1898
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1437
1899
  */
1438
1900
  SavePersonalisedView = "savePersonalisedView",
1439
1901
  /**
@@ -1443,7 +1905,7 @@ export declare enum EmbedEvent {
1443
1905
  * @returns viewId: string
1444
1906
  * @returns liveboardId: string
1445
1907
  * @returns isPublic: boolean
1446
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1908
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1447
1909
  */
1448
1910
  ResetLiveboard = "resetLiveboard",
1449
1911
  /**
@@ -1451,11 +1913,11 @@ export declare enum EmbedEvent {
1451
1913
  *
1452
1914
  * @returns views: string[]
1453
1915
  * @returns liveboardId: string
1454
- * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
1916
+ * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
1455
1917
  */
1456
1918
  DeletePersonalisedView = "deletePersonalisedView",
1457
1919
  /**
1458
- * Emitten when a user creates a new worksheet
1920
+ * Emitted when a user creates a new worksheet
1459
1921
  *
1460
1922
  * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
1461
1923
  */
@@ -1485,15 +1947,16 @@ export declare enum EmbedEvent {
1485
1947
  */
1486
1948
  export declare enum HostEvent {
1487
1949
  /**
1488
- * Triggers a search query in AppEmbed and SearchEmbed
1489
- * deployments.
1950
+ * Triggers a search operation with the search tokens specified in
1951
+ * the search query string.
1952
+ * Supported in `AppEmbed` and `SearchEmbed` deployments.
1490
1953
  * Includes the following properties:
1491
1954
  *
1492
- * @param - dataSourceIds - The data source GUID to Search on
1955
+ * @param - `searchQuery` - query string with search tokens
1956
+ * @param - `dataSources` - Data source GUID to Search on
1493
1957
  * - Although an array, only a single source
1494
1958
  * is supported.
1495
- * @param - searchQuery - Query string with search tokens
1496
- * @param - execute - executes the existing / updated query
1959
+ * @param - `execute` - executes search and updates the existing query
1497
1960
  * @example
1498
1961
  * ```js
1499
1962
  * searchembed.trigger(HostEvent.Search, {
@@ -1513,6 +1976,10 @@ export declare enum HostEvent {
1513
1976
  * @param - columnGuid - Optional. GUID of the column to drill
1514
1977
  * by. If not provided it will auto drill by the configured
1515
1978
  * column.
1979
+ * @param - autoDrillDown - Optional. If true, the drill down will be
1980
+ * done automatically on the most popular column.
1981
+ * @param - vizId [TS >= 9.8.0] - Optional. The GUID of the visualization to drill
1982
+ * in case of a liveboard.
1516
1983
  * @example
1517
1984
  * ```js
1518
1985
  * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
@@ -1529,6 +1996,25 @@ export declare enum HostEvent {
1529
1996
  * });
1530
1997
  * })
1531
1998
  * ```
1999
+ * @example
2000
+ * ```js
2001
+ * // Works with TS 9.8.0 and above
2002
+ *
2003
+ * liveboardEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
2004
+ * console.log(payload);
2005
+ * const clickedPoint = payload.data.clickedPoint;
2006
+ * const selectedPoint = payload.data.selectedPoints;
2007
+ * console.log('>>> called', clickedPoint);
2008
+ * liveboardEmbed.trigger(HostEvent.DrillDown, {
2009
+ * points: {
2010
+ * clickedPoint,
2011
+ * selectedPoints: selectedPoint
2012
+ * },
2013
+ * autoDrillDown: true,
2014
+ * vizId: payload.data.vizId
2015
+ * });
2016
+ * })
2017
+ * ```
1532
2018
  * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
1533
2019
  */
1534
2020
  DrillDown = "triggerDrillDown",
@@ -1545,7 +2031,7 @@ export declare enum HostEvent {
1545
2031
  */
1546
2032
  Reload = "reload",
1547
2033
  /**
1548
- * Sets the visible visualizations on a Liveboard.
2034
+ * Display specific visualizations on a Liveboard.
1549
2035
  *
1550
2036
  * @param - An array of GUIDs of the visualization to show. The visualization IDs not passed
1551
2037
  * in this parameter will be hidden.
@@ -1559,7 +2045,7 @@ export declare enum HostEvent {
1559
2045
  */
1560
2046
  SetVisibleVizs = "SetPinboardVisibleVizs",
1561
2047
  /**
1562
- * Set the Active Tab of a Liveboard.
2048
+ * Set a Liveboard tab as an active tab.
1563
2049
  *
1564
2050
  * @param - tabId - string of id of Tab to show
1565
2051
  * @example
@@ -1572,7 +2058,7 @@ export declare enum HostEvent {
1572
2058
  */
1573
2059
  SetActiveTab = "SetActiveTab",
1574
2060
  /**
1575
- * Updates runtime filters applied on a Saved Answer or Liveboard. The
2061
+ * Update runtime filters applied on a Saved Answer or Liveboard. The
1576
2062
  * runtime filters passed here are appended to the existing runtime
1577
2063
  * filters.
1578
2064
  * Pass an array of runtime filters with the following attributes:
@@ -1598,10 +2084,12 @@ export declare enum HostEvent {
1598
2084
  */
1599
2085
  UpdateRuntimeFilters = "UpdateRuntimeFilters",
1600
2086
  /**
1601
- * Navigate to a specific page in the embedded application without reloading the page.
2087
+ * Navigate to a specific page in the embedded ThoughtSpot application.
1602
2088
  * This is the same as calling `appEmbed.navigateToPage(path, true)`
1603
2089
  *
1604
- * @param - path - the path to navigate to (can be a number[1/-1] to go forward/back)
2090
+ * @param - `path` - the path to navigate to to go forward or back. The path value can
2091
+ * be a number; for example, `1`, `-1`.
2092
+ *
1605
2093
  * @example
1606
2094
  * ```js
1607
2095
  * appEmbed.navigateToPage(-1)
@@ -1610,7 +2098,7 @@ export declare enum HostEvent {
1610
2098
  */
1611
2099
  Navigate = "Navigate",
1612
2100
  /**
1613
- * Opens the filter panel for a particular column.
2101
+ * Open the filter panel for a particular column.
1614
2102
  * Works with Search and Liveboard embed.
1615
2103
  *
1616
2104
  * @param - { columnId: string,
@@ -1628,7 +2116,7 @@ export declare enum HostEvent {
1628
2116
  */
1629
2117
  OpenFilter = "openFilter",
1630
2118
  /**
1631
- * Adds columns to the current search query.
2119
+ * Add columns to the current search query.
1632
2120
  *
1633
2121
  * @param - { columnIds: string[] }
1634
2122
  * @example
@@ -1639,7 +2127,7 @@ export declare enum HostEvent {
1639
2127
  */
1640
2128
  AddColumns = "addColumns",
1641
2129
  /**
1642
- * Removes a column from the current search query.
2130
+ * Remove a column from the current search query.
1643
2131
  *
1644
2132
  * @param - { columnId: string }
1645
2133
  * @example
@@ -1650,27 +2138,29 @@ export declare enum HostEvent {
1650
2138
  */
1651
2139
  RemoveColumn = "removeColumn",
1652
2140
  /**
1653
- * Gets the current Liveboard content.
2141
+ * Get the transient state of a Liveboard as encoded content.
2142
+ * This includes unsaved and ad hoc changes such as
2143
+ * Liveboard filters, runtime filters applied on visualizations on a
2144
+ * Liveboard, and Liveboard layout, changes to visualizations such as
2145
+ * sorting, toggling of legends, and data drill down.
1654
2146
  *
1655
2147
  * @example
1656
2148
  * ```js
1657
- * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard)
2149
+ * liveboardEmbed.trigger(HostEvent.getexportrequestforcurrentpinboard).then(
2150
+ * data=>console.log(data))
1658
2151
  * ```
1659
2152
  * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1.sw
1660
2153
  */
1661
2154
  getExportRequestForCurrentPinboard = "getExportRequestForCurrentPinboard",
1662
2155
  /**
1663
- * Triggers the **Pin** action on an embedded object
2156
+ * Trigger the **Pin** action on an embedded object
1664
2157
  *
1665
2158
  * @param - Liveboard embed takes the `vizId` as a
1666
- * key. Can be left undefined when embedding Search, full app or
2159
+ * key. Can be left undefined when embedding Search, full app, or
1667
2160
  * a visualization.
1668
2161
  * @example
1669
2162
  * ```js
1670
- * liveboardEmbed.trigger(HostEvent.Pin, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
1671
- * ```
1672
- * ```js
1673
- * vizEmbed.trigger(HostEvent.Pin)
2163
+ * appEmbed.trigger(HostEvent.Pin)
1674
2164
  * ```
1675
2165
  * ```js
1676
2166
  * searchEmbed.trigger(HostEvent.Pin)
@@ -1679,17 +2169,18 @@ export declare enum HostEvent {
1679
2169
  */
1680
2170
  Pin = "pin",
1681
2171
  /**
1682
- * Triggers the **Show Liveboard details** action on a Liveboard
2172
+ * Trigger the **Show Liveboard details** action
2173
+ * on an embedded Liveboard.
1683
2174
  *
1684
2175
  * @example
1685
- * ```js
1686
- * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
1687
- * ```
2176
+ *```js
2177
+ * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
2178
+ *```
1688
2179
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
1689
2180
  */
1690
2181
  LiveboardInfo = "pinboardInfo",
1691
2182
  /**
1692
- * Triggers the **Schedule** action on a Liveboard
2183
+ * Trigger the **Schedule** action on an embedded Liveboard.
1693
2184
  *
1694
2185
  * @example
1695
2186
  * ```js
@@ -1699,7 +2190,7 @@ export declare enum HostEvent {
1699
2190
  */
1700
2191
  Schedule = "subscription",
1701
2192
  /**
1702
- * Triggers the **Manage schedule** action on a Liveboard
2193
+ * Trigger the **Manage schedule** action on an embedded Liveboard
1703
2194
  *
1704
2195
  * @example
1705
2196
  * ```js
@@ -1709,7 +2200,7 @@ export declare enum HostEvent {
1709
2200
  */
1710
2201
  SchedulesList = "schedule-list",
1711
2202
  /**
1712
- * Triggers the **Export TML** action on a Liveboard
2203
+ * Trigger the **Export TML** action on an embedded Liveboard.
1713
2204
  *
1714
2205
  * @example
1715
2206
  * ```js
@@ -1719,7 +2210,7 @@ export declare enum HostEvent {
1719
2210
  */
1720
2211
  ExportTML = "exportTSL",
1721
2212
  /**
1722
- * Triggers the **Edit TML** action on a Liveboard
2213
+ * Trigger the **Edit TML** action on an embedded Liveboard.
1723
2214
  *
1724
2215
  * @example
1725
2216
  * ```js
@@ -1729,7 +2220,7 @@ export declare enum HostEvent {
1729
2220
  */
1730
2221
  EditTML = "editTSL",
1731
2222
  /**
1732
- * Triggers the **Update TML** action on a Liveboard
2223
+ * Trigger the **Update TML** action on an embedded Liveboard.
1733
2224
  *
1734
2225
  * @example
1735
2226
  * ```js
@@ -1739,7 +2230,7 @@ export declare enum HostEvent {
1739
2230
  */
1740
2231
  UpdateTML = "updateTSL",
1741
2232
  /**
1742
- * Triggers the **Download PDF** action on a Liveboard
2233
+ * Trigger the **Download PDF** action on an embedded Liveboard.
1743
2234
  *
1744
2235
  * @example
1745
2236
  * ```js
@@ -1749,8 +2240,8 @@ export declare enum HostEvent {
1749
2240
  */
1750
2241
  DownloadAsPdf = "downloadAsPdf",
1751
2242
  /**
1752
- * Triggers the **Make a copy** action on a Liveboard, Search, or
1753
- * visualization page
2243
+ * Trigger the **Make a copy** action on a Liveboard, Search, or
2244
+ * visualization page.
1754
2245
  *
1755
2246
  * @example
1756
2247
  * ```js
@@ -1766,7 +2257,7 @@ export declare enum HostEvent {
1766
2257
  */
1767
2258
  MakeACopy = "makeACopy",
1768
2259
  /**
1769
- * Triggers the **Delete** action on a Liveboard
2260
+ * Trigger the **Delete** action for a Liveboard.
1770
2261
  *
1771
2262
  * @example
1772
2263
  * ```js
@@ -1776,7 +2267,7 @@ export declare enum HostEvent {
1776
2267
  */
1777
2268
  Remove = "delete",
1778
2269
  /**
1779
- * Triggers the **Explore* action on a visualization
2270
+ * Trigger the **Explore** action on a visualization.
1780
2271
  *
1781
2272
  * @param - an object with `vizId` as a key
1782
2273
  * @example
@@ -1787,7 +2278,7 @@ export declare enum HostEvent {
1787
2278
  */
1788
2279
  Explore = "explore",
1789
2280
  /**
1790
- * Triggers the **Create alert** action on a visualization
2281
+ * Trigger the **Create alert** action on a visualization
1791
2282
  *
1792
2283
  * @param - an object with `vizId` as a key
1793
2284
  * @example
@@ -1800,7 +2291,7 @@ export declare enum HostEvent {
1800
2291
  */
1801
2292
  CreateMonitor = "createMonitor",
1802
2293
  /**
1803
- * Triggers the **Manage alerts** action on a visualization
2294
+ * Trigger the **Manage alerts** action on a visualization
1804
2295
  *
1805
2296
  * @param - an object with `vizId` as a key
1806
2297
  * @example
@@ -1813,7 +2304,7 @@ export declare enum HostEvent {
1813
2304
  */
1814
2305
  ManageMonitor = "manageMonitor",
1815
2306
  /**
1816
- * Triggers the **Edit** action on a Liveboard or visualization
2307
+ * Trigger the **Edit** action on a Liveboard or visualization
1817
2308
  *
1818
2309
  * @param - object - To trigger the action for a specific visualization
1819
2310
  * in Liveboard embed, pass in `vizId` as a key.
@@ -1834,7 +2325,7 @@ export declare enum HostEvent {
1834
2325
  */
1835
2326
  Edit = "edit",
1836
2327
  /**
1837
- * Triggers the **Copy link** action on a Liveboard or visualization
2328
+ * Trigger the **Copy link** action on a Liveboard or visualization
1838
2329
  *
1839
2330
  * @param - object - to trigger the action for a
1840
2331
  * specific visualization in Liveboard embed, pass in `vizId` as a key
@@ -1852,7 +2343,7 @@ export declare enum HostEvent {
1852
2343
  */
1853
2344
  CopyLink = "embedDocument",
1854
2345
  /**
1855
- * Triggers the **Present** action on a Liveboard or visualization
2346
+ * Trigger the **Present** action on a Liveboard or visualization
1856
2347
  *
1857
2348
  * @param - object - to trigger the action for a specific visualization
1858
2349
  * in Liveboard embed, pass in `vizId` as a key
@@ -1870,7 +2361,7 @@ export declare enum HostEvent {
1870
2361
  */
1871
2362
  Present = "present",
1872
2363
  /**
1873
- * Gets TML for the current search.
2364
+ * Get TML for the current search.
1874
2365
  *
1875
2366
  * @example
1876
2367
  * ```js
@@ -1885,7 +2376,7 @@ export declare enum HostEvent {
1885
2376
  */
1886
2377
  GetTML = "getTML",
1887
2378
  /**
1888
- * Triggers the **Show underlying data** action on visualization or search
2379
+ * Trigger the **Show underlying data** action on visualization or search
1889
2380
  *
1890
2381
  * @param - an object with vizId as a key
1891
2382
  * @example
@@ -1903,7 +2394,9 @@ export declare enum HostEvent {
1903
2394
  */
1904
2395
  ShowUnderlyingData = "showUnderlyingData",
1905
2396
  /**
1906
- * Triggers the **Delete** action on visualization or search
2397
+ * Trigger the **Delete** action for a visualization
2398
+ * in an embedded Liveboard, or a chart or table
2399
+ * generated from Search.
1907
2400
  *
1908
2401
  * @param - Liveboard embed takes an object with `vizId` as a key.
1909
2402
  * Can be left empty if embedding Search or visualization.
@@ -1913,16 +2406,13 @@ export declare enum HostEvent {
1913
2406
  * '730496d6-6903-4601-937e-2c691821af3c'})
1914
2407
  * ```
1915
2408
  * ```js
1916
- * vizEmbed.trigger(HostEvent.Delete)
1917
- * ```
1918
- * ```js
1919
2409
  * searchEmbed.trigger(HostEvent.Delete)
1920
2410
  * ```
1921
2411
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
1922
2412
  */
1923
2413
  Delete = "onDeleteAnswer",
1924
2414
  /**
1925
- * Triggers the **SpotIQ analyze** action on visualization
2415
+ * Trigger the **SpotIQ analyze** action on visualization
1926
2416
  * or search.
1927
2417
  *
1928
2418
  * @param - Liveboard embed takes `vizId` as a
@@ -1943,7 +2433,7 @@ export declare enum HostEvent {
1943
2433
  */
1944
2434
  SpotIQAnalyze = "spotIQAnalyze",
1945
2435
  /**
1946
- * Triggers the **Download** action on charts in
2436
+ * Trigger the **Download** action on charts in
1947
2437
  * the embedded view.
1948
2438
  *
1949
2439
  * @example
@@ -1952,17 +2442,15 @@ export declare enum HostEvent {
1952
2442
  * '730496d6-6903-4601-937e-2c691821af3c'})
1953
2443
  * ```
1954
2444
  * ```js
1955
- * vizEmbed.trigger(HostEvent.Download)
2445
+ * embed.trigger(HostEvent.Download)
1956
2446
  * ```
1957
- * ```js
1958
- * searchEmbed.trigger(HostEvent.Download)
1959
- * ```
1960
- * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw ,Use {@link DownloadAsPng}
2447
+ * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw
2448
+ * Use {@link DownloadAsPng}
1961
2449
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
1962
2450
  */
1963
2451
  Download = "downloadAsPng",
1964
2452
  /**
1965
- * Triggers the **Download** > **PNG** action on
2453
+ * Trigger the **Download** > **PNG** action on
1966
2454
  * charts in the embedded view.
1967
2455
  *
1968
2456
  * @example
@@ -1978,7 +2466,7 @@ export declare enum HostEvent {
1978
2466
  */
1979
2467
  DownloadAsPng = "downloadAsPng",
1980
2468
  /**
1981
- * Triggers the **Download** > **CSV** action on tables in
2469
+ * Trigger the **Download** > **CSV** action on tables in
1982
2470
  * the embedded view.
1983
2471
  *
1984
2472
  * @example
@@ -1996,7 +2484,7 @@ export declare enum HostEvent {
1996
2484
  */
1997
2485
  DownloadAsCsv = "downloadAsCSV",
1998
2486
  /**
1999
- * Triggers the **Download** > **XLSX** action on tables
2487
+ * Trigger the **Download** > **XLSX** action on tables
2000
2488
  * in the embedded view.
2001
2489
  *
2002
2490
  * @example
@@ -2014,7 +2502,7 @@ export declare enum HostEvent {
2014
2502
  */
2015
2503
  DownloadAsXlsx = "downloadAsXLSX",
2016
2504
  /**
2017
- * Triggers the **Share** action on an embedded
2505
+ * Trigger the **Share** action on an embedded
2018
2506
  * Liveboard or Answer.
2019
2507
  *
2020
2508
  * @example
@@ -2028,7 +2516,7 @@ export declare enum HostEvent {
2028
2516
  */
2029
2517
  Share = "share",
2030
2518
  /**
2031
- * Triggers the **Save** action on a Liveboard or Answer.
2519
+ * Trigger the **Save** action on a Liveboard or Answer.
2032
2520
  * Saves the changes.
2033
2521
  *
2034
2522
  * @example
@@ -2042,7 +2530,7 @@ export declare enum HostEvent {
2042
2530
  */
2043
2531
  Save = "save",
2044
2532
  /**
2045
- * Triggers the **Sync to Sheets** action on an embedded visualization or Answer
2533
+ * Trigger the **Sync to Sheets** action on an embedded visualization or Answer
2046
2534
  * Sends data from an Answer or Liveboard visualization to a Google sheet.
2047
2535
  *
2048
2536
  * @param - an object with `vizId` as a key
@@ -2058,7 +2546,7 @@ export declare enum HostEvent {
2058
2546
  */
2059
2547
  SyncToSheets = "sync-to-sheets",
2060
2548
  /**
2061
- * Triggers the **Sync to Other Apps** action on an embedded visualization or Answer
2549
+ * Trigger the **Sync to Other Apps** action on an embedded visualization or Answer
2062
2550
  * Sends data from an Answer or Liveboard visualization to third-party apps such
2063
2551
  * as Slack, Salesforce, Microsoft Teams, ServiceNow and so on.
2064
2552
  *
@@ -2075,7 +2563,7 @@ export declare enum HostEvent {
2075
2563
  */
2076
2564
  SyncToOtherApps = "sync-to-other-apps",
2077
2565
  /**
2078
- * Triggers the **Manage pipelines** action on an embedded
2566
+ * Trigger the **Manage pipelines** action on an embedded
2079
2567
  * visualization or Answer.
2080
2568
  * Allows users to manage ThoughtSpot Sync pipelines.
2081
2569
  *
@@ -2092,18 +2580,21 @@ export declare enum HostEvent {
2092
2580
  */
2093
2581
  ManagePipelines = "manage-pipeline",
2094
2582
  /**
2095
- * Triggers the Reset search on the Search page
2583
+ * Reset search operation on the Search or Answer page.
2096
2584
  *
2097
2585
  * @example
2098
2586
  * ```js
2099
2587
  * searchEmbed.trigger(HostEvent.ResetSearch)
2100
2588
  * ```
2589
+ * ```js
2590
+ * appEmbed.trigger(HostEvent.ResetSearch)
2591
+ * ```
2101
2592
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.0.1.sw
2102
2593
  */
2103
2594
  ResetSearch = "resetSearch",
2104
2595
  /**
2105
2596
  * @hidden
2106
- * Gets the currents visible and runtime filters applied on a Liveboard
2597
+ * Get the currents visible and runtime filters applied on a Liveboard
2107
2598
  * @example
2108
2599
  * liveboardEmbed.trigger(HostEvent.GetFilters)
2109
2600
  * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
@@ -2111,7 +2602,7 @@ export declare enum HostEvent {
2111
2602
  GetFilters = "getFilters",
2112
2603
  /**
2113
2604
  * @hidden
2114
- * Updates the visible filters on the Liveboard.
2605
+ * Update the visible filters on the Liveboard.
2115
2606
  * @param - filter: filter object containing column name and filter operation and values
2116
2607
  * @example
2117
2608
  *
@@ -2124,7 +2615,7 @@ export declare enum HostEvent {
2124
2615
  */
2125
2616
  UpdateFilters = "updateFilters",
2126
2617
  /**
2127
- * Get Tab for the current Liveboard.
2618
+ * Get tab details for the current Liveboard.
2128
2619
  *
2129
2620
  * @example
2130
2621
  * ```js
@@ -2138,9 +2629,9 @@ export declare enum HostEvent {
2138
2629
  */
2139
2630
  GetTabs = "getTabs",
2140
2631
  /**
2141
- * Set the visible Tabs on a Liveboard.
2632
+ * Set the visible tabs on a Liveboard.
2142
2633
  *
2143
- * @param - an array of ids of Tabs to show, the ids not passed
2634
+ * @param - an array of ids of tabs to show, the IDs not passed
2144
2635
  * will be hidden.
2145
2636
  * @example
2146
2637
  * ```js
@@ -2154,8 +2645,8 @@ export declare enum HostEvent {
2154
2645
  /**
2155
2646
  * Set the hidden tabs on a Liveboard.
2156
2647
  *
2157
- * @param - an array of ids of Tabs to hide, the ids not passed
2158
- * will be shown.
2648
+ * @param - an array of the IDs of the tabs to hide.
2649
+ * The IDs not passed will be shown.
2159
2650
  * @example
2160
2651
  * ```js
2161
2652
  * liveboardEmbed.trigger(HostEvent.SetHiddenTabs, [
@@ -2166,9 +2657,12 @@ export declare enum HostEvent {
2166
2657
  */
2167
2658
  SetHiddenTabs = "SetPinboardHiddenTabs",
2168
2659
  /**
2169
- * Updates the search query for sage embed.
2660
+ * Updates the search query string for Natural Language Search operations.
2661
+ *
2662
+ * @param - `queryString`: Text string in Natural Language format
2663
+ *
2664
+ * @param - `executeSearch`: Boolean to execute search and update search query
2170
2665
  *
2171
- * @param - searchOptions: an object queryString and option to execute the query.
2172
2666
  * @example
2173
2667
  * ```js
2174
2668
  * sageEmbed.trigger(HostEvent.UpdateSageQuery, {
@@ -2176,7 +2670,7 @@ export declare enum HostEvent {
2176
2670
  * executeSearch: true,
2177
2671
  * })
2178
2672
  * ```
2179
- * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
2673
+ * @version SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
2180
2674
  */
2181
2675
  UpdateSageQuery = "updateSageQuery",
2182
2676
  /**
@@ -2189,24 +2683,25 @@ export declare enum HostEvent {
2189
2683
  * vizId: '123', // For Liveboard Visualization.
2190
2684
  * })
2191
2685
  * ```
2686
+ * @version SDK: 1.26.0 | Thoughtspot: 9.10.0.cl
2192
2687
  */
2193
2688
  GetAnswerSession = "getAnswerSession"
2194
2689
  }
2195
2690
  /**
2196
2691
  * The different visual modes that the data sources panel within
2197
- * search could appear in, i.e., hidden, collapsed, or expanded.
2692
+ * search could appear in, such as hidden, collapsed, or expanded.
2198
2693
  */
2199
2694
  export declare enum DataSourceVisualMode {
2200
2695
  /**
2201
- * Data source panel is hidden.
2696
+ * The data source panel is hidden.
2202
2697
  */
2203
2698
  Hidden = "hide",
2204
2699
  /**
2205
- * Data source panel is collapsed, but the user can manually expand it.
2700
+ * The data source panel is collapsed, but the user can manually expand it.
2206
2701
  */
2207
2702
  Collapsed = "collapse",
2208
2703
  /**
2209
- * Data source panel is expanded, but the user can manually collapse it.
2704
+ * The data source panel is expanded, but the user can manually collapse it.
2210
2705
  */
2211
2706
  Expanded = "expand"
2212
2707
  }
@@ -2282,7 +2777,10 @@ export declare enum Param {
2282
2777
  LiveboardHeaderSticky = "isLiveboardHeaderSticky",
2283
2778
  IsProductTour = "isProductTour",
2284
2779
  HideSearchBarTitle = "hideSearchBarTitle",
2285
- HideSageAnswerHeader = "hideSageAnswerHeader"
2780
+ HideSageAnswerHeader = "hideSageAnswerHeader",
2781
+ HideSearchBar = "hideSearchBar",
2782
+ ClientLogLevel = "clientLogLevel",
2783
+ OverrideNativeConsole = "overrideConsoleLogs"
2286
2784
  }
2287
2785
  /**
2288
2786
  * ThoughtSpot application pages include actions and menu commands
@@ -2342,9 +2840,11 @@ export declare enum Action {
2342
2840
  SaveAsView = "saveAsView",
2343
2841
  /**
2344
2842
  * The **Make a copy** action on a Liveboard or Answer
2345
- * page.
2346
- * Creates a copy of the Liveboard, visualization,
2347
- * or Answer.
2843
+ * page. Creates a copy of the Liveboard.
2844
+ * In LiveboardEmbed, the **Make a copy** action is not available for
2845
+ * visualizations in the embedded Liveboard view.
2846
+ * In AppEmbed, the **Make a copy** action is available on both
2847
+ * Liveboards and visualizations.
2348
2848
  *
2349
2849
  * @example
2350
2850
  * ```js
@@ -2528,7 +3028,7 @@ export declare enum Action {
2528
3028
  */
2529
3029
  DownloadAsPdf = "downloadAsPdf",
2530
3030
  /**
2531
- * The **Download** > **CSV** menu action for tables on a Liveboard
3031
+ * The **Download** > **CSV** menu action for tables on a Liveboard
2532
3032
  * or Answer page.
2533
3033
  * Downloads a visualization or Answer in the XLSX format.
2534
3034
  *
@@ -3059,6 +3559,7 @@ export declare enum Action {
3059
3559
  */
3060
3560
  RenameModalTitleDescription = "renameModalTitleDescription",
3061
3561
  /**
3562
+ *
3062
3563
  * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
3063
3564
  */
3064
3565
  RequestVerification = "requestVerification",
@@ -3194,4 +3695,12 @@ export interface CustomActionPayload {
3194
3695
  session: SessionInterface;
3195
3696
  vizId?: string;
3196
3697
  }
3698
+ export declare enum LogLevel {
3699
+ SILENT = "SILENT",
3700
+ ERROR = "ERROR",
3701
+ WARN = "WARN",
3702
+ INFO = "INFO",
3703
+ DEBUG = "DEBUG",
3704
+ TRACE = "TRACE"
3705
+ }
3197
3706
  //# sourceMappingURL=types.d.ts.map