import { Param, BaseViewConfig, RuntimeFilter, RuntimeParameter, ErrorDetailsTypes, EmbedErrorCodes, DefaultAppInitData, VisualizationOverrides, SpotterFileUploadFileTypes } from '../types';
import { TsEmbed } from './ts-embed';
import { buildSpotterSidebarAppInitData, buildSpotterShareConversationAppInitData, buildStarterPromptsAppInitData } from './spotter-utils';
import { getQueryParamString, getFilterQuery, getRuntimeParameters, setParamIfDefined } from '../utils';

/**
 * Configuration for search options
 */
export interface SearchOptions {
    /**
     * The query string to pass to start the Conversation.
     */
    searchQuery: string;
}

/**
 * The query mode Spotter uses when answering a question.
 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
 */
export enum SpotterQueryMode {
    FAST_SEARCH = 'fastSearch',
    RESEARCH = 'research',
}

/**
 * Configuration for the pin/unpin conversation feature in the Spotter sidebar.
 * Grouped into one object because pin exposes several related settings
 * (enable + label overrides), unlike single-item actions like rename or
 * delete.
 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
 */
export interface SpotterChatPinConfig {
    /**
     * Enables the pin/unpin conversation feature in embedded Spotter. Disabled
     * by default — hosts must opt in. When off, the Pin/Unpin menu entry and
     * the pin glyph are hidden and the PinSpotterConversation /
     * UnpinSpotterConversation host events are no-ops. Native (non-embedded)
     * Spotter is unaffected and ships pin enabled.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @default false
     */
    enabled?: boolean;
    /**
     * Custom label text for the pin action in the conversation edit menu.
     * Defaults to translated "Pin" text.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    pinLabel?: string;
    /**
     * Custom label text for the unpin action in the conversation edit menu.
     * Defaults to translated "Unpin" text.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    unpinLabel?: string;
}

/**
 * Configuration for the Spotter sidebar.
 * Can be used in SpotterEmbed and AppEmbed.
 * @group Embed components
 * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
 */
export interface SpotterSidebarViewConfig {
    /**
     * Controls the visibility of the past conversations sidebar.
     * @default false
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    enablePastConversationsSidebar?: boolean;
    /**
     * Custom title text for the sidebar header.
     * Defaults to translated "Spotter" text.
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterSidebarTitle?: string;
    /**
     * Boolean to set the default expanded state of the sidebar.
     * @default false
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterSidebarDefaultExpanded?: boolean;
    /**
     * Custom label text for the rename action in the conversation edit menu.
     * Defaults to translated "Rename" text.
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterChatRenameLabel?: string;
    /**
     * Custom label text for the delete action in the conversation edit menu.
     * Defaults to translated "DELETE" text.
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterChatDeleteLabel?: string;
    /**
     * Pin/unpin conversation feature config (enable + label overrides).
     * Off by default in embed — hosts opt in via `enabled`.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    spotterChatPinConfig?: SpotterChatPinConfig;
    /**
     * Custom title text for the delete conversation confirmation modal.
     * Defaults to translated "Delete chat" text.
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterDeleteConversationModalTitle?: string;
    /**
     * Custom message text for the past conversation banner alert.
     * Defaults to translated alert message.
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterPastConversationAlertMessage?: string;
    /**
     * Custom URL for the documentation/best practices link.
     * Defaults to ThoughtSpot docs URL based on release version.
     * Note: URL must include the protocol (e.g., `https://www.example.com`).
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterDocumentationUrl?: string;
    /**
     * Custom label text for the best practices button in the footer.
     * Defaults to translated "Best Practices" text.
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterBestPracticesLabel?: string;
    /**
     * Number of conversations to fetch per batch when loading conversation history.
     * @default 30
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterConversationsBatchSize?: number;
    /**
     * Custom title text for the "New Chat" button in the sidebar.
     * Defaults to translated "New Chat" text.
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     */
    spotterNewChatButtonTitle?: string;
    /**
     * Custom label text for the Spotter Analyst section in the sidebar.
     * @version SDK: 1.51.0 | ThoughtSpot: 26.8.0.cl
     * @default Analyst
     */
    spotterAnalystLabel?: string;
    /**
     * Custom label text for the Spotter Analysts section in the sidebar.
     * @version SDK: 1.51.0 | ThoughtSpot: 26.8.0.cl
     * @default Analysts
     */
    spotterAnalystsLabel?: string;
}

/**
 * Configuration for the Spotter conversation sharing feature.
 * Can be used in SpotterEmbed and AppEmbed.
 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
 * @group Embed components
 */
export interface SpotterShareConversationConfig {
    /**
     * Enables sharing of the conversation.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @default false
     */
    enableShareConversation?: boolean;
    /**
     * Header Share button + sidebar Share item label.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @default "Share"
     */
    spotterShareLabel?: string;
    /**
     * Share modal title.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    spotterShareModalTitle?: string;
    /**
     * Modal confirm button label.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @default "Share"
     */
    spotterShareConfirmLabel?: string;
    /**
     * Modal cancel button label.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @default "Cancel"
     */
    spotterShareCancelLabel?: string;
    /**
     * "Add users or groups" label.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    spotterShareAddUsersLabel?: string;
    /**
     * Empty-state title ("No users added yet").
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    spotterShareEmptyTitle?: string;
    /**
     * Empty-state subtitle ("Not shared with any user").
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    spotterShareEmptySubtitle?: string;
    /**
     * "Include new messages since last shared version" checkbox label.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    spotterShareIncludeNewMessagesLabel?: string;
    /**
     * Footer note when the snapshot is current ("…up to the current moment…").
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    spotterShareUpToCurrentLabel?: string;
    /**
     * Stale-snapshot info banner text ("All added users and groups will receive…").
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    spotterShareStaleInfoLabel?: string;
    /**
     * Read-only shared-view data-access banner message.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    spotterSharedConversationBannerMessage?: string;
    /**
     * Read-only shared-view Exit button label.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @default "Exit"
     */
    spotterSharedConversationExitLabel?: string;
}

/**
 * A single starter prompt question shown under a category pill.
 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
 * @group Embed components
 */
export interface StarterPromptQuestion {
    /**
     * Short label shown as a clickable suggestion. Falls back to `prompt` when
     * omitted. ThoughtSpot truncates it beyond 80 characters.
     */
    label?: string;
    /**
     * Prompt text sent to Spotter on click. ThoughtSpot truncates it beyond
     * 300 characters.
     */
    prompt: string;
}

/**
 * Configuration for a starter prompt category with questions
 * (`quick` and `research`).
 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
 * @group Embed components
 */
export interface StarterPromptCategory {
    /**
     * Overrides the default category pill label. ThoughtSpot truncates it
     * beyond 30 characters.
     */
    label?: string;
    /**
     * Replaces the backend-generated prompts. ThoughtSpot renders the first 4
     * and drops any entry without a `prompt`.
     */
    questions?: StarterPromptQuestion[];
}

/**
 * Configuration for the Data Literacy starter prompt category.
 * Only the label is customizable; the prompt text comes from the backend.
 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
 * @group Embed components
 */
export interface StarterPreviewDataCategory {
    /**
     * Overrides the default category pill label. ThoughtSpot truncates it
     * beyond 30 characters.
     */
    label?: string;
}

/**
 * Content configuration for the Spotter starter prompts.
 * Keys are fixed: `quick` (Basic Search), `research` (Deep Analysis),
 * `previewData` (Data Literacy) and `liveboard` (Liveboard chat panel).
 *
 * Note: this controls the Spotter chat interface only. The starter prompts on
 * the Liveboard SpotterViz surface are configured separately through
 * {@link SpotterVizConfig.customStarterPrompts}.
 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
 * @group Embed components
 */
export interface StarterPromptsConfig {
    /**
     * Turns the starter prompts surface on. Must be set explicitly, an
     * unset flag leaves the surface off.
     *
     * Either this or `enableStarterPrompts` turns the surface on, so `false`
     * here does not switch it off while `enableStarterPrompts` is `true`.
     * @default false
     */
    enable?: boolean;
    /** Basic Search category configuration. */
    quick?: StarterPromptCategory;
    /** Deep Analysis category configuration. */
    research?: StarterPromptCategory;
    /** Data Literacy category configuration. */
    previewData?: StarterPreviewDataCategory;
    /**
     * Starter prompts for the Spotter chat panel on a Liveboard.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    liveboard?: StarterPromptQuestion[];
}

/**
 * Configuration for customizing Spotter chat UI branding.
 * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
 * @group Embed components
 */
export interface SpotterChatViewConfig {
    /**
     * Hides the ThoughtSpot logo/icon in tool response
     * cards. The branding label prefix is controlled
     * separately via `toolResponseCardBrandingLabel`.
     * External MCP tool branding is not affected.
     * @default false
     */
    hideToolResponseCardBranding?: boolean;
    /**
     * Custom label to replace the "ThoughtSpot" prefix
     * in tool response cards. Set to an empty string
     * `''` to hide the prefix entirely. Works
     * independently of `hideToolResponseCardBranding`.
     * External MCP tool branding is not affected.
     */
    toolResponseCardBrandingLabel?: string;
    /**
     * Enables file upload in the Spotter chat interface.
     *
     * Supported embed types: `SpotterEmbed`, `LiveboardEmbed`, `AppEmbed`
     * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
     * @default false
     */
    spotterFileUploadEnabled?: boolean;
    /**
     * Restricts the allowed file types for Spotter file upload.
     *
     * Supported embed types: `SpotterEmbed`, `LiveboardEmbed`, `AppEmbed`
     * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
     */
    spotterFileUploadFileTypes?: SpotterFileUploadFileTypes;
    /**
     * Enables starter prompts in the Spotter chat interface.
     *
     * Either this or `starterPrompts.enable` turns the surface on, so it stays
     * on while this is `true` even if `starterPrompts.enable` is `false`.
     *
     * Supported embed types: `SpotterEmbed`, `LiveboardEmbed`, `AppEmbed`
     * @version SDK: 1.51.0 | ThoughtSpot: 26.8.0.cl
     * @default false
     */
    enableStarterPrompts?: boolean;
    /**
     * Customizes the labels and questions of the Spotter starter prompts.
     * Individual pills are hidden or shown with `hiddenActions` /
     * `visibleActions` using `Action.QuickSearchPill`,
     * `Action.DeepAnalysisPill` and `Action.DataLiteracyPill`.
     *
     * Supported embed types: `SpotterEmbed`, `LiveboardEmbed`, `AppEmbed`
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    worksheetId: 'worksheet-id',
     *    hiddenActions: [Action.DeepAnalysisPill],
     *    spotterChatConfig: {
     *        starterPrompts: {
     *            enable: true,
     *            quick: {
     *                label: 'Quick questions',
     *                questions: [
     *                    { label: 'Top products', prompt: 'What are the top products by revenue?' },
     *                ],
     *            },
     *            previewData: { label: 'Explore your data' },
     *        },
     *    },
     * })
     * ```
     */
    starterPrompts?: StarterPromptsConfig;
    /**
     * Opens the Spotter chat panel when the Liveboard loads.
     *
     * Supported embed types: `LiveboardEmbed`, `AppEmbed`
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @default true
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#tsEmbed', {
     *    liveboardId: 'liveboard-id',
     *    spotterChatConfig: {
     *        openSpotterOnLiveboardByDefault: false,
     *    },
     * })
     * ```
     */
    openSpotterOnLiveboardByDefault?: boolean;
}

/**
 * Configuration for the Spotter Analyst experience.
 * Can be used in SpotterEmbed.
 * @group Embed components
 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
 * @example
 * ```js
 * const embed = new SpotterEmbed('#tsEmbed', {
 *    ... //other embed view config
 *    spotterAnalystConfig: {
 *        analystId: 'analyst-id-1234',
 *    },
 * })
 * ```
 */
export interface SpotterAnalystConfig {
    /**
     * Pins the embed to a single spotter analyst. Implies no default Spotter
     * and no "Show all".
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    analystId?: string;
}

/**
 * The configuration for the embedded spotterEmbed options.
 * @group Embed components
 */
export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAction'> {
    /**
     * The ID of the data source object. For example, Model, View, or Table. Spotter uses
     * this object to query data and generate Answers.
     * This field is optional. If not provided, Spotter loads using the
     * previously selected user data source.
     */
    worksheetId?: string;
    /**
     * The array of data source GUIDs to set on load. Spotter uses
     * these GUIDs to query data and generate Answers.
     * dataSources is preferred over worksheetId if both are provided.
     * The feature is currently behind a feature flag.
     *
     * Supported embed types: `SpotterEmbed`
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *     // ...other embed view config
     *     dataSources: ['id-2345', 'id-2345'],
     * });
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    dataSources?: string[];
    /**
     * Configuration for the Spotter Analyst experience.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    spotterAnalystConfig: {
     *        analystId: 'analyst-id-1234',
     *    },
     * })
     * ```
     */
    spotterAnalystConfig?: SpotterAnalystConfig;
    /**
     * Ability to pass a starting search query to the conversation.
     */
    searchOptions?: SearchOptions;
    /**
     * disableSourceSelection : Disables data source selection
     * but still display the selected data source.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    disableSourceSelection : true,
     * })
     * ```
     */
    disableSourceSelection?: boolean;
    /**
     * hideSourceSelection : Hide data source selection
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    hideSourceSelection : true,
     * })
     * ```
     */
    hideSourceSelection?: boolean;
    /**
     * Flag to control Data panel experience
     *
     * Supported embed types: `SageEmbed`, `AppEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
     * @deprecated from SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     * @default true
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, or SearchBarEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    dataPanelV2: true,
     * })
     * ```
     */
    dataPanelV2?: boolean;
    /**
     * showSpotterLimitations : show limitation text
     * of the spotter underneath the chat input.
     * default is false.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.36.0 | ThoughtSpot: 10.5.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    showSpotterLimitations : true,
     * })
     * ```
     */
    showSpotterLimitations?: boolean;
    /**
     * hideSampleQuestions : Hide sample questions on
     * the initial screen of the conversation.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    hideSampleQuestions : true,
     * })
     * ```
     */
    hideSampleQuestions?: boolean;
    /**
     * The list of runtime filters to apply to a search Answer,
     * visualization, or Liveboard.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    // other embed view config
     *    runtimeFilters: [
     *           {
     *             columnName: 'color',
     *             operator: RuntimeFilterOp.EQ,
     *             values: ['red'],
     *           },
     *       ],
     * })
     * ```
     */
    runtimeFilters?: RuntimeFilter[];
    /**
     * Flag to control whether runtime filters should be included in the URL.
     * If true, filters will be passed via app initialization payload
     * (default behavior from SDK 1.45.0).
     * If false/undefined, filters are appended to the iframe URL instead.
     * (default behavior before SDK 1.45.0).
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
     * @default true
     */
    excludeRuntimeFiltersfromURL?: boolean;
    /**
     * The list of runtime parameters to apply to the conversation.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    // other embed view config
     *    runtimeParameters: [
     *           {
     *             name: 'Integer Param',
     *             value: 10,
     *           },
     *       ],
     * })
     * ```
     */
    runtimeParameters?: RuntimeParameter[];
    /**
     * Flag to control whether runtime parameters should be included in the URL.
     * If true, parameters will be passed via app
     * initialization payload (default behavior from SDK 1.45.0).
     * If false/undefined, parameters are appended to
     * the iframe URL instead (default behavior before SDK 1.45.0).
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
     * @default true
     */
    excludeRuntimeParametersfromURL?: boolean;
    /**
     * updatedSpotterChatPrompt : Controls the updated spotter chat prompt.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
     * @default false
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    updatedSpotterChatPrompt : true,
     * })
     * ```
     */
    updatedSpotterChatPrompt?: boolean;
    /**
     * showSpotterRadiance : Controls the radiance on the Spotter page.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @default false
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    showSpotterRadiance : true,
     * })
     * ```
     */
    showSpotterRadiance?: boolean;
    /**
     * Sets the default query mode when Spotter loads — Fast Search or
     * Research Mode. Applies fresh on every new session for this embed
     * instance only; it does not persist as a user preference and does
     * not affect other embeds or native ThoughtSpot usage.
     *
     * Supported embed types: `SpotterEmbed`, `AppEmbed`
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @default SpotterQueryMode.FAST_SEARCH
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    defaultQueryMode: SpotterQueryMode.RESEARCH,
     * })
     * ```
     */
    defaultQueryMode?: SpotterQueryMode;
    /**
     * Enables the stop answer generation button in the Spotter embed UI,
     * allowing users to interrupt an ongoing answer generation.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     * @default false
     */
    enableStopAnswerGenerationEmbed?: boolean;
    /**
     * Controls the visibility of the past conversations sidebar.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
     * @deprecated from SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     * Use `spotterSidebarConfig.enablePastConversationsSidebar`.
     * @default false
     */
    enablePastConversationsSidebar?: boolean;
    /**
     * Configuration for the Spotter sidebar UI customization.
     *
     * Supported embed types: `SpotterEmbed`, `AppEmbed`
     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    worksheetId: 'worksheet-id',
     *    // Deprecated standalone flag (backward compatibility)
     *    enablePastConversationsSidebar: false,
     *    // Recommended config; this value takes precedence
     *    spotterSidebarConfig: {
     *        enablePastConversationsSidebar: true,
     *        spotterSidebarTitle: 'My Conversations',
     *        spotterSidebarDefaultExpanded: true,
     *    },
     * })
     * ```
     */
    spotterSidebarConfig?: SpotterSidebarViewConfig;
    /**
     * Configuration for customizing Spotter chat UI
     * branding in tool response cards.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    spotterChatConfig: {
     *        hideToolResponseCardBranding: true,
     *        toolResponseCardBrandingLabel: 'MyBrand',
     *    },
     * })
     * ```
     */
    spotterChatConfig?: SpotterChatViewConfig;
    /**
     * Configuration for the Spotter conversation sharing feature.
     *
     * Supported embed types: `SpotterEmbed`, `AppEmbed`
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    spotterShareConversationConfig: {
     *        enableShareConversation: true,
     *    },
     * })
     * ```
     */
    spotterShareConversationConfig?: SpotterShareConversationConfig;
    /**
     * The ID of a shared Spotter conversation to open directly in the read-only
     * reader view. Use this to land a share recipient in the shared conversation
     * when they open a host-configured `CONVERSATION_URL` share link: read the
     * `{conversation-id}` from your page URL and pass it here.
     *
     * Requires the Spotter conversation-sharing feature to be enabled
     * (`spotterShareConversationConfig.enableShareConversation`). The recipient
     * must be an authorized sharee — the server returns access-denied otherwise.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @example
     * ```js
     * const convId = new URLSearchParams(window.location.search).get('conversation-id');
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    sharedConversationId: convId,
     * })
     * ```
     */
    sharedConversationId?: string;
    /**
     * updatedSpotterExperience : Controls the updated Spotter experience.
     *
     * Supported embed types: `SpotterEmbed`
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @default false
     * @example
     * ```js
     * const embed = new SpotterEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    updatedSpotterExperience : true,
     * })
     * ```
     */
    updatedSpotterExperience?: boolean;
}

/**
 * The configuration for the embedded spotterEmbed options.
 * Use {@link SpotterEmbedViewConfig} instead
 * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
 * @group Embed components
 */
// eslint-disable-next-line @typescript-eslint/no-empty-object-type
export interface ConversationViewConfig extends SpotterEmbedViewConfig {}

/**
 * APP_INIT data shape for SpotterEmbed.
 * @internal
 */
export interface SpotterAppInitData extends DefaultAppInitData {
    embedParams?: {
        spotterSidebarConfig?: SpotterSidebarViewConfig;
        spotterShareConversationConfig?: SpotterShareConversationConfig;
        visualOverridesParams?: VisualizationOverrides | null;
        starterPrompts?: StarterPromptsConfig;
    };
}

/**
 * Embed ThoughtSpot AI Conversation.
 * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
 * @group Embed components
 * @example
 * ```js
 * const conversation = new SpotterEmbed('#tsEmbed', {
 *   worksheetId: 'worksheetId',
 *   searchOptions: {
 *     searchQuery: 'searchQuery',
 *   },
 * });
 * conversation.render();
 * ```
 */
export class SpotterEmbed extends TsEmbed {
    constructor(container: HTMLElement, protected viewConfig: SpotterEmbedViewConfig) {
        viewConfig = {
            embedComponentType: 'conversation',
            excludeRuntimeFiltersfromURL: true,
            excludeRuntimeParametersfromURL: true,
            ...viewConfig,
        }
        super(container, viewConfig);
    }

    /**
     * Extends the default APP_INIT payload with `embedParams.spotterSidebarConfig`
     * so the conv-assist app can read sidebar configuration on initialisation.
     *
     * Precedence for `enablePastConversationsSidebar`:
     * `spotterSidebarConfig.enablePastConversationsSidebar` wins over the
     * deprecated top-level `enablePastConversationsSidebar` flag; if the former
     * is absent the latter is used as a fallback.
     *
     * An invalid `spotterDocumentationUrl` triggers a validation error and is
     * excluded from the payload rather than forwarded to the app.
     */
    protected async getAppInitData(): Promise<SpotterAppInitData> {
        const defaultAppInitData = await super.getAppInitData();
        const sidebarInitData = buildSpotterSidebarAppInitData(
            defaultAppInitData,
            this.viewConfig,
            this.handleError.bind(this),
        );
        const shareInitData = buildSpotterShareConversationAppInitData(sidebarInitData, this.viewConfig);
        return buildStarterPromptsAppInitData(shareInitData, this.viewConfig);
    }

    protected getEmbedParamsObject() {
        const {
            searchOptions,
            disableSourceSelection,
            hideSourceSelection,
            dataPanelV2,
            updatedSpotterExperience,
            showSpotterLimitations,
            hideSampleQuestions,
            runtimeFilters,
            excludeRuntimeFiltersfromURL,
            runtimeParameters,
            excludeRuntimeParametersfromURL,
            updatedSpotterChatPrompt,
            showSpotterRadiance,
            defaultQueryMode,
            enableStopAnswerGenerationEmbed,
            spotterChatConfig,
            spotterAnalystConfig,
        } = this.viewConfig;

        const queryParams = this.getBaseQueryParams();
        queryParams[Param.SpotterEnabled] = true;

        // Boolean params
        setParamIfDefined(queryParams, Param.DisableSourceSelection, disableSourceSelection, true);
        setParamIfDefined(queryParams, Param.HideSourceSelection, hideSourceSelection, true);
        setParamIfDefined(queryParams, Param.DataPanelV2Enabled, dataPanelV2, true);
        setParamIfDefined(queryParams, Param.ShowSpotterLimitations, showSpotterLimitations, true);
        setParamIfDefined(queryParams, Param.HideSampleQuestions, hideSampleQuestions, true);
        setParamIfDefined(queryParams, Param.UpdatedSpotterChatPrompt, updatedSpotterChatPrompt, true);
        setParamIfDefined(queryParams, Param.ShowSpotterRadiance, showSpotterRadiance, true);
        setParamIfDefined(queryParams, Param.DefaultQueryMode, defaultQueryMode);
        setParamIfDefined(queryParams, Param.EnableStopAnswerGenerationEmbed, enableStopAnswerGenerationEmbed, true);
        setParamIfDefined(queryParams, Param.AnalystId, spotterAnalystConfig?.analystId);

        // Handle spotterChatConfig params
        if (spotterChatConfig) {
            const {
                hideToolResponseCardBranding,
                toolResponseCardBrandingLabel,
                spotterFileUploadEnabled,
                spotterFileUploadFileTypes,
                enableStarterPrompts,
            } = spotterChatConfig;

            setParamIfDefined(queryParams, Param.HideToolResponseCardBranding, hideToolResponseCardBranding, true);
            setParamIfDefined(queryParams, Param.ToolResponseCardBrandingLabel, toolResponseCardBrandingLabel);
            setParamIfDefined(queryParams, Param.SpotterFileUploadEnabled, spotterFileUploadEnabled, true);
            setParamIfDefined(queryParams, Param.IsStarterPromptsEnabled, enableStarterPrompts, true);
            if (spotterFileUploadFileTypes !== undefined) {
                queryParams[Param.SpotterFileUploadFileTypes] = JSON.stringify(spotterFileUploadFileTypes);
            }
        }

        setParamIfDefined(queryParams, Param.UpdatedSpotterExperience, updatedSpotterExperience, true);

        return queryParams;
    }

    public getIframeSrc(): string {
        const {
            worksheetId,
            searchOptions,
            runtimeFilters,
            excludeRuntimeFiltersfromURL,
            runtimeParameters,
            excludeRuntimeParametersfromURL,
            sharedConversationId,
            dataSources,
        } = this.viewConfig;
        // Deep-link into the read-only shared-conversation reader view when a
        // shared conversation id is supplied (e.g. a recipient landing from a
        // host-configured CONVERSATION_URL share link); otherwise the normal
        // Spotter conversation surface.
        const path = sharedConversationId
            ? `insights/conv-assist/s/${encodeURIComponent(sharedConversationId)}`
            : 'insights/conv-assist';
        const queryParams = this.getEmbedParamsObject();

        let query = '';
        const queryParamsString = getQueryParamString(queryParams, true);
        if (queryParamsString) {
            query = `?${queryParamsString}`;
        }

        const filterQuery = getFilterQuery(runtimeFilters || []);
        if (filterQuery && !excludeRuntimeFiltersfromURL) {
            query += `&${filterQuery}`;
        }

        const parameterQuery = getRuntimeParameters(runtimeParameters || []);
        if (parameterQuery && !excludeRuntimeParametersfromURL) {
            query += `&${parameterQuery}`;
        }

        const tsPostHashParams = this.getThoughtSpotPostUrlParams({
            ...(!(Array.isArray(dataSources) && dataSources.length > 0) && worksheetId
                && { worksheet: worksheetId }),
            ...(searchOptions?.searchQuery && { query: searchOptions.searchQuery }),
            ...(Array.isArray(dataSources)
                && dataSources.length > 0
                && { dataSources: JSON.stringify(dataSources) }),
        });
        return `${this.getEmbedBasePath(query)}/embed/${path}${tsPostHashParams}`;
    }

    public async render(): Promise<SpotterEmbed> {
        await super.render();

        const src = this.getIframeSrc();
        await this.renderIFrame(src);
        return this;
    }
}

/**
 * Embed ThoughtSpot AI Conversation.
 * Use {@link SpotterEmbed} instead
 * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
 * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
 * @group Embed components
 * @example
 * ```js
 * const conversation = new SpotterEmbed('#tsEmbed', {
 *   worksheetId: 'worksheetId',
 *   searchOptions: {
 *     searchQuery: 'searchQuery',
 *   },
 * });
 * conversation.render();
 * ```
 */
export class ConversationEmbed extends SpotterEmbed {
    constructor(container: HTMLElement, protected viewConfig: ConversationViewConfig) {
        viewConfig = {
            embedComponentType: 'conversation',
            excludeRuntimeFiltersfromURL: true,
            excludeRuntimeParametersfromURL: true,
            ...viewConfig,
        }
        super(container, viewConfig);
    }
}