@thoughtspot/visual-embed-sdk 1.51.1 → 1.52.0

package/dist/tsembed.js

@@ -1,4 +1,4 @@
-/* @thoughtspot/visual-embed-sdk version 1.51.1 */
+/* @thoughtspot/visual-embed-sdk version 1.52.0 */
 'use client';
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
@@ -1731,7 +1731,32 @@
          */
         EmbedEvent["OrgSwitched"] = "orgSwitched";
         /**
-         * Emitted when the user intercepts a URL.
+         * Emitted before the embedded ThoughtSpot app sends a network request whose
+         * fully resolved URL matches one of the `interceptUrls` in the view config.
+         * The request is held until you call `responder`, which decides whether the
+         * real request goes out or a response you supply is used in its place.
+         *
+         * Setting `interceptUrls` is what enables this; there is no separate enable
+         * flag. If `responder` is not called within `interceptTimeout` (30000 ms by
+         * default) the request fails and `EmbedEvent.Error` is emitted.
+         *
+         * The payload is `{ input, init, urlType }`, where `input` is the request
+         * URL and `init` is the `fetch` init object, with `init.body` parsed into an
+         * object when it is valid JSON. `urlType` is the matching
+         * `InterceptedApiType`; it is `InterceptedApiType.ALL` for any URL outside
+         * the recognized API groups.
+         *
+         * Interception wraps the outermost layer of `fetch`, so `init` holds the
+         * request as the application composed it, before ThoughtSpot attaches its
+         * authentication headers. Those headers, and any token refresh and retry,
+         * are applied afterwards and only when you pass `execute: true`. Only
+         * requests made through `fetch` are intercepted.
+         *
+         * Pass `execute: true` to let the original request proceed untouched, in
+         * which case any `response` you supply alongside it is ignored. With
+         * `execute: false` the request is never sent, and your `response.body` is
+         * returned to the app as JSON, defaulting to status 200 and a
+         * `Content-Type: application/json` header.
          *
          * Supported on all embed types.
          *
@@ -2541,7 +2566,7 @@
          *
          * Unlike {@link HostEvent.OpenFilter}, which opens the panel of an
          * existing filter, this event starts the creation of a new filter.
-         * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+         * @version SDK: 1.51.1 | ThoughtSpot Cloud: 26.8.0.cl
          * @example
          * ```js
          * liveboardEmbed.trigger(HostEvent.OpenAddFilterModal);
@@ -2557,7 +2582,7 @@
          * Hiding the *Add parameter* button with `hiddenActions:
          * [Action.AddParameter]` does not block this event, but disabling it
          * with `disabledActions` does.
-         * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+         * @version SDK: 1.51.1 | ThoughtSpot Cloud: 26.8.0.cl
          * @example
          * ```js
          * liveboardEmbed.trigger(HostEvent.OpenAddParameterModal);
@@ -4435,7 +4460,13 @@
          */
         HostEvent["UpdateEmbedParams"] = "updateEmbedParams";
         /**
-         * Triggered when the embed needs to be destroyed. This is used to clean up any embed-related resources internally.
+         * Notifies the embedded ThoughtSpot app that the embed is being torn down, so that
+         * it can release any resources it holds before the iframe is removed from the DOM.
+         *
+         * This is triggered for you by `embed.destroy()`; you rarely need to trigger it
+         * directly. If `waitForCleanupOnDestroy` is set in the embed config, `destroy()`
+         * waits for the app to acknowledge this event (up to `cleanupTimeout`) before
+         * removing the iframe.
          * @example
          * ```js
          * liveboardEmbed.trigger(HostEvent.DestroyEmbed);
@@ -6553,7 +6584,7 @@
          * ```js
          * hiddenActions: [Action.QuickSearchPill]
          * ```
-         * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+         * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
          */
         Action["QuickSearchPill"] = "quickSearchPill";
         /**
@@ -6568,7 +6599,7 @@
          * ```js
          * hiddenActions: [Action.DeepAnalysisPill]
          * ```
-         * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+         * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
          */
         Action["DeepAnalysisPill"] = "deepAnalysisPill";
         /**
@@ -6583,7 +6614,7 @@
          * ```js
          * hiddenActions: [Action.DataLiteracyPill]
          * ```
-         * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+         * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
          */
         Action["DataLiteracyPill"] = "dataLiteracyPill";
         /**
@@ -7056,6 +7087,36 @@
         /** UpdateParameters payload is invalid - malformed applicability */
         EmbedErrorCodes["UPDATEPARAMETERS_INVALID_PAYLOAD"] = "UPDATEPARAMETERS_INVALID_PAYLOAD";
     })(exports.EmbedErrorCodes || (exports.EmbedErrorCodes = {}));
+    /**
+     * How badly an error affects the embed, so the host can decide whether it is
+     * worth surfacing to the end user.
+     *
+     * Mirrors the severity that ThoughtSpot itself stamps on errors raised inside
+     * the embedded app, so a host can apply one rule to both sources.
+     *
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     * @group Error Handling
+     *
+     * @example
+     * Only surface errors that took the embed down
+     *
+     * ```js
+     * embed.on(EmbedEvent.Error, (error) => {
+     *   if (error.severity === EmbedErrorSeverity.SEV1) {
+     *     showBanner(error.message);
+     *   }
+     * });
+     * ```
+     */
+    exports.EmbedErrorSeverity = void 0;
+    (function (EmbedErrorSeverity) {
+        /** The embed cannot render. Nothing usable is on screen. */
+        EmbedErrorSeverity[EmbedErrorSeverity["SEV1"] = 1] = "SEV1";
+        /** Something is degraded but the embed still works. */
+        EmbedErrorSeverity[EmbedErrorSeverity["SEV2"] = 2] = "SEV2";
+        /** Everything else, including validation of the embedder's own input. */
+        EmbedErrorSeverity[EmbedErrorSeverity["SEV3"] = 3] = "SEV3";
+    })(exports.EmbedErrorSeverity || (exports.EmbedErrorSeverity = {}));
     /**
      * Context types for specifying the page context when triggering host events.
      * Used as the third parameter in the `trigger` method to help ThoughtSpot
@@ -7096,20 +7157,27 @@
         ContextType["Other"] = "other";
     })(exports.ContextType || (exports.ContextType = {}));
     /**
-     * Enum for the type of API intercepted
+     * Named groups of ThoughtSpot APIs that can be intercepted, for use in
+     * `interceptUrls`. Each group expands to the underlying request URLs, so you do
+     * not have to list them individually.
      */
     exports.InterceptedApiType = void 0;
     (function (InterceptedApiType) {
         /**
-         * The apis that are use to get the data for the embed
+         * The APIs that fetch the data backing an Answer, including its chart,
+         * table, and headline data.
          */
         InterceptedApiType["AnswerData"] = "AnswerData";
         /**
-         * This will intercept all the apis
+         * Intercepts every `fetch` request the embedded application makes, not only
+         * the data APIs. This includes authentication, session, and metadata calls,
+         * so the handler must respond to requests it does not recognize by passing
+         * `execute: true`. Listing this alongside other entries in `interceptUrls`
+         * supersedes them.
          */
         InterceptedApiType["ALL"] = "ALL";
         /**
-         * The apis that are use to get the data for the liveboard
+         * The APIs that fetch the data backing a Liveboard.
          */
         InterceptedApiType["LiveboardData"] = "LiveboardData";
     })(exports.InterceptedApiType || (exports.InterceptedApiType = {}));
@@ -7233,7 +7301,7 @@
         TableContentDensity["Compact"] = "COMPACT";
     })(exports.TableContentDensity || (exports.TableContentDensity = {}));
 
-    var version$1="1.51.1";var pkg = {version:version$1};
+    var version$1="1.52.0";var pkg = {version:version$1};
 
     const { version } = pkg;
 
@@ -7481,6 +7549,23 @@
         }
         return JSON.stringify(value);
     };
+    /**
+     * Inverse of serializeParam: JSON.parse with fallback to the raw string,
+     * matching how the app parses the same values from the iframe URL.
+     */
+    const deserializeParam = (value) => {
+        if (typeof value !== 'string')
+            return value;
+        try {
+            const parsed = JSON.parse(value);
+            // Numeric strings stay strings ('123' !== 123), same as the app's
+            // URL parser — param consumers expect string ids/versions.
+            return typeof parsed === 'number' ? value : parsed;
+        }
+        catch (e) {
+            return value;
+        }
+    };
     /**
      * Convert a value to a string:
      * in case of an array, we convert it to CSV.
@@ -21257,6 +21342,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                 errorType: exports.ErrorDetailsTypes.API,
                 message: ERROR_MESSAGE.ERROR_PARSING_API_INTERCEPT_BODY,
                 code: exports.EmbedErrorCodes.PARSING_API_INTERCEPT_BODY_ERROR,
+                severity: exports.EmbedErrorSeverity.SEV3,
                 error: ERROR_MESSAGE.ERROR_PARSING_API_INTERCEPT_BODY,
             };
             executeEvent(exports.EmbedEvent.Error, errorDetails);
@@ -21601,6 +21687,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                 errorType: exports.ErrorDetailsTypes.VALIDATION_ERROR,
                 message: ERROR_MESSAGE.INIT_SDK_REQUIRED,
                 code: exports.EmbedErrorCodes.INIT_ERROR,
+                severity: exports.EmbedErrorSeverity.SEV1,
                 error: ERROR_MESSAGE.INIT_SDK_REQUIRED,
             });
         }
@@ -21611,7 +21698,10 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
          */
         handleError(errorDetails) {
             this.isError = true;
-            this.executeCallbacks(exports.EmbedEvent.Error, errorDetails);
+            this.executeCallbacks(exports.EmbedEvent.Error, {
+                severity: exports.EmbedErrorSeverity.SEV3,
+                ...errorDetails,
+            });
             // Log error
             logger$3.error(errorDetails);
         }
@@ -21696,6 +21786,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                     errorType: exports.ErrorDetailsTypes.NETWORK,
                     message: ERROR_MESSAGE.OFFLINE_WARNING,
                     code: exports.EmbedErrorCodes.NETWORK_ERROR,
+                    severity: exports.EmbedErrorSeverity.SEV2,
                     offlineWarning: ERROR_MESSAGE.OFFLINE_WARNING,
                 };
                 this.executeCallbacks(exports.EmbedEvent.Error, errorDetails);
@@ -21853,10 +21944,14 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
             return `${basePath}#`;
         }
         async getUpdateEmbedParamsObject() {
-            let queryParams = this.getEmbedParamsObject();
+            const queryParams = this.getEmbedParamsObject();
+            // Values are URL-serialized (e.g. dataSources as '["guid"]'); parse
+            // them back so the event payload matches a URL load (SCAL-334713).
+            Object.keys(queryParams).forEach((key) => {
+                queryParams[key] = deserializeParam(queryParams[key]);
+            });
             const appInitData = await this.getAppInitData();
-            queryParams = { ...this.viewConfig, ...queryParams, ...appInitData };
-            return queryParams;
+            return { ...this.viewConfig, ...queryParams, ...appInitData };
         }
         /**
          * Common query params set for all the embed modes.
@@ -22064,9 +22159,10 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
             return iFrame;
         }
         /**
-         * Returns a merged {@link PreRenderConfig} object where each shared key
-         * prefers `preRenderConfig.key` over the top-level `viewConfig.key` for
-         * backward compatibility.
+         * Returns a merged {@link PreRenderConfig} object where each key prefers the
+         * value from `preRenderConfig` over its deprecated top-level `viewConfig`
+         * counterpart (`id`/`preRenderId`, `containerSelector`/`preRenderContainer`,
+         * `doNotTrackSize`/`doNotTrackPreRenderSize`) for backward compatibility.
          */
         getPreRenderConfig() {
             var _a, _b, _c, _d;
@@ -22074,16 +22170,16 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
             const preRenderCfg = (_a = viewCfg.preRenderConfig) !== null && _a !== void 0 ? _a : {};
             return {
                 ...preRenderCfg,
-                preRenderId: (_b = preRenderCfg.preRenderId) !== null && _b !== void 0 ? _b : viewCfg.preRenderId,
-                preRenderContainer: (_c = preRenderCfg.preRenderContainer) !== null && _c !== void 0 ? _c : viewCfg.preRenderContainer,
-                doNotTrackPreRenderSize: (_d = preRenderCfg.doNotTrackPreRenderSize) !== null && _d !== void 0 ? _d : viewCfg.doNotTrackPreRenderSize,
+                id: (_b = preRenderCfg.id) !== null && _b !== void 0 ? _b : viewCfg.preRenderId,
+                containerSelector: (_c = preRenderCfg.containerSelector) !== null && _c !== void 0 ? _c : viewCfg.preRenderContainer,
+                doNotTrackSize: (_d = preRenderCfg.doNotTrackSize) !== null && _d !== void 0 ? _d : viewCfg.doNotTrackPreRenderSize,
             };
         }
         /**
          * Returns true if this embed instance is configured for pre-rendering.
          */
         isPreRenderEmbed() {
-            return !!this.getPreRenderConfig().preRenderId;
+            return !!this.getPreRenderConfig().id;
         }
         handleInsertionIntoDOM(child) {
             if (this.isPreRenderEmbed()) {
@@ -22179,6 +22275,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                         errorType: exports.ErrorDetailsTypes.API,
                         message: error.message || ERROR_MESSAGE.LOGIN_FAILED,
                         code: exports.EmbedErrorCodes.LOGIN_FAILED,
+                        severity: exports.EmbedErrorSeverity.SEV1,
                         error: error,
                     });
                 });
@@ -22270,7 +22367,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
          */
         resolvePreRenderContainerTarget() {
             var _a;
-            const containerConfig = this.getPreRenderConfig().preRenderContainer;
+            const containerConfig = this.getPreRenderConfig().containerSelector;
             let container = null;
             if (typeof containerConfig === 'string') {
                 try {
@@ -22295,7 +22392,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                 return;
             }
             const ownerContainer = (_a = preRenderedObject.preRenderContainerEl) !== null && _a !== void 0 ? _a : document.body;
-            if (this.getPreRenderConfig().preRenderContainer
+            if (this.getPreRenderConfig().containerSelector
                 && this.resolvePreRenderContainerTarget() !== ownerContainer) {
                 logger$3.warn('preRenderContainer is applied only by the component that creates the preRender; '
                     + 'the one passed here is ignored. Set it on the PreRender component instead.');
@@ -22792,7 +22889,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                 showPreRenderByDefault,
                 replaceExistingPreRender,
             });
-            if (!this.getPreRenderConfig().preRenderId) {
+            if (!this.getPreRenderConfig().id) {
                 logger$3.error(ERROR_MESSAGE.PRERENDER_ID_MISSING);
                 return this;
             }
@@ -22968,12 +23065,12 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
         async showPreRender() {
             var _a, _b;
             uploadMixpanelEvent(MIXPANEL_EVENT.VISUAL_SDK_SHOW_PRE_RENDER, {
-                preRenderId: this.getPreRenderConfig().preRenderId,
+                preRenderId: this.getPreRenderConfig().id,
                 embedComponentType: this.viewConfig.embedComponentType,
             });
             if (this.shouldWaitForRenderPromise)
                 await this.isReadyForRenderPromise;
-            if (!this.getPreRenderConfig().preRenderId) {
+            if (!this.getPreRenderConfig().id) {
                 logger$3.error(ERROR_MESSAGE.PRERENDER_ID_MISSING);
                 return this;
             }
@@ -23009,7 +23106,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                     this.containerScrollListener = () => this.syncPreRenderStyle();
                     customContainer.addEventListener('scroll', this.containerScrollListener);
                 }
-                if (!this.getPreRenderConfig().doNotTrackPreRenderSize) {
+                if (!this.getPreRenderConfig().doNotTrackSize) {
                     const observeTarget = (_b = this.insertedDomEl) !== null && _b !== void 0 ? _b : this.hostElement;
                     this.resizeObserver = new ResizeObserver((entries) => {
                         entries.forEach((entry) => {
@@ -23077,7 +23174,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
          */
         hidePreRender() {
             uploadMixpanelEvent(MIXPANEL_EVENT.VISUAL_SDK_HIDE_PRE_RENDER, {
-                preRenderId: this.getPreRenderConfig().preRenderId,
+                preRenderId: this.getPreRenderConfig().id,
                 embedComponentType: this.viewConfig.embedComponentType,
             });
             logger$3.debug('HidePreRender Called');
@@ -23115,7 +23212,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
          * @property {string} child - The HTML element ID for the PreRender child.
          */
         getPreRenderIds() {
-            const preRenderId = this.getPreRenderConfig().preRenderId;
+            const preRenderId = this.getPreRenderConfig().id;
             return {
                 wrapper: `${PRERENDER_WRAPPER_ID_PREFIX}${preRenderId}`,
                 child: `tsEmbed-pre-render-child-${preRenderId}`,
@@ -24324,6 +24421,7 @@ query GetEurekaVizSnapshots(
                     errorType: exports.ErrorDetailsTypes.VALIDATION_ERROR,
                     message: ERROR_MESSAGE.LIVEBOARD_VIZ_ID_VALIDATION,
                     code: exports.EmbedErrorCodes.LIVEBOARD_ID_MISSING,
+                    severity: exports.EmbedErrorSeverity.SEV1,
                     error: ERROR_MESSAGE.LIVEBOARD_VIZ_ID_VALIDATION,
                 });
             }
@@ -24475,7 +24573,7 @@ query GetEurekaVizSnapshots(
             if (this.isRendered) {
                 this.trigger(exports.HostEvent.Navigate, path.substring(1));
             }
-            else if (this.getPreRenderConfig().preRenderId) {
+            else if (this.getPreRenderConfig().id) {
                 this.preRender(true);
             }
             else {