@thoughtspot/visual-embed-sdk 1.6.0-alpha.2 → 1.7.0-alpha.1

package/dist/src/embed/app.d.ts

@@ -67,7 +67,7 @@ export interface AppViewConfig extends ViewConfig {
     pageId?: Page;
     /**
      * This puts a filter tag on the application. All metadata lists in the application, such as
-     * liveboards and answers, would be filtered by this tag.
+     * Liveboards and answers, would be filtered by this tag.
      */
     tag?: string;
     /**
@@ -84,7 +84,7 @@ export declare class AppEmbed extends V1Embed {
     constructor(domSelector: DOMSelector, viewConfig: AppViewConfig);
     /**
      * Constructs a map of parameters to be passed on to the
-     * embedded liveboard or visualization.
+     * embedded Liveboard or visualization.
      */
     private getEmbedParams;
     /**
@@ -103,6 +103,13 @@ export declare class AppEmbed extends V1Embed {
      * @returns The URL path that the embedded app understands.
      */
     private formatPath;
+    /**
+     * Navigate to particular page for app embed. eg:answers/pinboards/home
+     * This is used for embedding answers, pinboards, visualizations and full application only.
+     * @param path The string, set to iframe src and navigate to new page
+     * eg: appEmbed.navigateToPage('pinboards')
+     */
+    navigateToPage(path: string): void;
     /**
      * Renders the embedded application pages in the ThoughtSpot app.
      * @param renderOptions An object containing the page ID

package/dist/src/embed/liveboard.d.ts

@@ -1,7 +1,7 @@
 /**
  * Copyright (c) 2021
  *
- * Embed a ThoughtSpot liveboard or visualization
+ * Embed a ThoughtSpot Liveboard or visualization
  * https://developers.thoughtspot.com/docs/?pageid=embed-pinboard
  * https://developers.thoughtspot.com/docs/?pageid=embed-a-viz
  *
@@ -11,21 +11,21 @@
 import { DOMSelector } from '../types';
 import { V1Embed, ViewConfig } from './ts-embed';
 /**
- * The configuration for the embedded liveboard or visualization page view.
+ * The configuration for the embedded Liveboard or visualization page view.
  * @Category Liveboards and Charts
  */
 export interface LiveboardViewConfig extends ViewConfig {
     /**
      * If set to true, the embedded object container dynamically resizes
-     * according to the height of the liveboard.
+     * according to the height of the Liveboard.
      */
     fullHeight?: boolean;
     /**
-     * This is the minimum height(in pixels) for a full height liveboard.
-     * Setting this height helps resolves issues with empty liveboards and
-     * other screens navigable from a liveboard.
+     * This is the minimum height(in pixels) for a full height Liveboard.
+     * Setting this height helps resolves issues with empty Liveboards and
+     * other screens navigable from a Liveboard.
+     * *_since 1.5.0_
      * @default 500
-     * * _since 1.5.0_
      */
     defaultHeight?: number;
     /**
@@ -33,7 +33,7 @@ export interface LiveboardViewConfig extends ViewConfig {
      */
     enableVizTransformations?: boolean;
     /**
-     * The liveboard to display in the embedded view.
+     * The Liveboard to display in the embedded view.
      * Use either of liveboardId or pinboardId to reference the Liveboard to embed.
      */
     liveboardId?: string;
@@ -43,12 +43,12 @@ export interface LiveboardViewConfig extends ViewConfig {
      */
     pinboardId?: string;
     /**
-     * The visualization within the liveboard to display.
+     * The visualization within the Liveboard to display.
      */
     vizId?: string;
     /**
      * If set to true, all filter chips from a
-     * liveboard page will be read-only (no X buttons)
+     * Liveboard page will be read-only (no X buttons)
      */
     preventLiveboardFilterRemoval?: boolean;
     /**
@@ -58,7 +58,7 @@ export interface LiveboardViewConfig extends ViewConfig {
     preventPinboardFilterRemoval?: boolean;
 }
 /**
- * Embed a ThoughtSpot liveboard or visualization
+ * Embed a ThoughtSpot Liveboard or visualization
  * @Category Liveboards and Charts
  */
 export declare class LiveboardEmbed extends V1Embed {
@@ -67,16 +67,16 @@ export declare class LiveboardEmbed extends V1Embed {
     constructor(domSelector: DOMSelector, viewConfig: LiveboardViewConfig);
     /**
      * Construct a map of params to be passed on to the
-     * embedded liveboard or visualization.
+     * embedded Liveboard or visualization.
      */
     private getEmbedParams;
     /**
-     * Construct the URL of the embedded ThoughtSpot liveboard or visualization
+     * Construct the URL of the embedded ThoughtSpot Liveboard or visualization
      * to be loaded within the iframe.
-     * @param liveboardId The GUID of the liveboard.
-     * @param vizId The optional GUID of a visualization within the liveboard.
+     * @param liveboardId The GUID of the Liveboard.
+     * @param vizId The optional GUID of a visualization within the Liveboard.
      * @param runtimeFilters A list of runtime filters to be applied to
-     * the liveboard or visualization on load.
+     * the Liveboard or visualization on load.
      */
     private getIFrameSrc;
     /**
@@ -86,10 +86,10 @@ export declare class LiveboardEmbed extends V1Embed {
      */
     private updateIFrameHeight;
     private embedIframeCenter;
-    private handleRouteChangeFullHeightLiveboard;
+    private setIframeHeightForNonEmbedLiveboard;
     /**
-     * Render an embedded ThoughtSpot liveboard or visualization
-     * @param renderOptions An object specifying the liveboard ID,
+     * Render an embedded ThoughtSpot Liveboard or visualization
+     * @param renderOptions An object specifying the Liveboard ID,
      * visualization ID and the runtime filters.
      */
     render(): LiveboardEmbed;

package/dist/src/embed/liveboard.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/embed/search.d.ts

@@ -6,7 +6,7 @@
  * @summary Search embed
  * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
  */
-import { DOMSelector } from '../types';
+import { DOMSelector, Action } from '../types';
 import { ViewConfig, TsEmbed } from './ts-embed';
 /**
  * Configuration for search options
@@ -71,6 +71,7 @@ export interface SearchViewConfig extends ViewConfig {
      */
     answerId?: string;
 }
+export declare const HiddenActionItemByDefaultForSearchEmbed: Action[];
 /**
  * Embed ThoughtSpot search
  *

package/dist/src/embed/ts-embed.d.ts

@@ -64,7 +64,7 @@ export interface ViewConfig {
     visibleActions?: Action[];
     /**
      * The list of runtime filters to apply to a search answer,
-     * visualization, or liveboard.
+     * visualization, or Liveboard.
      */
     runtimeFilters?: RuntimeFilter[];
 }
@@ -162,7 +162,7 @@ export declare class TsEmbed {
     protected getBaseQueryParams(): {};
     /**
      * Constructs the base URL string to load v1 of the ThoughtSpot app.
-     * This is used for embedding liveboards, visualizations, and full application.
+     * 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.
@@ -221,15 +221,6 @@ export declare class TsEmbed {
      * @param callback A callback function
      */
     on(messageType: EmbedEvent, callback: MessageCallback): typeof TsEmbed.prototype;
-    /**
-     * Navigates users to the specified application page.
-     * Use this method to navigate users from the embedded
-     * ThoughtSpot context to a specific page in your app.
-     * @param path The page path string.
-     * For example, to navigate users to a liveboard page,
-     * define the method as navigateToPage('liveboard/<liveboardId>').
-     */
-    navigateToPage(path: string): void;
     /**
      * Triggers an event on specific Port registered against
      * for the EmbedEvent

package/dist/src/test/test-utils.d.ts

@@ -24,4 +24,5 @@ export declare const executeAfterWait: (fn: (...args: any[]) => void, waitTime?:
  * Time (in milliseconds) to wait for async events to be triggered
  */
 export declare const EVENT_WAIT_TIME = 1000;
+export declare function fixedEncodeURI(str: string): string;
 export {};

package/dist/src/types.d.ts

@@ -112,12 +112,13 @@ export interface EmbedConfig {
      * When there are multiple embeds, queue the render of embed to start
      *  after the previous embed's render is complete. This helps in the load performance
      *  by decreasing the load on the browser.
+     * @version 1.5.0 or later
      * @default false
      */
     queueMultiRenders?: boolean;
     /**
      * Dynamic CSS Url to be injected in the loaded application.
-     * _Since: 1.6.0_
+     * @version 1.6.0 or later
      * @default ''
      */
     customCssUrl?: string;
@@ -193,7 +194,7 @@ export declare enum RuntimeFilterOp {
     IN = "IN"
 }
 /**
- * A filter that can be applied to ThoughtSpot answers, liveboards, or
+ * A filter that can be applied to ThoughtSpot answers, Liveboards, or
  * visualizations at runtime.
  */
 export interface RuntimeFilter {
@@ -231,12 +232,12 @@ export declare enum EmbedEvent {
      */
     Load = "load",
     /**
-     * Data pertaining to answer or liveboard is received
-     * @return data - The answer or liveboard data
+     * Data pertaining to answer or Liveboard is received
+     * @return data - The answer or Liveboard data
      */
     Data = "data",
     /**
-     * Search/answer/liveboard filters have been applied/updated
+     * Search/answer/Liveboard filters have been applied/updated
      * @hidden
      */
     FiltersChanged = "filtersChanged",
@@ -259,13 +260,13 @@ export declare enum EmbedEvent {
     /**
      * A custom action has been triggered
      * @return actionId - The id of the custom action
-     * @return data - The answer or liveboard data
+     * @return data - The answer or Liveboard data
      */
     CustomAction = "customAction",
     /**
      * A double click has been triggered on table/chart
      * @return ContextMenuInputPoints - data point that is double clicked
-     * * _since: 1.5.0_
+     * @version 1.5.0 or later
      */
     VizPointDoubleClick = "vizPointDoubleClick",
     /**
@@ -283,8 +284,8 @@ export declare enum EmbedEvent {
      */
     AuthExpire = "ThoughtspotAuthExpired",
     /**
-     * The height of the embedded liveboard or visualization has been computed.
-     * @return data - The height of the embedded liveboard or visualization
+     * The height of the embedded Liveboard or visualization has been computed.
+     * @return data - The height of the embedded Liveboard or visualization
      * @hidden
      */
     EmbedHeight = "EMBED_HEIGHT",
@@ -296,7 +297,6 @@ export declare enum EmbedEvent {
     EmbedIframeCenter = "EmbedIframeCenter",
     /**
      * Detects the route change.
-     * @hidden
      */
     RouteChange = "ROUTE_CHANGE",
     /**
@@ -308,7 +308,7 @@ export declare enum EmbedEvent {
      * Emitted when the embed does not have cookie access. This
      * happens on Safari where third-party cookies are blocked by default.
      *
-     * @version 1.1.0
+     * @version 1.1.0 or later
      */
     NoCookieAccess = "noCookieAccess",
     /**
@@ -319,12 +319,12 @@ export declare enum EmbedEvent {
     SAMLComplete = "samlComplete",
     /**
      * Emitted when any modal is opened in the app
-     * * _since: 1.6.0_
+     * @version 1.6.0 or later
      */
     DialogOpen = "dialog-open",
     /**
      * Emitted when any modal is closed in the app
-     * * _since: 1.6.0_
+     * @version 1.6.0 or later
      */
     DialogClose = "dialog-close"
 }
@@ -345,7 +345,7 @@ export declare enum HostEvent {
      *              eg. { selectedPoints: []}
      * @param columnGuid - a string guid of the column to drill by. This is optional,
      *                     if not provided it will auto drill by the configured column. \
-     * * _since: 1.5.0_
+     * @version 1.5.0 or later
      */
     DrillDown = "triggerDrillDown",
     /**
@@ -359,10 +359,10 @@ export declare enum HostEvent {
      */
     Reload = "reload",
     /**
-     * Set the visible Vizs on a pinboard/liveboard.
-     * @param - an array of ids of vizs to show, the ids not passed
+     * Set the visible visualizations on a Liveboard.
+     * @param - an array of ids of visualizations to show, the ids not passed
      *          will be hidden.
-     * _since: 1.6.0_
+     * @version 1.6.0 or later
      */
     SetVisibleVizs = "SetPinboardVisibleVizs"
 }
@@ -416,7 +416,7 @@ export declare enum Param {
 }
 /**
  * The list of actions that can be performed on visual ThoughtSpot
- * entities, such as answers and liveboards.
+ * entities, such as answers and Liveboards.
  */
 export declare enum Action {
     Save = "save",
@@ -426,13 +426,8 @@ export declare enum Action {
     MakeACopy = "makeACopy",
     EditACopy = "editACopy",
     CopyLink = "embedDocument",
-    /**
-     * @hidden
-     */
-    PinboardSnapshot = "pinboardSnapshot",
-    LiveboardSnapshot = "liveboardSnapshot",
     ResetLayout = "resetLayout",
-    Schedule = "schedule",
+    Schedule = "subscription",
     SchedulesList = "schedule-list",
     Share = "share",
     AddFilter = "addFilter",
@@ -467,7 +462,7 @@ export declare enum Action {
      * @hidden
      */
     PinboardInfo = "pinboardInfo",
-    LiveboardInfo = "liveboardInfo",
+    LiveboardInfo = "pinboardInfo",
     SendAnswerFeedback = "sendFeedback",
     /**
      * @deprecated Will be removed in next version
@@ -481,6 +476,7 @@ export declare enum Action {
     DrillInclude = "context-menu-item-include",
     DrillExclude = "context-menu-item-exclude",
     CopyToClipboard = "context-menu-item-copy-to-clipboard",
+    CopyAndEdit = "context-menu-item-copy-and-edit",
     DrillEdit = "context-menu-item-edit",
     EditMeasure = "context-menu-item-edit-measure",
     Separator = "context-menu-item-separator",