@thoughtspot/visual-embed-sdk 1.48.0 → 1.49.0

package/src/index.ts

@@ -33,6 +33,7 @@ import { SearchEmbed, SearchViewConfig } from './embed/search';
 import { SearchBarEmbed, SearchBarViewConfig } from './embed/search-bar';
 import { SpotterAgentEmbed, SpotterAgentEmbedViewConfig, BodylessConversation, BodylessConversationViewConfig} from './embed/bodyless-conversation';
 import { SpotterEmbed, SpotterEmbedViewConfig, SpotterChatViewConfig, SpotterSidebarViewConfig, ConversationEmbed, ConversationViewConfig } from './embed/conversation';
+import { SpotterVizConfig, SpotterVizStarterPrompt } from './embed/spotter-viz-utils';
 import {
     AuthFailureType, AuthStatus, AuthEvent, AuthEventEmitter,
 } from './auth';
@@ -140,6 +141,8 @@ export {
     SearchViewConfig,
     SearchBarViewConfig,
     LiveboardViewConfig,
+    SpotterVizConfig,
+    SpotterVizStarterPrompt,
     AppViewConfig,
     PrefetchFeatures,
     FrameParams,

package/src/react/index.tsx

@@ -95,6 +95,9 @@ const componentFactory = <T extends typeof TsEmbed, U extends EmbedProps, V exte
 
             const preRenderStyles = isPreRenderedComponent ? { display: 'none' } : {};
 
+            // We dont add any component for preRenderedComponent
+            if (isPreRenderedComponent) return <></>;
+
             return viewConfig.insertAsSibling ? (
                 <span data-testid="tsEmbed" ref={ref} style={{ position: 'absolute', ...preRenderStyles }}></span>
             ) : (

package/src/types.ts

@@ -1140,6 +1140,14 @@ export interface BaseViewConfig extends ApiInterceptFlags {
      * This flag can be used to disable links inside the embedded app,
      * and disable redirection of links in a new tab.
      *
+     * Note: When set to `true`, this flag automatically disables
+     * {@link enableLinkOverridesV2} for the
+     * embed session. The two features are mutually exclusive — link
+     * overrides mutate anchors (delete `href`, attach a JS click handler),
+     * which breaks native browser behavior (Cmd/Ctrl+Click, middle-click,
+     * right-click "Open in new tab") when combined with the disable flag.
+     * The disable flag preserves native anchor semantics instead.
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.32.1 | ThoughtSpot: 10.3.0.cl
      * @example
@@ -1175,8 +1183,13 @@ export interface BaseViewConfig extends ApiInterceptFlags {
      * Flag to override the *Open Link in New Tab* context
      * menu option.
      *
-     * For improved link override handling, use
-     * {@link enableLinkOverridesV2} instead.
+     * Note: Setting this flag implicitly enables
+     * {@link enableLinkOverridesV2}. V1 is auto-upgraded to
+     * V2 to ensure consistent link-override behavior; the
+     * legacy V1-only path is no longer used in isolation.
+     *
+     * Note: This flag is ignored when
+     * {@link disableRedirectionLinksInNewTab} is `true`.
      *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`,
      * `SearchEmbed`, `SpotterAgentEmbed`,
@@ -1202,6 +1215,9 @@ export interface BaseViewConfig extends ApiInterceptFlags {
      * alongside this flag for backward compatibility with
      * older ThoughtSpot versions.
      *
+     * Note: This flag is ignored when
+     * {@link disableRedirectionLinksInNewTab} is `true`.
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`,
      * `SearchEmbed`, `SpotterAgentEmbed`,
      * `SpotterEmbed`, `SearchBarEmbed`
@@ -1477,8 +1493,29 @@ export interface BaseViewConfig extends ApiInterceptFlags {
     useHostEventsV2?: boolean;
 }
 
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
-export interface AutoMCPFrameRendererViewConfig extends BaseViewConfig {}
+/**
+ * Configuration for {@link startAutoMCPFrameRenderer}.
+ *
+ * Extends {@link BaseViewConfig} but omits params that are not applicable
+ * to the auto-frame renderer:
+ * - `preRenderId` / `usePrerenderedIfAvailable` / `doNotTrackPreRenderSize` —
+ *   the renderer always replaces a live iframe in-place; prerender pools are not used.
+ * - `insertAsSibling` — insertion is always a same-position `replaceWith`; the
+ *   container-append path is never taken.
+ * - `primaryAction` — a Liveboard/AppEmbed-specific feature; the renderer renders
+ *   whatever route the MCP server specifies.
+ * - `enableV2Shell_experimental` — the renderer always uses the v2 URL format;
+ *   this flag has no effect.
+ */
+export type AutoMCPFrameRendererViewConfig = Omit<
+    BaseViewConfig,
+    | 'preRenderId'
+    | 'usePrerenderedIfAvailable'
+    | 'doNotTrackPreRenderSize'
+    | 'insertAsSibling'
+    | 'primaryAction'
+    | 'enableV2Shell_experimental'
+>;
 
 /**
  * The configuration object for Home page embeds configs.
@@ -2465,38 +2502,54 @@ export enum EmbedEvent {
      */
     VizPointClick = 'vizPointClick',
     /**
-     * An error has occurred. This event is fired for the following error types:
+     * Fired when an error occurs in the embedded component.
+     *
+     * **Important:** This event fires for many reasons — including internal
+     * validation warnings (e.g. `HOST_EVENT_VALIDATION`), configuration issues,
+     * and transient errors that ThoughtSpot already handles gracefully inside the
+     * iframe. **Do not call `embed.destroy()` or unmount the embed component on
+     * every error.** Doing so will tear down the iframe and abort all in-flight
+     * requests, causing the embed to fail entirely.
      *
+     * Only treat the following codes as unrecoverable:
+     * - `INIT_ERROR` — SDK was not initialised before render
+     * - `LOGIN_FAILED` — authentication could not be completed
+     *
+     * All other error codes should be logged and inspected, not acted upon
+     * destructively.
+     *
+     * **Note:** There is currently no dedicated event for a true unrecoverable
+     * crash. A future `EmbedEvent.FatalError` event is planned to give customers
+     * a clean signal for when the embed cannot recover and needs to be torn down.
+     *
+     * Error types include:
      * `API` - API call failure.
-     * `FULLSCREEN` - Error when presenting a Liveboard or visualization in full screen
-     * mode. `SINGLE_VALUE_FILTER` - Error due to multiple values in the single value
-     * filter. `NON_EXIST_FILTER` - Error due to a non-existent filter.
-     * `INVALID_DATE_VALUE` - Invalid date value error.
-     * `INVALID_OPERATOR` - Use of invalid operator during filter application.
+     * `FULLSCREEN` - Error when presenting a Liveboard in full screen mode.
+     * `VALIDATION_ERROR` - Internal host event or configuration validation warning.
      *
      * For more information, see https://developers.thoughtspot.com/docs/events-app-integration#errorType
      * @returns error - An error object or message
      * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
      * @example
      * ```js
-     * // API error
-     * SearchEmbed.on(EmbedEvent.Error, (error) => {
-     *   console.log(error);
-     *  // { type: "Error", data: { errorType: "API", error: { message: '...', error: '...' } } }
-     *  // { errorType: "API", message: '...', code: '...' } new format
+     * // Recommended pattern — only destroy on truly fatal errors
+     * embed.on(EmbedEvent.Error, (error) => {
+     *   const FATAL_CODES = ['INIT_ERROR', 'LOGIN_FAILED'];
+     *   if (FATAL_CODES.includes(error.data?.code)) {
+     *     embed.destroy();
+     *     return;
+     *   }
+     *   // Log all other errors — do not destroy
+     *   console.warn('Embed error (non-fatal):', error);
      * });
      * ```
      * @example
      * ```js
-     * // Fullscreen error (Errors during presenting of a liveboard)
-     * LiveboardEmbed.on(EmbedEvent.Error, (error) => {
+     * // API error
+     * SearchEmbed.on(EmbedEvent.Error, (error) => {
      *   console.log(error);
-     *   // { type: "Error", data: { errorType: "FULLSCREEN", error: {
-     *   //   message: "Fullscreen API is not enabled",
-     *   //   stack: "..."
-     *   // } }}
-     *   // { errorType: "FULLSCREEN", message: "Fullscreen API is not enabled", code: '...' } new format
-     * })
+     *   // { errorType: "API", message: '...', code: '...' }
+     * });
      * ```
      */
     Error = 'Error',
@@ -3704,6 +3757,109 @@ export enum EmbedEvent {
      * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
      */
     SendTestScheduleEmail = 'sendTestScheduleEmail',
+
+    /**
+     * Emitted when the SpotterViz panel mounts in embed mode.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.SpotterVizInit, (payload) => {
+     *     console.log('SpotterViz initialized', payload);
+     *     // payload: { liveboardId: string }
+     * })
+     * ```
+     */
+    SpotterVizInit = 'SpotterVizInit',
+
+    /**
+     * Emitted when the user submits a prompt in the SpotterViz panel.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.SpotterVizQueryTriggered, (payload) => {
+     *     console.log('SpotterViz query triggered', payload);
+     *     // payload: { query: string, sessionId: string }
+     * })
+     * ```
+     */
+    SpotterVizQueryTriggered = 'SpotterVizQueryTriggered',
+
+    /**
+     * Emitted when the SpotterViz agent finishes responding.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.SpotterVizResponseComplete, (payload) => {
+     *     console.log('SpotterViz response complete', payload);
+     *     // payload: { sessionId: string, messageId: string }
+     * })
+     * ```
+     */
+    SpotterVizResponseComplete = 'SpotterVizResponseComplete',
+
+    /**
+     * Emitted when a checkpoint is created in the SpotterViz panel.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.SpotterVizCheckpointCreated, (payload) => {
+     *     console.log('SpotterViz checkpoint created', payload);
+     *     // payload: { checkpointId: string, source: string, label: string }
+     * })
+     * ```
+     */
+    SpotterVizCheckpointCreated = 'SpotterVizCheckpointCreated',
+
+    /**
+     * Emitted when a checkpoint is restored in the SpotterViz panel.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.SpotterVizCheckpointRestored, (payload) => {
+     *     console.log('SpotterViz checkpoint restored', payload);
+     *     // payload: { checkpointId: string, newGenNumber: number }
+     * })
+     * ```
+     */
+    SpotterVizCheckpointRestored = 'SpotterVizCheckpointRestored',
+
+    /**
+     * Emitted when an error occurs in the SpotterViz panel.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.SpotterVizError, (payload) => {
+     *     console.log('SpotterViz error', payload);
+     * })
+     * ```
+     */
+    SpotterVizError = 'SpotterVizError',
+
+    /**
+     * Emitted when the SpotterViz panel is closed.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.SpotterVizClosed, (payload) => {
+     *     console.log('SpotterViz panel closed', payload);
+     * })
+     * ```
+     */
+    SpotterVizClosed = 'SpotterVizClosed',
+    /**
+     * Emitted when a user clicks the **Refresh** button in the
+     * Liveboard header. Requires `enableLiveboardDataCache`
+     * to be enabled.
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.RefreshLiveboardBrowserCache, (payload) => {
+     *     console.log('Liveboard browser cache refreshed', payload);
+     *     // payload: { liveboardId: string }
+     * })
+     * ```
+     * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
+     */
+    RefreshLiveboardBrowserCache = 'refreshLiveboardBrowserCache',    
 }
 
 /**
@@ -5779,6 +5935,39 @@ export enum HostEvent {
      * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
      */
     SendTestScheduleEmail = 'sendTestScheduleEmail',
+
+    /**
+     * Sends a user message (prompt) to the SpotterViz panel programmatically.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @param query - the prompt text to send.
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.SpotterVizSendUserMessage, {
+     *     query: 'Show me revenue by region',
+     * });
+     * ```
+     */
+    SpotterVizSendUserMessage = 'SpotterVizSendUserMessage',
+
+    /**
+     * Initializes a new SpotterViz conversation.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.InitSpotterVizConversation);
+     * ```
+     */
+    InitSpotterVizConversation = 'InitSpotterVizConversation',
+    /**
+     * Clears browser cache and fetches new data for liveboard ChartViz Containers.
+     * Requires `enableLiveboardDataCache` to be enabled.
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.RefreshLiveboardBrowserCache);
+     * ```
+     * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
+     */
+    RefreshLiveboardBrowserCache = 'refreshLiveboardBrowserCache',
 }
 
 /**
@@ -5821,6 +6010,7 @@ export enum Param {
     HostAppUrl = 'hostAppUrl',
     EnableVizTransformations = 'enableVizTransform',
     EnableSearchAssist = 'enableSearchAssist',
+    EnableConnectionNewExperience = 'newConnectionsExperience',
     EnablePendoHelp = 'enablePendoHelp',
     HideResult = 'hideResult',
     UseLastSelectedDataSource = 'useLastSelectedSources',
@@ -5957,8 +6147,18 @@ export enum Param {
     ToolResponseCardBrandingLabel = 'toolResponseCardBrandingLabel',
     EnableHomepageAnnouncement = 'enableHomepageAnnouncement',
     EnableLiveboardDataCache = 'enableLiveboardDataCache',
+    SpotterFileUploadEnabled = 'spotterFileUploadEnabled',
+    SpotterFileUploadFileTypes = 'spotterFileUploadFileTypes',
 }
 
+/**
+ * Configuration for allowed file types in Spotter file upload.
+ * @group Embed components
+ */
+export type SpotterFileUploadFileTypes = {
+    types?: string[];
+};
+
 /**
  * ThoughtSpot application pages include actions and menu commands
  * for various user-initiated operations. These actions are represented
@@ -6296,6 +6496,20 @@ export enum Action {
      * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
      */
     DownloadLiveboardAsContinuousPDF = 'downloadLiveboardAsContinuousPDF',
+    /**
+     * The Download Liveboard as A4 PDF menu action on a Liveboard.
+     * Allows downloading the entire Liveboard as an A4 PDF.
+     * Requires {@link Action.DownloadLiveboard} as a parent action when
+     * {@link LiveboardViewConfig.isLiveboardXLSXCSVDownloadEnabled} or
+     * {@link LiveboardViewConfig.isContinuousLiveboardPDFEnabled} flags are enabled.
+     * Use this instead of {@link Action.DownloadAsPdf} when either flag is on.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * disabledActions: [Action.DownloadLiveboardAsA4Pdf]
+     * ```
+     */
+    DownloadLiveboardAsA4Pdf = 'downloadLiveboardAsA4Pdf',
     /**
      * The **Download Liveboard as XLSX** menu action on a Liveboard.
      * Allows downloading the entire Liveboard as an XLSX file.
@@ -7629,6 +7843,53 @@ export enum Action {
      * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
      */
     SendTestScheduleEmail = 'sendTestScheduleEmail',
+
+    /**
+     * The thumbs up/down feedback buttons in the SpotterViz panel.
+     * Visible by default.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterVizFeedback]
+     * disabledActions: [Action.SpotterVizFeedback]
+     * ```
+     */
+    SpotterVizFeedback = 'spotterVizFeedback',
+
+    /**
+     * The version restore button on checkpoint cards in the SpotterViz panel.
+     * Visible by default.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterVizCheckpointRestore]
+     * disabledActions: [Action.SpotterVizCheckpointRestore]
+     * ```
+     */
+    SpotterVizCheckpointRestore = 'spotterVizCheckpointRestore',
+
+    /**
+     * The **SpotterViz** button in the top edit header.
+     * Visible by default.
+     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterViz]
+     * disabledActions: [Action.SpotterViz]
+     * ```
+     */
+    SpotterViz = 'spotterViz',
+    /**
+     * Clears browser cache and fetches new data for liveboard ChartViz Containers.
+     * Requires `enableLiveboardDataCache` to be enabled.
+     * @example
+     * ```js
+     * disabledActions: [Action.RefreshLiveboardBrowserCache]
+     * hiddenActions: [Action.RefreshLiveboardBrowserCache]
+     * ```
+     * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
+     */
+    RefreshLiveboardBrowserCache = 'refreshLiveboardBrowserCache',    
 }
 export interface AnswerServiceType {
     getAnswer?: (offset: number, batchSize: number) => any;

package/src/utils/authService/tokenizedAuthService.spec.ts

@@ -79,8 +79,9 @@ describe('fetchPreauthInfoService', () => {
     });
     it('fetchPreauthInfoService if fetch fails', async () => {
         const mockFetch = jest.spyOn(tokenizedFetchModule, 'tokenizedFetch');
+        // Prevent logger.error from reaching console.error (which throws in test env)
+        jest.spyOn(logger, 'error').mockImplementation(() => {});
 
-        // Mock for fetchPreauthInfoService
         mockFetch.mockResolvedValueOnce({
             ok: false,
             status: 500,
@@ -89,11 +90,10 @@ describe('fetchPreauthInfoService', () => {
             text: jest.fn().mockResolvedValue('Internal Server Error'),
         } as any);
 
-        try {
-            await fetchPreauthInfoService(thoughtspotHost);
-        } catch (e) {
-            expect(e.message).toContain(`Failed to fetch ${thoughtspotHost}${EndPoints.PREAUTH_INFO}`);
-        }
+        const response = await fetchPreauthInfoService(thoughtspotHost);
+        expect(response.ok).toBe(false);
+        expect(response.status).toBe(500);
+        expect(logger.error).toHaveBeenCalled();
         expect(mockFetch).toHaveBeenCalledTimes(1);
         expect(mockFetch).toHaveBeenCalledWith(`${thoughtspotHost}${EndPoints.PREAUTH_INFO}`, {});
     });

package/src/utils/logger.spec.ts

@@ -8,6 +8,8 @@ const consoleInfoSpy = jest.spyOn(console, 'info');
 const consoleDebugSpy = jest.spyOn(console, 'debug');
 const consoleTraceSpy = jest.spyOn(console, 'trace');
 
+const versionPrefix = expect.stringMatching(/^\[vesdk-/);
+
 describe('Logger', () => {
     beforeAll(async () => {
         const a = await import('./logger');
@@ -52,7 +54,7 @@ describe('Logger', () => {
         logger.error('Error message');
         logger.warn('Warning message');
         logger.debug('Debug message');
-        expect(consoleErrorSpy).toHaveBeenCalledWith('Error message');
+        expect(consoleErrorSpy).toHaveBeenCalledWith(versionPrefix, 'Error message');
         expect(consoleWarnSpy).not.toHaveBeenCalled();
         expect(consoleDebugSpy).not.toHaveBeenCalled();
 
@@ -65,17 +67,17 @@ describe('Logger', () => {
         logger.error('Warning message');
         logger.warn('Warning message');
         logger.debug('Debug message');
-        expect(consoleErrorSpy).toHaveBeenCalledWith('Warning message');
-        expect(consoleWarnSpy).toHaveBeenCalledWith('Warning message');
+        expect(consoleErrorSpy).toHaveBeenCalledWith(versionPrefix, 'Warning message');
+        expect(consoleWarnSpy).toHaveBeenCalledWith(versionPrefix, 'Warning message');
         expect(consoleDebugSpy).not.toHaveBeenCalled();
 
         logger.setLogLevel(LogLevel.DEBUG);
         logger.error('Warning message');
         logger.warn('Warning message');
         logger.debug('Debug message');
-        expect(consoleErrorSpy).toHaveBeenCalledWith('Warning message');
-        expect(consoleWarnSpy).toHaveBeenCalledWith('Warning message');
-        expect(consoleDebugSpy).toHaveBeenCalledWith('Debug message');
+        expect(consoleErrorSpy).toHaveBeenCalledWith(versionPrefix, 'Warning message');
+        expect(consoleWarnSpy).toHaveBeenCalledWith(versionPrefix, 'Warning message');
+        expect(consoleDebugSpy).toHaveBeenCalledWith(versionPrefix, 'Debug message');
     });
 
     it('should log messages with the global log level override', () => {
@@ -85,8 +87,8 @@ describe('Logger', () => {
         logger.warn('Warn message');
         logger.info('Info message');
         logger.trace('Trace message');
-        expect(consoleErrorSpy).toHaveBeenCalledWith('Error message');
-        expect(consoleWarnSpy).toHaveBeenCalledWith('Warn message');
+        expect(consoleErrorSpy).toHaveBeenCalledWith(versionPrefix, 'Error message');
+        expect(consoleWarnSpy).toHaveBeenCalledWith(versionPrefix, 'Warn message');
         expect(consoleInfoSpy).not.toHaveBeenCalled();
         expect(consoleDebugSpy).not.toHaveBeenCalled();
         expect(consoleTraceSpy).not.toHaveBeenCalled();
@@ -99,7 +101,7 @@ describe('Logger', () => {
         logger.warn('Warn message');
         logger.info('Info message');
         logger.trace('Trace message');
-        expect(consoleErrorSpy).toHaveBeenCalledWith('Error message');
+        expect(consoleErrorSpy).toHaveBeenCalledWith(versionPrefix, 'Error message');
         expect(consoleWarnSpy).not.toHaveBeenCalled();
         expect(consoleInfoSpy).not.toHaveBeenCalled();
         expect(consoleDebugSpy).not.toHaveBeenCalled();

package/src/utils/logger.ts

@@ -1,5 +1,5 @@
 import { LogLevel } from '../types';
-
+import { version } from '../../package.json';
 const logFunctions: {
     [key: string]: (...args: any[]) => void;
 } = {
@@ -51,7 +51,7 @@ class Logger {
         if (this.canLog(logLevel)) {
             const logFn = logFunctions[logLevel];
             if (logFn) {
-                logFn(...args);
+                logFn(`[vesdk-${version}]` , ...args);
             }
         }
     }