@thoughtspot/visual-embed-sdk 1.24.0-preRender.2 → 1.24.0-preRender.4

package/src/embed/ts-embed.ts

@@ -88,12 +88,17 @@ export class TsEmbed {
      * This is useful for removing the DOM node when the
      * embed instance is destroyed.
      */
-    private insertedDomEl: Node;
+    protected insertedDomEl: Node;
 
     /**
      * The DOM node where the ThoughtSpot app is to be embedded.
      */
-    private el: Element;
+    protected el: Element;
+
+    /**
+     * The key to store the embed instance in the DOM node
+     */
+    protected embedNodeKey = '__tsEmbed'
 
     protected isAppInitialized = false;
 
@@ -129,13 +134,18 @@ export class TsEmbed {
     /**
      * A flag that is set to true post render.
      */
-    private isRendered: boolean;
+    protected isRendered: boolean;
 
     /**
      * A flag to mark if an error has occurred.
      */
     private isError: boolean;
 
+    /**
+     * A flag that is set to true post preRender.
+     */
+    private isPreRendered: boolean;
+
     /**
      * Should we encode URL Query Params using base64 encoding which thoughtspot
      * will generate for embedding. This provides additional security to
@@ -147,6 +157,8 @@ export class TsEmbed {
 
     private defaultHiddenActions = [Action.ReportError];
 
+    private resizeObserver: ResizeObserver;
+
     constructor(domSelector: DOMSelector, viewConfig?: ViewConfig) {
         this.el = getDOMNode(domSelector);
         // TODO: handle error
@@ -377,7 +389,8 @@ export class TsEmbed {
         queryParams[Param.ViewPortWidth] = window.innerWidth;
         queryParams[Param.Version] = version;
         queryParams[Param.AuthType] = this.embedConfig.authType;
-        queryParams[Param.blockNonEmbedFullAppAccess] = this.embedConfig.blockNonEmbedFullAppAccess ?? true;
+        queryParams[Param.blockNonEmbedFullAppAccess] = this.embedConfig.blockNonEmbedFullAppAccess
+            ?? true;
         if (this.embedConfig.disableLoginRedirect === true || this.embedConfig.autoLogin === true) {
             queryParams[Param.DisableLoginRedirect] = true;
         }
@@ -454,7 +467,8 @@ export class TsEmbed {
             queryParams[Param.ContextMenuTrigger] = false;
         }
 
-        const spriteUrl = customizations?.iconSpriteUrl || this.embedConfig.customizations?.iconSpriteUrl;
+        const spriteUrl = customizations?.iconSpriteUrl
+            || this.embedConfig.customizations?.iconSpriteUrl;
         if (spriteUrl) {
             queryParams[Param.IconSpriteUrl] = spriteUrl.replace('https://', '');
         }
@@ -533,7 +547,9 @@ export class TsEmbed {
         // @ts-ignore
         iFrame.allow = 'clipboard-read; clipboard-write';
 
-        const { height: frameHeight, width: frameWidth, ...restParams } = this.viewConfig.frameParams || {};
+        const {
+            height: frameHeight, width: frameWidth, ...restParams
+        } = this.viewConfig.frameParams || {};
         const width = getCssDimension(frameWidth || DEFAULT_EMBED_WIDTH);
         const height = getCssDimension(frameHeight || DEFAULT_EMBED_HEIGHT);
         setAttributes(iFrame, restParams);
@@ -545,15 +561,15 @@ export class TsEmbed {
         return iFrame;
     }
 
-    protected handleInsertionIntoDOM(child: string | Node, showPreRenderByDefault = false): void {
+    protected handleInsertionIntoDOM(child: string | Node): void {
         if (this.isPreRendered) {
-            if (!this.viewConfig.preRenderId) {
-                throw Error('PreRender id is required for preRender');
-            }
-            this.insertIntoDOMForPreRender(child, showPreRenderByDefault);
+            this.insertIntoDOMForPreRender(child);
         } else {
             this.insertIntoDOM(child);
         }
+        if (this.insertedDomEl instanceof Node) {
+            this.insertedDomEl[this.embedNodeKey] = this;
+        }
     }
 
     /**
@@ -561,9 +577,8 @@ export class TsEmbed {
      * event listeners.
      *
      * @param url - The URL of the embedded ThoughtSpot app.
-     * @param showPreRenderByDefault - The flag to show the preRender by default.
      */
-    protected async renderIFrame(url: string, showPreRenderByDefault = false): Promise<any> {
+    protected async renderIFrame(url: string): Promise<any> {
         if (this.isError) {
             return null;
         }
@@ -588,10 +603,7 @@ export class TsEmbed {
             return getAuthPromise()
                 ?.then((isLoggedIn: boolean) => {
                     if (!isLoggedIn) {
-                        this.handleInsertionIntoDOM(
-                            this.embedConfig.loginFailedMessage,
-                            showPreRenderByDefault,
-                        );
+                        this.handleInsertionIntoDOM(this.embedConfig.loginFailedMessage);
                         return;
                     }
 
@@ -614,7 +626,7 @@ export class TsEmbed {
                     this.iFrame.addEventListener('error', () => {
                         nextInQueue();
                     });
-                    this.handleInsertionIntoDOM(this.iFrame, showPreRenderByDefault);
+                    this.handleInsertionIntoDOM(this.iFrame);
                     const prefetchIframe = document.querySelectorAll('.prefetchIframe');
                     if (prefetchIframe.length) {
                         prefetchIframe.forEach((el) => {
@@ -634,15 +646,6 @@ export class TsEmbed {
         });
     }
 
-    public getPreRenderIds() {
-        return {
-            wrapper: `tsEmbed-pre-render-wrapper-${this.viewConfig.preRenderId}`,
-            // shield:
-            // `tsEmbed-pre-render-shield-${this.viewConfig.preRenderId}`,
-            child: `tsEmbed-pre-render-child-${this.viewConfig.preRenderId}`,
-        };
-    }
-
     protected createPreRenderWrapper(): HTMLDivElement {
         if (!this.viewConfig.preRenderId) {
             throw new Error('PreRender id is required to create PreRender wrapper');
@@ -661,44 +664,38 @@ export class TsEmbed {
         };
         setStyleProperties(preRenderWrapper, initialPreRenderWrapperStyle);
 
-        // const preRenderShield = document.createElement('div');
-        // preRenderShield.id = preRenderIds.shield;
-        // setStyleProperties(preRenderShield, { position: 'absolute',
-        // width: '100%', height: '100%' });
-
-        // preRenderWrapper.appendChild(preRenderShield);
-
-        // this.preRenderWrapper = preRenderWrapper;
-        // this.preRenderShield = preRenderShield;
-        // this.preRenderChild = child;
-
         return preRenderWrapper;
     }
 
     protected preRenderWrapper: HTMLElement;
 
-    // protected preRenderShield: HTMLElement;
-
     protected preRenderChild: HTMLElement;
 
     protected connectPreRendered(): boolean {
         const preRenderIds = this.getPreRenderIds();
         this.preRenderWrapper = this.preRenderWrapper
-            || document.getElementById(preRenderIds.wrapper);
-        // this.preRenderShield = this.preRenderShield
-        //     || document.getElementById(preRenderIds.shield);
+          || document.getElementById(preRenderIds.wrapper);
+
         this.preRenderChild = this.preRenderChild || document.getElementById(preRenderIds.child);
 
         if (this.preRenderWrapper && this.preRenderChild) {
             this.isPreRendered = true;
-            this.iFrame = this.preRenderChild as HTMLIFrameElement;
+            if (this.preRenderChild instanceof HTMLIFrameElement) {
+                this.iFrame = this.preRenderChild;
+            }
+            this.insertedDomEl = this.preRenderWrapper;
+            this.isRendered = true;
         }
 
         return this.isPreRenderAvailable();
     }
 
     protected isPreRenderAvailable(): boolean {
-        return this.isPreRendered;
+        return (
+            this.isRendered
+            && this.isPreRendered
+            && Boolean(this.preRenderWrapper && this.preRenderChild)
+        );
     }
 
     protected createPreRenderChild(child: string | Node): HTMLElement {
@@ -724,10 +721,7 @@ export class TsEmbed {
         return divChildNode;
     }
 
-    protected insertIntoDOMForPreRender(
-        child: string | Node,
-        showPreRenderByDefault = false,
-    ): void {
+    protected insertIntoDOMForPreRender(child: string | Node): void {
         const preRenderChild = this.createPreRenderChild(child);
         const preRenderWrapper = this.createPreRenderWrapper();
         preRenderWrapper.appendChild(preRenderChild);
@@ -738,8 +732,9 @@ export class TsEmbed {
         if (preRenderChild instanceof HTMLIFrameElement) {
             this.iFrame = preRenderChild;
         }
+        this.insertedDomEl = preRenderWrapper;
 
-        if (showPreRenderByDefault) {
+        if (this.showPreRenderByDefault) {
             this.showPreRender();
         } else {
             this.hidePreRender();
@@ -748,74 +743,7 @@ export class TsEmbed {
         document.body.appendChild(preRenderWrapper);
     }
 
-    public hidePreRender(): void {
-        if (!this.isPreRenderAvailable()) {
-            // if the embed component is not preRendered , nothing to hide
-            console.warn(
-                'Warning: You should call PreRender before hiding it using hidePreRender.',
-            );
-            return;
-        }
-        const preRenderHideStyles = {
-            opacity: '0',
-            pointerEvents: 'none',
-            zIndex: '-1000',
-            position: 'absolute ',
-            top: '0',
-            left: '0',
-        };
-        setStyleProperties(this.preRenderWrapper, preRenderHideStyles);
-
-        // const childBoundingRect = this.preRenderChild.getBoundingClientRect();
-        //
-        // setStyleProperties(this.preRenderShield, {
-        //     opacity: '0',
-        //     pointerEvents: 'none',
-        //     zIndex: '1',
-        //     width: `${childBoundingRect.width}px`,
-        //     height: `${childBoundingRect.height}px`,
-        //     position: 'absolute',
-        //     top: '0',
-        //     left: '0',
-        // });
-
-        this.unsubscribeToEvents();
-    }
-
-    public showPreRender(): void {
-        if (!this.isPreRenderAvailable()) {
-            const isAvailable = this.connectPreRendered();
-            if (!isAvailable) {
-                // if the Embed component is not preRendered , Render it now and
-                this.preRender(true);
-                // show it (hide is defalt behaviour)
-                // console.log('No preRender found, creating new ');
-                return;
-            }
-        }
-
-        this.syncPreRenderStyle();
-
-        removeStyleProperties(this.preRenderWrapper, ['z-index', 'opacity', 'pointer-events']);
-
-        // setStyleProperties(this.preRenderShield, { zIndex: '-1' });
-
-        this.subscribeToEvents();
-    }
-
-    public syncPreRenderStyle(): void {
-        if (!this.el) {
-            throw new Error('Embed element is not defined');
-        }
-        const elBoundingClient = this.el.getBoundingClientRect();
-
-        setStyleProperties(this.preRenderWrapper, {
-            top: `${elBoundingClient.y}px`,
-            left: `${elBoundingClient.x}px`,
-            width: `${elBoundingClient.width}px`,
-            height: `${elBoundingClient.height}px`,
-        });
-    }
+    private showPreRenderByDefault = false;
 
     protected insertIntoDOM(child: string | Node): void {
         if (this.viewConfig.insertAsSibling) {
@@ -1048,15 +976,23 @@ export class TsEmbed {
         return this;
     }
 
-    private isPreRendered: boolean;
+    protected handleRenderForPrerender() {
+        this.render();
+    }
 
     /**
      * Creates the preRender shell
      *
-     * @param showPreRenderByDefault
+     * @param showPreRenderByDefault - Show the preRender after render, hidden by default
      */
     public preRender(showPreRenderByDefault = false): TsEmbed {
+        if (!this.viewConfig.preRenderId) {
+            console.error('PreRender id is required for preRender');
+            return this;
+        }
         this.isPreRendered = true;
+        this.showPreRenderByDefault = showPreRenderByDefault;
+        this.handleRenderForPrerender();
         return this;
     }
 
@@ -1118,8 +1054,119 @@ export class TsEmbed {
      */
     public async prerenderGeneric(): Promise<any> {
         const prerenderFrameSrc = this.getRootIframeSrc();
+        this.isRendered = true;
         return this.renderIFrame(prerenderFrameSrc);
     }
+
+    protected beforePrerenderVisible(): void {
+        // Override in subclass
+    }
+
+    /**
+     * Displays the PreRender component.
+     * If the component is not preRendered, it attempts to create and render it.
+     * Also, synchronizes the style of the PreRender component with the embedding
+     * element.
+     */
+    public showPreRender(): void {
+        if (!this.isPreRenderAvailable()) {
+            const isAvailable = this.connectPreRendered();
+            if (!isAvailable) {
+                // if the Embed component is not preRendered , Render it now and
+                this.preRender(true);
+                return;
+            }
+        }
+
+        if (this.el) {
+            this.syncPreRenderStyle();
+
+            this.resizeObserver = new ResizeObserver((entries) => {
+                entries.forEach((entry) => {
+                    if (entry.contentRect && entry.target === this.el) {
+                        setStyleProperties(this.preRenderWrapper, {
+                            width: `${entry.contentRect.width}px`,
+                            height: `${entry.contentRect.height}px`,
+                        });
+                    }
+                });
+            });
+            this.resizeObserver.observe(this.el);
+        }
+
+        this.beforePrerenderVisible();
+
+        removeStyleProperties(this.preRenderWrapper, ['z-index', 'opacity', 'pointer-events']);
+
+        this.subscribeToEvents();
+    }
+
+    /**
+     * Synchronizes the style properties of the PreRender component with the embedding
+     * element. This function adjusts the position, width, and height of the PreRender
+     * component
+     * to match the dimensions and position of the embedding element.
+     *
+     * @throws {Error} Throws an error if the embedding element (passed as domSelector)
+     * is not defined or not found.
+     */
+    public syncPreRenderStyle(): void {
+        if (!this.el) {
+            throw new Error('Embed element is not defined');
+        }
+        const elBoundingClient = this.el.getBoundingClientRect();
+
+        setStyleProperties(this.preRenderWrapper, {
+            top: `${elBoundingClient.y}px`,
+            left: `${elBoundingClient.x}px`,
+            width: `${elBoundingClient.width}px`,
+            height: `${elBoundingClient.height}px`,
+        });
+    }
+
+    /**
+     * Hides the PreRender component if it is available.
+     * If the component is not preRendered, it issues a warning.
+     */
+    public hidePreRender(): void {
+        if (!this.isPreRenderAvailable()) {
+            // if the embed component is not preRendered , nothing to hide
+            console.warn(
+                'Warning: You should call PreRender before hiding it using hidePreRender.',
+            );
+            return;
+        }
+        const preRenderHideStyles = {
+            opacity: '0',
+            pointerEvents: 'none',
+            zIndex: '-1000',
+            position: 'absolute ',
+            top: '0',
+            left: '0',
+        };
+        setStyleProperties(this.preRenderWrapper, preRenderHideStyles);
+
+        if (this.resizeObserver) {
+            this.resizeObserver.disconnect();
+        }
+
+        this.unsubscribeToEvents();
+    }
+
+    /**
+     * Retrieves unique HTML element IDs for PreRender-related elements.
+     * These IDs are constructed based on the provided 'preRenderId' from 'viewConfig'.
+     *
+     * @returns {object} An object containing the IDs for the PreRender elements.
+     * @property {string} wrapper - The HTML element ID for the PreRender wrapper.
+     * @property {string} child - The HTML element ID for the PreRender child.
+     */
+    public getPreRenderIds() {
+        return {
+            wrapper: `tsEmbed-pre-render-wrapper-${this.viewConfig.preRenderId}`,
+            child: `tsEmbed-pre-render-child-${this.viewConfig.preRenderId}`,
+        };
+    }
 }
 
 /**
@@ -1141,10 +1188,9 @@ export class V1Embed extends TsEmbed {
      * Render the app in an iframe and set up event handlers
      *
      * @param iframeSrc
-     * @param showPreRenderByDefault - if true the preRender will be shown by default
      */
-    protected renderV1Embed(iframeSrc: string, showPreRenderByDefault = false): any {
-        return this.renderIFrame(iframeSrc, showPreRenderByDefault);
+    protected renderV1Embed(iframeSrc: string): Promise<any> {
+        return this.renderIFrame(iframeSrc);
     }
 
     protected getRootIframeSrc(): string {

package/src/react/all-types-export.ts

@@ -1,11 +1,15 @@
 export {
     SearchEmbed,
+    PreRenderedSearchEmbed,
     LiveboardEmbed,
+    PreRenderedLiveboardEmbed,
     SearchBarEmbed,
+    PreRenderedSearchBarEmbed,
     AppEmbed,
+    PreRenderedAppEmbed,
     SageEmbed,
+    PreRenderedSageEmbed,
     useEmbedRef,
-    PreRenderedLiveboardEmbed,
 } from './index';
 
 export {

package/src/react/index.spec.tsx

@@ -15,7 +15,7 @@ import {
     mockMessageChannel,
 } from '../test/test-utils';
 import {
-    SearchEmbed, AppEmbed, LiveboardEmbed, useEmbedRef, SearchBarEmbed,
+    SearchEmbed, AppEmbed, LiveboardEmbed, useEmbedRef, SearchBarEmbed, PreRenderedLiveboardEmbed,
 } from './index';
 import * as allExports from './index';
 import {
@@ -226,6 +226,47 @@ describe('React Components', () => {
             );
         });
     });
+
+    describe('PreRenderedLiveboardEmbed', () => {
+        it('should preRender the liveboard ', async () => {
+            const preRenderId = 'tsEmbed-pre-render-wrapper-test';
+
+            const { container } = render(
+                <PreRenderedLiveboardEmbed
+                    className="embedClass"
+                    preRenderId="test"
+                    liveboardId="libId"
+                />,
+            );
+
+            await waitFor(() => getIFrameEl());
+            const preRenderWrapper = document.body.querySelector(`#${preRenderId}`) as HTMLDivElement;
+
+            expect(preRenderWrapper).toBeInstanceOf(HTMLDivElement);
+            expect((preRenderWrapper as HTMLDivElement).childElementCount).toBe(1);
+
+            const preRenderChildId = 'tsEmbed-pre-render-child-test';
+            const preRenderChild = document.body.querySelector(`#${preRenderChildId}`);
+            expect(preRenderWrapper.children[0]).toBe(preRenderChild);
+
+            (window as any).ResizeObserver = jest.fn().mockImplementation(() => ({
+                disconnect: jest.fn(),
+                observe: jest.fn(),
+                unobserve: jest.fn(),
+            }));
+            const { container: libContainer } = render(
+                <LiveboardEmbed
+                    className="embedClass"
+                    preRenderId="test"
+                    liveboardId="libId"
+                />,
+            );
+
+            expect(preRenderWrapper.style.opacity).toBe('');
+            expect(preRenderWrapper.style.pointerEvents).toBe('');
+            expect(preRenderWrapper.style.zIndex).toBe('');
+        });
+    });
 });
 
 describe('allExports', () => {