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