@thoughtspot/visual-embed-sdk 1.51.2 → 1.52.1

package/cjs/src/embed/ts-embed.spec.js

@@ -20,7 +20,7 @@ const logger_1 = require("../utils/logger");
 const package_json_1 = require("../../package.json");
 const search_1 = require("./search");
 const processTrigger_1 = require("../utils/processTrigger");
-const contracts_1 = require("./hostEventClient/contracts");
+const ui_passthrough_contracts_1 = require("../contracts/ui-passthrough-contracts");
 const sessionInfoService = tslib_1.__importStar(require("../utils/sessionInfoService"));
 const authToken = tslib_1.__importStar(require("../authToken"));
 const apiIntercept = tslib_1.__importStar(require("../api-intercept"));
@@ -141,10 +141,10 @@ describe('Unit test case for ts embed', () => {
             mockProcessTrigger.mockResolvedValue({ session: 'test' });
             await (0, test_utils_1.executeAfterWait)(async () => {
                 const payload = { newVizName: 'test' };
-                await searchEmbed.triggerUIPassThrough(contracts_1.UIPassthroughEvent.PinAnswerToLiveboard, payload);
+                await searchEmbed.triggerUIPassThrough(ui_passthrough_contracts_1.UIPassthroughEvent.PinAnswerToLiveboard, payload);
                 expect(mockProcessTrigger).toHaveBeenCalledWith((0, test_utils_1.getIFrameEl)(), types_1.HostEvent.UIPassthrough, 'http://tshost', {
                     parameters: payload,
-                    type: contracts_1.UIPassthroughEvent.PinAnswerToLiveboard,
+                    type: ui_passthrough_contracts_1.UIPassthroughEvent.PinAnswerToLiveboard,
                 }, undefined);
             });
         });
@@ -168,6 +168,9 @@ describe('Unit test case for ts embed', () => {
             liveboardEmbed.render();
             mockProcessTrigger.mockResolvedValue({ session: 'test' });
             await (0, test_utils_1.executeAfterWait)(async () => {
+                // `false` is a deliberately off-contract payload here — this
+                // asserts raw passthrough to processTrigger, not a real Save
+                // payload — so it is cast past the typed `data` parameter.
                 await liveboardEmbed.trigger(types_1.HostEvent.Save, false);
                 expect(mockProcessTrigger).toHaveBeenCalledWith((0, test_utils_1.getIFrameEl)(), types_1.HostEvent.Save, 'http://tshost', false, undefined);
             });
@@ -1561,9 +1564,48 @@ describe('Unit test case for ts embed', () => {
                 errorType: types_1.ErrorDetailsTypes.VALIDATION_ERROR,
                 message: errors_1.ERROR_MESSAGE.INIT_SDK_REQUIRED,
                 code: types_1.EmbedErrorCodes.INIT_ERROR,
+                severity: types_1.EmbedErrorSeverity.SEV1,
                 error: errors_1.ERROR_MESSAGE.INIT_SDK_REQUIRED,
             });
         });
+        test('a missing init is reported to the host as SEV1', async () => {
+            const errorHandler = jest.fn();
+            const tsEmbed = new index_1.SearchEmbed((0, test_utils_1.getRootEl)(), {});
+            tsEmbed.on(index_1.EmbedEvent.Error, errorHandler);
+            await tsEmbed.render();
+            expect(errorHandler.mock.calls[0][0]).toEqual(expect.objectContaining({
+                code: types_1.EmbedErrorCodes.INIT_ERROR,
+                severity: types_1.EmbedErrorSeverity.SEV1,
+            }));
+        });
+    });
+    describe('error severity', () => {
+        beforeEach(() => {
+            jest.spyOn(config, 'getThoughtSpotHost').mockImplementation(() => 'http://tshost');
+        });
+        test('defaults to SEV3 when the raising site does not set one', () => {
+            const errorHandler = jest.fn();
+            const tsEmbed = new index_1.SearchEmbed((0, test_utils_1.getRootEl)(), {});
+            tsEmbed.on(index_1.EmbedEvent.Error, errorHandler);
+            tsEmbed.handleError({
+                errorType: types_1.ErrorDetailsTypes.VALIDATION_ERROR,
+                message: 'no severity set',
+                code: types_1.EmbedErrorCodes.HOST_EVENT_VALIDATION,
+            });
+            expect(errorHandler.mock.calls[0][0]).toEqual(expect.objectContaining({ severity: types_1.EmbedErrorSeverity.SEV3 }));
+        });
+        test('does not override a severity the raising site set', () => {
+            const errorHandler = jest.fn();
+            const tsEmbed = new index_1.SearchEmbed((0, test_utils_1.getRootEl)(), {});
+            tsEmbed.on(index_1.EmbedEvent.Error, errorHandler);
+            tsEmbed.handleError({
+                errorType: types_1.ErrorDetailsTypes.VALIDATION_ERROR,
+                message: 'explicitly fatal',
+                code: types_1.EmbedErrorCodes.HOST_EVENT_VALIDATION,
+                severity: types_1.EmbedErrorSeverity.SEV1,
+            });
+            expect(errorHandler.mock.calls[0][0]).toEqual(expect.objectContaining({ severity: types_1.EmbedErrorSeverity.SEV1 }));
+        });
     });
     describe('V1Embed ', () => {
         beforeEach(() => {
@@ -2901,12 +2943,12 @@ describe('Unit test case for ts embed', () => {
                 expect(preRenderWrapper.style.zIndex).toBe('-5');
                 libEmbed.destroy();
             });
-            it('should use preRenderConfig.preRenderId to identify the pre-render instance', async () => {
+            it('should use preRenderConfig.id to identify the pre-render instance', async () => {
                 (0, test_utils_1.createRootEleForEmbed)();
                 const libEmbed = new index_1.LiveboardEmbed('#tsEmbedDiv', {
                     liveboardId: 'myLiveboardId',
                     preRenderConfig: {
-                        preRenderId: 'config-level-id',
+                        id: 'config-level-id',
                     },
                 });
                 await libEmbed.preRender();
@@ -2916,13 +2958,13 @@ describe('Unit test case for ts embed', () => {
                 expect(document.getElementById(preRenderIds.wrapper)).not.toBeNull();
                 libEmbed.destroy();
             });
-            it('should prefer preRenderConfig.preRenderId over top-level preRenderId', async () => {
+            it('should prefer preRenderConfig.id over top-level preRenderId', async () => {
                 (0, test_utils_1.createRootEleForEmbed)();
                 const libEmbed = new index_1.LiveboardEmbed('#tsEmbedDiv', {
                     liveboardId: 'myLiveboardId',
                     preRenderId: 'top-level-id',
                     preRenderConfig: {
-                        preRenderId: 'config-level-id',
+                        id: 'config-level-id',
                     },
                 });
                 await libEmbed.preRender();
@@ -2932,7 +2974,7 @@ describe('Unit test case for ts embed', () => {
                 expect(preRenderIds.wrapper).not.toContain('top-level-id');
                 libEmbed.destroy();
             });
-            it('should mount the wrapper into preRenderConfig.preRenderContainer', async () => {
+            it('should mount the wrapper into preRenderConfig.containerSelector', async () => {
                 (0, test_utils_1.createRootEleForEmbed)();
                 const customContainer = document.createElement('div');
                 customContainer.id = 'config-level-container';
@@ -2940,8 +2982,8 @@ describe('Unit test case for ts embed', () => {
                 const libEmbed = new index_1.LiveboardEmbed('#tsEmbedDiv', {
                     liveboardId: 'myLiveboardId',
                     preRenderConfig: {
-                        preRenderId: 'container-via-config',
-                        preRenderContainer: '#config-level-container',
+                        id: 'container-via-config',
+                        containerSelector: '#config-level-container',
                     },
                 });
                 await libEmbed.preRender();
@@ -2952,7 +2994,7 @@ describe('Unit test case for ts embed', () => {
                 libEmbed.destroy();
                 customContainer.remove();
             });
-            it('should prefer preRenderConfig.preRenderContainer over top-level preRenderContainer', async () => {
+            it('should prefer preRenderConfig.containerSelector over top-level preRenderContainer', async () => {
                 (0, test_utils_1.createRootEleForEmbed)();
                 const topContainer = document.createElement('div');
                 topContainer.id = 'top-level-container';
@@ -2964,8 +3006,8 @@ describe('Unit test case for ts embed', () => {
                     liveboardId: 'myLiveboardId',
                     preRenderContainer: '#top-level-container',
                     preRenderConfig: {
-                        preRenderId: 'container-precedence',
-                        preRenderContainer: '#config-level-container-2',
+                        id: 'container-precedence',
+                        containerSelector: '#config-level-container-2',
                     },
                 });
                 await libEmbed.preRender();
@@ -2978,7 +3020,7 @@ describe('Unit test case for ts embed', () => {
                 topContainer.remove();
                 configContainer.remove();
             });
-            it('should not attach ResizeObserver when preRenderConfig.doNotTrackPreRenderSize is true', async () => {
+            it('should not attach ResizeObserver when preRenderConfig.doNotTrackSize is true', async () => {
                 (0, test_utils_1.createRootEleForEmbed)();
                 const observeMock = jest.fn();
                 window.ResizeObserver = jest.fn().mockImplementation(() => ({
@@ -2989,8 +3031,8 @@ describe('Unit test case for ts embed', () => {
                 const libEmbed = new index_1.LiveboardEmbed('#tsEmbedDiv', {
                     liveboardId: 'myLiveboardId',
                     preRenderConfig: {
-                        preRenderId: 'no-track-via-config',
-                        doNotTrackPreRenderSize: true,
+                        id: 'no-track-via-config',
+                        doNotTrackSize: true,
                     },
                 });
                 await libEmbed.preRender();
@@ -2999,7 +3041,7 @@ describe('Unit test case for ts embed', () => {
                 expect(observeMock).not.toHaveBeenCalled();
                 libEmbed.destroy();
             });
-            it('should prefer preRenderConfig.doNotTrackPreRenderSize over top-level doNotTrackPreRenderSize', async () => {
+            it('should prefer preRenderConfig.doNotTrackSize over top-level doNotTrackPreRenderSize', async () => {
                 (0, test_utils_1.createRootEleForEmbed)();
                 const observeMock = jest.fn();
                 window.ResizeObserver = jest.fn().mockImplementation(() => ({
@@ -3011,8 +3053,8 @@ describe('Unit test case for ts embed', () => {
                     liveboardId: 'myLiveboardId',
                     doNotTrackPreRenderSize: false,
                     preRenderConfig: {
-                        preRenderId: 'no-track-precedence',
-                        doNotTrackPreRenderSize: true,
+                        id: 'no-track-precedence',
+                        doNotTrackSize: true,
                     },
                 });
                 await libEmbed.preRender();
@@ -3530,7 +3572,9 @@ describe('Unit test case for ts embed', () => {
         });
         test('should return getPreRenderObj and log if same object', () => {
             const searchEmbed = new index_1.SearchEmbed((0, test_utils_1.getRootEl)(), defaultViewConfig);
-            const loggerSpy = jest.spyOn(logger_1.logger, 'info');
+            // debug, not info: the wrapper points at the embed being shown, so
+            // this is now the common case rather than a rare diagnostic.
+            const loggerSpy = jest.spyOn(logger_1.logger, 'debug');
             // getPreRenderObj reads the embed reference from preRenderWrapper
             searchEmbed.preRenderWrapper = {
                 [searchEmbed['embedNodeKey']]: searchEmbed,
@@ -4232,16 +4276,6 @@ describe('Additional Coverage Tests', () => {
             expect((0, test_utils_1.getIFrameEl)().style.height).toBe('500px');
         });
     });
-    test('should test getIframeCenter calculation', async () => {
-        const searchEmbed = new index_1.SearchEmbed((0, test_utils_1.getRootEl)(), defaultViewConfig);
-        await searchEmbed.render();
-        await (0, test_utils_1.executeAfterWait)(() => {
-            const center = searchEmbed['getIframeCenter']();
-            expect(center).toHaveProperty('iframeCenter');
-            expect(center).toHaveProperty('iframeHeight');
-            expect(center).toHaveProperty('viewPortHeight');
-        });
-    });
     test('should handle preRender with replaceExistingPreRender=true', async () => {
         (0, test_utils_1.createRootEleForEmbed)();
         const embed1 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
@@ -4314,7 +4348,7 @@ describe('Trigger method edge cases', () => {
         await searchEmbed.render();
         // First processTrigger call is getAvailableUIPassthroughKeys for DrillDown
         mockProcessTrigger.mockResolvedValueOnce([
-            { value: { keys: Object.values(contracts_1.UIPassthroughEvent) } },
+            { value: { keys: Object.values(ui_passthrough_contracts_1.UIPassthroughEvent) } },
         ]);
         // DrillDown with no points → throwDrillDownValidationError → isValidationError=true
         await expect(searchEmbed.trigger(types_1.HostEvent.DrillDown, {})).rejects.toThrow('DrillDown requires a valid points object');
@@ -4541,7 +4575,8 @@ describe('ShowPreRender with UpdateEmbedParams', () => {
         });
         embed2.showPreRender();
         await (0, test_utils_1.executeAfterWait)(() => {
-            expect(mockProcessTrigger).toHaveBeenLastCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
+            // Not LastCalledWith: LiveboardEmbed fires Navigate after this.
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
                 liveboardId: 'original-lb',
                 visibleVizs: ['viz-1'],
                 runtimeFilters: [
@@ -4584,7 +4619,8 @@ describe('ShowPreRender with UpdateEmbedParams', () => {
         });
         embed2.showPreRender();
         await (0, test_utils_1.executeAfterWait)(() => {
-            expect(mockProcessTrigger).toHaveBeenLastCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
+            // Not LastCalledWith: LiveboardEmbed fires Navigate after this.
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
                 liveboardId: 'original-lb',
                 visibleVizs: ['viz-1', 'viz-2'],
                 runtimeFilters: [
@@ -4597,6 +4633,317 @@ describe('ShowPreRender with UpdateEmbedParams', () => {
             }), undefined);
         });
     });
+    test('should carry the new config filters in UpdateEmbedParams', async () => {
+        await setupPreRenderTest('params-new-filters', { liveboardId: 'original-lb' });
+        const runtimeFilters = [
+            {
+                columnName: 'Color',
+                operator: types_1.RuntimeFilterOp.IN,
+                values: ['red', 'blue'],
+            },
+        ];
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-new-filters',
+            liveboardId: 'original-lb',
+            runtimeFilters,
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
+                runtimeFilters,
+                // The serialized form is the one the container reads.
+                runtimeFilterParams: 'col1=Color&op1=IN&val1=red&val1=blue',
+            }), undefined);
+            // Everything rides in the params payload; nothing follows it.
+            const runtimeFilterCalls = mockProcessTrigger.mock.calls.filter((call) => call[1] === types_1.HostEvent.UpdateRuntimeFilters);
+            expect(runtimeFilterCalls).toHaveLength(0);
+        });
+    });
+    test('should serialize the filters when they are not excluded from the URL', async () => {
+        await setupPreRenderTest('params-url-filters', { liveboardId: 'original-lb' });
+        // With the flag off, getDefaultAppInitData leaves runtimeFilterParams
+        // null and a URL render carries the filters in the iframe's query
+        // string. A show cycle has no URL, so the payload has to carry them.
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-url-filters',
+            liveboardId: 'original-lb',
+            excludeRuntimeFiltersfromURL: false,
+            runtimeFilters: [
+                {
+                    columnName: 'Color',
+                    operator: types_1.RuntimeFilterOp.IN,
+                    values: ['red'],
+                },
+            ],
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
+                runtimeFilterParams: 'col1=Color&op1=IN&val1=red',
+            }), undefined);
+        });
+    });
+    test('should trigger Navigate only after UpdateEmbedParams has settled', async () => {
+        await setupPreRenderTest('navigate-after-params', {
+            liveboardId: 'original-lb',
+            runtimeFilters: [
+                {
+                    columnName: 'Color',
+                    operator: types_1.RuntimeFilterOp.IN,
+                    values: ['red'],
+                },
+            ],
+        });
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'navigate-after-params',
+            liveboardId: 'updated-lb',
+        });
+        embed2.showPreRender();
+        // Inside the settle window the params are already out
+        // and Navigate is not.
+        await (0, test_utils_1.executeAfterWait)(() => {
+            const eventTypes = mockProcessTrigger.mock.calls.map((call) => call[1]);
+            expect(eventTypes).toContain(types_1.HostEvent.UpdateEmbedParams);
+            expect(eventTypes).not.toContain(types_1.HostEvent.Navigate);
+        }, 50);
+        await (0, test_utils_1.executeAfterWait)(() => {
+            const eventTypes = mockProcessTrigger.mock.calls.map((call) => call[1]);
+            // A Navigate that beat the params would make the container load
+            // `updated-lb` while still holding `original-lb`'s runtime filters,
+            // and drop the params that then arrive mid-load (SCAL-336321).
+            expect(eventTypes).toContain(types_1.HostEvent.Navigate);
+            expect(eventTypes.indexOf(types_1.HostEvent.UpdateEmbedParams)).toBeLessThan(eventTypes.indexOf(types_1.HostEvent.Navigate));
+        }, 300);
+    });
+    test('should mark the params empty when the config declares no filters', async () => {
+        await setupPreRenderTest('params-clear-filters', {
+            liveboardId: 'original-lb',
+            runtimeFilters: [
+                {
+                    columnName: 'Color',
+                    operator: types_1.RuntimeFilterOp.IN,
+                    values: ['red', 'blue'],
+                },
+            ],
+        });
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-clear-filters',
+            liveboardId: 'original-lb',
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            // Not null and not '': the container only reads this field when it
+            // is truthy, so either would leave the previous embed's filters in
+            // place. A lone separator passes that gate and parses to {}.
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({ runtimeFilterParams: '&' }), undefined);
+            const runtimeFilterCalls = mockProcessTrigger.mock.calls.filter((call) => call[1] === types_1.HostEvent.UpdateRuntimeFilters);
+            expect(runtimeFilterCalls).toHaveLength(0);
+        });
+    });
+    test('should mark the params empty for an explicitly empty filter array', async () => {
+        await setupPreRenderTest('params-empty-array', {
+            liveboardId: 'original-lb',
+            runtimeFilters: [
+                {
+                    columnName: 'Color',
+                    operator: types_1.RuntimeFilterOp.IN,
+                    values: ['red'],
+                },
+            ],
+        });
+        // `runtimeFilters: []` is the shape the customer reported as not
+        // resetting anything.
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-empty-array',
+            liveboardId: 'original-lb',
+            runtimeFilters: [],
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({ runtimeFilterParams: '&' }), undefined);
+        });
+    });
+    test('should mark the params empty when no config in the chain has filters', async () => {
+        await setupPreRenderTest('params-no-filters', { liveboardId: 'original-lb' });
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-no-filters',
+            liveboardId: 'updated-lb',
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            const paramsCall = mockProcessTrigger.mock.calls.find((call) => call[1] === types_1.HostEvent.UpdateEmbedParams);
+            expect(paramsCall === null || paramsCall === void 0 ? void 0 : paramsCall[3]).not.toHaveProperty('runtimeFilters');
+            expect(paramsCall === null || paramsCall === void 0 ? void 0 : paramsCall[3].runtimeFilterParams).toBe('&');
+        });
+    });
+    test('should state each embed filters as the pre-render is handed along', async () => {
+        await setupPreRenderTest('params-chain', {
+            liveboardId: 'original-lb',
+            runtimeFilters: [
+                {
+                    columnName: 'Color',
+                    operator: types_1.RuntimeFilterOp.IN,
+                    values: ['red', 'blue'],
+                },
+            ],
+        });
+        // Second in the chain declares none, so it empties the field rather
+        // than letting the creator's filters stand.
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-chain',
+            liveboardId: 'second-lb',
+        });
+        await embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({ runtimeFilterParams: '&' }), undefined);
+        });
+        mockProcessTrigger.mockClear();
+        // Third declares its own, and states them without reference to either
+        // embed before it.
+        const embed3 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-chain',
+            liveboardId: 'third-lb',
+            runtimeFilters: [
+                {
+                    columnName: 'Region',
+                    operator: types_1.RuntimeFilterOp.EQ,
+                    values: ['North'],
+                },
+            ],
+        });
+        await embed3.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
+                runtimeFilterParams: 'col1=Region&op1=EQ&val1=North',
+            }), undefined);
+        });
+    });
+    test('should carry the new config runtime parameters in UpdateEmbedParams', async () => {
+        await setupPreRenderTest('params-parameters', {
+            liveboardId: 'original-lb',
+            runtimeParameters: [{ name: 'Region Param', value: 'East' }],
+        });
+        const runtimeParameters = [{ name: 'Region Param', value: 'West' }];
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-parameters',
+            liveboardId: 'original-lb',
+            runtimeParameters,
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
+                runtimeParameters,
+                runtimeParameterParams: 'param1=Region%20Param&paramVal1=West',
+            }), undefined);
+            // A parameter always carries a value, so the payload says everything
+            // there is to say — no follow-up event.
+            const parameterCalls = mockProcessTrigger.mock.calls.filter((call) => call[1] === types_1.HostEvent.UpdateParameters);
+            expect(parameterCalls).toHaveLength(0);
+        });
+    });
+    test('should mark the params empty when the config declares no parameters', async () => {
+        await setupPreRenderTest('params-clear-parameters', {
+            liveboardId: 'original-lb',
+            runtimeParameters: [{ name: 'Region Param', value: 'East' }],
+        });
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-clear-parameters',
+            liveboardId: 'original-lb',
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            // Same gate as the filters: the container only reads this field
+            // when it is truthy, so null would leave 'East' standing.
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({ runtimeParameterParams: '&' }), undefined);
+        });
+    });
+    test('should keep an empty string parameter value distinct from having none', async () => {
+        await setupPreRenderTest('params-empty-value', { liveboardId: 'original-lb' });
+        // `paramVal1=` is that parameter's value, not an absence — so it must
+        // not collapse to the empty marker.
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'params-empty-value',
+            liveboardId: 'original-lb',
+            runtimeParameters: [{ name: 'Region Param', value: '' }],
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            expect(mockProcessTrigger).toHaveBeenCalledWith(expect.any(Object), types_1.HostEvent.UpdateEmbedParams, expect.any(String), expect.objectContaining({
+                runtimeParameterParams: 'param1=Region%20Param&paramVal1=',
+            }), undefined);
+        });
+    });
+    test('should hand the pre-render over to the embed being shown', async () => {
+        const embed1 = await setupPreRenderTest('take-over-state', { liveboardId: 'original-lb' });
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'take-over-state',
+            liveboardId: 'second-lb',
+        });
+        await embed2.showPreRender();
+        // It connected to embed1's pre-render and is now what the wrapper
+        // points at, so getPreRenderObj() means "what is showing".
+        expect(embed2.getPreRenderObj()).toBe(embed2);
+        expect(embed1.getPreRenderObj()).toBe(embed2);
+    });
+    test('should not strand callbacks when the container loads after the shown embed was hidden', async () => {
+        // The creator is subscribed but the container has NOT announced itself
+        // yet, which is the state a real pre-render starts in.
+        const embed1 = await setupPreRenderTest('loaded-after-hide', { liveboardId: 'original-lb' });
+        embed1.isEmbedContainerLoaded = false;
+        // Second embed shows, takes the pre-render over, then is hidden — which
+        // unsubscribes it, so it will never hear EmbedListenerReady itself.
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'loaded-after-hide',
+            liveboardId: 'second-lb',
+        });
+        await embed2.showPreRender();
+        embed2.hidePreRender();
+        expect(embed2.isEmbedContainerLoaded).toBe(false);
+        // Container comes up and the creator hears it.
+        embed1.createEmbedContainerHandler(index_1.EmbedEvent.EmbedListenerReady)();
+        mockProcessTrigger.mockClear();
+        mockProcessTrigger.mockResolvedValue({});
+        // A third embed reads the state off embed2, which owns the wrapper and
+        // never learned the container was up. Reading a per-instance snapshot
+        // here leaves UpdateEmbedParams queued forever and the pre-render stuck
+        // on the previous liveboard.
+        const embed3 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'loaded-after-hide',
+            liveboardId: 'third-lb',
+        });
+        await embed3.showPreRender();
+        expect(embed3.isEmbedContainerLoaded).toBe(true);
+        await (0, test_utils_1.executeAfterWait)(() => {
+            const eventTypes = mockProcessTrigger.mock.calls.map((call) => call[1]);
+            expect(eventTypes).toContain(types_1.HostEvent.UpdateEmbedParams);
+        }, 300);
+    });
+    test('should not reconcile runtime filters unless the view config opts in', async () => {
+        await setupPreRenderTest('reconcile-flag-off', {
+            liveboardId: 'original-lb',
+            runtimeFilters: [
+                {
+                    columnName: 'Color',
+                    operator: types_1.RuntimeFilterOp.IN,
+                    values: ['red', 'blue'],
+                },
+            ],
+        });
+        // Same shape as the clear-filters case above, minus the flag: the
+        // previous config left filters on the shared pre-render and this one
+        // declares none. Without preRenderConfig.reconcileRuntimeParams the SDK
+        // leaves that to the container, so no UpdateRuntimeFilters goes out.
+        const embed2 = new index_1.LiveboardEmbed('#tsEmbedDiv', {
+            preRenderId: 'reconcile-flag-off',
+            liveboardId: 'original-lb',
+        });
+        embed2.showPreRender();
+        await (0, test_utils_1.executeAfterWait)(() => {
+            const eventTypes = mockProcessTrigger.mock.calls.map((call) => call[1]);
+            expect(eventTypes).toContain(types_1.HostEvent.UpdateEmbedParams);
+            expect(eventTypes).not.toContain(types_1.HostEvent.UpdateRuntimeFilters);
+        });
+    });
     test('should handle error when getUpdateEmbedParamsObject fails during showPreRender', async () => {
         await setupPreRenderTest('error-test', { liveboardId: 'original-lb' });
         const handleErrorSpy = jest.spyOn(index_1.LiveboardEmbed.prototype, 'handleError');