@thoughtspot/visual-embed-sdk 1.33.3 → 1.33.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 (145) hide show
  1. package/cjs/package.json +1 -1
  2. package/cjs/src/config.d.ts.map +1 -1
  3. package/cjs/src/config.js.map +1 -1
  4. package/cjs/src/embed/app.d.ts +20 -6
  5. package/cjs/src/embed/app.d.ts.map +1 -1
  6. package/cjs/src/embed/app.js +3 -3
  7. package/cjs/src/embed/app.js.map +1 -1
  8. package/cjs/src/embed/app.spec.js +10 -0
  9. package/cjs/src/embed/app.spec.js.map +1 -1
  10. package/cjs/src/embed/base.d.ts +4 -1
  11. package/cjs/src/embed/base.d.ts.map +1 -1
  12. package/cjs/src/embed/base.js +14 -6
  13. package/cjs/src/embed/base.js.map +1 -1
  14. package/cjs/src/embed/base.spec.js +58 -4
  15. package/cjs/src/embed/base.spec.js.map +1 -1
  16. package/cjs/src/embed/bodyless-conversation.d.ts +17 -0
  17. package/cjs/src/embed/bodyless-conversation.d.ts.map +1 -1
  18. package/cjs/src/embed/bodyless-conversation.js +13 -0
  19. package/cjs/src/embed/bodyless-conversation.js.map +1 -1
  20. package/cjs/src/embed/conversation.d.ts.map +1 -1
  21. package/cjs/src/embed/conversation.js +4 -0
  22. package/cjs/src/embed/conversation.js.map +1 -1
  23. package/cjs/src/embed/conversation.spec.js +13 -0
  24. package/cjs/src/embed/conversation.spec.js.map +1 -1
  25. package/cjs/src/embed/liveboard.d.ts.map +1 -1
  26. package/cjs/src/embed/liveboard.js +1 -2
  27. package/cjs/src/embed/liveboard.js.map +1 -1
  28. package/cjs/src/embed/liveboard.spec.js +2 -2
  29. package/cjs/src/embed/liveboard.spec.js.map +1 -1
  30. package/cjs/src/embed/sage.d.ts.map +1 -1
  31. package/cjs/src/embed/sage.js +0 -1
  32. package/cjs/src/embed/sage.js.map +1 -1
  33. package/cjs/src/embed/search.js +1 -1
  34. package/cjs/src/embed/search.js.map +1 -1
  35. package/cjs/src/embed/search.spec.js +6 -6
  36. package/cjs/src/embed/search.spec.js.map +1 -1
  37. package/cjs/src/embed/ts-embed.d.ts.map +1 -1
  38. package/cjs/src/embed/ts-embed.js +13 -2
  39. package/cjs/src/embed/ts-embed.js.map +1 -1
  40. package/cjs/src/embed/ts-embed.spec.js +41 -1
  41. package/cjs/src/embed/ts-embed.spec.js.map +1 -1
  42. package/cjs/src/errors.d.ts +1 -0
  43. package/cjs/src/errors.d.ts.map +1 -1
  44. package/cjs/src/errors.js +10 -9
  45. package/cjs/src/errors.js.map +1 -1
  46. package/cjs/src/react/index.spec.js +2 -2
  47. package/cjs/src/react/index.spec.js.map +1 -1
  48. package/cjs/src/types.d.ts +75 -22
  49. package/cjs/src/types.d.ts.map +1 -1
  50. package/cjs/src/types.js +33 -16
  51. package/cjs/src/types.js.map +1 -1
  52. package/dist/{index-Ck3m4Sis.js → index-CAHz286m.js} +1 -1
  53. package/dist/src/config.d.ts.map +1 -1
  54. package/dist/src/embed/app.d.ts +20 -6
  55. package/dist/src/embed/app.d.ts.map +1 -1
  56. package/dist/src/embed/base.d.ts +4 -1
  57. package/dist/src/embed/base.d.ts.map +1 -1
  58. package/dist/src/embed/bodyless-conversation.d.ts +17 -0
  59. package/dist/src/embed/bodyless-conversation.d.ts.map +1 -1
  60. package/dist/src/embed/conversation.d.ts.map +1 -1
  61. package/dist/src/embed/liveboard.d.ts.map +1 -1
  62. package/dist/src/embed/sage.d.ts.map +1 -1
  63. package/dist/src/embed/ts-embed.d.ts.map +1 -1
  64. package/dist/src/errors.d.ts +1 -0
  65. package/dist/src/errors.d.ts.map +1 -1
  66. package/dist/src/types.d.ts +75 -22
  67. package/dist/src/types.d.ts.map +1 -1
  68. package/dist/tsembed-react.es.js +188 -91
  69. package/dist/tsembed-react.js +187 -90
  70. package/dist/tsembed.es.js +210 -93
  71. package/dist/tsembed.js +209 -92
  72. package/dist/visual-embed-sdk-react-full.d.ts +116 -29
  73. package/dist/visual-embed-sdk-react.d.ts +116 -29
  74. package/dist/visual-embed-sdk.d.ts +116 -29
  75. package/lib/package.json +1 -1
  76. package/lib/src/config.d.ts.map +1 -1
  77. package/lib/src/config.js.map +1 -1
  78. package/lib/src/embed/app.d.ts +20 -6
  79. package/lib/src/embed/app.d.ts.map +1 -1
  80. package/lib/src/embed/app.js +3 -3
  81. package/lib/src/embed/app.js.map +1 -1
  82. package/lib/src/embed/app.spec.js +10 -0
  83. package/lib/src/embed/app.spec.js.map +1 -1
  84. package/lib/src/embed/base.d.ts +4 -1
  85. package/lib/src/embed/base.d.ts.map +1 -1
  86. package/lib/src/embed/base.js +15 -7
  87. package/lib/src/embed/base.js.map +1 -1
  88. package/lib/src/embed/base.spec.js +58 -4
  89. package/lib/src/embed/base.spec.js.map +1 -1
  90. package/lib/src/embed/bodyless-conversation.d.ts +17 -0
  91. package/lib/src/embed/bodyless-conversation.d.ts.map +1 -1
  92. package/lib/src/embed/bodyless-conversation.js +13 -0
  93. package/lib/src/embed/bodyless-conversation.js.map +1 -1
  94. package/lib/src/embed/conversation.d.ts.map +1 -1
  95. package/lib/src/embed/conversation.js +4 -0
  96. package/lib/src/embed/conversation.js.map +1 -1
  97. package/lib/src/embed/conversation.spec.js +13 -0
  98. package/lib/src/embed/conversation.spec.js.map +1 -1
  99. package/lib/src/embed/liveboard.d.ts.map +1 -1
  100. package/lib/src/embed/liveboard.js +1 -2
  101. package/lib/src/embed/liveboard.js.map +1 -1
  102. package/lib/src/embed/liveboard.spec.js +2 -2
  103. package/lib/src/embed/liveboard.spec.js.map +1 -1
  104. package/lib/src/embed/sage.d.ts.map +1 -1
  105. package/lib/src/embed/sage.js +0 -1
  106. package/lib/src/embed/sage.js.map +1 -1
  107. package/lib/src/embed/search.js +1 -1
  108. package/lib/src/embed/search.js.map +1 -1
  109. package/lib/src/embed/search.spec.js +6 -6
  110. package/lib/src/embed/search.spec.js.map +1 -1
  111. package/lib/src/embed/ts-embed.d.ts.map +1 -1
  112. package/lib/src/embed/ts-embed.js +13 -2
  113. package/lib/src/embed/ts-embed.js.map +1 -1
  114. package/lib/src/embed/ts-embed.spec.js +42 -2
  115. package/lib/src/embed/ts-embed.spec.js.map +1 -1
  116. package/lib/src/errors.d.ts +1 -0
  117. package/lib/src/errors.d.ts.map +1 -1
  118. package/lib/src/errors.js +10 -9
  119. package/lib/src/errors.js.map +1 -1
  120. package/lib/src/react/index.spec.js +2 -2
  121. package/lib/src/react/index.spec.js.map +1 -1
  122. package/lib/src/types.d.ts +75 -22
  123. package/lib/src/types.d.ts.map +1 -1
  124. package/lib/src/types.js +33 -16
  125. package/lib/src/types.js.map +1 -1
  126. package/lib/src/visual-embed-sdk.d.ts +116 -29
  127. package/package.json +1 -1
  128. package/src/config.ts +0 -1
  129. package/src/embed/app.spec.ts +15 -0
  130. package/src/embed/app.ts +23 -8
  131. package/src/embed/base.spec.ts +61 -4
  132. package/src/embed/base.ts +21 -7
  133. package/src/embed/bodyless-conversation.ts +17 -0
  134. package/src/embed/conversation.spec.ts +16 -0
  135. package/src/embed/conversation.ts +4 -0
  136. package/src/embed/liveboard.spec.ts +2 -2
  137. package/src/embed/liveboard.ts +1 -2
  138. package/src/embed/sage.ts +0 -1
  139. package/src/embed/search.spec.ts +6 -6
  140. package/src/embed/search.ts +1 -1
  141. package/src/embed/ts-embed.spec.ts +48 -1
  142. package/src/embed/ts-embed.ts +16 -2
  143. package/src/errors.ts +10 -9
  144. package/src/react/index.spec.tsx +2 -2
  145. package/src/types.ts +71 -20
@@ -1118,7 +1118,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1118
1118
  */
1119
1119
  dataPanelCustomGroupsAccordionInitialState?: DataPanelCustomColumnGroupsAccordionState;
1120
1120
  /**
1121
- * This flag is used to enable the 2 column layout in liveboard
1121
+ * This attribute can be used to enable the two-column layout on an embedded Liveboard
1122
1122
  * @type {boolean}
1123
1123
  * @default false
1124
1124
  * @version SDK: 1.32.0 | ThoughtSpot:10.1.0.cl
@@ -1132,17 +1132,17 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1132
1132
  */
1133
1133
  enable2ColumnLayout?: boolean;
1134
1134
  /**
1135
- * Flag to use OnBeforeSearchExecute embed event
1135
+ * Flag that allows using `EmbedEvent.OnBeforeGetVizDataIntercept`.
1136
1136
  * @version SDK : 1.29.0 | Thoughtspot : 10.1.0.cl
1137
1137
  */
1138
1138
  isOnBeforeGetVizDataInterceptEnabled?: boolean;
1139
1139
  /**
1140
1140
  * Flag to use home page search bar mode
1141
- * @version SDK : 1.33.0 | Thoughtspot : 10.2.0.cl
1141
+ * @version SDK : 1.33.0 | Thoughtspot : 10.3.0.cl
1142
1142
  */
1143
1143
  homePageSearchBarMode?: HomePageSearchBarMode;
1144
1144
  /**
1145
- * This flag is used to enable the compact header in liveboard
1145
+ * This flag can be used to enable the compact header in Liveboard
1146
1146
  * @type {boolean}
1147
1147
  * @default false
1148
1148
  * @version SDK: 1.35.0 | ThoughtSpot:10.3.0.cl
@@ -1156,7 +1156,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1156
1156
  */
1157
1157
  isLiveboardCompactHeaderEnabled?: boolean;
1158
1158
  /**
1159
- * This flag is used to show/hide verified Icon in liveboard compact header
1159
+ * This flag can be used to show or hide the Liveboard verified icon in the compact header.
1160
1160
  * @type {boolean}
1161
1161
  * @default true
1162
1162
  * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
@@ -1170,7 +1170,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1170
1170
  */
1171
1171
  showLiveboardVerifiedBadge?: boolean;
1172
1172
  /**
1173
- * This flag is used to show/hide re-verify banner in liveboard compact header
1173
+ * This flag can be used to show or hide the re-verify banner on the Liveboard compact header
1174
1174
  * @type {boolean}
1175
1175
  * @default true
1176
1176
  * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
@@ -1183,6 +1183,20 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1183
1183
  * ```
1184
1184
  */
1185
1185
  showLiveboardReverifyBanner?: boolean;
1186
+ /**
1187
+ * This flag is used to enable unified search experience for full app embed.
1188
+ * @type {boolean}
1189
+ * @default true
1190
+ * @version SDK: 1.34.0 | ThoughtSpot:10.5.0.cl
1191
+ * @example
1192
+ * ```js
1193
+ * const embed = new AppEmbed('#embed-container', {
1194
+ * ... // other options
1195
+ * isUnifiedSearchExperienceEnabled: true,
1196
+ * })
1197
+ * ```
1198
+ */
1199
+ isUnifiedSearchExperienceEnabled?: boolean;
1186
1200
  }
1187
1201
  /**
1188
1202
  * Embeds full ThoughtSpot experience in a host application.
@@ -1670,10 +1684,13 @@ export declare const handleAuth: () => Promise<boolean>;
1670
1684
  * to your app.
1671
1685
  * @param url The URL provided for prefetch
1672
1686
  * @param prefetchFeatures Specify features which needs to be prefetched.
1687
+ * @param additionalFlags This can be used to add any URL flag.
1673
1688
  * @version SDK: 1.4.0 | ThoughtSpot: ts7.sep.cl, 7.2.1
1674
1689
  * @group Global methods
1675
1690
  */
1676
- export declare const prefetch: (url?: string, prefetchFeatures?: PrefetchFeatures[]) => void;
1691
+ export declare const prefetch: (url?: string, prefetchFeatures?: PrefetchFeatures[], additionalFlags?: {
1692
+ [key: string]: string | number | boolean;
1693
+ }) => void;
1677
1694
  /**
1678
1695
  * Initializes the Visual Embed SDK globally and perform
1679
1696
  * authentication if applicable. This function needs to be called before any ThoughtSpot
@@ -1777,6 +1794,10 @@ export declare const exportTML: (data: exportTMLInput) => Promise<any>;
1777
1794
  */
1778
1795
  export declare function reset(): void;
1779
1796
 
1797
+ /**
1798
+ * Configuration for bodyless conversation options.
1799
+ * @group Embed components
1800
+ */
1780
1801
  export interface BodylessConversationViewConfig extends ViewConfig {
1781
1802
  /**
1782
1803
  * The ID of the worksheet to use for the conversation.
@@ -1786,6 +1807,19 @@ export interface BodylessConversationViewConfig extends ViewConfig {
1786
1807
  /**
1787
1808
  * Create a conversation embed, which can be integrated inside
1788
1809
  * chatbots or other conversational interfaces.
1810
+ * @example
1811
+ * ```js
1812
+ * import { BodylessConversation } from '@thoughtspot/visual-embed-sdk';
1813
+ *
1814
+ * const conversation = new BodylessConversation({
1815
+ * worksheetId: 'worksheetId',
1816
+ * });
1817
+ *
1818
+ * const { container, error } = await conversation.sendMessage('show me sales by region');
1819
+ *
1820
+ * // append the container to the DOM
1821
+ * document.body.appendChild(container); // or to any other element
1822
+ * ```
1789
1823
  * @group Embed components
1790
1824
  * @version SDK: 1.33.1 | ThoughtSpot: 10.5.0.cl
1791
1825
  */
@@ -2591,6 +2625,28 @@ export interface EmbedConfig {
2591
2625
  * @version SDK 1.32.3 | Thoughtspot: *
2592
2626
  */
2593
2627
  disableLoginFailurePage?: boolean;
2628
+ /**
2629
+ * This is an object (key/val) of override flags which will be applied
2630
+ * to the internal embedded object. This can be used to add any
2631
+ * URL flag.
2632
+ * Warning: This option is for advanced use only and is used internally
2633
+ * to control embed behavior in non-regular ways. We do not publish the
2634
+ * list of supported keys and values associated with each.
2635
+ * @example
2636
+ * ```js
2637
+ * const embed = new LiveboardEmbed('#embed', {
2638
+ * ... // other liveboard view config
2639
+ * additionalFlags: {
2640
+ * flag1: 'value1',
2641
+ * flag2: 'value2'
2642
+ * }
2643
+ * });
2644
+ * ```
2645
+ * @version SDK: 1.33.5 | ThoughtSpot: *
2646
+ */
2647
+ additionalFlags?: {
2648
+ [key: string]: string | number | boolean;
2649
+ };
2594
2650
  }
2595
2651
  export interface LayoutConfig {
2596
2652
  }
@@ -2778,6 +2834,7 @@ export interface ViewConfig {
2778
2834
  * This is an object (key/val) of override flags which will be applied
2779
2835
  * to the internal embedded object. This can be used to add any
2780
2836
  * URL flag.
2837
+ * If the same flags are passed in init, they will be overriden by the values here.
2781
2838
  * Warning: This option is for advanced use only and is used internally
2782
2839
  * to control embed behavior in non-regular ways. We do not publish the
2783
2840
  * list of supported keys and values associated with each.
@@ -3016,7 +3073,7 @@ export interface ViewConfig {
3016
3073
  */
3017
3074
  enableV2Shell_experimental?: boolean;
3018
3075
  /**
3019
- * To set the initial state of the search bar in case of saved-answers.
3076
+ * To set the initial state of the search bar in case of saved Answers.
3020
3077
  * @default true
3021
3078
  * @version SDK: 1.34.0 | Thoughtspot: 10.3.0.cl
3022
3079
  * @example
@@ -3029,7 +3086,7 @@ export interface ViewConfig {
3029
3086
  collapseSearchBar?: boolean;
3030
3087
  /**
3031
3088
  * This flag can be used to disable links inside the embedded app,
3032
- * and disables redirection of links in a new tab.
3089
+ * and disable redirection of links in a new tab.
3033
3090
  * @example
3034
3091
  * ```js
3035
3092
  * const embed = new LiveboardEmbed('#embed', {
@@ -3041,7 +3098,7 @@ export interface ViewConfig {
3041
3098
  disableRedirectionLinksInNewTab?: boolean;
3042
3099
  /**
3043
3100
  * Flag to control Data panel experience
3044
- * @default true
3101
+ * @default false
3045
3102
  * @version SDK: 1.34.0 | Thoughtspot: 10.3.0.cl
3046
3103
  * @example
3047
3104
  * ```js
@@ -3065,6 +3122,19 @@ export interface ViewConfig {
3065
3122
  * ```
3066
3123
  */
3067
3124
  enableCustomColumnGroups?: boolean;
3125
+ /**
3126
+ * View content for another org directly without having to use the org switcher
3127
+ * This flag is honoured if orgPerUrl feature is enabled for the ThoughtSpot cluster
3128
+ * @example
3129
+ * ```js
3130
+ * const embed = new LiveboardEmbed('#embed', {
3131
+ * ... // other options
3132
+ * overrideOrgId: 142536
3133
+ * });
3134
+ * ```
3135
+ * @version SDK: 1.35.0 | ThoughtSpot: 10.5.0.cl
3136
+ */
3137
+ overrideOrgId?: number;
3068
3138
  }
3069
3139
  /**
3070
3140
  * MessagePayload: Embed event payload: message type, data and status (start/end)
@@ -3110,7 +3180,7 @@ export type MessageCallbackObj = {
3110
3180
  };
3111
3181
  export type GenericCallbackFn = (...args: any[]) => any;
3112
3182
  export type QueryParams = {
3113
- [key: string]: string;
3183
+ [key: string]: string | boolean | number;
3114
3184
  };
3115
3185
  /**
3116
3186
  * A map of the supported runtime filter operations
@@ -4149,22 +4219,26 @@ export declare enum EmbedEvent {
4149
4219
  */
4150
4220
  Rename = "rename",
4151
4221
  /**
4152
- * Emitted if the user wants to intercept the search execution
4153
- * and implement logic to decide whether to run the search or not
4154
4222
  *
4155
- * Prerequisite: Set isOnBeforeGetVizDataInterceptEnabled : true
4223
+ * This event can be emitted to intercept search execution initiated by
4224
+ * the users and implement the logic to allow or restrict search execution.
4225
+ * You can can also show custom error text if the search query must be
4226
+ * restricted due to your application or business requirements.
4227
+
4228
+ * Prerequisite: Set `isOnBeforeGetVizDataInterceptEnabled` to `true`
4156
4229
  * for this embed event to get emitted.
4157
4230
  * @param: payload
4158
4231
  * @param: responder
4159
4232
  * Contains elements that lets developers define whether ThoughtSpot
4160
- * will run the search or not, and if not, which error message to provide.
4233
+ * should run the search, and if not, what error message
4234
+ * should be shown to the user.
4161
4235
  *
4162
- * execute: When execute returns true, the search will be run.
4163
- * When execute returns false, the search will not be executed.
4236
+ * execute: When execute returns `true`, the search will be run.
4237
+ * When execute returns `false`, the search will not be executed.
4164
4238
  *
4165
- * error: Developers can customize the user facing message when execute is
4166
- * set to false using the error parameter in responder
4167
- * @version SDK : 1.29.0 | Thoughtspot : 10.2.0.cl
4239
+ * error: Developers can customize the error message text when `execute`
4240
+ * returns `false` using the error parameter in responder.
4241
+ * @version SDK : 1.29.0 | Thoughtspot : 10.3.0.cl
4168
4242
  * @example
4169
4243
  *```js
4170
4244
  * .on(EmbedEvent.OnBeforeGetVizDataIntercept,
@@ -4204,15 +4278,15 @@ export declare enum EmbedEvent {
4204
4278
  */
4205
4279
  OnBeforeGetVizDataIntercept = "onBeforeGetVizDataIntercept",
4206
4280
  /**
4207
- * Emitted when parameter changes in an answer
4208
- * or liveboard
4281
+ * Emitted when parameter changes in an Answer
4282
+ * or Liveboard
4209
4283
  *
4210
4284
  * ```js
4211
4285
  * liveboardEmbed.on(EmbedEvent.ParameterChanged, (payload) => {
4212
4286
  * console.log('payload', payload);
4213
4287
  * })
4214
4288
  *```
4215
- * @version SDK : 1.29.0 | Thoughtspot : 10.2.0.cl
4289
+ * @version SDK : 1.29.0 | Thoughtspot : 10.3.0.cl
4216
4290
  */
4217
4291
  ParameterChanged = "parameterChanged"
4218
4292
  }
@@ -4941,11 +5015,13 @@ export declare enum HostEvent {
4941
5015
  * see link:https://developers.thoughtspot.com/docs/runtime-filters#rtOperator[Developer Documentation].
4942
5016
  *
4943
5017
  * `values` - An array of one or several values. The value definition on the
4944
- * data type you choose to filter on. For a complete list of supported data types, see
4945
- * link:https://developers.thoughtspot.com/docs/runtime-filters#_supported_data_types[Supported data types]
5018
+ * data type you choose to filter on. For a complete list of supported data types,
5019
+ * see
5020
+ * link:https://developers.thoughtspot.com/docs/runtime-filters#_supported_data_types[Supported
5021
+ * data types].
5022
+ *
4946
5023
  * `type` - To update filters for date time, specify the date format type.
4947
5024
  * For more information and examples, see link:https://developers.thoughtspot.com/docs/embed-liveboard#_date_filters[Date filters].
4948
- *
4949
5025
  * @example
4950
5026
  * ```js
4951
5027
  *
@@ -5230,7 +5306,9 @@ export declare enum Param {
5230
5306
  ShowLiveboardVerifiedBadge = "showLiveboardVerifiedBadge",
5231
5307
  ShowLiveboardReverifyBanner = "showLiveboardReverifyBanner",
5232
5308
  LiveboardHeaderV2 = "isLiveboardHeaderV2Enabled",
5233
- SpotterEnabled = "isSpotterExperienceEnabled"
5309
+ SpotterEnabled = "isSpotterExperienceEnabled",
5310
+ IsUnifiedSearchExperienceEnabled = "isUnifiedSearchExperienceEnabled",
5311
+ OverrideOrgId = "orgId"
5234
5312
  }
5235
5313
  /**
5236
5314
  * ThoughtSpot application pages include actions and menu commands
@@ -6200,7 +6278,7 @@ export declare enum Action {
6200
6278
  */
6201
6279
  AIHighlights = "AIHighlights",
6202
6280
  /**
6203
- * Action ID for edit schedule action on schedule on homepage
6281
+ * Action ID for edit the schedule action on schedule on homepage
6204
6282
  * @example
6205
6283
  * ```js
6206
6284
  * disabledActions: [Action.EditScheduleHomepage]
@@ -6261,7 +6339,16 @@ export declare enum Action {
6261
6339
  * ```
6262
6340
  * @version SDK: 1.34.0 | Thoughtspot: 10.3.0.cl
6263
6341
  */
6264
- KPIAnalysisCTA = "kpiAnalysisCTA"
6342
+ KPIAnalysisCTA = "kpiAnalysisCTA",
6343
+ /**
6344
+ * Action ID for disabling chip reorder in Answer and Liveboard
6345
+ * @example
6346
+ * ```js
6347
+ * const disabledActions = [Action.DisableChipReorder]
6348
+ * ```
6349
+ * @version SDK: 1.35.0 | Thoughtspot: 10.5.0.cl
6350
+ */
6351
+ DisableChipReorder = "disableChipReorder"
6265
6352
  }
6266
6353
  export interface AnswerServiceType {
6267
6354
  getAnswer?: (offset: number, batchSize: number) => any;
@@ -1108,7 +1108,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1108
1108
  */
1109
1109
  dataPanelCustomGroupsAccordionInitialState?: DataPanelCustomColumnGroupsAccordionState;
1110
1110
  /**
1111
- * This flag is used to enable the 2 column layout in liveboard
1111
+ * This attribute can be used to enable the two-column layout on an embedded Liveboard
1112
1112
  * @type {boolean}
1113
1113
  * @default false
1114
1114
  * @version SDK: 1.32.0 | ThoughtSpot:10.1.0.cl
@@ -1122,17 +1122,17 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1122
1122
  */
1123
1123
  enable2ColumnLayout?: boolean;
1124
1124
  /**
1125
- * Flag to use OnBeforeSearchExecute embed event
1125
+ * Flag that allows using `EmbedEvent.OnBeforeGetVizDataIntercept`.
1126
1126
  * @version SDK : 1.29.0 | Thoughtspot : 10.1.0.cl
1127
1127
  */
1128
1128
  isOnBeforeGetVizDataInterceptEnabled?: boolean;
1129
1129
  /**
1130
1130
  * Flag to use home page search bar mode
1131
- * @version SDK : 1.33.0 | Thoughtspot : 10.2.0.cl
1131
+ * @version SDK : 1.33.0 | Thoughtspot : 10.3.0.cl
1132
1132
  */
1133
1133
  homePageSearchBarMode?: HomePageSearchBarMode;
1134
1134
  /**
1135
- * This flag is used to enable the compact header in liveboard
1135
+ * This flag can be used to enable the compact header in Liveboard
1136
1136
  * @type {boolean}
1137
1137
  * @default false
1138
1138
  * @version SDK: 1.35.0 | ThoughtSpot:10.3.0.cl
@@ -1146,7 +1146,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1146
1146
  */
1147
1147
  isLiveboardCompactHeaderEnabled?: boolean;
1148
1148
  /**
1149
- * This flag is used to show/hide verified Icon in liveboard compact header
1149
+ * This flag can be used to show or hide the Liveboard verified icon in the compact header.
1150
1150
  * @type {boolean}
1151
1151
  * @default true
1152
1152
  * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
@@ -1160,7 +1160,7 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1160
1160
  */
1161
1161
  showLiveboardVerifiedBadge?: boolean;
1162
1162
  /**
1163
- * This flag is used to show/hide re-verify banner in liveboard compact header
1163
+ * This flag can be used to show or hide the re-verify banner on the Liveboard compact header
1164
1164
  * @type {boolean}
1165
1165
  * @default true
1166
1166
  * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
@@ -1173,6 +1173,20 @@ export interface AppViewConfig extends Omit<ViewConfig, 'visibleTabs'> {
1173
1173
  * ```
1174
1174
  */
1175
1175
  showLiveboardReverifyBanner?: boolean;
1176
+ /**
1177
+ * This flag is used to enable unified search experience for full app embed.
1178
+ * @type {boolean}
1179
+ * @default true
1180
+ * @version SDK: 1.34.0 | ThoughtSpot:10.5.0.cl
1181
+ * @example
1182
+ * ```js
1183
+ * const embed = new AppEmbed('#embed-container', {
1184
+ * ... // other options
1185
+ * isUnifiedSearchExperienceEnabled: true,
1186
+ * })
1187
+ * ```
1188
+ */
1189
+ isUnifiedSearchExperienceEnabled?: boolean;
1176
1190
  }
1177
1191
  /**
1178
1192
  * Embeds full ThoughtSpot experience in a host application.
@@ -2203,6 +2217,28 @@ export interface EmbedConfig {
2203
2217
  * @version SDK 1.32.3 | Thoughtspot: *
2204
2218
  */
2205
2219
  disableLoginFailurePage?: boolean;
2220
+ /**
2221
+ * This is an object (key/val) of override flags which will be applied
2222
+ * to the internal embedded object. This can be used to add any
2223
+ * URL flag.
2224
+ * Warning: This option is for advanced use only and is used internally
2225
+ * to control embed behavior in non-regular ways. We do not publish the
2226
+ * list of supported keys and values associated with each.
2227
+ * @example
2228
+ * ```js
2229
+ * const embed = new LiveboardEmbed('#embed', {
2230
+ * ... // other liveboard view config
2231
+ * additionalFlags: {
2232
+ * flag1: 'value1',
2233
+ * flag2: 'value2'
2234
+ * }
2235
+ * });
2236
+ * ```
2237
+ * @version SDK: 1.33.5 | ThoughtSpot: *
2238
+ */
2239
+ additionalFlags?: {
2240
+ [key: string]: string | number | boolean;
2241
+ };
2206
2242
  }
2207
2243
  export interface LayoutConfig {
2208
2244
  }
@@ -2390,6 +2426,7 @@ export interface ViewConfig {
2390
2426
  * This is an object (key/val) of override flags which will be applied
2391
2427
  * to the internal embedded object. This can be used to add any
2392
2428
  * URL flag.
2429
+ * If the same flags are passed in init, they will be overriden by the values here.
2393
2430
  * Warning: This option is for advanced use only and is used internally
2394
2431
  * to control embed behavior in non-regular ways. We do not publish the
2395
2432
  * list of supported keys and values associated with each.
@@ -2628,7 +2665,7 @@ export interface ViewConfig {
2628
2665
  */
2629
2666
  enableV2Shell_experimental?: boolean;
2630
2667
  /**
2631
- * To set the initial state of the search bar in case of saved-answers.
2668
+ * To set the initial state of the search bar in case of saved Answers.
2632
2669
  * @default true
2633
2670
  * @version SDK: 1.34.0 | Thoughtspot: 10.3.0.cl
2634
2671
  * @example
@@ -2641,7 +2678,7 @@ export interface ViewConfig {
2641
2678
  collapseSearchBar?: boolean;
2642
2679
  /**
2643
2680
  * This flag can be used to disable links inside the embedded app,
2644
- * and disables redirection of links in a new tab.
2681
+ * and disable redirection of links in a new tab.
2645
2682
  * @example
2646
2683
  * ```js
2647
2684
  * const embed = new LiveboardEmbed('#embed', {
@@ -2653,7 +2690,7 @@ export interface ViewConfig {
2653
2690
  disableRedirectionLinksInNewTab?: boolean;
2654
2691
  /**
2655
2692
  * Flag to control Data panel experience
2656
- * @default true
2693
+ * @default false
2657
2694
  * @version SDK: 1.34.0 | Thoughtspot: 10.3.0.cl
2658
2695
  * @example
2659
2696
  * ```js
@@ -2677,6 +2714,19 @@ export interface ViewConfig {
2677
2714
  * ```
2678
2715
  */
2679
2716
  enableCustomColumnGroups?: boolean;
2717
+ /**
2718
+ * View content for another org directly without having to use the org switcher
2719
+ * This flag is honoured if orgPerUrl feature is enabled for the ThoughtSpot cluster
2720
+ * @example
2721
+ * ```js
2722
+ * const embed = new LiveboardEmbed('#embed', {
2723
+ * ... // other options
2724
+ * overrideOrgId: 142536
2725
+ * });
2726
+ * ```
2727
+ * @version SDK: 1.35.0 | ThoughtSpot: 10.5.0.cl
2728
+ */
2729
+ overrideOrgId?: number;
2680
2730
  }
2681
2731
  /**
2682
2732
  * MessagePayload: Embed event payload: message type, data and status (start/end)
@@ -2722,7 +2772,7 @@ export type MessageCallbackObj = {
2722
2772
  };
2723
2773
  export type GenericCallbackFn = (...args: any[]) => any;
2724
2774
  export type QueryParams = {
2725
- [key: string]: string;
2775
+ [key: string]: string | boolean | number;
2726
2776
  };
2727
2777
  /**
2728
2778
  * A map of the supported runtime filter operations
@@ -3761,22 +3811,26 @@ export declare enum EmbedEvent {
3761
3811
  */
3762
3812
  Rename = "rename",
3763
3813
  /**
3764
- * Emitted if the user wants to intercept the search execution
3765
- * and implement logic to decide whether to run the search or not
3766
3814
  *
3767
- * Prerequisite: Set isOnBeforeGetVizDataInterceptEnabled : true
3815
+ * This event can be emitted to intercept search execution initiated by
3816
+ * the users and implement the logic to allow or restrict search execution.
3817
+ * You can can also show custom error text if the search query must be
3818
+ * restricted due to your application or business requirements.
3819
+
3820
+ * Prerequisite: Set `isOnBeforeGetVizDataInterceptEnabled` to `true`
3768
3821
  * for this embed event to get emitted.
3769
3822
  * @param: payload
3770
3823
  * @param: responder
3771
3824
  * Contains elements that lets developers define whether ThoughtSpot
3772
- * will run the search or not, and if not, which error message to provide.
3825
+ * should run the search, and if not, what error message
3826
+ * should be shown to the user.
3773
3827
  *
3774
- * execute: When execute returns true, the search will be run.
3775
- * When execute returns false, the search will not be executed.
3828
+ * execute: When execute returns `true`, the search will be run.
3829
+ * When execute returns `false`, the search will not be executed.
3776
3830
  *
3777
- * error: Developers can customize the user facing message when execute is
3778
- * set to false using the error parameter in responder
3779
- * @version SDK : 1.29.0 | Thoughtspot : 10.2.0.cl
3831
+ * error: Developers can customize the error message text when `execute`
3832
+ * returns `false` using the error parameter in responder.
3833
+ * @version SDK : 1.29.0 | Thoughtspot : 10.3.0.cl
3780
3834
  * @example
3781
3835
  *```js
3782
3836
  * .on(EmbedEvent.OnBeforeGetVizDataIntercept,
@@ -3816,15 +3870,15 @@ export declare enum EmbedEvent {
3816
3870
  */
3817
3871
  OnBeforeGetVizDataIntercept = "onBeforeGetVizDataIntercept",
3818
3872
  /**
3819
- * Emitted when parameter changes in an answer
3820
- * or liveboard
3873
+ * Emitted when parameter changes in an Answer
3874
+ * or Liveboard
3821
3875
  *
3822
3876
  * ```js
3823
3877
  * liveboardEmbed.on(EmbedEvent.ParameterChanged, (payload) => {
3824
3878
  * console.log('payload', payload);
3825
3879
  * })
3826
3880
  *```
3827
- * @version SDK : 1.29.0 | Thoughtspot : 10.2.0.cl
3881
+ * @version SDK : 1.29.0 | Thoughtspot : 10.3.0.cl
3828
3882
  */
3829
3883
  ParameterChanged = "parameterChanged"
3830
3884
  }
@@ -4553,11 +4607,13 @@ export declare enum HostEvent {
4553
4607
  * see link:https://developers.thoughtspot.com/docs/runtime-filters#rtOperator[Developer Documentation].
4554
4608
  *
4555
4609
  * `values` - An array of one or several values. The value definition on the
4556
- * data type you choose to filter on. For a complete list of supported data types, see
4557
- * link:https://developers.thoughtspot.com/docs/runtime-filters#_supported_data_types[Supported data types]
4610
+ * data type you choose to filter on. For a complete list of supported data types,
4611
+ * see
4612
+ * link:https://developers.thoughtspot.com/docs/runtime-filters#_supported_data_types[Supported
4613
+ * data types].
4614
+ *
4558
4615
  * `type` - To update filters for date time, specify the date format type.
4559
4616
  * For more information and examples, see link:https://developers.thoughtspot.com/docs/embed-liveboard#_date_filters[Date filters].
4560
- *
4561
4617
  * @example
4562
4618
  * ```js
4563
4619
  *
@@ -4842,7 +4898,9 @@ export declare enum Param {
4842
4898
  ShowLiveboardVerifiedBadge = "showLiveboardVerifiedBadge",
4843
4899
  ShowLiveboardReverifyBanner = "showLiveboardReverifyBanner",
4844
4900
  LiveboardHeaderV2 = "isLiveboardHeaderV2Enabled",
4845
- SpotterEnabled = "isSpotterExperienceEnabled"
4901
+ SpotterEnabled = "isSpotterExperienceEnabled",
4902
+ IsUnifiedSearchExperienceEnabled = "isUnifiedSearchExperienceEnabled",
4903
+ OverrideOrgId = "orgId"
4846
4904
  }
4847
4905
  /**
4848
4906
  * ThoughtSpot application pages include actions and menu commands
@@ -5812,7 +5870,7 @@ export declare enum Action {
5812
5870
  */
5813
5871
  AIHighlights = "AIHighlights",
5814
5872
  /**
5815
- * Action ID for edit schedule action on schedule on homepage
5873
+ * Action ID for edit the schedule action on schedule on homepage
5816
5874
  * @example
5817
5875
  * ```js
5818
5876
  * disabledActions: [Action.EditScheduleHomepage]
@@ -5873,7 +5931,16 @@ export declare enum Action {
5873
5931
  * ```
5874
5932
  * @version SDK: 1.34.0 | Thoughtspot: 10.3.0.cl
5875
5933
  */
5876
- KPIAnalysisCTA = "kpiAnalysisCTA"
5934
+ KPIAnalysisCTA = "kpiAnalysisCTA",
5935
+ /**
5936
+ * Action ID for disabling chip reorder in Answer and Liveboard
5937
+ * @example
5938
+ * ```js
5939
+ * const disabledActions = [Action.DisableChipReorder]
5940
+ * ```
5941
+ * @version SDK: 1.35.0 | Thoughtspot: 10.5.0.cl
5942
+ */
5943
+ DisableChipReorder = "disableChipReorder"
5877
5944
  }
5878
5945
  export interface AnswerServiceType {
5879
5946
  getAnswer?: (offset: number, batchSize: number) => any;
@@ -6324,10 +6391,13 @@ export declare const handleAuth: () => Promise<boolean>;
6324
6391
  * to your app.
6325
6392
  * @param url The URL provided for prefetch
6326
6393
  * @param prefetchFeatures Specify features which needs to be prefetched.
6394
+ * @param additionalFlags This can be used to add any URL flag.
6327
6395
  * @version SDK: 1.4.0 | ThoughtSpot: ts7.sep.cl, 7.2.1
6328
6396
  * @group Global methods
6329
6397
  */
6330
- export declare const prefetch: (url?: string, prefetchFeatures?: PrefetchFeatures[]) => void;
6398
+ export declare const prefetch: (url?: string, prefetchFeatures?: PrefetchFeatures[], additionalFlags?: {
6399
+ [key: string]: string | number | boolean;
6400
+ }) => void;
6331
6401
  /**
6332
6402
  * Initializes the Visual Embed SDK globally and perform
6333
6403
  * authentication if applicable. This function needs to be called before any ThoughtSpot
@@ -6431,6 +6501,10 @@ export declare const exportTML: (data: exportTMLInput) => Promise<any>;
6431
6501
  */
6432
6502
  export declare function reset(): void;
6433
6503
 
6504
+ /**
6505
+ * Configuration for bodyless conversation options.
6506
+ * @group Embed components
6507
+ */
6434
6508
  export interface BodylessConversationViewConfig extends ViewConfig {
6435
6509
  /**
6436
6510
  * The ID of the worksheet to use for the conversation.
@@ -6440,6 +6514,19 @@ export interface BodylessConversationViewConfig extends ViewConfig {
6440
6514
  /**
6441
6515
  * Create a conversation embed, which can be integrated inside
6442
6516
  * chatbots or other conversational interfaces.
6517
+ * @example
6518
+ * ```js
6519
+ * import { BodylessConversation } from '@thoughtspot/visual-embed-sdk';
6520
+ *
6521
+ * const conversation = new BodylessConversation({
6522
+ * worksheetId: 'worksheetId',
6523
+ * });
6524
+ *
6525
+ * const { container, error } = await conversation.sendMessage('show me sales by region');
6526
+ *
6527
+ * // append the container to the DOM
6528
+ * document.body.appendChild(container); // or to any other element
6529
+ * ```
6443
6530
  * @group Embed components
6444
6531
  * @version SDK: 1.33.1 | ThoughtSpot: 10.5.0.cl
6445
6532
  */