@thoughtspot/visual-embed-sdk 1.40.1-alpha.1 → 1.41.0-pre-render-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. package/cjs/package.json +5 -4
  2. package/cjs/src/css-variables.d.ts +316 -0
  3. package/cjs/src/css-variables.d.ts.map +1 -1
  4. package/cjs/src/embed/app.d.ts.map +1 -1
  5. package/cjs/src/embed/app.js +8 -0
  6. package/cjs/src/embed/app.js.map +1 -1
  7. package/cjs/src/embed/app.spec.js +12 -2
  8. package/cjs/src/embed/app.spec.js.map +1 -1
  9. package/cjs/src/embed/bodyless-conversation.d.ts +1 -0
  10. package/cjs/src/embed/bodyless-conversation.d.ts.map +1 -1
  11. package/cjs/src/embed/bodyless-conversation.js +7 -3
  12. package/cjs/src/embed/bodyless-conversation.js.map +1 -1
  13. package/cjs/src/embed/conversation.d.ts +64 -2
  14. package/cjs/src/embed/conversation.d.ts.map +1 -1
  15. package/cjs/src/embed/conversation.js +16 -3
  16. package/cjs/src/embed/conversation.js.map +1 -1
  17. package/cjs/src/embed/conversation.spec.js +102 -0
  18. package/cjs/src/embed/conversation.spec.js.map +1 -1
  19. package/cjs/src/embed/liveboard.d.ts +12 -2
  20. package/cjs/src/embed/liveboard.d.ts.map +1 -1
  21. package/cjs/src/embed/liveboard.js +48 -18
  22. package/cjs/src/embed/liveboard.js.map +1 -1
  23. package/cjs/src/embed/liveboard.spec.js +211 -5
  24. package/cjs/src/embed/liveboard.spec.js.map +1 -1
  25. package/cjs/src/embed/sage.d.ts +1 -0
  26. package/cjs/src/embed/sage.d.ts.map +1 -1
  27. package/cjs/src/embed/sage.js +10 -6
  28. package/cjs/src/embed/sage.js.map +1 -1
  29. package/cjs/src/embed/search-bar.d.ts +1 -0
  30. package/cjs/src/embed/search-bar.d.ts.map +1 -1
  31. package/cjs/src/embed/search-bar.js +11 -7
  32. package/cjs/src/embed/search-bar.js.map +1 -1
  33. package/cjs/src/embed/search.d.ts +1 -0
  34. package/cjs/src/embed/search.d.ts.map +1 -1
  35. package/cjs/src/embed/search.js +7 -8
  36. package/cjs/src/embed/search.js.map +1 -1
  37. package/cjs/src/embed/ts-embed.d.ts +24 -7
  38. package/cjs/src/embed/ts-embed.d.ts.map +1 -1
  39. package/cjs/src/embed/ts-embed.js +87 -57
  40. package/cjs/src/embed/ts-embed.js.map +1 -1
  41. package/cjs/src/embed/ts-embed.spec.js +173 -1
  42. package/cjs/src/embed/ts-embed.spec.js.map +1 -1
  43. package/cjs/src/types.d.ts +152 -44
  44. package/cjs/src/types.d.ts.map +1 -1
  45. package/cjs/src/types.js +139 -42
  46. package/cjs/src/types.js.map +1 -1
  47. package/cjs/src/utils/liveboardService/liveboardService.d.ts +21 -6
  48. package/cjs/src/utils/liveboardService/liveboardService.d.ts.map +1 -1
  49. package/cjs/src/utils/liveboardService/liveboardService.js +21 -6
  50. package/cjs/src/utils/liveboardService/liveboardService.js.map +1 -1
  51. package/dist/index-BDlM0f0T.js +7371 -0
  52. package/dist/index-k7pkZMhx.js +7371 -0
  53. package/dist/src/css-variables.d.ts +316 -0
  54. package/dist/src/css-variables.d.ts.map +1 -1
  55. package/dist/src/embed/app.d.ts.map +1 -1
  56. package/dist/src/embed/bodyless-conversation.d.ts +5 -0
  57. package/dist/src/embed/bodyless-conversation.d.ts.map +1 -1
  58. package/dist/src/embed/conversation.d.ts +64 -2
  59. package/dist/src/embed/conversation.d.ts.map +1 -1
  60. package/dist/src/embed/liveboard.d.ts +11 -0
  61. package/dist/src/embed/liveboard.d.ts.map +1 -1
  62. package/dist/src/embed/sage.d.ts +1 -0
  63. package/dist/src/embed/sage.d.ts.map +1 -1
  64. package/dist/src/embed/search-bar.d.ts +1 -0
  65. package/dist/src/embed/search-bar.d.ts.map +1 -1
  66. package/dist/src/embed/search.d.ts +1 -0
  67. package/dist/src/embed/search.d.ts.map +1 -1
  68. package/dist/src/embed/ts-embed.d.ts +24 -0
  69. package/dist/src/embed/ts-embed.d.ts.map +1 -1
  70. package/dist/src/react/index.d.ts +2 -0
  71. package/dist/src/react/index.d.ts.map +1 -1
  72. package/dist/src/types.d.ts +351 -30
  73. package/dist/src/types.d.ts.map +1 -1
  74. package/dist/src/utils/graphql/nlsService/conversation-service.d.ts.map +1 -1
  75. package/dist/src/utils/liveboardService/liveboardService.d.ts +21 -6
  76. package/dist/src/utils/liveboardService/liveboardService.d.ts.map +1 -1
  77. package/dist/tsembed-react.es.js +551 -80
  78. package/dist/tsembed-react.js +550 -79
  79. package/dist/tsembed.es.js +572 -86
  80. package/dist/tsembed.js +571 -85
  81. package/dist/visual-embed-sdk-react-full.d.ts +787 -37
  82. package/dist/visual-embed-sdk-react.d.ts +787 -37
  83. package/dist/visual-embed-sdk.d.ts +785 -37
  84. package/lib/package.json +5 -4
  85. package/lib/src/css-variables.d.ts +316 -0
  86. package/lib/src/css-variables.d.ts.map +1 -1
  87. package/lib/src/embed/app.d.ts.map +1 -1
  88. package/lib/src/embed/app.js +8 -0
  89. package/lib/src/embed/app.js.map +1 -1
  90. package/lib/src/embed/app.spec.js +12 -2
  91. package/lib/src/embed/app.spec.js.map +1 -1
  92. package/lib/src/embed/bodyless-conversation.d.ts +1 -0
  93. package/lib/src/embed/bodyless-conversation.d.ts.map +1 -1
  94. package/lib/src/embed/bodyless-conversation.js +7 -3
  95. package/lib/src/embed/bodyless-conversation.js.map +1 -1
  96. package/lib/src/embed/conversation.d.ts +64 -2
  97. package/lib/src/embed/conversation.d.ts.map +1 -1
  98. package/lib/src/embed/conversation.js +17 -4
  99. package/lib/src/embed/conversation.js.map +1 -1
  100. package/lib/src/embed/conversation.spec.js +104 -2
  101. package/lib/src/embed/conversation.spec.js.map +1 -1
  102. package/lib/src/embed/liveboard.d.ts +12 -2
  103. package/lib/src/embed/liveboard.d.ts.map +1 -1
  104. package/lib/src/embed/liveboard.js +48 -18
  105. package/lib/src/embed/liveboard.js.map +1 -1
  106. package/lib/src/embed/liveboard.spec.js +211 -5
  107. package/lib/src/embed/liveboard.spec.js.map +1 -1
  108. package/lib/src/embed/sage.d.ts +1 -0
  109. package/lib/src/embed/sage.d.ts.map +1 -1
  110. package/lib/src/embed/sage.js +10 -6
  111. package/lib/src/embed/sage.js.map +1 -1
  112. package/lib/src/embed/search-bar.d.ts +1 -0
  113. package/lib/src/embed/search-bar.d.ts.map +1 -1
  114. package/lib/src/embed/search-bar.js +11 -7
  115. package/lib/src/embed/search-bar.js.map +1 -1
  116. package/lib/src/embed/search.d.ts +1 -0
  117. package/lib/src/embed/search.d.ts.map +1 -1
  118. package/lib/src/embed/search.js +7 -8
  119. package/lib/src/embed/search.js.map +1 -1
  120. package/lib/src/embed/ts-embed.d.ts +24 -7
  121. package/lib/src/embed/ts-embed.d.ts.map +1 -1
  122. package/lib/src/embed/ts-embed.js +87 -57
  123. package/lib/src/embed/ts-embed.js.map +1 -1
  124. package/lib/src/embed/ts-embed.spec.js +173 -1
  125. package/lib/src/embed/ts-embed.spec.js.map +1 -1
  126. package/lib/src/types.d.ts +152 -44
  127. package/lib/src/types.d.ts.map +1 -1
  128. package/lib/src/types.js +139 -42
  129. package/lib/src/types.js.map +1 -1
  130. package/lib/src/utils/liveboardService/liveboardService.d.ts +21 -6
  131. package/lib/src/utils/liveboardService/liveboardService.d.ts.map +1 -1
  132. package/lib/src/utils/liveboardService/liveboardService.js +21 -6
  133. package/lib/src/utils/liveboardService/liveboardService.js.map +1 -1
  134. package/lib/src/visual-embed-sdk.d.ts +786 -38
  135. package/package.json +6 -4
  136. package/src/css-variables.ts +396 -1
  137. package/src/embed/app.spec.ts +17 -2
  138. package/src/embed/app.ts +8 -0
  139. package/src/embed/bodyless-conversation.ts +8 -3
  140. package/src/embed/conversation.spec.ts +131 -5
  141. package/src/embed/conversation.ts +102 -12
  142. package/src/embed/liveboard.spec.ts +264 -5
  143. package/src/embed/liveboard.ts +55 -20
  144. package/src/embed/sage.ts +12 -7
  145. package/src/embed/search-bar.tsx +14 -7
  146. package/src/embed/search.ts +18 -7
  147. package/src/embed/ts-embed.spec.ts +345 -113
  148. package/src/embed/ts-embed.ts +97 -67
  149. package/src/types.ts +199 -91
  150. package/src/utils/liveboardService/liveboardService.ts +21 -6
@@ -354,6 +354,8 @@ export function useSpotterAgent(config: SpotterAgentEmbedViewConfig): {
354
354
  query: string;
355
355
  message: {
356
356
  worksheetId: string;
357
+ convId: any;
358
+ messageId: any;
357
359
  sessionId: any;
358
360
  genNo: any;
359
361
  acSessionId: any;
@@ -660,6 +662,7 @@ export declare class SearchBarEmbed extends TsEmbed {
660
662
  protected viewConfig: SearchBarViewConfig;
661
663
  protected embedComponentType: string;
662
664
  constructor(domSelector: string, viewConfig: SearchBarViewConfig);
665
+ protected getEmbedParamsObject(): Record<any, any>;
663
666
  /**
664
667
  * Render the embedded ThoughtSpot search
665
668
  */
@@ -812,6 +815,7 @@ export declare class SageEmbed extends V1Embed {
812
815
  */
813
816
  protected viewConfig: SageViewConfig;
814
817
  constructor(domSelector: DOMSelector, viewConfig: SageViewConfig);
818
+ protected getEmbedParamsObject(): Record<any, any>;
815
819
  /**
816
820
  * Constructs a map of parameters to be passed on to the
817
821
  * embedded Eureka or Sage search page.
@@ -1149,6 +1153,7 @@ export declare class SearchEmbed extends TsEmbed {
1149
1153
  };
1150
1154
  };
1151
1155
  protected getAppInitData(): Promise<SearchAppInitData>;
1156
+ protected getEmbedParamsObject(): Record<any, any>;
1152
1157
  protected getEmbedParams(): string;
1153
1158
  /**
1154
1159
  * Construct the URL of the embedded ThoughtSpot search to be
@@ -2129,6 +2134,17 @@ export declare class LiveboardEmbed extends V1Embed {
2129
2134
  * embedded Liveboard or visualization.
2130
2135
  */
2131
2136
  protected getEmbedParams(): string;
2137
+ protected getEmbedParamsObject(): any;
2138
+ /**
2139
+ * @hidden
2140
+ * Internal state to track the current liveboard id.
2141
+ * This is used to navigate to the correct liveboard when the prerender is visible.
2142
+ */
2143
+ currentLiveboardState: {
2144
+ liveboardId: string;
2145
+ vizId: string;
2146
+ activeTabId: string;
2147
+ };
2132
2148
  protected beforePrerenderVisible(): void;
2133
2149
  protected handleRenderForPrerender(): Promise<TsEmbed>;
2134
2150
  /**
@@ -2186,10 +2202,13 @@ export interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConf
2186
2202
  genNo: number;
2187
2203
  acSessionId: string;
2188
2204
  acGenNo: number;
2205
+ convId: string;
2206
+ messageId: string;
2189
2207
  }
2190
2208
  export declare class ConversationMessage extends TsEmbed {
2191
2209
  protected viewConfig: SpotterAgentMessageViewConfig;
2192
2210
  constructor(container: HTMLElement, viewConfig: SpotterAgentMessageViewConfig);
2211
+ protected getEmbedParamsObject(): Record<any, any>;
2193
2212
  getIframeSrc(): string;
2194
2213
  render(): Promise<ConversationMessage>;
2195
2214
  }
@@ -2233,6 +2252,8 @@ export declare class SpotterAgentEmbed {
2233
2252
  data?: undefined;
2234
2253
  } | {
2235
2254
  data: {
2255
+ convId: any;
2256
+ messageId: any;
2236
2257
  sessionId: any;
2237
2258
  genNo: any;
2238
2259
  acSessionId: any;
@@ -3272,12 +3293,14 @@ export interface HomePageConfig {
3272
3293
  * Hide list page columns
3273
3294
  * For example: hiddenListColumns = [ListPageColumns.Author]
3274
3295
  *
3275
- * **Note**: This option is available only in full app embedding.
3296
+ * **Note**: This option is available only in full app embedding. To use it, you need to import `ListPageColumns` enum.
3276
3297
  *
3277
3298
  * Supported embed types: `AppEmbed`
3278
3299
  * @version SDK: 1.38.0 | ThoughtSpot: 10.9.0.cl
3279
3300
  * @example
3280
3301
  * ```js
3302
+ * import { ListPageColumns } from '@thoughtspot/visual-embed-sdk';
3303
+ *
3281
3304
  * const embed = new AppEmbed('#tsEmbed', {
3282
3305
  * ... //other embed view config
3283
3306
  * hiddenListColumns : [ListPageColumns.Favorite,ListPageColumns.Author],
@@ -3292,11 +3315,14 @@ export interface HomePageConfig {
3292
3315
  * **Note**: This option does not apply to the classic homepage.
3293
3316
  * To access the updated modular homepage, set
3294
3317
  * `modularHomeExperience` to `true` (available as Early Access feature in 9.12.5.cl).
3318
+ * To use it, you need to import `HomepageModule` enum.
3295
3319
  *
3296
3320
  * Supported embed types: `AppEmbed`
3297
3321
  * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
3298
3322
  * @example
3299
3323
  * ```js
3324
+ * import { HomepageModule } from '@thoughtspot/visual-embed-sdk';
3325
+ *
3300
3326
  * const embed = new AppEmbed('#tsEmbed', {
3301
3327
  * ... //other embed view config
3302
3328
  * hiddenHomepageModules : [HomepageModule.Favorite,HomepageModule.Learning],
@@ -3311,11 +3337,14 @@ export interface HomePageConfig {
3311
3337
  * **Note**: This option does not apply to the classic homepage.
3312
3338
  * To access the updated modular homepage, set
3313
3339
  * `modularHomeExperience` to `true` (available as Early Access feature in 9.12.5.cl).
3340
+ * To use it, you need to import `HomepageModule` enum.
3314
3341
  *
3315
3342
  * Supported embed types: `AppEmbed`
3316
3343
  * @version SDK: 1.28.0| ThoughtSpot: 9.12.5.cl, 10.1.0.sw
3317
3344
  * @example
3318
3345
  * ```js
3346
+ * import { HomepageModule } from '@thoughtspot/visual-embed-sdk';
3347
+ *
3319
3348
  * const embed = new AppEmbed('#tsEmbed', {
3320
3349
  * ... //other embed view config
3321
3350
  * reorderedHomepageModules:[HomepageModule.Favorite,HomepageModule.MyLibrary],
@@ -3331,6 +3360,8 @@ export interface HomePageConfig {
3331
3360
  * Supported embed types: `AppEmbed`
3332
3361
  * @example
3333
3362
  * ```js
3363
+ * import { HomeLeftNavItem } from '@thoughtspot/visual-embed-sdk';
3364
+ *
3334
3365
  * const embed = new AppEmbed('#tsEmbed', {
3335
3366
  * ... //other embed view config
3336
3367
  * hiddenHomeLeftNavItems : [HomeLeftNavItem.Home,HomeLeftNavItem.Answers],
@@ -3340,6 +3371,7 @@ export interface HomePageConfig {
3340
3371
  * **Note**: This option does not apply to the classic homepage.
3341
3372
  * To access the updated modular homepage, set
3342
3373
  * `modularHomeExperience` to `true` (available as Early Access feature in 9.12.5.cl).
3374
+ * To use it, you need to import `HomeLeftNavItem` enum.
3343
3375
  * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
3344
3376
  */
3345
3377
  hiddenHomeLeftNavItems?: HomeLeftNavItem[];
@@ -4548,7 +4580,7 @@ export declare enum EmbedEvent {
4548
4580
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
4549
4581
  * @example
4550
4582
  *```js
4551
- * liveboardEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
4583
+ * liveboardEmbed.on(EmbedEvent.LiveboardInfo, payload => {
4552
4584
  * console.log('Liveboard details', payload);
4553
4585
  * })
4554
4586
  *```
@@ -4921,7 +4953,96 @@ export declare enum EmbedEvent {
4921
4953
  * @version SDK : 1.39.0 | ThoughtSpot : 10.10.0.cl
4922
4954
  * @hidden
4923
4955
  */
4924
- RequestVisibleEmbedCoordinates = "requestVisibleEmbedCoordinates"
4956
+ RequestVisibleEmbedCoordinates = "requestVisibleEmbedCoordinates",
4957
+ /**
4958
+ * Emitted when Spotter response is text data
4959
+ * @example
4960
+ * ```js
4961
+ * spotterEmbed.on(EmbedEvent.SpotterData, (payload) => {
4962
+ * console.log('payload', payload);
4963
+ * })
4964
+ *```
4965
+ * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
4966
+ */
4967
+ SpotterData = "SpotterData",
4968
+ /**
4969
+ * Emitted when user opens up the worksheet preview modal in Spotter embed.
4970
+ * @example
4971
+ * ```js
4972
+ * spotterEmbed.on(EmbedEvent.PreviewSpotterData, (payload) => {
4973
+ * console.log('payload', payload);
4974
+ * })
4975
+ *```
4976
+ * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
4977
+ */
4978
+ PreviewSpotterData = "PreviewSpotterData",
4979
+ /**
4980
+ * Emitted when the Spotter query is triggered in Spotter embed.
4981
+ * @example
4982
+ * ```js
4983
+ * spotterEmbed.on(EmbedEvent.SpotterQueryTriggered, (payload) => {
4984
+ * console.log('payload', payload);
4985
+ * })
4986
+ *```
4987
+ * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
4988
+ */
4989
+ SpotterQueryTriggered = "SpotterQueryTriggered",
4990
+ /**
4991
+ * Emitted when the last Spotter query is edited in Spotter embed.
4992
+ * @example
4993
+ * ```js
4994
+ * spotterEmbed.on(EmbedEvent.LastPromptEdited, (payload) => {
4995
+ * console.log('payload', payload);
4996
+ * })
4997
+ *```
4998
+ * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
4999
+ */
5000
+ LastPromptEdited = "LastPromptEdited",
5001
+ /**
5002
+ * Emitted when the last Spotter query is deleted in Spotter embed.
5003
+ * @example
5004
+ * ```js
5005
+ * spotterEmbed.on(EmbedEvent.LastPromptDeleted, (payload) => {
5006
+ * console.log('payload', payload);
5007
+ * })
5008
+ *```
5009
+ * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
5010
+ */
5011
+ LastPromptDeleted = "LastPromptDeleted",
5012
+ /**
5013
+ * Emitted when the coversation is reset in spotter embed.
5014
+ * @example
5015
+ * ```js
5016
+ * spotterEmbed.on(EmbedEvent.ResetSpotterConversation, (payload) => {
5017
+ * console.log('payload', payload);
5018
+ * })
5019
+ *```
5020
+ * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
5021
+ */
5022
+ ResetSpotterConversation = "ResetSpotterConversation",
5023
+ /**
5024
+ * Emitted when the *Spotter* is initialized.
5025
+ * @example
5026
+ * ```js
5027
+ * spotterEmbed.on(EmbedEvent.SpotterInit, (payload) => {
5028
+ * console.log('payload', payload);
5029
+ * })
5030
+ *```
5031
+ * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
5032
+ */
5033
+ SpotterInit = "spotterInit",
5034
+ /**
5035
+ * @hidden
5036
+ * Triggers when the embed listener is ready to receive events.
5037
+ * This is used to trigger events after the embed container is loaded.
5038
+ * @example
5039
+ * ```js
5040
+ * liveboardEmbed.on(EmbedEvent.EmbedListenerReady, () => {
5041
+ * console.log('EmbedListenerReady');
5042
+ * })
5043
+ * ```
5044
+ */
5045
+ EmbedListenerReady = "EmbedListenerReady"
4925
5046
  }
4926
5047
  /**
4927
5048
  * Event types that can be triggered by the host application
@@ -4939,7 +5060,7 @@ export declare enum EmbedEvent {
4939
5060
  * // create the liveboard embed.
4940
5061
  *
4941
5062
  * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
4942
- * { columnName: 'state, operator: RuntimeFilterOp.EQ, values: ['california']}
5063
+ * { columnName: 'state', operator: RuntimeFilterOp.EQ, values: ["california"]}
4943
5064
  * ]);
4944
5065
  * ```
4945
5066
  * @example
@@ -5009,6 +5130,7 @@ export declare enum HostEvent {
5009
5130
  * done automatically on the most popular column.
5010
5131
  * @param - vizId [TS >= 9.8.0] - Optional. The GUID of the visualization to drill
5011
5132
  * in case of a Liveboard.
5133
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5012
5134
  * @example
5013
5135
  * ```js
5014
5136
  * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
@@ -5147,12 +5269,12 @@ export declare enum HostEvent {
5147
5269
  * Works with Search and Liveboard embed.
5148
5270
  * @param - { columnId: string,
5149
5271
  * name: string,
5150
- * type: INT64/CHAR/DATE,
5151
- * dataType: ATTRIBUTE/MEASURE }
5272
+ * type: ATTRIBUTE/MEASURE,
5273
+ * dataType: INT64/CHAR/DATE }
5152
5274
  * @example
5153
5275
  * ```js
5154
5276
  * searchEmbed.trigger(HostEvent.OpenFilter,
5155
- * {column: { columnId: '<column-GUID>', name: 'column name', type: 'INT64', dataType: 'ATTRIBUTE'}})
5277
+ * {column: { columnId: '<column-GUID>', name: 'column name', type: 'ATTRIBUTE', dataType: 'INT64'}})
5156
5278
  * ```
5157
5279
  * @example
5158
5280
  * ```js
@@ -5210,6 +5332,7 @@ export declare enum HostEvent {
5210
5332
  * @param
5211
5333
  * `vizId`- GUID of the saved Answer or visualization to pin to a Liveboard.
5212
5334
  * Optional when pinning a new chart or table generated from a Search query.
5335
+ * **Required** in Spotter Embed.
5213
5336
  * @param
5214
5337
  * `liveboardID` - GUID of the Liveboard to pin an Answer. If there is no Liveboard,
5215
5338
  * specify the `newLiveboardName` parameter to create a new Liveboard.
@@ -5257,6 +5380,12 @@ export declare enum HostEvent {
5257
5380
  * ```js
5258
5381
  * appEmbed.trigger(HostEvent.Pin)
5259
5382
  * ```
5383
+ * @example
5384
+ * ```js
5385
+ * const pinResponse = await spotterEmbed.trigger(HostEvent.Pin, {
5386
+ * vizId:'730496d6-6903-4601-937e-2c691821af3c'
5387
+ * });
5388
+ * ```
5260
5389
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
5261
5390
  */
5262
5391
  Pin = "pin",
@@ -5321,12 +5450,21 @@ export declare enum HostEvent {
5321
5450
  * Trigger the **Download PDF** action on an embedded Liveboard,
5322
5451
  * visualization or Answer.
5323
5452
  *
5453
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5454
+ *
5324
5455
  * **NOTE**: The **Download** > **PDF** action is available on
5325
5456
  * visualizations and Answers if the data is in tabular format.
5326
5457
  * @example
5327
5458
  * ```js
5328
5459
  * liveboardEmbed.trigger(HostEvent.DownloadAsPdf)
5329
5460
  * ```
5461
+ * @example
5462
+ * ```js
5463
+ * spotterEmbed.trigger(HostEvent.DownloadAsPdf, {
5464
+ * vizId:'730496d6-6903-4601-937e-2c691821af3c'
5465
+ * });
5466
+ * ```
5467
+ *
5330
5468
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
5331
5469
  */
5332
5470
  DownloadAsPdf = "downloadAsPdf",
@@ -5350,6 +5488,12 @@ export declare enum HostEvent {
5350
5488
  * ```js
5351
5489
  * searchEmbed.trigger(HostEvent.MakeACopy)
5352
5490
  * ```
5491
+ * @example
5492
+ * ```js
5493
+ * const pinResponse = await spotterEmbed.trigger(HostEvent.MakeACopy, {
5494
+ * vizId:'730496d6-6903-4601-937e-2c691821af3c'
5495
+ * });
5496
+ * ```
5353
5497
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
5354
5498
  */
5355
5499
  MakeACopy = "makeACopy",
@@ -5422,6 +5566,8 @@ export declare enum HostEvent {
5422
5566
  * This event is not supported in visualization embed and search embed.
5423
5567
  * @param - object - To trigger the action for a specific visualization
5424
5568
  * in Liveboard embed, pass in `vizId` as a key.
5569
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5570
+ *
5425
5571
  * @example
5426
5572
  * ```js
5427
5573
  * liveboardEmbed.trigger(HostEvent.Edit)
@@ -5430,6 +5576,18 @@ export declare enum HostEvent {
5430
5576
  * liveboardEmbed.trigger(HostEvent.Edit, {vizId:
5431
5577
  * '730496d6-6903-4601-937e-2c691821af3c'})
5432
5578
  * ```
5579
+ * @example
5580
+ * ```js
5581
+ * const pinResponse = await spotterEmbed.trigger(HostEvent.Edit, {
5582
+ * vizId:'730496d6-6903-4601-937e-2c691821af3c'
5583
+ * });
5584
+ * ```
5585
+ * @example
5586
+ * ```js
5587
+ * const editResponse = await spotterEmbed.trigger(HostEvent.Edit, {
5588
+ * vizId:'730496d6-6903-4601-937e-2c691821af3c'
5589
+ * });
5590
+ * ```
5433
5591
  * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
5434
5592
  */
5435
5593
  Edit = "edit",
@@ -5477,6 +5635,16 @@ export declare enum HostEvent {
5477
5635
  * );
5478
5636
  * })
5479
5637
  * ```
5638
+ * @example
5639
+ * ```js
5640
+ * spotterEmbed.trigger(HostEvent.GetTML, {
5641
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'
5642
+ * }).then((tml) => {
5643
+ * console.log(
5644
+ * tml.answer.search_query // TML representation of the search query
5645
+ * );
5646
+ * })
5647
+ * ```
5480
5648
  * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1.sw
5481
5649
  * @important
5482
5650
  */
@@ -5540,6 +5708,7 @@ export declare enum HostEvent {
5540
5708
  /**
5541
5709
  * Trigger the **Download** action on charts in
5542
5710
  * the embedded view.
5711
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5543
5712
  * @example
5544
5713
  * ```js
5545
5714
  * liveboardEmbed.trigger(HostEvent.Download, {vizId:
@@ -5548,6 +5717,11 @@ export declare enum HostEvent {
5548
5717
  * ```js
5549
5718
  * embed.trigger(HostEvent.Download)
5550
5719
  * ```
5720
+ * ```js
5721
+ * spotterEmbed.trigger(HostEvent.Download, {
5722
+ * vizId:'730496d6-6903-4601-937e-2c691821af3c'
5723
+ * });
5724
+ * ```
5551
5725
  * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw
5552
5726
  * Use {@link DownloadAsPng}
5553
5727
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
@@ -5564,13 +5738,19 @@ export declare enum HostEvent {
5564
5738
  * vizEmbed.trigger(HostEvent.DownloadAsPng)
5565
5739
  *
5566
5740
  * searchEmbed.trigger(HostEvent.DownloadAsPng)
5741
+ *
5742
+ * spotterEmbed.trigger(HostEvent.DownloadAsPng, {
5743
+ * vizId:"730496d6-6903-4601-937e-2c691821af3c"
5744
+ * })
5567
5745
  * ```
5746
+ *
5568
5747
  * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.1.sw
5569
5748
  */
5570
5749
  DownloadAsPng = "downloadAsPng",
5571
5750
  /**
5572
5751
  * Trigger the **Download** > **CSV** action on tables in
5573
5752
  * the embedded view.
5753
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5574
5754
  * @example
5575
5755
  * ```js
5576
5756
  * liveboardEmbed.trigger(HostEvent.DownloadAsCsv, {vizId:
@@ -5582,12 +5762,18 @@ export declare enum HostEvent {
5582
5762
  * ```js
5583
5763
  * searchEmbed.trigger(HostEvent.DownloadAsCsv)
5584
5764
  * ```
5765
+ * ```js
5766
+ * spotterEmbed.trigger(HostEvent.DownloadAsCsv, {
5767
+ * vizId:"730496d6-6903-4601-937e-2c691821af3c"
5768
+ * })
5769
+ * ```
5585
5770
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
5586
5771
  */
5587
5772
  DownloadAsCsv = "downloadAsCSV",
5588
5773
  /**
5589
5774
  * Trigger the **Download** > **XLSX** action on tables
5590
5775
  * in the embedded view.
5776
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5591
5777
  * @example
5592
5778
  * ```js
5593
5779
  * liveboardEmbed.trigger(HostEvent.DownloadAsXlsx, {vizId:
@@ -5599,6 +5785,11 @@ export declare enum HostEvent {
5599
5785
  * ```js
5600
5786
  * searchEmbed.trigger(HostEvent.DownloadAsXlsx)
5601
5787
  * ```
5788
+ * ```js
5789
+ * spotterEmbed.trigger(HostEvent.downloadAsXLSX, {
5790
+ * vizId:"730496d6-6903-4601-937e-2c691821af3c"
5791
+ * })
5792
+ * ```
5602
5793
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
5603
5794
  */
5604
5795
  DownloadAsXlsx = "downloadAsXLSX",
@@ -5618,6 +5809,7 @@ export declare enum HostEvent {
5618
5809
  /**
5619
5810
  * Trigger the **Save** action on a Liveboard or Answer.
5620
5811
  * Saves the changes.
5812
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5621
5813
  * @example
5622
5814
  * ```js
5623
5815
  * liveboardEmbed.trigger(HostEvent.Save)
@@ -5625,6 +5817,11 @@ export declare enum HostEvent {
5625
5817
  * ```js
5626
5818
  * searchEmbed.trigger(HostEvent.Save)
5627
5819
  * ```
5820
+ * ```js
5821
+ * spotterEmbed.trigger(HostEvent.Save, {
5822
+ * vizId:"730496d6-6903-4601-937e-2c691821af3c"
5823
+ * })
5824
+ * ```
5628
5825
  * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
5629
5826
  */
5630
5827
  Save = "save",
@@ -5908,7 +6105,7 @@ export declare enum HostEvent {
5908
6105
  ResetLiveboardPersonalisedView = "ResetLiveboardPersonalisedView",
5909
6106
  /**
5910
6107
  * Triggers an action to update Parameter values on embedded
5911
- * Answers and Liveboard.
6108
+ * Answers, Liveboard and Spotter answer in Edit mode.
5912
6109
  *
5913
6110
  * @example
5914
6111
  * ```js
@@ -5922,11 +6119,19 @@ export declare enum HostEvent {
5922
6119
  UpdateParameters = "UpdateParameters",
5923
6120
  /**
5924
6121
  * Triggers GetParameters to fetch the runtime Parameters.
6122
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5925
6123
  * ```js
5926
6124
  * liveboardEmbed.trigger(HostEvent.GetParameters).then((parameter) => {
5927
6125
  * console.log('parameters', parameter);
5928
6126
  * });
5929
6127
  *```
6128
+ *```js
6129
+ * spotterEmbed.trigger(HostEvent.GetParameters, {
6130
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c'
6131
+ * }).then((parameter) => {
6132
+ * console.log('parameters', parameter);
6133
+ * });
6134
+ *```
5930
6135
  * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
5931
6136
  */
5932
6137
  GetParameters = "GetParameters",
@@ -5958,7 +6163,7 @@ export declare enum HostEvent {
5958
6163
  * @param - optional attributes to set Answer properties.
5959
6164
  * `name` - Name string for the Answer.
5960
6165
  * `description` - Description text for the Answer.
5961
- *
6166
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
5962
6167
  * @example
5963
6168
  * ```js
5964
6169
  * const saveAnswerResponse = await searchEmbed.trigger(HostEvent.SaveAnswer, {
@@ -5966,6 +6171,14 @@ export declare enum HostEvent {
5966
6171
  * description: "Total sales by states in MidWest"
5967
6172
  * });
5968
6173
  * ```
6174
+ * @example
6175
+ * ```js
6176
+ * const saveAnswerResponse = await spotterEmbed.trigger(HostEvent.SaveAnswer, {
6177
+ * vizId: '730496d6-6903-4601-937e-2c691821af3c',
6178
+ * name: "Sales by states",
6179
+ * description: "Total sales by states in MidWest"
6180
+ * });
6181
+ * ```
5969
6182
  * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
5970
6183
  */
5971
6184
  SaveAnswer = "saveAnswer",
@@ -5994,6 +6207,70 @@ export declare enum HostEvent {
5994
6207
  * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl
5995
6208
  */
5996
6209
  TransformTableVizData = "TransformTableVizData",
6210
+ /**
6211
+ * Triggers a search operation with the search tokens specified in
6212
+ * the search query string in spotter embed.
6213
+ * @param - `query`: Text string in Natural Language format
6214
+ * @param - `executeSearch`: Boolean to execute search and update search query
6215
+ * @example
6216
+ * ```js
6217
+ * spotterEmbed.trigger(HostEvent.SpotterSearch, {
6218
+ * query: 'revenue per year',
6219
+ * executeSearch: true,
6220
+ * })
6221
+ * ```
6222
+ * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
6223
+ */
6224
+ SpotterSearch = "SpotterSearch",
6225
+ /**
6226
+ * Edits the last prompt in spotter embed.
6227
+ * @param - `query`: Text string
6228
+ * @example
6229
+ * ```js
6230
+ * spotterEmbed.trigger(HostEvent.EditLastPrompt, "revenue per year");
6231
+ * ```
6232
+ * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
6233
+ */
6234
+ EditLastPrompt = "EditLastPrompt",
6235
+ /**
6236
+ * Opens the Worksheet preview modal in Spotter Embed.
6237
+ * @example
6238
+ * ```js
6239
+ * spotterEmbed.trigger(HostEvent.PreviewSpotterData);
6240
+ * ```
6241
+ * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
6242
+ */
6243
+ PreviewSpotterData = "PreviewSpotterData",
6244
+ /**
6245
+ * Resets the Spotter Embed Conversation.
6246
+ * @example
6247
+ * ```js
6248
+ * spotterEmbed.trigger(HostEvent.ResetSpotterConversation);
6249
+ * ```
6250
+ * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
6251
+ */
6252
+ ResetSpotterConversation = "ResetSpotterConversation",
6253
+ /**
6254
+ * Deletes the last prompt in spotter embed.
6255
+ * @example
6256
+ * ```js
6257
+ * spotterEmbed.trigger(HostEvent.DeleteLastPrompt);
6258
+ * ```
6259
+ * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
6260
+ */
6261
+ DeleteLastPrompt = "DeleteLastPrompt",
6262
+ /**
6263
+ * Toggle the visualization to chart or table view.
6264
+ * @param - `vizId ` refers to the answer id in spotter Embed, it is required in spotter Embed.
6265
+ * @example
6266
+ * ```js
6267
+ * spotterEmbed.trigger(HostEvent.AnswerChartSwitcher, {
6268
+ * vizId:'b535c760-8bbe-4e6f-bb26-af56b4129a1e'
6269
+ * });
6270
+ *```
6271
+ * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
6272
+ */
6273
+ AnswerChartSwitcher = "answerChartSwitcher",
5997
6274
  /**
5998
6275
  * @hidden
5999
6276
  * Trigger exit from presentation mode when user exits fullscreen.
@@ -6016,7 +6293,28 @@ export declare enum HostEvent {
6016
6293
  *
6017
6294
  * @hidden
6018
6295
  */
6019
- VisibleEmbedCoordinates = "visibleEmbedCoordinates"
6296
+ VisibleEmbedCoordinates = "visibleEmbedCoordinates",
6297
+ /**
6298
+ * Trigger the *Ask Spotter* action for visualizations
6299
+ * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
6300
+ * @example
6301
+ * ```js
6302
+ * spotterEmbed.trigger(HostEvent.AskSpotter,
6303
+ * {vizId:'730496d6-6903-4601-937e-2c691821af3c'})
6304
+ * ```
6305
+ * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
6306
+ */
6307
+ AskSpotter = "AskSpotter",
6308
+ /**
6309
+ * @hidden
6310
+ * Triggers the update of the embed params.
6311
+ *
6312
+ * @example
6313
+ * ```js
6314
+ * liveboardEmbed.trigger(HostEvent.UpdateEmbedParams, viewConfig);
6315
+ * ```
6316
+ */
6317
+ UpdateEmbedParams = "updateEmbedParams"
6020
6318
  }
6021
6319
  /**
6022
6320
  * The different visual modes that the data sources panel within
@@ -6304,27 +6602,27 @@ export declare enum Action {
6304
6602
  */
6305
6603
  ConfigureFilter = "configureFilter",
6306
6604
  /**
6307
- * The **Collapse data sources** icon on the Search page.
6308
- * Collapses the panel showing data sources.
6309
- *
6310
- * @example
6311
- * ```js
6312
- * disabledActions: [Action.CollapseDataPanel]
6313
- * ```
6314
- * @version: SDK: 1.1.0 | ThoughtSpot Cloud: ts7.may.cl, 8.4.1.sw
6315
- */
6605
+ * The **Collapse data sources** icon on the Search page.
6606
+ * Collapses the panel showing data sources.
6607
+ *
6608
+ * @example
6609
+ * ```js
6610
+ * disabledActions: [Action.CollapseDataPanel]
6611
+ * ```
6612
+ * @version: SDK: 1.1.0 | ThoughtSpot Cloud: ts7.may.cl, 8.4.1.sw
6613
+ */
6316
6614
  CollapseDataSources = "collapseDataSources",
6317
6615
  /**
6318
- * The **Collapse data panel** icon on the Search page.
6319
- * Collapses the data panel view.
6320
- *
6321
- * @version: SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
6322
- *
6323
- * @example
6324
- * ```js
6325
- * disabledActions: [Action.CollapseDataPanel]
6326
- * ```
6327
- */
6616
+ * The **Collapse data panel** icon on the Search page.
6617
+ * Collapses the data panel view.
6618
+ *
6619
+ * @version: SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
6620
+ *
6621
+ * @example
6622
+ * ```js
6623
+ * disabledActions: [Action.CollapseDataPanel]
6624
+ * ```
6625
+ */
6328
6626
  CollapseDataPanel = "collapseDataPanel",
6329
6627
  /**
6330
6628
  * The **Choose sources** button on Search page.
@@ -7020,6 +7318,17 @@ export declare enum Action {
7020
7318
  * @version SDK: 1.25.0 | ThoughtSpot Cloud: 9.6.0.cl
7021
7319
  */
7022
7320
  EnableContextualChangeAnalysis = "enableContextualChangeAnalysis",
7321
+ /**
7322
+ * Action ID to hide or disable Iterative Change Analysis option
7323
+ * on contextual change analysis Inisght charts context menu
7324
+ *
7325
+ * @example
7326
+ * ```js
7327
+ * disabledActions: [Action.EnableIterativeChangeAnalysis]
7328
+ * ```
7329
+ * @version SDK: 1.41.0 | ThoughtSpot Cloud: 9.12.0.cl
7330
+ */
7331
+ EnableIterativeChangeAnalysis = "enableIterativeChangeAnalysis",
7023
7332
  /**
7024
7333
  * Action ID to hide or disable Natural Language Search query.
7025
7334
  *
@@ -7388,7 +7697,40 @@ export declare enum Action {
7388
7697
  * ```
7389
7698
  * @version SDK: 1.39.0 | ThoughtSpot Cloud: 10.10.0.cl
7390
7699
  */
7391
- InConversationTraining = "InConversationTraining"
7700
+ InConversationTraining = "InConversationTraining",
7701
+ /**
7702
+ * Action ID to hide the warnings banner in
7703
+ * Spotter results. It's an EA feature and
7704
+ * handled by LD.
7705
+ * @example
7706
+ * ```js
7707
+ * hiddenAction: [Action.SpotterWarningsBanner]
7708
+ * ```
7709
+ * @version SDK: 1.41.0 | ThoughtSpot Cloud: 10.13.0.cl
7710
+ */
7711
+ SpotterWarningsBanner = "SpotterWarningsBanner",
7712
+ /**
7713
+ * Action ID to hide the warnings border on the knowledge
7714
+ * card in Spotter results. It's an EA feature and
7715
+ * handled by LD.
7716
+ * @example
7717
+ * ```js
7718
+ * hiddenAction: [Action.SpotterWarningsOnTokens]
7719
+ * ```
7720
+ * @version SDK: 1.41.0 | ThoughtSpot Cloud: 10.13.0.cl
7721
+ */
7722
+ SpotterWarningsOnTokens = "SpotterWarningsOnTokens",
7723
+ /**
7724
+ * Action ID to disable the click event handler on knowledge
7725
+ * card in Spotter results. It's an EA feature and
7726
+ * handled by LD.
7727
+ * @example
7728
+ * ```js
7729
+ * hiddenAction: [Action.SpotterTokenQuickEdit]
7730
+ * ```
7731
+ * @version SDK: 1.41.0 | ThoughtSpot Cloud: 10.13.0.cl
7732
+ */
7733
+ SpotterTokenQuickEdit = "SpotterTokenQuickEdit"
7392
7734
  }
7393
7735
  export interface AnswerServiceType {
7394
7736
  getAnswer?: (offset: number, batchSize: number) => any;
@@ -7582,7 +7924,8 @@ export interface SearchOptions {
7582
7924
  */
7583
7925
  export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAction'> {
7584
7926
  /**
7585
- * The ID of the data source object. For example, Model, View, or Table. Spotter uses this object to query data and generate Answers.
7927
+ * The ID of the data source object. For example, Model, View, or Table. Spotter uses
7928
+ * this object to query data and generate Answers.
7586
7929
  */
7587
7930
  worksheetId: string;
7588
7931
  /**
@@ -7665,6 +8008,66 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
7665
8008
  * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
7666
8009
  */
7667
8010
  hideSampleQuestions?: boolean;
8011
+ /**
8012
+ * The list of runtime filters to apply to a search Answer,
8013
+ * visualization, or Liveboard.
8014
+ *
8015
+ * Supported embed types: `SpotterEmbed`
8016
+ * @example
8017
+ * ```js
8018
+ * const embed = new SpotterEmbed('#tsEmbed', {
8019
+ * // other embed view config
8020
+ * runtimeFilters: [
8021
+ * {
8022
+ * columnName: 'color',
8023
+ * operator: RuntimeFilterOp.EQ,
8024
+ * values: ['red'],
8025
+ * },
8026
+ * ],
8027
+ * })
8028
+ * ```
8029
+ * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
8030
+ */
8031
+ runtimeFilters?: RuntimeFilter[];
8032
+ /**
8033
+ * Flag to control whether runtime filters should be included in the URL.
8034
+ * If true, filters will be passed via app initialization payload instead.
8035
+ * If false/undefined, filters will be added to URL (default behavior).
8036
+ *
8037
+ * Supported embed types: `SpotterEmbed`
8038
+ * @default false
8039
+ * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
8040
+ */
8041
+ excludeRuntimeFiltersfromURL?: boolean;
8042
+ /**
8043
+ * The list of runtime parameters to apply to the conversation.
8044
+ *
8045
+ * Supported embed types: `SpotterEmbed`
8046
+ * @example
8047
+ * ```js
8048
+ * const embed = new SpotterEmbed('#tsEmbed', {
8049
+ * // other embed view config
8050
+ * runtimeParameters: [
8051
+ * {
8052
+ * name: 'Integer Param',
8053
+ * value: 10,
8054
+ * },
8055
+ * ],
8056
+ * })
8057
+ * ```
8058
+ * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
8059
+ */
8060
+ runtimeParameters?: RuntimeParameter[];
8061
+ /**
8062
+ * Flag to control whether runtime parameters should be included in the URL.
8063
+ * If true, parameters will be passed via app initialization payload instead.
8064
+ * If false/undefined, parameters will be added to URL (default behavior).
8065
+ *
8066
+ * Supported embed types: `SpotterEmbed`
8067
+ * @default false
8068
+ * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
8069
+ */
8070
+ excludeRuntimeParametersfromURL?: boolean;
7668
8071
  }
7669
8072
  /**
7670
8073
  * The configuration for the embedded spotterEmbed options.
@@ -7692,6 +8095,7 @@ export interface ConversationViewConfig extends SpotterEmbedViewConfig {
7692
8095
  export declare class SpotterEmbed extends TsEmbed {
7693
8096
  protected viewConfig: SpotterEmbedViewConfig;
7694
8097
  constructor(container: HTMLElement, viewConfig: SpotterEmbedViewConfig);
8098
+ protected getEmbedParamsObject(): Record<any, any>;
7695
8099
  getIframeSrc(): string;
7696
8100
  render(): Promise<SpotterEmbed>;
7697
8101
  }
@@ -8352,6 +8756,322 @@ export interface CustomCssVariables {
8352
8756
  * Background color of checkbox.
8353
8757
  */
8354
8758
  '--ts-var-checkbox-background-color'?: string;
8759
+ /**
8760
+ * Height of the tiles in the Liveboard.
8761
+ */
8762
+ '--ts-var-viz-tile-height'?: string;
8763
+ /**
8764
+ * Background color of the layout in the Liveboard.
8765
+ */
8766
+ '--ts-var-liveboard-layout-background'?: string;
8767
+ /**
8768
+ * Font color of the title of the layout in the Liveboard.
8769
+ */
8770
+ '--ts-var-liveboard-layout-title-color'?: string;
8771
+ /**
8772
+ * Font size of the title of the layout in the Liveboard.
8773
+ */
8774
+ '--ts-var-liveboard-layout-title-fontsize'?: string;
8775
+ /**
8776
+ * Background color of the header in the Liveboard.
8777
+ */
8778
+ '--ts-var-liveboard-header-background'?: string;
8779
+ /**
8780
+ * Font size of the header in the Liveboard.
8781
+ */
8782
+ '--ts-var-liveboard-header-fontsize'?: string;
8783
+ /**
8784
+ * Font color of the header in the Liveboard.
8785
+ */
8786
+ '--ts-var-liveboard-header-font-color'?: string;
8787
+ /**
8788
+ * Border color of the tiles in the Liveboard.
8789
+ */
8790
+ '--ts-var-liveboard-tile-border-color'?: string;
8791
+ /**
8792
+ * Background color of the tiles in the Liveboard.
8793
+ */
8794
+ '--ts-var-liveboard-tile-background'?: string;
8795
+ /**
8796
+ * Border radius of the tiles in the Liveboard.
8797
+ */
8798
+ '--ts-var-liveboard-tile-border-radius'?: string;
8799
+ /**
8800
+ * Padding of the tiles in the Liveboard.
8801
+ */
8802
+ '--ts-var-liveboard-tile-padding'?: string;
8803
+ /**
8804
+ * Background color of the table header in the Liveboard.
8805
+ */
8806
+ '--ts-var-liveboard-tile-table-header-background'?: string;
8807
+ /**
8808
+ * Padding of the groups in the Liveboard.
8809
+ */
8810
+ '--ts-var-liveboard-group-padding'?: string;
8811
+ /**
8812
+ * Padding of the title of the groups in the Liveboard.
8813
+ */
8814
+ '--ts-var-liveboard-group-title-padding'?: string;
8815
+ /**
8816
+ * Font size of the title of the groups in the Liveboard.
8817
+ */
8818
+ '--ts-var-liveboard-group-title-font-size'?: string;
8819
+ /**
8820
+ * Font weight of the title of the groups in the Liveboard.
8821
+ */
8822
+ '--ts-var-liveboard-group-title-font-weight'?: string;
8823
+ /**
8824
+ * Font size of the title of the tiles inside the groups in the Liveboard.
8825
+ */
8826
+ '--ts-var-liveboard-group-tile-title-font-size'?: string;
8827
+ /**
8828
+ * Font weight of the title of the tiles inside the groups in the Liveboard.
8829
+ */
8830
+ '--ts-var-liveboard-group-tile-title-font-weight'?: string;
8831
+ /**
8832
+ * Font size of the description of the groups in the Liveboard.
8833
+ */
8834
+ '--ts-var-liveboard-group-description-font-size'?: string;
8835
+ /**
8836
+ * Font weight of the description of the groups in the Liveboard.
8837
+ */
8838
+ '--ts-var-liveboard-group-description-font-weight'?: string;
8839
+ /**
8840
+ * Border of the tiles in the Liveboard.
8841
+ */
8842
+ '--ts-var-liveboard-group-tile-border'?: string;
8843
+ /**
8844
+ * Padding of the tiles in the Liveboard.
8845
+ */
8846
+ '--ts-var-liveboard-group-tile-padding'?: string;
8847
+ /**
8848
+ * Padding of the answer viz in the Liveboard.
8849
+ */
8850
+ '--ts-var-liveboard-answer-viz-padding'?: string;
8851
+ /**
8852
+ * Background color of the groups in the Liveboard.
8853
+ */
8854
+ '--ts-var-liveboard-group-background'?: string;
8855
+ /**
8856
+ * Border color of the groups in the Liveboard.
8857
+ */
8858
+ '--ts-var-liveboard-group-border-color'?: string;
8859
+ /**
8860
+ * Font color of the heading of the note title in the Liveboard.
8861
+ */
8862
+ '--ts-var-liveboard-notetitle-heading-font-color'?: string;
8863
+ /**
8864
+ * Font color of the body of the note title in the Liveboard.
8865
+ */
8866
+ '--ts-var-liveboard-notetitle-body-font-color'?: string;
8867
+ /**
8868
+ * Font color of the title of the groups in the Liveboard.
8869
+ */
8870
+ '--ts-var-liveboard-group-title-font-color'?: string;
8871
+ /**
8872
+ * Font color of the description of the groups in the Liveboard.
8873
+ */
8874
+ '--ts-var-liveboard-group-description-font-color'?: string;
8875
+ /**
8876
+ * Font color of the title of the tiles inside the groups in the Liveboard.
8877
+ */
8878
+ '--ts-var-liveboard-group-tile-title-font-color'?: string;
8879
+ /**
8880
+ * Background color of the tiles inside the groups in the Liveboard.
8881
+ */
8882
+ '--ts-var-liveboard-group-tile-background'?: string;
8883
+ /**
8884
+ * Background color of the chips in the Liveboard.
8885
+ */
8886
+ '--ts-var-liveboard-chip-background'?: string;
8887
+ /**
8888
+ * Font color of the chips in the Liveboard.
8889
+ */
8890
+ '--ts-var-liveboard-chip-color'?: string;
8891
+ /**
8892
+ * Background color of the chips in the Liveboard on hover.
8893
+ */
8894
+ '--ts-var-liveboard-chip--hover-background'?: string;
8895
+ /**
8896
+ * Font color of the chips in the Liveboard on hover.
8897
+ */
8898
+ '--ts-var-liveboard-chip--hover-color'?: string;
8899
+ /**
8900
+ * Background color of the chips in the Liveboard on active.
8901
+ */
8902
+ '--ts-var-liveboard-chip--active-background'?: string;
8903
+ /**
8904
+ * Font color of the chips in the Liveboard on active.
8905
+ */
8906
+ '--ts-var-liveboard-chip--active-color'?: string;
8907
+ /**
8908
+ * Width of the side panel in the Liveboard.
8909
+ */
8910
+ '--ts-var-side-panel-width'?: string;
8911
+ /**
8912
+ * Background color of the edit bar in the Liveboard.
8913
+ */
8914
+ '--ts-var-liveboard-edit-bar-background'?: string;
8915
+ /**
8916
+ * Breakpoint for the dual column layout in the Liveboard.
8917
+ */
8918
+ '--ts-var-liveboard-dual-column-breakpoint'?: string;
8919
+ /**
8920
+ * Breakpoint for the single column layout in the Liveboard.
8921
+ */
8922
+ '--ts-var-liveboard-single-column-breakpoint'?: string;
8923
+ /**
8924
+ * Background color of the cross filter layout in the Liveboard.
8925
+ */
8926
+ '--ts-var-liveboard-cross-filter-layout-background'?: string;
8927
+ /**
8928
+ * Border color of the active tab in the Liveboard.
8929
+ */
8930
+ '--ts-var-liveboard-tab-active-border-color'?: string;
8931
+ /**
8932
+ * Font color of the hover tab in the Liveboard.
8933
+ */
8934
+ '--ts-var-liveboard-tab-hover-color'?: string;
8935
+ /**
8936
+ * Font size of the title of the tiles in the Liveboard.
8937
+ */
8938
+ '--ts-var-liveboard-tile-title-fontsize'?: string;
8939
+ /**
8940
+ * Font weight of the title of the tiles in the Liveboard.
8941
+ */
8942
+ '--ts-var-liveboard-tile-title-fontweight'?: string;
8943
+ /**
8944
+ * Font weight of the description of the tiles in the Liveboard.
8945
+ */
8946
+ '--ts-var-liveboard-tile-description-font-weight'?: string;
8947
+ /**
8948
+ * Opacity of the description of the tiles in the Liveboard.
8949
+ */
8950
+ '--ts-var-liveboard-tile-description-opacity'?: string;
8951
+ /**
8952
+ * Background color of the parameter chips in the Liveboard.
8953
+ */
8954
+ '--ts-var-parameter-chip-background'?: string;
8955
+ /**
8956
+ * Font color of the parameter chips in the Liveboard.
8957
+ */
8958
+ '--ts-var-parameter-chip-text-color'?: string;
8959
+ /**
8960
+ * Background color of the parameter chips in the Liveboard on hover.
8961
+ */
8962
+ '--ts-var-parameter-chip-hover-background'?: string;
8963
+ /**
8964
+ * Font color of the parameter chips in the Liveboard on hover.
8965
+ */
8966
+ '--ts-var-parameter-chip-hover-text-color'?: string;
8967
+ /**
8968
+ * Background color of the parameter chips in the Liveboard on active.
8969
+ */
8970
+ '--ts-var-parameter-chip-active-background'?: string;
8971
+ /**
8972
+ * Font color of the parameter chips in the Liveboard on active.
8973
+ */
8974
+ '--ts-var-parameter-chip-active-text-color'?: string;
8975
+ /**
8976
+ * Background color of the action button in the Liveboard header.
8977
+ */
8978
+ '--ts-var-liveboard-header-action-button-background'?: string;
8979
+ /**
8980
+ * Font color of the action button in the Liveboard header.
8981
+ */
8982
+ '--ts-var-liveboard-header-action-button-font-color'?: string;
8983
+ /**
8984
+ * Font color of the action button in the Liveboard header on hover.
8985
+ */
8986
+ '--ts-var-liveboard-header-action-button-hover-color'?: string;
8987
+ /**
8988
+ * Font color of the action button in the Liveboard header on active.
8989
+ */
8990
+ '--ts-var-liveboard-header-action-button-active-color'?: string;
8991
+ /**
8992
+ * Background color of the badge in the Liveboard header.
8993
+ */
8994
+ '--ts-var-liveboard-header-badge-background'?: string;
8995
+ /**
8996
+ * Font color of the badge in the Liveboard header.
8997
+ */
8998
+ '--ts-var-liveboard-header-badge-font-color'?: string;
8999
+ /**
9000
+ * Background color of the modified badge in the Liveboard header.
9001
+ */
9002
+ '--ts-var-liveboard-header-badge-modified-background'?: string;
9003
+ /**
9004
+ * Font color of the modified badge in the Liveboard header.
9005
+ */
9006
+ '--ts-var-liveboard-header-badge-modified-font-color'?: string;
9007
+ /**
9008
+ * Font color of the badge in the Liveboard header on hover.
9009
+ */
9010
+ '--ts-var-liveboard-header-badge-hover-color'?: string;
9011
+ /**
9012
+ * Font color of the badge in the Liveboard header on active.
9013
+ */
9014
+ '--ts-var-liveboard-header-badge-active-color'?: string;
9015
+ /**
9016
+ * Font color of the hero text in the KPI widget.
9017
+ */
9018
+ '--ts-var-kpi-hero-color'?: string;
9019
+ /**
9020
+ * Font color of the comparison text in the KPI widget.
9021
+ */
9022
+ '--ts-var-kpi-comparison-color'?: string;
9023
+ /**
9024
+ * Font color of the analyze text in the KPI widget.
9025
+ */
9026
+ '--ts-var-kpi-analyze-text-color'?: string;
9027
+ /**
9028
+ * Font color of the legend title in the heatmap chart.
9029
+ */
9030
+ '--ts-var-chart-heatmap-legend-title-color'?: string;
9031
+ /**
9032
+ * Font color of the legend label in the heatmap chart.
9033
+ */
9034
+ '--ts-var-chart-heatmap-legend-label-color'?: string;
9035
+ /**
9036
+ * Font color of the legend title in the treemap chart.
9037
+ */
9038
+ '--ts-var-chart-treemap-legend-title-color'?: string;
9039
+ /**
9040
+ * Font color of the legend label in the treemap chart.
9041
+ */
9042
+ '--ts-var-chart-treemap-legend-label-color'?: string;
9043
+ /**
9044
+ * Color of the positive change in the KPI.
9045
+ */
9046
+ '--ts-var-kpi-positive-change-color'?: string;
9047
+ /**
9048
+ * Color of the negative change in the KPI.
9049
+ */
9050
+ '--ts-var-kpi-negative-change-color'?: string;
9051
+ /**
9052
+ * Background color of the change analysis insights.
9053
+ */
9054
+ '--ts-var-change-analysis-insights-background'?: string;
9055
+ /**
9056
+ * Background color of the forecasting card in the SpotIQ analyze.
9057
+ */
9058
+ '--ts-var-spotiq-analyze-forecasting-card-background'?: string;
9059
+ /**
9060
+ * Background color of the outlier card in the SpotIQ analyze.
9061
+ */
9062
+ '--ts-var-spotiq-analyze-outlier-card-background'?: string;
9063
+ /**
9064
+ * Background color of the trend card in the SpotIQ analyze.
9065
+ */
9066
+ '--ts-var-spotiq-analyze-trend-card-background'?: string;
9067
+ /**
9068
+ * Background color of the crosscorrelation card in the SpotIQ analyze.
9069
+ */
9070
+ '--ts-var-spotiq-analyze-crosscorrelation-card-background'?: string;
9071
+ /**
9072
+ * Background color of the summary header in the CCA modal.
9073
+ */
9074
+ '--ts-var-cca-modal-summary-header-background'?: string;
8355
9075
  }
8356
9076
 
8357
9077
  export interface SessionInterface {
@@ -8678,16 +9398,31 @@ export declare const getAnswerFromQuery: (query: string, worksheetId: string) =>
8678
9398
  }>;
8679
9399
 
8680
9400
  /**
8681
- * Create a liveboard with the given answers
8682
- * @param answers AnswerService[]
8683
- * @param name string
9401
+ * Creates a new Liveboard in ThoughtSpot using the provided AnswerService instances.
9402
+ *
9403
+ * Each answer will be added as a visualization to the newly created Liveboard.
9404
+ *
9405
+ * @param {AnswerService[]} answers - An array of initialized `AnswerService` instances
9406
+ * representing the answers to be added to the Liveboard.
9407
+ * @param {string} name - The name of the Liveboard to create.
8684
9408
  * @returns result Promise
8685
9409
  * @version SDK: 1.33.1 | ThoughtSpot: *
8686
9410
  * @example
8687
9411
  * ```js
8688
- * const lb = createLiveboardWithAnswers([
8689
- * new AnswerService(session, null, 'tshost'),
8690
- * ], "my-liveboard");
9412
+ * import { EmbedEvent, AnswerService } from "@thoughtspot/visual-embed-sdk";
9413
+ *
9414
+ * embed.on(EmbedEvent.Data, async () => {
9415
+ * try {
9416
+ * const answerService = await embed.getAnswerService();
9417
+ * const lb = await createLiveboardWithAnswers(
9418
+ * [answerService],
9419
+ * "My Liveboard"
9420
+ * );
9421
+ * console.log("Liveboard created:", lb);
9422
+ * } catch (err) {
9423
+ * console.error("Failed to create liveboard:", err);
9424
+ * }
9425
+ * });
8691
9426
  * ```
8692
9427
  */
8693
9428
  export declare const createLiveboardWithAnswers: (answers: AnswerService[], name: string) => Promise<any>;
@@ -8860,6 +9595,7 @@ export declare class TsEmbed {
8860
9595
  * @param query
8861
9596
  */
8862
9597
  protected getEmbedBasePath(query: string): string;
9598
+ protected getUpdateEmbedParamsObject(): Record<any, any>;
8863
9599
  /**
8864
9600
  * Common query params set for all the embed modes.
8865
9601
  * @param queryParams
@@ -8875,6 +9611,7 @@ export declare class TsEmbed {
8875
9611
  */
8876
9612
  protected getV1EmbedBasePath(queryString: string): string;
8877
9613
  protected getEmbedParams(): string;
9614
+ protected getEmbedParamsObject(): Record<any, any>;
8878
9615
  protected getRootIframeSrc(): string;
8879
9616
  protected createIframeEl(frameSrc: string): HTMLIFrameElement;
8880
9617
  protected handleInsertionIntoDOM(child: string | Node): void;
@@ -8966,6 +9703,19 @@ export declare class TsEmbed {
8966
9703
  * ```
8967
9704
  */
8968
9705
  off(messageType: EmbedEvent, callback: MessageCallback): typeof TsEmbed.prototype;
9706
+ /**
9707
+ * @hidden
9708
+ * Internal state to track if the embed container is loaded.
9709
+ * This is used to trigger events after the embed container is loaded.
9710
+ */
9711
+ isEmbedContainerLoaded: boolean;
9712
+ protected getPreRenderObj<T extends TsEmbed>(): T;
9713
+ /**
9714
+ * Executes a callback after the embed container is loaded.
9715
+ * @param callback The callback to execute
9716
+ */
9717
+ protected executeAfterEmbedContainerLoaded(callback: () => void): void;
9718
+ protected createEmbedContainerHandler: (source: EmbedEvent.AuthInit | EmbedEvent.EmbedListenerReady) => () => void;
8969
9719
  /**
8970
9720
  * Triggers an event to the embedded app
8971
9721
  * @param {HostEvent} messageType The event type