@thoughtspot/visual-embed-sdk 1.44.4 → 1.44.5

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 (122) hide show
  1. package/cjs/package.json +1 -1
  2. package/cjs/src/embed/app.d.ts +32 -0
  3. package/cjs/src/embed/app.d.ts.map +1 -1
  4. package/cjs/src/embed/app.js +7 -4
  5. package/cjs/src/embed/app.js.map +1 -1
  6. package/cjs/src/embed/app.spec.js +18 -7
  7. package/cjs/src/embed/app.spec.js.map +1 -1
  8. package/cjs/src/embed/conversation.d.ts +10 -6
  9. package/cjs/src/embed/conversation.d.ts.map +1 -1
  10. package/cjs/src/embed/conversation.js +12 -2
  11. package/cjs/src/embed/conversation.js.map +1 -1
  12. package/cjs/src/embed/conversation.spec.js +3 -0
  13. package/cjs/src/embed/conversation.spec.js.map +1 -1
  14. package/cjs/src/embed/embed.spec.js +1 -0
  15. package/cjs/src/embed/embed.spec.js.map +1 -1
  16. package/cjs/src/embed/liveboard.d.ts +32 -0
  17. package/cjs/src/embed/liveboard.d.ts.map +1 -1
  18. package/cjs/src/embed/liveboard.js +7 -4
  19. package/cjs/src/embed/liveboard.js.map +1 -1
  20. package/cjs/src/embed/liveboard.spec.js +46 -33
  21. package/cjs/src/embed/liveboard.spec.js.map +1 -1
  22. package/cjs/src/embed/pinboard.spec.js +1 -0
  23. package/cjs/src/embed/pinboard.spec.js.map +1 -1
  24. package/cjs/src/embed/search.d.ts.map +1 -1
  25. package/cjs/src/embed/search.js +6 -1
  26. package/cjs/src/embed/search.js.map +1 -1
  27. package/cjs/src/embed/search.spec.js +2 -0
  28. package/cjs/src/embed/search.spec.js.map +1 -1
  29. package/cjs/src/embed/ts-embed.d.ts.map +1 -1
  30. package/cjs/src/embed/ts-embed.js +7 -3
  31. package/cjs/src/embed/ts-embed.js.map +1 -1
  32. package/cjs/src/embed/ts-embed.spec.js +1 -0
  33. package/cjs/src/embed/ts-embed.spec.js.map +1 -1
  34. package/cjs/src/types.d.ts +140 -141
  35. package/cjs/src/types.d.ts.map +1 -1
  36. package/cjs/src/types.js +127 -117
  37. package/cjs/src/types.js.map +1 -1
  38. package/cjs/src/utils/graphql/answerService/answer-queries.d.ts +1 -1
  39. package/cjs/src/utils/graphql/answerService/answer-queries.d.ts.map +1 -1
  40. package/cjs/src/utils/graphql/answerService/answer-queries.js +0 -1
  41. package/cjs/src/utils/graphql/answerService/answer-queries.js.map +1 -1
  42. package/cjs/src/utils/graphql/answerService/answerService.spec.js +0 -1
  43. package/cjs/src/utils/graphql/answerService/answerService.spec.js.map +1 -1
  44. package/dist/{index-C5FAW929.js → index-_2rRJf4J.js} +1 -1
  45. package/dist/src/embed/app.d.ts +32 -0
  46. package/dist/src/embed/app.d.ts.map +1 -1
  47. package/dist/src/embed/conversation.d.ts +10 -6
  48. package/dist/src/embed/conversation.d.ts.map +1 -1
  49. package/dist/src/embed/liveboard.d.ts +32 -0
  50. package/dist/src/embed/liveboard.d.ts.map +1 -1
  51. package/dist/src/embed/search.d.ts.map +1 -1
  52. package/dist/src/embed/ts-embed.d.ts.map +1 -1
  53. package/dist/src/types.d.ts +140 -141
  54. package/dist/src/types.d.ts.map +1 -1
  55. package/dist/src/utils/graphql/answerService/answer-queries.d.ts +1 -1
  56. package/dist/src/utils/graphql/answerService/answer-queries.d.ts.map +1 -1
  57. package/dist/tsembed-react.es.js +169 -135
  58. package/dist/tsembed-react.js +168 -134
  59. package/dist/tsembed.es.js +169 -135
  60. package/dist/tsembed.js +168 -134
  61. package/dist/visual-embed-sdk-react-full.d.ts +207 -129
  62. package/dist/visual-embed-sdk-react.d.ts +207 -129
  63. package/dist/visual-embed-sdk.d.ts +212 -146
  64. package/lib/package.json +1 -1
  65. package/lib/src/embed/app.d.ts +32 -0
  66. package/lib/src/embed/app.d.ts.map +1 -1
  67. package/lib/src/embed/app.js +7 -4
  68. package/lib/src/embed/app.js.map +1 -1
  69. package/lib/src/embed/app.spec.js +18 -7
  70. package/lib/src/embed/app.spec.js.map +1 -1
  71. package/lib/src/embed/conversation.d.ts +10 -6
  72. package/lib/src/embed/conversation.d.ts.map +1 -1
  73. package/lib/src/embed/conversation.js +12 -2
  74. package/lib/src/embed/conversation.js.map +1 -1
  75. package/lib/src/embed/conversation.spec.js +3 -0
  76. package/lib/src/embed/conversation.spec.js.map +1 -1
  77. package/lib/src/embed/embed.spec.js +1 -0
  78. package/lib/src/embed/embed.spec.js.map +1 -1
  79. package/lib/src/embed/liveboard.d.ts +32 -0
  80. package/lib/src/embed/liveboard.d.ts.map +1 -1
  81. package/lib/src/embed/liveboard.js +7 -4
  82. package/lib/src/embed/liveboard.js.map +1 -1
  83. package/lib/src/embed/liveboard.spec.js +46 -33
  84. package/lib/src/embed/liveboard.spec.js.map +1 -1
  85. package/lib/src/embed/pinboard.spec.js +1 -0
  86. package/lib/src/embed/pinboard.spec.js.map +1 -1
  87. package/lib/src/embed/search.d.ts.map +1 -1
  88. package/lib/src/embed/search.js +6 -1
  89. package/lib/src/embed/search.js.map +1 -1
  90. package/lib/src/embed/search.spec.js +2 -0
  91. package/lib/src/embed/search.spec.js.map +1 -1
  92. package/lib/src/embed/ts-embed.d.ts.map +1 -1
  93. package/lib/src/embed/ts-embed.js +7 -3
  94. package/lib/src/embed/ts-embed.js.map +1 -1
  95. package/lib/src/embed/ts-embed.spec.js +1 -0
  96. package/lib/src/embed/ts-embed.spec.js.map +1 -1
  97. package/lib/src/types.d.ts +140 -141
  98. package/lib/src/types.d.ts.map +1 -1
  99. package/lib/src/types.js +127 -117
  100. package/lib/src/types.js.map +1 -1
  101. package/lib/src/utils/graphql/answerService/answer-queries.d.ts +1 -1
  102. package/lib/src/utils/graphql/answerService/answer-queries.d.ts.map +1 -1
  103. package/lib/src/utils/graphql/answerService/answer-queries.js +0 -1
  104. package/lib/src/utils/graphql/answerService/answer-queries.js.map +1 -1
  105. package/lib/src/utils/graphql/answerService/answerService.spec.js +0 -1
  106. package/lib/src/utils/graphql/answerService/answerService.spec.js.map +1 -1
  107. package/package.json +1 -1
  108. package/src/embed/app.spec.ts +25 -7
  109. package/src/embed/app.ts +44 -5
  110. package/src/embed/conversation.spec.ts +3 -0
  111. package/src/embed/conversation.ts +22 -8
  112. package/src/embed/embed.spec.ts +1 -0
  113. package/src/embed/liveboard.spec.ts +62 -42
  114. package/src/embed/liveboard.ts +42 -5
  115. package/src/embed/pinboard.spec.ts +1 -0
  116. package/src/embed/search.spec.ts +2 -0
  117. package/src/embed/search.ts +6 -1
  118. package/src/embed/ts-embed.spec.ts +1 -0
  119. package/src/embed/ts-embed.ts +7 -3
  120. package/src/types.ts +144 -144
  121. package/src/utils/graphql/answerService/answer-queries.ts +0 -1
  122. package/src/utils/graphql/answerService/answerService.spec.ts +0 -1
@@ -347,7 +347,7 @@ export interface EmbedConfig {
347
347
  /**
348
348
  * [AuthServer] The trusted authentication endpoint to use to get the
349
349
  * authentication token. A `GET` request is made to the
350
- * authentication API endpoint, which returns the token
350
+ * authentication API endpoint, which returns the token
351
351
  * as a plaintext response. For trusted authentication,
352
352
  * the `authEndpoint` or `getAuthToken` attribute is required.
353
353
  */
@@ -457,12 +457,12 @@ export interface EmbedConfig {
457
457
  * When there are multiple objects embedded, queue the rendering of embedded objects
458
458
  * to start after the previous embed's render is complete. This helps improve
459
459
  * performance by decreasing the load on the browser.
460
- * @Version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
460
+ * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
461
461
  * @default false
462
462
  */
463
463
  queueMultiRenders?: boolean;
464
464
  /**
465
- * [AuthServer|Basic] Detect if third-party party cookies are enabled by doing an
465
+ * [AuthServer|Basic] Detect if third-party cookies are enabled by doing an
466
466
  * additional call. This is slower and should be avoided. Listen to the
467
467
  * `NO_COOKIE_ACCESS` event to handle the situation.
468
468
  *
@@ -1241,21 +1241,26 @@ export interface SearchLiveboardCommonViewConfig {
1241
1241
  /**
1242
1242
  * Boolean to exclude runtimeFilters in the URL
1243
1243
  * By default it is true, this flag removes runtime filters from the URL
1244
- * when set to false, runtime filters will be included in the URL.
1244
+ * (default behavior from SDK 1.45.0).
1245
+ * when set to false, runtime filters will be included in the URL
1246
+ * (default behavior before SDK 1.45.0).
1245
1247
  *
1246
1248
  * Irrespective of this flag, runtime filters ( if passed ) will be applied to the
1247
1249
  * embedded view.
1248
- * @default false
1250
+ * @default true
1249
1251
  * @version SDK: 1.24.0 | ThoughtSpot: 9.5.0.cl
1250
1252
  */
1251
1253
  excludeRuntimeFiltersfromURL?: boolean;
1252
1254
  /**
1253
1255
  * Boolean to exclude runtimeParameters from the URL
1254
- * when set to true, this flag removes runtime parameters from the URL.
1256
+ * when set to true, this flag removes runtime parameters from the URL
1257
+ * (default behavior from SDK 1.45.0).
1258
+ * when set to false, runtime parameters will be included in the URL
1259
+ * (default behavior before SDK 1.45.0).
1255
1260
  *
1256
1261
  * Irrespective of this flag, runtime filters ( if passed ) will be applied to the
1257
1262
  * embedded view.
1258
- * @default false
1263
+ * @default true
1259
1264
  * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl
1260
1265
  */
1261
1266
  excludeRuntimeParametersfromURL?: boolean;
@@ -1493,22 +1498,6 @@ export interface LiveboardAppEmbedViewConfig {
1493
1498
  * ```
1494
1499
  */
1495
1500
  coverAndFilterOptionInPDF?: boolean;
1496
- /**
1497
- * This flag is used to enable or disable the XLSX/CSV download option for Liveboards.
1498
- * To enable this feature on your instance, contact ThoughtSpot Support.
1499
- *
1500
- * Supported embed types: `AppEmbed`, `LiveboardEmbed`
1501
- * @version SDK: 1.41.0 | ThoughtSpot: 26.3.0.cl
1502
- * @example
1503
- * ```js
1504
- * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
1505
- * const embed = new <EmbedComponent>('#tsEmbed', {
1506
- * ... // other embed view config
1507
- * liveboardXLSXCSVDownload: true,
1508
- * })
1509
- * ```
1510
- */
1511
- liveboardXLSXCSVDownload?: boolean;
1512
1501
  /**
1513
1502
  * This flag is used to enable or disable the new centralized Liveboard filter UX (v2).
1514
1503
  * When enabled, a unified modal is used to manage and update multiple filters at once,
@@ -1744,7 +1733,11 @@ export declare enum HomepageModule {
1744
1733
  */
1745
1734
  export declare enum ListPageColumns {
1746
1735
  /**
1747
- * Favourite
1736
+ * Favorites
1737
+ */
1738
+ Favorites = "FAVOURITE",
1739
+ /**
1740
+ * @deprecated Use {@link ListPageColumns.Favorites} instead.
1748
1741
  */
1749
1742
  Favourite = "FAVOURITE",
1750
1743
  /**
@@ -1762,7 +1755,11 @@ export declare enum ListPageColumns {
1762
1755
  /**
1763
1756
  * Share
1764
1757
  */
1765
- Share = "SHARE"
1758
+ Share = "SHARE",
1759
+ /**
1760
+ * Verified badge/column
1761
+ */
1762
+ Verified = "VERIFIED"
1766
1763
  }
1767
1764
  /**
1768
1765
  * A filter that can be applied to ThoughtSpot answers, Liveboards, or
@@ -2012,7 +2009,7 @@ export declare enum EmbedEvent {
2012
2009
  /**
2013
2010
  * An error has occurred. This event is fired for the following error types:
2014
2011
  *
2015
- * `API` - API call failure error.
2012
+ * `API` - API call failure.
2016
2013
  * `FULLSCREEN` - Error when presenting a Liveboard or visualization in full screen
2017
2014
  * mode. `SINGLE_VALUE_FILTER` - Error due to multiple values in the single value
2018
2015
  * filter. `NON_EXIST_FILTER` - Error due to a non-existent filter.
@@ -2743,20 +2740,20 @@ export declare enum EmbedEvent {
2743
2740
  /**
2744
2741
  *
2745
2742
  * This event can be emitted to intercept search execution initiated by
2746
- * the users and implement the logic to allow or restrict search execution.
2747
- * You can can also show custom error text if the search query must be
2743
+ * users and implement logic to allow or restrict search execution.
2744
+ * You can also show custom error text if the search query must be
2748
2745
  * restricted due to your application or business requirements.
2749
2746
 
2750
2747
  * Prerequisite: Set `isOnBeforeGetVizDataInterceptEnabled` to `true`
2751
2748
  * for this embed event to get emitted.
2752
- * @param:payload The payload received from the embed related to the Data API call.
2753
- * @param:responder
2754
- * Contains elements that lets developers define whether ThoughtSpot
2755
- * should run the search, and if not, what error message
2756
- * should be shown to the user.
2749
+ * @param - Includes the following event listener parameters:
2750
+ * - `payload`: The payload received from the embed related to the Data API call.
2751
+ * - `responder`: Contains elements that let developers define whether ThoughtSpot
2752
+ * should run the search, and if not, what error message
2753
+ * should be shown to the user.
2757
2754
  *
2758
- * `execute` - When execute returns `true`, the search will be run.
2759
- * When execute returns `false`, the search will not be executed.
2755
+ * `execute` - When `execute` returns `true`, the search will be run.
2756
+ * When `execute` returns `false`, the search will not be executed.
2760
2757
  *
2761
2758
  * `error` - Developers can customize the error message text when `execute`
2762
2759
  * is `false` using the `errorText` and `errorDescription` parameters in responder.
@@ -2928,7 +2925,7 @@ export declare enum EmbedEvent {
2928
2925
  * console.log('payload', payload);
2929
2926
  * })
2930
2927
  * ```
2931
- * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
2928
+ * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
2932
2929
  */
2933
2930
  DataModelInstructions = "DataModelInstructions",
2934
2931
  /**
@@ -3146,14 +3143,14 @@ export declare enum HostEvent {
3146
3143
  * the search query string.
3147
3144
  * Supported in `AppEmbed` and `SearchEmbed` deployments.
3148
3145
  * Includes the following properties:
3149
- * @param - `searchQuery` - query string with search tokens
3150
- * @param - `dataSources` - Data source GUID to Search on
3151
- * - Although an array, only a single source
3152
- * is supported.
3153
- * @param - `execute` - executes search and updates the existing query
3146
+ * @param - Includes the following keys:
3147
+ * - `searchQuery`: Query string with search tokens.
3148
+ * - `dataSources`: Data source GUID to search on.
3149
+ * Although an array, only a single source is supported.
3150
+ * - `execute`: Executes search and updates the existing query.
3154
3151
  * @example
3155
3152
  * ```js
3156
- * searchembed.trigger(HostEvent.Search, {
3153
+ * searchEmbed.trigger(HostEvent.Search, {
3157
3154
  searchQuery: "[sales] by [item type]",
3158
3155
  dataSources: ["cd252e5c-b552-49a8-821d-3eadaa049cca"],
3159
3156
  execute: true
@@ -3164,16 +3161,15 @@ export declare enum HostEvent {
3164
3161
  /**
3165
3162
  * Triggers a drill on certain points of the specified column
3166
3163
  * Includes the following properties:
3167
- * @param - points - an object containing selectedPoints/clickedPoints
3168
- * to drill to. For example, { selectedPoints: []}
3169
- * @param - columnGuid - Optional. GUID of the column to drill
3170
- * by. If not provided it will auto drill by the configured
3171
- * column.
3172
- * @param - autoDrillDown - Optional. If true, the drill down will be
3173
- * done automatically on the most popular column.
3174
- * @param - vizId [TS >= 9.8.0] - Optional. The GUID of the visualization to drill
3175
- * in case of a Liveboard.
3176
- * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
3164
+ * @param - Includes the following keys:
3165
+ * - `points`: An object containing `selectedPoints` and/or `clickedPoint`
3166
+ * to drill to. For example, `{ selectedPoints: [] }`.
3167
+ * - `columnGuid`: Optional. GUID of the column to drill by. If not provided,
3168
+ * it will auto drill by the configured column.
3169
+ * - `autoDrillDown`: Optional. If `true`, the drill down will be done automatically
3170
+ * on the most popular column.
3171
+ * - `vizId` (TS >= 9.8.0): Optional. The GUID of the visualization to drill in case
3172
+ * of a Liveboard. In Spotter embed, `vizId` refers to the Answer ID and is **required**.
3177
3173
  * @example
3178
3174
  * ```js
3179
3175
  * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
@@ -3266,14 +3262,12 @@ export declare enum HostEvent {
3266
3262
  * and `AppEmbed` only. In full application embedding, this event updates
3267
3263
  * the runtime filters applied on the Liveboard and saved Answer objects.
3268
3264
  *
3269
- * @param - Pass an array of {@link RuntimeFilter} with the following attributes:
3270
- * `columnName` - _String_. The name of the column to filter on.
3271
- *
3272
- * `operator` - {@link RuntimeFilterOp} to apply. For more information,
3273
- * see link:https://developers.thoughtspot.com/docs/?pageid=runtime-filters#rtOperator[Developer Documentation].
3274
- *
3275
- * `values` - List of operands. Some operators such as EQ and LE allow a
3276
- * single value, whereas BW and IN accept multiple values.
3265
+ * @param - Array of {@link RuntimeFilter} objects. Each item includes:
3266
+ * - `columnName`: Name of the column to filter on.
3267
+ * - `operator`: {@link RuntimeFilterOp} to apply. For more information, see
3268
+ * link:https://developers.thoughtspot.com/docs/runtime-filters#rtOperator[Developer Documentation].
3269
+ * - `values`: List of operands. Some operators such as EQ and LE allow a single
3270
+ * value, whereas BW and IN accept multiple values.
3277
3271
  *
3278
3272
  * **Note**: Updating runtime filters resets the ThoughtSpot
3279
3273
  * object to its original state and applies new filter conditions.
@@ -3296,7 +3290,7 @@ export declare enum HostEvent {
3296
3290
  /**
3297
3291
  * Navigate to a specific page in the embedded ThoughtSpot application.
3298
3292
  * This is the same as calling `appEmbed.navigateToPage(path, true)`.
3299
- * @param - `path` - the path to navigate to to go forward or back. The path value can
3293
+ * @param - `path` - the path to navigate to go forward or back. The path value can
3300
3294
  * be a number; for example, `1`, `-1`.
3301
3295
  * @example
3302
3296
  * ```js
@@ -3367,30 +3361,25 @@ export declare enum HostEvent {
3367
3361
  * for the Answer that the user is currently on
3368
3362
  * and a modal opens for Liveboard selection.
3369
3363
  * To add an Answer or visualization to a Liveboard programmatically without
3370
- * showing requiring additional user input via *Pin to Liveboard* modal, define
3364
+ * requiring additional user input via the *Pin to Liveboard* modal, define
3371
3365
  * the following parameters:
3372
3366
  *
3373
- * @param
3374
- * `vizId`- GUID of the saved Answer or Spotter visualization ID to pin to a Liveboard.
3375
- * Optional when pinning a new chart or table generated from a Search query.
3376
- * **Required** in Spotter Embed.
3377
- * @param
3378
- * `liveboardID` - GUID of the Liveboard to pin an Answer. If there is no Liveboard,
3379
- * specify the `newLiveboardName` parameter to create a new Liveboard.
3380
- * @param
3381
- * `tabId` - GUID of the Liveboard tab. Adds the Answer to the Liveboard tab
3382
- * specified in the code.
3383
- * @param
3384
- * `newVizName` - Name string for the Answer or visualization. If defined,
3385
- * this parameter adds a new visualization object or creates a copy of the
3386
- * Answer or visualization specified in `vizId`.
3387
- * Required attribute.
3388
- * @param
3389
- * `newLiveboardName` - Name string for the Liveboard.
3390
- * Creates a new Liveboard object with the specified name.
3391
- * @param
3392
- * `newTabName` - Name of the tab. Adds a new tab Liveboard specified
3393
- * in the code.
3367
+ * @param - Includes the following keys:
3368
+ * - `vizId`: GUID of the saved Answer or Spotter visualization ID to pin to a Liveboard.
3369
+ * Optional when pinning a new chart or table generated from a Search query.
3370
+ * **Required** in Spotter Embed.
3371
+ * - `liveboardId`: GUID of the Liveboard to pin an Answer. If there is no Liveboard,
3372
+ * specify the `newLiveboardName` parameter to create a new Liveboard.
3373
+ * - `tabId`: GUID of the Liveboard tab. Adds the Answer to the Liveboard tab
3374
+ * specified in the code.
3375
+ * - `newVizName`: Name string for the Answer or visualization. If defined,
3376
+ * this parameter adds a new visualization object or creates a copy of the
3377
+ * Answer or visualization specified in `vizId`.
3378
+ * Required.
3379
+ * - `newLiveboardName`: Name string for the Liveboard.
3380
+ * Creates a new Liveboard object with the specified name.
3381
+ * - `newTabName`: Name of the tab. Adds a new tab Liveboard specified
3382
+ * in the code.
3394
3383
  *
3395
3384
  * @example
3396
3385
  * ```js
@@ -3630,9 +3619,9 @@ export declare enum HostEvent {
3630
3619
  * on a Liveboard.
3631
3620
  *
3632
3621
  * This event is not supported in visualization embed and search embed.
3633
- * @param - object - To trigger the action for a specific visualization
3634
- * in Liveboard embed, pass in `vizId` as a key.
3635
- * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
3622
+ * @param - Object parameter. Includes the following keys:
3623
+ * - `vizId`: To trigger the action for a specific visualization in Liveboard embed,
3624
+ * pass in `vizId` as a key. In Spotter embed, `vizId` refers to the Answer ID and is **required**.
3636
3625
  *
3637
3626
  * @example
3638
3627
  * ```js
@@ -3999,10 +3988,9 @@ export declare enum HostEvent {
3999
3988
  GetFilters = "getFilters",
4000
3989
  /**
4001
3990
  * Update one or several filters applied on a Liveboard.
4002
- * @param - `filter`: a single filter object containing column name,
4003
- * filter operator, and values.
4004
- * @param - `filters`: multiple filter objects with column name, filter operator,
4005
- * and values for each.
3991
+ * @param - Includes the following keys:
3992
+ * - `filter`: A single filter object containing column name, filter operator, and values.
3993
+ * - `filters`: Multiple filter objects with column name, filter operator, and values for each.
4006
3994
  *
4007
3995
  * Each filter object must include the following attributes:
4008
3996
  *
@@ -4128,8 +4116,9 @@ export declare enum HostEvent {
4128
4116
  SetHiddenTabs = "SetPinboardHiddenTabs",
4129
4117
  /**
4130
4118
  * Updates the search query string for Natural Language Search operations.
4131
- * @param - `queryString`: Text string in Natural Language format
4132
- * @param - `executeSearch`: Boolean to execute search and update search query
4119
+ * @param - Includes the following keys:
4120
+ * - `queryString`: Text string in Natural Language format.
4121
+ * - `executeSearch`: Boolean to execute search and update search query.
4133
4122
  * @example
4134
4123
  * ```js
4135
4124
  * sageEmbed.trigger(HostEvent.UpdateSageQuery, {
@@ -4208,11 +4197,10 @@ export declare enum HostEvent {
4208
4197
  /**
4209
4198
  * Triggers an action to update Parameter values on embedded
4210
4199
  * Answers, Liveboard, and Spotter answer in Edit mode.
4211
- * @param - `name` - Name of the Parameter
4212
- * @param - `value` - The value to set for the Parameter.
4213
- *
4214
- * Optionally, to control the visibility of the Parameter chip,
4215
- * use the `isVisibleToUser` attribute when applying an override.
4200
+ * @param - Includes the following keys for each item:
4201
+ * - `name`: Name of the parameter.
4202
+ * - `value`: The value to set for the parameter.
4203
+ * - `isVisibleToUser`: Optional. To control the visibility of the parameter chip.
4216
4204
  *
4217
4205
  * @example
4218
4206
  * ```js
@@ -4270,11 +4258,10 @@ export declare enum HostEvent {
4270
4258
  * If no parameters are specified, the save action is
4271
4259
  * triggered with a modal to prompt users to
4272
4260
  * add a name and description for the Answer.
4273
- * @param - `vizId` refers to the Answer ID in Spotter embed
4274
- * and is required in Spotter embed.
4275
- * Optional attributes to set Answer properties include:
4276
- * @param - `name` - Name string for the Answer.
4277
- * @param - `description` - Description text for the Answer.
4261
+ * @param - Includes the following keys:
4262
+ * - `vizId`: Refers to the Answer ID in Spotter embed and is **required** in Spotter embed.
4263
+ * - `name`: Optional. Name string for the Answer.
4264
+ * - `description`: Optional. Description text for the Answer.
4278
4265
  * @example
4279
4266
  * ```js
4280
4267
  * const saveAnswerResponse = await searchEmbed.trigger(HostEvent.SaveAnswer, {
@@ -4323,8 +4310,9 @@ export declare enum HostEvent {
4323
4310
  /**
4324
4311
  * Triggers a search operation with the search tokens specified in
4325
4312
  * the search query string in spotter embed.
4326
- * @param - `query`: Text string in Natural Language format
4327
- * @param - `executeSearch`: Boolean to execute search and update search query
4313
+ * @param - Includes the following keys:
4314
+ * - `query`: Text string in Natural Language format.
4315
+ * - `executeSearch`: Boolean to execute search and update search query.
4328
4316
  * @example
4329
4317
  * ```js
4330
4318
  * spotterEmbed.trigger(HostEvent.SpotterSearch, {
@@ -4371,7 +4359,7 @@ export declare enum HostEvent {
4371
4359
  * ```js
4372
4360
  * spotterEmbed.trigger(HostEvent.DataModelInstructions);
4373
4361
  * ```
4374
- * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
4362
+ * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
4375
4363
  */
4376
4364
  DataModelInstructions = "DataModelInstructions",
4377
4365
  /**
@@ -4456,7 +4444,7 @@ export declare enum HostEvent {
4456
4444
  */
4457
4445
  UpdateEmbedParams = "updateEmbedParams",
4458
4446
  /**
4459
- * Triggered when the embed is needed to be destroyed. This is used to clean up any embed related resources internally.
4447
+ * Triggered when the embed needs to be destroyed. This is used to clean up any embed-related resources internally.
4460
4448
  * @example
4461
4449
  * ```js
4462
4450
  * liveboardEmbed.trigger(HostEvent.DestroyEmbed);
@@ -4464,11 +4452,12 @@ export declare enum HostEvent {
4464
4452
  * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
4465
4453
  */
4466
4454
  DestroyEmbed = "EmbedDestroyed",
4467
- /** Triggers a create new conversation operation in spotter embed.
4468
- * @example
4469
- * ```js
4455
+ /**
4456
+ * Triggers a new conversation in Spotter embed.
4457
+ *
4470
4458
  * This feature is available only when chat history is enabled on your ThoughtSpot instance.
4471
4459
  * Contact your admin or ThoughtSpot Support to enable chat history on your instance.
4460
+ *
4472
4461
  * @example
4473
4462
  * ```js
4474
4463
  * spotterEmbed.trigger(HostEvent.StartNewSpotterConversation);
@@ -4617,8 +4606,9 @@ export declare enum Param {
4617
4606
  IsLiveboardStylingAndGroupingEnabled = "isLiveboardStylingAndGroupingEnabled",
4618
4607
  IsLazyLoadingForEmbedEnabled = "isLazyLoadingForEmbedEnabled",
4619
4608
  RootMarginForLazyLoad = "rootMarginForLazyLoad",
4620
- LiveboardXLSXCSVDownload = "isLiveboardXLSXCSVDownloadEnabled",
4621
4609
  isPNGInScheduledEmailsEnabled = "isPNGInScheduledEmailsEnabled",
4610
+ isLiveboardXLSXCSVDownloadEnabled = "isLiveboardXLSXCSVDownloadEnabled",
4611
+ isGranularXLSXCSVSchedulesEnabled = "isGranularXLSXCSVSchedulesEnabled",
4622
4612
  isCentralizedLiveboardFilterUXEnabled = "isCentralizedLiveboardFilterUXEnabled",
4623
4613
  isLinkParametersEnabled = "isLinkParametersEnabled",
4624
4614
  EnablePastConversationsSidebar = "enablePastConversationsSidebar",
@@ -4649,7 +4639,7 @@ export declare enum Param {
4649
4639
  * hiddenActions: [Action.Edit, ActionAction.Explore],
4650
4640
  * })
4651
4641
  * ```
4652
- * See also link:https://developers.thoughtspot.com/docs/actions[Action IDs in the SDK]
4642
+ * See also link:https://developers.thoughtspot.com/docs/actions[Developer Documentation].
4653
4643
  */
4654
4644
  export declare enum Action {
4655
4645
  /**
@@ -4936,6 +4926,16 @@ export declare enum Action {
4936
4926
  * ```
4937
4927
  */
4938
4928
  DownloadAsXlsx = "downloadAsXLSX",
4929
+ /**
4930
+ * The **Download Liveboard** menu action on a Liveboard.
4931
+ * Allows downloading the entire Liveboard.
4932
+ * @example
4933
+ * ```js
4934
+ * disabledActions: [Action.DownloadLiveboard]
4935
+ * ```
4936
+ * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
4937
+ */
4938
+ DownloadLiveboard = "downloadLiveboard",
4939
4939
  /**
4940
4940
  * @hidden
4941
4941
  */
@@ -5275,28 +5275,28 @@ export declare enum Action {
5275
5275
  CrossFilter = "context-menu-item-cross-filter",
5276
5276
  /**
5277
5277
  * The **Sync to Slack** action on Liveboard visualizations.
5278
- * Allows sending data to third-party apps Slack
5278
+ * Allows sending data to third-party apps like Slack.
5279
5279
  * @example
5280
5280
  * ```js
5281
5281
  * disabledActions: [Action.SyncToSlack]
5282
5282
  * ```
5283
- * @version @version SDK : 1.32.0 | ThoughtSpot Cloud: 10.1.0.cl
5283
+ * @version SDK: 1.32.0 | ThoughtSpot Cloud: 10.1.0.cl
5284
5284
  */
5285
5285
  SyncToSlack = "syncToSlack",
5286
5286
  /**
5287
5287
  * The **Sync to Teams** action on Liveboard visualizations.
5288
- * Allows sending data to third-party apps Team
5288
+ * Allows sending data to third-party apps like Microsoft Teams.
5289
5289
  * @example
5290
5290
  * ```js
5291
5291
  * disabledActions: [Action.SyncToTeams]
5292
5292
  * ```
5293
- * @version @version SDK : 1.32.0 | ThoughtSpot Cloud: 10.1.0.cl
5293
+ * @version SDK: 1.32.0 | ThoughtSpot Cloud: 10.1.0.cl
5294
5294
  */
5295
5295
  SyncToTeams = "syncToTeams",
5296
5296
  /**
5297
5297
  * The **Remove** action that appears when cross filters are applied
5298
5298
  * on a Liveboard.
5299
- * Removes filters applied o a visualization.
5299
+ * Removes filters applied to a visualization.
5300
5300
  * @example
5301
5301
  * ```js
5302
5302
  * disabledActions: [Action.RemoveCrossFilter]
@@ -5482,7 +5482,7 @@ export declare enum Action {
5482
5482
  AddTab = "addTab",
5483
5483
  /**
5484
5484
  *
5485
- *Initiates contextual change analysis on KPI charts.
5485
+ * Initiates contextual change analysis on KPI charts.
5486
5486
  * @example
5487
5487
  * ```js
5488
5488
  * disabledActions: [Action.EnableContextualChangeAnalysis]
@@ -5492,7 +5492,7 @@ export declare enum Action {
5492
5492
  EnableContextualChangeAnalysis = "enableContextualChangeAnalysis",
5493
5493
  /**
5494
5494
  * Action ID to hide or disable Iterative Change Analysis option
5495
- * on contextual change analysis Inisght charts context menu
5495
+ * in the contextual change analysis Insight charts context menu.
5496
5496
  *
5497
5497
  * @example
5498
5498
  * ```js
@@ -5770,6 +5770,17 @@ export declare enum Action {
5770
5770
  * @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
5771
5771
  */
5772
5772
  ChangeFilterVisibilityInTab = "changeFilterVisibilityInTab",
5773
+ /**
5774
+ * The **Data model instructions** button on the Spotter interface.
5775
+ * Allows opening the data model instructions modal.
5776
+ *
5777
+ * @example
5778
+ * ```js
5779
+ * hiddenAction: [Action.DataModelInstructions]
5780
+ * ```
5781
+ * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
5782
+ */
5783
+ DataModelInstructions = "DataModelInstructions",
5773
5784
  /**
5774
5785
  * The **Preview data** button on the Spotter interface.
5775
5786
  * Allows previewing the data used for Spotter queries.
@@ -5855,12 +5866,12 @@ export declare enum Action {
5855
5866
  */
5856
5867
  CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF",
5857
5868
  /**
5858
- * Action ID for hide or disable the
5859
- * Spotter in conversation training widget.
5860
- * The Add to Coaching feature is currently in beta
5861
- * and is disabled by default on embed deployments.
5862
- * To enable this feature on your instance,
5863
- * contact ThoughtSpot Support.
5869
+ * Action ID to hide or disable the Spotter in the conversation training widget.
5870
+ * When disabled, users cannot access **Add to Coaching**, which allows adding reference
5871
+ * questions and business terms to improve Spotter’s responses.
5872
+ * The **Add to Coaching** feature is generally available from version 26.2.0.cl and
5873
+ * enabled by default on embed deployments.
5874
+
5864
5875
  * @example
5865
5876
  * ```js
5866
5877
  * hiddenAction: [Action.InConversationTraining]
@@ -6175,31 +6186,19 @@ export declare enum ErrorDetailsTypes {
6175
6186
  NETWORK = "NETWORK"
6176
6187
  }
6177
6188
  /**
6178
- * Specific error codes for embedded component errors.
6179
- *
6180
- * These codes provide granular identification of errors that occur in embedded components.
6181
- * They are returned in the {@link EmbedErrorDetailsEvent.code} property and allow for
6182
- * precise error handling and debugging.
6189
+ * Error codes for identifying specific issues in embedded ThoughtSpot components.
6183
6190
  *
6184
- * The codes are organized into categories:
6185
- * - **Worksheet ID not found or does not exist**: Errors related to applying or updating filters
6186
- * - **Liveboard ID missing**: Errors related to missing liveboard ID
6187
- * - **Conflicting actions configuration**: Errors related to conflicting actions configuration
6188
- * - **Conflicting tabs configuration**: Errors related to conflicting tabs configuration
6189
- * - **Initialization error**: Errors related to initialization error
6190
- * - **Network error**: Errors related to network error
6191
- * - **Custom action validation**: Errors related to custom action validation
6192
- * - **Login failed**: Errors related to login failed
6193
- * - **Render not called**: Errors related to render not called
6194
- * - **Host event type undefined or invalid**: Errors related to host event type undefined or invalid
6191
+ * Use these codes for precise error handling and debugging. Each code maps to a
6192
+ * distinct failure scenario, enabling targeted recovery strategies.
6195
6193
  *
6196
6194
  * @version SDK: 1.44.2 | ThoughtSpot: 26.2.0.cl
6197
6195
  * @group Error Handling
6196
+ *
6198
6197
  * @see {@link EmbedErrorDetailsEvent} - The error event object that includes these codes
6199
6198
  * @see {@link ErrorDetailsTypes} - General error type categories
6200
6199
  *
6201
6200
  * @example
6202
- * Handle specific error codes
6201
+ * Handle specific error codes in the error event handler
6203
6202
  *
6204
6203
  * embed.on(EmbedEvent.Error, (error) => {
6205
6204
  * if (error.code === EmbedErrorCodes.WORKSHEET_ID_NOT_FOUND) {