@thoughtspot/visual-embed-sdk 1.39.1 → 1.39.2-spotter-agent

package/lib/src/visual-embed-sdk.d.ts

@@ -985,23 +985,6 @@ declare module '@thoughtspot/visual-embed-sdk/embed/liveboard' {
                 * })
                 */
             dataSourceId?: string;
-            /**
-                * This flag is for show/hide checkboxes for include or exclude
-                * cover page and filters in the Liveboard PDF.
-                *
-                * Supported embed types: `LiveboardEmbed`
-                * @version SDK: 1.37.0 | ThoughtSpot:10.8.0.cl
-                * @default true
-                * Supported embed types: `LiveboardEmbed`
-                * @example
-                * ```js
-                * const embed = new LiveboardEmbed('#tsEmbed', {
-                *    ... //other embed view config
-                *    coverAndFilterOptionInPDF: false,
-                * })
-                * ```
-                */
-            coverAndFilterOptionInPDF?: boolean;
             /**
                 * The list of tab IDs to hide from the embedded.
                 * This Tabs will be hidden from their respective LBs.
@@ -1581,10 +1564,6 @@ declare module '@thoughtspot/visual-embed-sdk/embed/bodyless-conversation' {
                 * The ID of the worksheet to use for the conversation.
                 */
             worksheetId: string;
-            /**
-                * Optional CSS class name to add to the container div.
-                */
-            containerClassName?: string;
     }
     /**
         * Configuration for conversation options.
@@ -1594,13 +1573,13 @@ declare module '@thoughtspot/visual-embed-sdk/embed/bodyless-conversation' {
         */
     export interface BodylessConversationViewConfig extends SpotterAgentEmbedViewConfig {
     }
-    interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConfig {
+    export interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConfig {
             sessionId: string;
             genNo: number;
             acSessionId: string;
             acGenNo: number;
     }
-    class ConversationMessage extends TsEmbed {
+    export class ConversationMessage extends TsEmbed {
             protected viewConfig: SpotterAgentMessageViewConfig;
             constructor(container: HTMLElement, viewConfig: SpotterAgentMessageViewConfig);
             getIframeSrc(): string;
@@ -1636,6 +1615,23 @@ declare module '@thoughtspot/visual-embed-sdk/embed/bodyless-conversation' {
                     viz: ConversationMessage;
                     error?: undefined;
             }>;
+            /**
+                * Send a message to the conversation service and return only the data.
+                * @param userMessage - The message to send to the conversation service.
+                * @returns The data from the conversation service.
+                */
+            sendMessageData(userMessage: string): Promise<{
+                    error: any;
+                    data?: undefined;
+            } | {
+                    data: {
+                            sessionId: any;
+                            genNo: any;
+                            acSessionId: any;
+                            acGenNo: any;
+                    };
+                    error?: undefined;
+            }>;
     }
     /**
         * Create a conversation embed, which can be integrated inside
@@ -1660,7 +1656,6 @@ declare module '@thoughtspot/visual-embed-sdk/embed/bodyless-conversation' {
     export class BodylessConversation extends SpotterAgentEmbed {
             constructor(viewConfig: BodylessConversationViewConfig);
     }
-    export {};
 }
 
 declare module '@thoughtspot/visual-embed-sdk/embed/conversation' {
@@ -3465,6 +3460,22 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```
                 */
             enableAskSage?: boolean;
+            /**
+             * This flag is used to show or hide checkboxes for including or excluding
+             * the cover and filters pages in the Liveboard PDF.
+             *
+             * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+             * @version SDK: 1.40.0 | ThoughtSpot:10.8.0.cl
+             * @example
+             * ```js
+             * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
+             * const embed = new <EmbedComponent>('#tsEmbed', {
+             *    ... // other embed view config
+             *    coverAndFilterOptionInPDF: false,
+             * })
+             * ```
+             */
+            coverAndFilterOptionInPDF?: boolean;
     }
     export interface AllEmbedViewConfig extends BaseViewConfig, SearchLiveboardCommonViewConfig, HomePageConfig, LiveboardAppEmbedViewConfig {
     }
@@ -5936,7 +5947,7 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
             DataSourceId = "dataSourceId",
             preAuthCache = "preAuthCache",
             ShowSpotterLimitations = "showSpotterLimitations",
-            CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF",
+            CoverAndFilterOptionInPDF = "arePdfCoverFilterPageCheckboxesEnabled",
             PrimaryAction = "primaryAction",
             isSpotterAgentEmbed = "isSpotterAgentEmbed",
             IsLiveboardStylingAndGroupingEnabled = "isLiveboardStylingAndGroupingEnabled"
@@ -7159,7 +7170,23 @@ declare module '@thoughtspot/visual-embed-sdk/types' {
                 * ```
                 *  @version SDK: 1.37.0 | ThoughtSpot Cloud: 10.8.0.cl
                 */
-            CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF"
+            CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF",
+            /**
+                * Action ID for hide or disable the
+                * Spotter in conversation training widget.
+                * The Add to Coaching feature is currently in beta
+                * and is disabled by default on embed deployments.
+                * To enable this feature on your instance,
+                * contact ThoughtSpot Support.
+                *  @example
+                * ```js
+                * hiddenAction: [Action.InConversationTraining]
+                * disabledActions: [Action.InConversationTraining]
+                *
+                * ```
+                *  @version SDK: 1.39.0 | ThoughtSpot Cloud: 10.10.0.cl
+                */
+            InConversationTraining = "InConversationTraining"
     }
     export interface AnswerServiceType {
             getAnswer?: (offset: number, batchSize: number) => any;
@@ -8083,13 +8110,14 @@ declare module '@thoughtspot/visual-embed-sdk/embed/embedConfig' {
         *
         * @example
         * ```js
+        * import { getInitConfig } from '@thoughtspot/visual-embed-sdk';
+        * // Call the getInitConfig method to retrieve the embed configuration
         * const config = getInitConfig();
+        * // Log the configuration settings
         * console.log(config);
         * ```
-        * @example
-        *
-        * Returns the `EmbedConfig` object, which
-        * contains the configuration settings used to
+        * Returns the link:https://developers.thoughtspot.com/docs/Interface_EmbedConfig[EmbedConfig]
+        * object, which contains the configuration settings used to
         * initialize the SDK, including the following:
         *
         *  - `thoughtSpotHost` - ThoughtSpot host URL
@@ -8098,9 +8126,10 @@ declare module '@thoughtspot/visual-embed-sdk/embed/embedConfig' {
         *  - `customizations` - Style, text, and icon customization settings
         *  that were applied during the SDK initialization.
         *
-        * For a comprehensive list of embed configuration settings,
-        * see link:https://developers.thoughtspot.com/docs/Interface_EmbedConfig[Developer Documentation].
+        * The following JSON output shows the embed configuration
+        * settings returned from the code in the previous example:
         *
+        * @example
         * ```json
         * {
         *   "thoughtSpotHost": "https://{ThoughtSpot-Host}",
@@ -8122,7 +8151,7 @@ declare module '@thoughtspot/visual-embed-sdk/embed/embedConfig' {
         *   "authTriggerContainer": "#your-own-div"
         *  }
         * ```
-        * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.cl, and later
+        * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw, and later
         * @group Global methods
         */
     export const getEmbedConfig: () => EmbedConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thoughtspot/visual-embed-sdk",
-    "version": "1.39.1",
+    "version": "1.39.2-spotter-agent",
     "description": "ThoughtSpot Embed SDK",
     "module": "lib/src/index.js",
     "main": "dist/tsembed.js",

package/src/config.spec.ts

@@ -21,6 +21,17 @@ describe('getThoughtSpotHost', () => {
         expect(testFn).toThrow(Error);
     });
 
+    test('invalid URL format', () => {
+        const testFn = () => {
+            getThoughtSpotHost({
+                ...embedConfig,
+                thoughtSpotHost: '',
+            });
+        };
+
+        expect(testFn).toThrow('Error parsing ThoughtSpot host. Please provide a valid URL.');
+    });
+
     test('IP address/hostname only', () => {
         expect(
             getThoughtSpotHost({

package/src/embed/app.spec.ts

@@ -8,9 +8,7 @@ import {
     HomePage,
 } from './app';
 import { init } from '../index';
-import {
-    Action, AuthType, EmbedEvent, HostEvent, RuntimeFilterOp,
-} from '../types';
+import { Action, AuthType, EmbedEvent, HostEvent, RuntimeFilterOp } from '../types';
 import {
     executeAfterWait,
     getDocumentBody,
@@ -45,12 +43,13 @@ beforeAll(() => {
         authType: AuthType.None,
     });
     jest.spyOn(auth, 'postLoginService').mockImplementation(() => Promise.resolve({}));
-    (window as any).ResizeObserver = window.ResizeObserver
-            || jest.fn().mockImplementation(() => ({
-                disconnect: jest.fn(),
-                observe: jest.fn(),
-                unobserve: jest.fn(),
-            }));
+    (window as any).ResizeObserver =
+        window.ResizeObserver ||
+        jest.fn().mockImplementation(() => ({
+            disconnect: jest.fn(),
+            observe: jest.fn(),
+            unobserve: jest.fn(),
+        }));
 });
 
 const cleanUp = () => {
@@ -316,6 +315,20 @@ describe('App embed tests', () => {
         });
     });
 
+    test('should set coverAndFilterOptionInPDF to false in url', async () => {
+        const appEmbed = new AppEmbed(getRootEl(), {
+            ...defaultViewConfig,
+            coverAndFilterOptionInPDF: false,
+        } as AppViewConfig);
+        appEmbed.render();
+        await executeAfterWait(() => {
+            expectUrlMatchesWithParams(
+                getIFrameSrc(),
+                `http://${thoughtSpotHost}/?embedApp=true&profileAndHelpInNavBarHidden=false&arePdfCoverFilterPageCheckboxesEnabled=false${defaultParamsPost}#/home`,
+            );
+        });
+    });
+
     test('should set isLiveboardStylingAndGroupingEnabled to true in url', async () => {
         const appEmbed = new AppEmbed(getRootEl(), {
             ...defaultViewConfig,
@@ -687,7 +700,8 @@ describe('App embed tests', () => {
         const appEmbed = new AppEmbed(getRootEl(), {
             ...defaultViewConfig,
             // eslint-disable-next-line max-len
-            dataPanelCustomGroupsAccordionInitialState: DataPanelCustomColumnGroupsAccordionState.EXPAND_FIRST,
+            dataPanelCustomGroupsAccordionInitialState:
+                DataPanelCustomColumnGroupsAccordionState.EXPAND_FIRST,
         } as AppViewConfig);
 
         appEmbed.render();
@@ -700,19 +714,18 @@ describe('App embed tests', () => {
     });
 
     test('should register event handlers to adjust iframe height', async () => {
-        const onSpy = jest.spyOn(AppEmbed.prototype, 'on')
-            .mockImplementation((event, callback) => {
-                if (event === EmbedEvent.RouteChange) {
-                    callback({ data: { currentPath: '/answers' } }, jest.fn());
-                }
-                if (event === EmbedEvent.EmbedHeight) {
-                    callback({ data: '100%' });
-                }
-                if (event === EmbedEvent.EmbedIframeCenter) {
-                    callback({}, jest.fn());
-                }
-                return null;
-            });
+        const onSpy = jest.spyOn(AppEmbed.prototype, 'on').mockImplementation((event, callback) => {
+            if (event === EmbedEvent.RouteChange) {
+                callback({ data: { currentPath: '/answers' } }, jest.fn());
+            }
+            if (event === EmbedEvent.EmbedHeight) {
+                callback({ data: '100%' });
+            }
+            if (event === EmbedEvent.EmbedIframeCenter) {
+                callback({}, jest.fn());
+            }
+            return null;
+        });
         jest.spyOn(TsEmbed.prototype as any, 'getIframeCenter').mockReturnValue({});
         jest.spyOn(TsEmbed.prototype as any, 'setIFrameHeight').mockReturnValue({});
         const appEmbed = new AppEmbed(getRootEl(), {

package/src/embed/app.ts

@@ -588,6 +588,7 @@ export class AppEmbed extends V1Embed {
             isUnifiedSearchExperienceEnabled = true,
             enablePendoHelp = true,
             discoveryExperience,
+            coverAndFilterOptionInPDF = false,
             isLiveboardStylingAndGroupingEnabled,
         } = this.viewConfig;
 
@@ -606,6 +607,7 @@ export class AppEmbed extends V1Embed {
         params[Param.ShowLiveboardReverifyBanner] = showLiveboardReverifyBanner;
         params[Param.HideIrrelevantFiltersInTab] = hideIrrelevantChipsInLiveboardTabs;
         params[Param.IsUnifiedSearchExperienceEnabled] = isUnifiedSearchExperienceEnabled;
+        params[Param.CoverAndFilterOptionInPDF] = !!coverAndFilterOptionInPDF;
 
         params = this.getBaseQueryParams(params);
 

package/src/embed/bodyless-conversation.spec.ts

@@ -1,5 +1,5 @@
 import 'jest-fetch-mock';
-import { SpotterAgentEmbed, SpotterAgentEmbedViewConfig } from './bodyless-conversation';
+import { SpotterAgentEmbed, SpotterAgentEmbedViewConfig, ConversationMessage } from './bodyless-conversation';
 import * as authInstance from '../auth';
 import { init } from '../index';
 import { Action, AuthType, RuntimeFilterOp } from '../types';
@@ -138,7 +138,7 @@ describe('SpotterAgentEmbed', () => {
         expect(errorResult.error instanceof Error).toBeTruthy();
     });
 
-    test('should apply containerClassName to the container element', async () => {
+    test('should handle hideActions parameter correctly', async () => {
         fetchMock.mockResponses(
             JSON.stringify({
                 data: {
@@ -227,221 +227,27 @@ describe('SpotterAgentEmbed', () => {
 
         const viewConfig: SpotterAgentEmbedViewConfig = {
             worksheetId: 'worksheetId',
-            containerClassName: 'custom-conversation-container',
+            hiddenActions: [Action.Download, Action.Save], // This should trigger the HideActions branch
         };
 
         const spotterAgentEmbed = new SpotterAgentEmbed(viewConfig);
         const result = await spotterAgentEmbed.sendMessage('userMessage');
         
-        // Verify that the container has the custom class name
-        expect(result.container.className).toBe('custom-conversation-container');
-        
-        // Also verify the iframe src is correct
+        // Verify the iframe src contains the hideActions parameter
         const iframeSrc = getIFrameSrc(result.container);
-        expectUrlToHaveParamsWithValues(iframeSrc, {
-            sessionId: 'sessionId',
-            genNo: 2,
-            acSessionId: 'transactionId',
-            acGenNo: 1,
-        });
+        expect(iframeSrc).toContain('hideAction');
     });
 
-    test('should not set className when containerClassName is not provided', async () => {
-        fetchMock.mockResponses(
-            JSON.stringify({
-                data: {
-                    ConvAssist__createConversation: {
-                        convId: 'conversationId',
-                        initialCtx: {
-                            type: 'TS_ANSWER',
-                            tsAnsCtx: {
-                                sessionId: 'sessionId',
-                                genNo: 1,
-                                stateKey: {
-                                    transactionId: 'transactionId',
-                                    generationNumber: 1,
-                                },
-                                worksheet: {
-                                    worksheetId: 'worksheetId',
-                                    worksheetName: 'GTM',
-                                },
-                            },
-                        },
-                    },
-                },
-            }),
-            JSON.stringify({
-                data: {
-                    ConvAssist__sendMessage: {
-                        responses: [
-                            {
-                                msgId: 'msgId',
-                                data: {
-                                    asstRespData: {
-                                        tool: 'TS_NLS',
-                                        asstRespText: '',
-                                        nlsAnsData: {
-                                            sageQuerySuggestions: [
-                                                {
-                                                    llmReasoning: {
-                                                        assumptions: 'You want the total [COL|sales] for [COL|item_type] [VAL|jackets] for [VAL|this year].',
-                                                        clarifications: '',
-                                                        interpretation: '',
-                                                        __typename: 'eureka_SageQuerySuggestion_LLMReasoning',
-                                                    },
-                                                    tokens: [
-                                                        'sum sales',
-                                                        "item type = 'jackets'",
-                                                        "date = 'this year'",
-                                                    ],
-                                                    tmlTokens: [
-                                                        'sum [sales]',
-                                                        "[date] = [date].'this year'",
-                                                        "[item type] = [item type].'jackets'",
-                                                    ],
-                                                    worksheetId: 'worksheetId',
-                                                    description: '',
-                                                    title: '',
-                                                    cached: false,
-                                                    sqlQuery: "SELECT SUM(sales) FROM __Sample_Retail_Apparel WHERE item_type = 'jackets' AND date = _this_year();",
-                                                    sessionId: 'sessionId',
-                                                    genNo: 2,
-                                                    formulaInfo: [],
-                                                    tmlPhrases: [],
-                                                    stateKey: {
-                                                        transactionId: 'transactionId',
-                                                        generationNumber: 1,
-                                                        __typename: 'sage_auto_complete_v2_ACStateKey',
-                                                    },
-                                                    __typename: 'eureka_SageQuerySuggestion',
-                                                },
-                                            ],
-                                            responseType: 'ANSWER',
-                                            __typename: 'convassist_nls_tool_NLSToolAsstRespData',
-                                        },
-                                        __typename: 'convassist_AsstResponseData',
-                                    },
-                                    __typename: 'convassist_MessageData',
-                                },
-                                type: 'ASST_RESPONSE',
-                                __typename: 'convassist_MessagePayload',
-                            },
-                        ],
-                        __typename: 'convassist_SendMessageResponse',
-                    },
-                },
-            }),
-        );
-
+    test('should have sendMessageData method', () => {
         const viewConfig: SpotterAgentEmbedViewConfig = {
             worksheetId: 'worksheetId',
-            // No containerClassName provided
         };
 
         const spotterAgentEmbed = new SpotterAgentEmbed(viewConfig);
-        const result = await spotterAgentEmbed.sendMessage('userMessage');
-        
-        // Verify that the container has no class name (empty string)
-        expect(result.container.className).toBe('');
+        expect(typeof spotterAgentEmbed.sendMessageData).toBe('function');
     });
 
-    test('should handle hideActions parameter correctly', async () => {
-        fetchMock.mockResponses(
-            JSON.stringify({
-                data: {
-                    ConvAssist__createConversation: {
-                        convId: 'conversationId',
-                        initialCtx: {
-                            type: 'TS_ANSWER',
-                            tsAnsCtx: {
-                                sessionId: 'sessionId',
-                                genNo: 1,
-                                stateKey: {
-                                    transactionId: 'transactionId',
-                                    generationNumber: 1,
-                                },
-                                worksheet: {
-                                    worksheetId: 'worksheetId',
-                                    worksheetName: 'GTM',
-                                },
-                            },
-                        },
-                    },
-                },
-            }),
-            JSON.stringify({
-                data: {
-                    ConvAssist__sendMessage: {
-                        responses: [
-                            {
-                                msgId: 'msgId',
-                                data: {
-                                    asstRespData: {
-                                        tool: 'TS_NLS',
-                                        asstRespText: '',
-                                        nlsAnsData: {
-                                            sageQuerySuggestions: [
-                                                {
-                                                    llmReasoning: {
-                                                        assumptions: 'You want the total [COL|sales] for [COL|item_type] [VAL|jackets] for [VAL|this year].',
-                                                        clarifications: '',
-                                                        interpretation: '',
-                                                        __typename: 'eureka_SageQuerySuggestion_LLMReasoning',
-                                                    },
-                                                    tokens: [
-                                                        'sum sales',
-                                                        "item type = 'jackets'",
-                                                        "date = 'this year'",
-                                                    ],
-                                                    tmlTokens: [
-                                                        'sum [sales]',
-                                                        "[date] = [date].'this year'",
-                                                        "[item type] = [item type].'jackets'",
-                                                    ],
-                                                    worksheetId: 'worksheetId',
-                                                    description: '',
-                                                    title: '',
-                                                    cached: false,
-                                                    sqlQuery: "SELECT SUM(sales) FROM __Sample_Retail_Apparel WHERE item_type = 'jackets' AND date = _this_year();",
-                                                    sessionId: 'sessionId',
-                                                    genNo: 2,
-                                                    formulaInfo: [],
-                                                    tmlPhrases: [],
-                                                    stateKey: {
-                                                        transactionId: 'transactionId',
-                                                        generationNumber: 1,
-                                                        __typename: 'sage_auto_complete_v2_ACStateKey',
-                                                    },
-                                                    __typename: 'eureka_SageQuerySuggestion',
-                                                },
-                                            ],
-                                            responseType: 'ANSWER',
-                                            __typename: 'convassist_nls_tool_NLSToolAsstRespData',
-                                        },
-                                        __typename: 'convassist_AsstResponseData',
-                                    },
-                                    __typename: 'convassist_MessageData',
-                                },
-                                type: 'ASST_RESPONSE',
-                                __typename: 'convassist_MessagePayload',
-                            },
-                        ],
-                        __typename: 'convassist_SendMessageResponse',
-                    },
-                },
-            }),
-        );
-
-        const viewConfig: SpotterAgentEmbedViewConfig = {
-            worksheetId: 'worksheetId',
-            hiddenActions: [Action.Download, Action.Save], // This should trigger the HideActions branch
-        };
-
-        const spotterAgentEmbed = new SpotterAgentEmbed(viewConfig);
-        const result = await spotterAgentEmbed.sendMessage('userMessage');
-        
-        // Verify the iframe src contains the hideActions parameter
-        const iframeSrc = getIFrameSrc(result.container);
-        expect(iframeSrc).toContain('hideAction');
+    test('should export ConversationMessage class', () => {
+        expect(typeof ConversationMessage).toBe('function');
     });
 });

package/src/embed/bodyless-conversation.ts

@@ -13,11 +13,6 @@ export interface SpotterAgentEmbedViewConfig extends Omit<BaseViewConfig, 'prima
      * The ID of the worksheet to use for the conversation.
      */
     worksheetId: string;
-    
-    /**
-     * Optional CSS class name to add to the container div.
-     */
-    containerClassName?: string;
 }
 
 /**
@@ -29,14 +24,14 @@ export interface SpotterAgentEmbedViewConfig extends Omit<BaseViewConfig, 'prima
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface BodylessConversationViewConfig extends SpotterAgentEmbedViewConfig {}
 
-interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConfig {
+export interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConfig {
     sessionId: string;
     genNo: number;
     acSessionId: string;
     acGenNo: number;
 }
 
-class ConversationMessage extends TsEmbed {
+export class ConversationMessage extends TsEmbed {
     constructor(container: HTMLElement, protected viewConfig: SpotterAgentMessageViewConfig) {
         viewConfig.embedComponentType = 'bodyless-conversation';
         super(container, viewConfig);
@@ -116,9 +111,6 @@ export class SpotterAgentEmbed {
         }
 
         const container = document.createElement('div');
-        if (this.viewConfig.containerClassName) {
-            container.className = this.viewConfig.containerClassName;
-        }
 
         const embed = new ConversationMessage(container, {
             ...this.viewConfig,
@@ -130,6 +122,28 @@ export class SpotterAgentEmbed {
         await embed.render();
         return { container, viz: embed };
     }
+
+    /**
+     * Send a message to the conversation service and return only the data.
+     * @param userMessage - The message to send to the conversation service.
+     * @returns The data from the conversation service.
+     */
+    public async sendMessageData(userMessage: string) {
+        try {
+            const { data, error } = await this.conversationService.sendMessage(userMessage);
+            if (error) {
+                return { error };
+            }
+            return { data: {
+                sessionId: data.sessionId,
+                genNo: data.genNo,
+                acSessionId: data.stateKey.transactionId,
+                acGenNo: data.stateKey.generationNumber,
+            } };
+        } catch (error) {
+            return { error: error as Error };
+        }
+    }
 }
 
 /**