@thoughtspot/visual-embed-sdk 1.23.1 → 1.23.3

package/dist/visual-embed-sdk-react.d.ts

@@ -21,7 +21,7 @@ interface SearchProps extends EmbedProps, SearchViewConfig {
     * }
     * ```
     */
-export const SearchEmbed: React.ForwardRefExoticComponent<SearchProps & React.RefAttributes<TsEmbed>>;
+export const SearchEmbed: React.ForwardRefExoticComponent<SearchProps & React.RefAttributes<_SearchEmbed>>;
 interface AppProps extends EmbedProps, AppViewConfig {
 }
 /**
@@ -38,7 +38,7 @@ interface AppProps extends EmbedProps, AppViewConfig {
     * }
     * ```
     */
-export const AppEmbed: React.ForwardRefExoticComponent<AppProps & React.RefAttributes<TsEmbed>>;
+export const AppEmbed: React.ForwardRefExoticComponent<AppProps & React.RefAttributes<_AppEmbed>>;
 interface LiveboardProps extends EmbedProps, LiveboardViewConfig {
 }
 /**
@@ -56,8 +56,8 @@ interface LiveboardProps extends EmbedProps, LiveboardViewConfig {
     * }
     * ```
     */
-export const LiveboardEmbed: React.ForwardRefExoticComponent<LiveboardProps & React.RefAttributes<TsEmbed>>;
-export const PinboardEmbed: React.ForwardRefExoticComponent<LiveboardProps & React.RefAttributes<TsEmbed>>;
+export const LiveboardEmbed: React.ForwardRefExoticComponent<LiveboardProps & React.RefAttributes<_LiveboardEmbed>>;
+export const PinboardEmbed: React.ForwardRefExoticComponent<LiveboardProps & React.RefAttributes<_LiveboardEmbed>>;
 interface SearchBarEmbedProps extends EmbedProps, SearchBarViewConfig {
 }
 /**
@@ -73,7 +73,7 @@ interface SearchBarEmbedProps extends EmbedProps, SearchBarViewConfig {
     * }
     * ```
     */
-export const SearchBarEmbed: React.ForwardRefExoticComponent<SearchBarEmbedProps & React.RefAttributes<TsEmbed>>;
+export const SearchBarEmbed: React.ForwardRefExoticComponent<SearchBarEmbedProps & React.RefAttributes<_SearchBarEmbed>>;
 interface SageEmbedProps extends EmbedProps, SageViewConfig {
 }
 /**
@@ -89,7 +89,8 @@ interface SageEmbedProps extends EmbedProps, SageViewConfig {
     * }
     * ```
     */
-export const SageEmbed: React.ForwardRefExoticComponent<SageEmbedProps & React.RefAttributes<TsEmbed>>;
+export const SageEmbed: React.ForwardRefExoticComponent<SageEmbedProps & React.RefAttributes<_SageEmbed>>;
+type EmbedComponent = typeof SearchEmbed | typeof AppEmbed | typeof LiveboardEmbed | typeof SearchBarEmbed | typeof SageEmbed;
 /**
     * Get a reference to the embed component to trigger events on the component.
     *
@@ -105,14 +106,14 @@ export const SageEmbed: React.ForwardRefExoticComponent<SageEmbedProps & React.R
     * return <LiveboardEmbed ref={ref} liveboardId={<id>} />
     * }
     * ```
-    * @returns {React.MutableRefObject<TsEmbed>} ref
+    * @returns {React.MutableRefObject<T extends TsEmbed>} ref
     */
-export const useEmbedRef: () => React.MutableRefObject<TsEmbed>;
+export function useEmbedRef<T extends EmbedComponent>(): React.MutableRefObject<React.ComponentRef<T>>;
 
 /**
     * @group Embed components
     */
-export interface SearchBarViewConfig extends Omit<ViewConfig, 'runtimeFilters' | 'showAlerts'> {
+export interface SearchBarViewConfig extends Omit<ViewConfig, 'runtimeFilters' | 'showAlerts' | 'dataPanelV2'> {
         /**
             * The array of data source GUIDs to set on load.
             * Only a single dataSource supported currently.
@@ -157,6 +158,22 @@ export declare class SearchBarEmbed extends TsEmbed {
     * @summary TS Sage embed
     * @author Mourya Balabhadra <mourya.balabhadra@thoughtspot.com>
     */
+/**
+    * Configuration for search options
+    */
+export interface SearchOptions {
+        /**
+            * The tml string to load the answer
+            */
+        searchQuery: string;
+        /**
+            * Boolean to determine if the search should be executed or not.
+            * if it is executed, put the focus on the results.
+            * if it’s not executed, put the focus in the search bar - at the end of
+            * the tokens
+            */
+        executeSearch?: boolean;
+}
 /**
     * The configuration attributes for the embedded Natural language search view. Based on
     * GPT and LLM.
@@ -166,7 +183,9 @@ export declare class SearchBarEmbed extends TsEmbed {
     */
 export interface SageViewConfig extends ViewConfig {
         /**
-            * If set to true, object results are shown.
+            * If set to true, a list of liveboard and answers related
+            * to the natural language search will be shown below the
+            * AI generated answer.
             */
         showObjectResults?: boolean;
         /**
@@ -178,7 +197,8 @@ export interface SageViewConfig extends ViewConfig {
             */
         hideWorksheetSelector?: boolean;
         /**
-            * If set to true, the object search suggestions are not shown
+            * If set to true, the search suggestions will contain existing
+            * liveboards and answers in addition with the autocomplete
             *
             */
         showObjectSuggestions?: boolean;
@@ -195,6 +215,10 @@ export interface SageViewConfig extends ViewConfig {
             * The data source GUID to set on load.
             */
         dataSource?: string;
+        /**
+            * Configuration for search options
+            */
+        searchOptions?: SearchOptions;
 }
 export declare const HiddenActionItemByDefaultForSageEmbed: Action[];
 /**
@@ -319,6 +343,14 @@ export interface SearchViewConfig extends ViewConfig {
             * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
             */
         hideSearchBar?: boolean;
+        /**
+            * Flag to control Data panel experience
+            *
+            * @default false
+            * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
+            * @hidden
+            */
+        dataPanelV2?: boolean;
 }
 export declare const HiddenActionItemByDefaultForSearchEmbed: Action[];
 /**
@@ -450,6 +482,14 @@ export interface AppViewConfig extends ViewConfig {
             * @version SDK: 1.21.0 | ThoughtSpot: 9.4.0.cl, 9.4.0-sw
             */
         fullHeight?: boolean;
+        /**
+            * Flag to control Data panel experience
+            *
+            * @default false
+            * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
+            * @hidden
+            */
+        dataPanelV2?: boolean;
 }
 /**
     * Embeds full ThoughtSpot experience in a host application.
@@ -631,233 +671,6 @@ export declare class LiveboardEmbed extends V1Embed {
 export declare class PinboardEmbed extends LiveboardEmbed {
 }
 
-/**
-    * Copyright (c) 2022
-    *
-    * Base classes
-    *
-    * @summary Base classes
-    * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
-    */
-/**
-    * Global prefix for all Thoughtspot postHash Params.
-    */
-export declare const THOUGHTSPOT_PARAM_PREFIX = "ts-";
-/**
-    * Base class for embedding v2 experience
-    * Note: the v2 version of ThoughtSpot Blink is built on the new stack:
-    * React+GraphQL
-    */
-export declare class TsEmbed {
-        protected isAppInitialized: boolean;
-        /**
-            * A reference to the iframe within which the ThoughtSpot app
-            * will be rendered.
-            */
-        protected iFrame: HTMLIFrameElement;
-        protected viewConfig: ViewConfig;
-        protected embedConfig: EmbedConfig;
-        /**
-            * The ThoughtSpot hostname or IP address
-            */
-        protected thoughtSpotHost: string;
-        protected thoughtSpotV2Base: string;
-        constructor(domSelector: DOMSelector, viewConfig?: ViewConfig);
-        /**
-            * Handles errors within the SDK
-            *
-            * @param error The error message or object
-            */
-        protected handleError(error: string | Record<string, unknown>): void;
-        /**
-            * Constructs the base URL string to load the ThoughtSpot app.
-            *
-            * @param query
-            */
-        protected getEmbedBasePath(query: string): string;
-        /**
-            * Common query params set for all the embed modes.
-            *
-            * @param queryParams
-            * @returns queryParams
-            */
-        protected getBaseQueryParams(queryParams?: {}): {};
-        /**
-            * Constructs the base URL string to load v1 of the ThoughtSpot app.
-            * This is used for embedding Liveboards, visualizations, and full application.
-            *
-            * @param queryString The query string to append to the URL.
-            * @param isAppEmbed A Boolean parameter to specify if you are embedding
-            * the full application.
-            */
-        protected getV1EmbedBasePath(queryString: string): string;
-        protected getEmbedParams(): string;
-        protected getRootIframeSrc(): string;
-        protected createIframeEl(frameSrc: string): HTMLIFrameElement;
-        /**
-            * Renders the embedded ThoughtSpot app in an iframe and sets up
-            * event listeners.
-            *
-            * @param url
-            * @param frameOptions
-            */
-        protected renderIFrame(url: string): Promise<any>;
-        protected insertIntoDOM(child: string | Node): void;
-        /**
-            * Sets the height of the iframe
-            *
-            * @param height The height in pixels
-            */
-        protected setIFrameHeight(height: number | string): void;
-        /**
-            * Executes all registered event handlers for a particular event type
-            *
-            * @param eventType The event type
-            * @param data The payload invoked with the event handler
-            * @param eventPort The event Port for a specific MessageChannel
-            */
-        protected executeCallbacks(eventType: EmbedEvent, data: any, eventPort?: MessagePort | void): void;
-        /**
-            * Returns the ThoughtSpot hostname or IP address.
-            */
-        protected getThoughtSpotHost(): string;
-        /**
-            * Gets the v1 event type (if applicable) for the EmbedEvent type
-            *
-            * @param eventType The v2 event type
-            * @returns The corresponding v1 event type if one exists
-            * or else the v2 event type itself
-            */
-        protected getCompatibleEventType(eventType: EmbedEvent): EmbedEvent;
-        /**
-            * Calculates the iframe center for the current visible viewPort
-            * of iframe using Scroll position of Host App, offsetTop for iframe
-            * in Host app. ViewPort height of the tab.
-            *
-            * @returns iframe Center in visible viewport,
-            *  Iframe height,
-            *  View port height.
-            */
-        protected getIframeCenter(): {
-                iframeCenter: number;
-                iframeScrolled: number;
-                iframeHeight: number;
-                viewPortHeight: number;
-                iframeVisibleViewPort: number;
-        };
-        /**
-            * Registers an event listener to trigger an alert when the ThoughtSpot app
-            * sends an event of a particular message type to the host application.
-            *
-            * @param messageType The message type
-            * @param callback A callback as a function
-            * @param options The message options
-            * @example
-            * ```js
-            * tsEmbed.on(EmbedEvent.Error, (data) => {
-            *   console.error(data);
-            * });
-            * ```
-            * @example
-            * ```js
-            * tsEmbed.on(EmbedEvent.Save, (data) => {
-            *   console.log("Answer save clicked", data);
-            * }, {
-            *   start: true // This will trigger the callback on start of save
-            * });
-            * ```
-            */
-        on(messageType: EmbedEvent, callback: MessageCallback, options?: MessageOptions): typeof TsEmbed.prototype;
-        /**
-            * Removes an event listener for a particular event type.
-            *
-            * @param messageType The message type
-            * @param callback The callback to remove
-            * @example
-            * ```js
-            * const errorHandler = (data) => { console.error(data); };
-            * tsEmbed.on(EmbedEvent.Error, errorHandler);
-            * tsEmbed.off(EmbedEvent.Error, errorHandler);
-            * ```
-            */
-        off(messageType: EmbedEvent, callback: MessageCallback): typeof TsEmbed.prototype;
-        /**
-            * Triggers an event to the embedded app
-            *
-            * @param messageType The event type
-            * @param data The payload to send with the message
-            */
-        trigger(messageType: HostEvent, data?: any): Promise<any>;
-        /**
-            * Marks the ThoughtSpot object to have been rendered
-            * Needs to be overridden by subclasses to do the actual
-            * rendering of the iframe.
-            *
-            * @param args
-            */
-        render(): TsEmbed;
-        /**
-            * Get the Post Url Params for THOUGHTSPOT from the current
-            * host app URL.
-            * THOUGHTSPOT URL params starts with a prefix "ts-"
-            *
-            * @version SDK: 1.14.0 | ThoughtSpot: 8.4.0.cl, 8.4.1-sw
-            */
-        getThoughtSpotPostUrlParams(): string;
-        /**
-            * Destroys the ThoughtSpot embed, and remove any nodes from the DOM.
-            *
-            * @version SDK: 1.19.1 | ThoughtSpot: *
-            */
-        destroy(): void;
-        getUnderlyingFrameElement(): HTMLIFrameElement;
-        /**
-            * Prerenders a generic instance of the TS component.
-            * This means without the path but with the flags already applied.
-            * This is useful for prerendering the component in the background.
-            *
-            * @version SDK: 1.22.0
-            * @returns
-            */
-        prerenderGeneric(): Promise<any>;
-}
-/**
-    * Base class for embedding v1 experience
-    * Note: The v1 version of ThoughtSpot Blink works on the AngularJS stack
-    * which is currently under migration to v2
-    *
-    * @inheritdoc
-    */
-export declare class V1Embed extends TsEmbed {
-        protected viewConfig: ViewConfig;
-        constructor(domSelector: DOMSelector, viewConfig: ViewConfig);
-        /**
-            * Render the app in an iframe and set up event handlers
-            *
-            * @param iframeSrc
-            */
-        protected renderV1Embed(iframeSrc: string): any;
-        protected getRootIframeSrc(): string;
-        /**
-            * @inheritdoc
-            * @example
-            * ```js
-            * tsEmbed.on(EmbedEvent.Error, (data) => {
-            *   console.error(data);
-            * });
-            * ```
-            * @example
-            * ```js
-            * tsEmbed.on(EmbedEvent.Save, (data) => {
-            *   console.log("Answer save clicked", data);
-            * }, {
-            *   start: true // This will trigger the callback on start of save
-            * });
-            * ```
-            */
-        on(messageType: EmbedEvent, callback: MessageCallback, options?: MessageOptions): typeof TsEmbed.prototype;
-}
-
 export type EmbedEventHandlers = {
     [key in keyof typeof EmbedEvent as `on${Capitalize<key>}`]?: MessageCallback;
 };
@@ -2881,7 +2694,21 @@ export declare enum HostEvent {
             * ```
             * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
             */
-        SetHiddenTabs = "SetPinboardHiddenTabs"
+        SetHiddenTabs = "SetPinboardHiddenTabs",
+        /**
+            * Updates the search query for sage embed.
+            *
+            * @param - searchOptions: an object queryString and option to execute the query.
+            * @example
+            * ```js
+            * sageEmbed.trigger(HostEvent.UpdateSageQuery, {
+            *  queryString: 'revenue per year',
+            *  executeSearch: true,
+            * })
+            * ```
+            * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
+            */
+        UpdateSageQuery = "updateSageQuery"
 }
 /**
     * The different visual modes that the data sources panel within
@@ -2936,6 +2763,7 @@ export declare enum Param {
         DisableLoginRedirect = "disableLoginRedirect",
         visibleVizs = "pinboardVisibleVizs",
         LiveboardV2Enabled = "isPinboardV2Enabled",
+        DataPanelV2Enabled = "enableDataPanelV2",
         ShowAlerts = "showAlerts",
         Locale = "locale",
         CustomStyle = "customStyle",
@@ -2963,8 +2791,8 @@ export declare enum Param {
         VisibleTabs = "visibleTabs",
         HideTabPanel = "hideTabPanel",
         HideSampleQuestions = "hideSampleQuestions",
-        WorksheetId = "worksheetId",
-        Query = "query,"
+        WorksheetId = "worksheet",
+        Query = "query"
 }
 /**
     * ThoughtSpot application pages include actions and menu commands
@@ -3802,6 +3630,235 @@ export declare enum ContextMenuTriggerOptions {
         RIGHT_CLICK = "right-click"
 }
 
+/**
+    * Copyright (c) 2022
+    *
+    * Base classes
+    *
+    * @summary Base classes
+    * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
+    */
+/**
+    * Global prefix for all Thoughtspot postHash Params.
+    */
+export declare const THOUGHTSPOT_PARAM_PREFIX = "ts-";
+/**
+    * Base class for embedding v2 experience
+    * Note: the v2 version of ThoughtSpot Blink is built on the new stack:
+    * React+GraphQL
+    */
+export declare class TsEmbed {
+        protected isAppInitialized: boolean;
+        /**
+            * A reference to the iframe within which the ThoughtSpot app
+            * will be rendered.
+            */
+        protected iFrame: HTMLIFrameElement;
+        protected viewConfig: ViewConfig;
+        protected embedConfig: EmbedConfig;
+        /**
+            * The ThoughtSpot hostname or IP address
+            */
+        protected thoughtSpotHost: string;
+        protected thoughtSpotV2Base: string;
+        constructor(domSelector: DOMSelector, viewConfig?: ViewConfig);
+        /**
+            * Handles errors within the SDK
+            *
+            * @param error The error message or object
+            */
+        protected handleError(error: string | Record<string, unknown>): void;
+        /**
+            * Constructs the base URL string to load the ThoughtSpot app.
+            *
+            * @param query
+            */
+        protected getEmbedBasePath(query: string): string;
+        /**
+            * Common query params set for all the embed modes.
+            *
+            * @param queryParams
+            * @returns queryParams
+            */
+        protected getBaseQueryParams(queryParams?: {}): {};
+        /**
+            * Constructs the base URL string to load v1 of the ThoughtSpot app.
+            * This is used for embedding Liveboards, visualizations, and full application.
+            *
+            * @param queryString The query string to append to the URL.
+            * @param isAppEmbed A Boolean parameter to specify if you are embedding
+            * the full application.
+            */
+        protected getV1EmbedBasePath(queryString: string): string;
+        protected getEmbedParams(): string;
+        protected getRootIframeSrc(): string;
+        protected createIframeEl(frameSrc: string): HTMLIFrameElement;
+        /**
+            * Renders the embedded ThoughtSpot app in an iframe and sets up
+            * event listeners.
+            *
+            * @param url
+            * @param frameOptions
+            */
+        protected renderIFrame(url: string): Promise<any>;
+        protected insertIntoDOM(child: string | Node): void;
+        /**
+            * Sets the height of the iframe
+            *
+            * @param height The height in pixels
+            */
+        protected setIFrameHeight(height: number | string): void;
+        /**
+            * Executes all registered event handlers for a particular event type
+            *
+            * @param eventType The event type
+            * @param data The payload invoked with the event handler
+            * @param eventPort The event Port for a specific MessageChannel
+            */
+        protected executeCallbacks(eventType: EmbedEvent, data: any, eventPort?: MessagePort | void): void;
+        /**
+            * Returns the ThoughtSpot hostname or IP address.
+            */
+        protected getThoughtSpotHost(): string;
+        /**
+            * Gets the v1 event type (if applicable) for the EmbedEvent type
+            *
+            * @param eventType The v2 event type
+            * @returns The corresponding v1 event type if one exists
+            * or else the v2 event type itself
+            */
+        protected getCompatibleEventType(eventType: EmbedEvent): EmbedEvent;
+        /**
+            * Calculates the iframe center for the current visible viewPort
+            * of iframe using Scroll position of Host App, offsetTop for iframe
+            * in Host app. ViewPort height of the tab.
+            *
+            * @returns iframe Center in visible viewport,
+            *  Iframe height,
+            *  View port height.
+            */
+        protected getIframeCenter(): {
+                iframeCenter: number;
+                iframeScrolled: number;
+                iframeHeight: number;
+                viewPortHeight: number;
+                iframeVisibleViewPort: number;
+        };
+        /**
+            * Registers an event listener to trigger an alert when the ThoughtSpot app
+            * sends an event of a particular message type to the host application.
+            *
+            * @param messageType The message type
+            * @param callback A callback as a function
+            * @param options The message options
+            * @param isSelf
+            * @param isRegisteredBySDK
+            * @example
+            * ```js
+            * tsEmbed.on(EmbedEvent.Error, (data) => {
+            *   console.error(data);
+            * });
+            * ```
+            * @example
+            * ```js
+            * tsEmbed.on(EmbedEvent.Save, (data) => {
+            *   console.log("Answer save clicked", data);
+            * }, {
+            *   start: true // This will trigger the callback on start of save
+            * });
+            * ```
+            */
+        on(messageType: EmbedEvent, callback: MessageCallback, options?: MessageOptions, isRegisteredBySDK?: boolean): typeof TsEmbed.prototype;
+        /**
+            * Removes an event listener for a particular event type.
+            *
+            * @param messageType The message type
+            * @param callback The callback to remove
+            * @example
+            * ```js
+            * const errorHandler = (data) => { console.error(data); };
+            * tsEmbed.on(EmbedEvent.Error, errorHandler);
+            * tsEmbed.off(EmbedEvent.Error, errorHandler);
+            * ```
+            */
+        off(messageType: EmbedEvent, callback: MessageCallback): typeof TsEmbed.prototype;
+        /**
+            * Triggers an event to the embedded app
+            *
+            * @param messageType The event type
+            * @param data The payload to send with the message
+            */
+        trigger(messageType: HostEvent, data?: any): Promise<any>;
+        /**
+            * Marks the ThoughtSpot object to have been rendered
+            * Needs to be overridden by subclasses to do the actual
+            * rendering of the iframe.
+            *
+            * @param args
+            */
+        render(): TsEmbed;
+        /**
+            * Get the Post Url Params for THOUGHTSPOT from the current
+            * host app URL.
+            * THOUGHTSPOT URL params starts with a prefix "ts-"
+            *
+            * @version SDK: 1.14.0 | ThoughtSpot: 8.4.0.cl, 8.4.1-sw
+            */
+        getThoughtSpotPostUrlParams(): string;
+        /**
+            * Destroys the ThoughtSpot embed, and remove any nodes from the DOM.
+            *
+            * @version SDK: 1.19.1 | ThoughtSpot: *
+            */
+        destroy(): void;
+        getUnderlyingFrameElement(): HTMLIFrameElement;
+        /**
+            * Prerenders a generic instance of the TS component.
+            * This means without the path but with the flags already applied.
+            * This is useful for prerendering the component in the background.
+            *
+            * @version SDK: 1.22.0
+            * @returns
+            */
+        prerenderGeneric(): Promise<any>;
+}
+/**
+    * Base class for embedding v1 experience
+    * Note: The v1 version of ThoughtSpot Blink works on the AngularJS stack
+    * which is currently under migration to v2
+    *
+    * @inheritdoc
+    */
+export declare class V1Embed extends TsEmbed {
+        protected viewConfig: ViewConfig;
+        constructor(domSelector: DOMSelector, viewConfig: ViewConfig);
+        /**
+            * Render the app in an iframe and set up event handlers
+            *
+            * @param iframeSrc
+            */
+        protected renderV1Embed(iframeSrc: string): any;
+        protected getRootIframeSrc(): string;
+        /**
+            * @inheritdoc
+            * @example
+            * ```js
+            * tsEmbed.on(EmbedEvent.Error, (data) => {
+            *   console.error(data);
+            * });
+            * ```
+            * @example
+            * ```js
+            * tsEmbed.on(EmbedEvent.Save, (data) => {
+            *   console.log("Answer save clicked", data);
+            * }, {
+            *   start: true // This will trigger the callback on start of save
+            * });
+            * ```
+            */
+        on(messageType: EmbedEvent, callback: MessageCallback, options?: MessageOptions): typeof TsEmbed.prototype;
+}
+
 export interface executeTMLInput {
         metadata_tmls: string[];
         import_policy?: 'PARTIAL' | 'ALL_OR_NONE' | 'VALIDATE_ONLY';
@@ -3889,11 +3946,13 @@ export declare const logout: (doNotDisableAutoLogin?: boolean) => Promise<boolea
     */
 export declare const renderInQueue: (fn: (next?: (val?: any) => void) => Promise<any>) => Promise<any>;
 /**
+    * Imports TML representation of the metadata objects into ThoughtSpot.
     * @param data
     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
     */
 export declare const executeTML: (data: executeTMLInput) => Promise<any>;
 /**
+    * Exports TML representation of the metadata objects from ThoughtSpot in JSON or YAML format.
     * @param data
     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
     */