@deepdesk/deepdesk-sdk 19.7.1 → 19.7.2-beta.1

package/dist/index.d.mts

@@ -2048,16 +2048,23 @@ declare class WebsocketClient {
     private eventListeners;
     private url;
     private maxReconnectAttempts;
+    private readonly initialReconnectAttempts;
     private reconnectInterval;
     private shouldReconnect;
     private cleanupCallbacks;
+    private disposed;
+    private reconnectTimer?;
     constructor(options: WebsocketOptions);
     connect(): void;
+    private attachSocket;
     private setupListeners;
-    private reconnect;
+    private tryReconnect;
     send(event: string, data: any): void;
     on<T = unknown>(eventType: string, callback: EventCallback<T>): void;
     close(): void;
+    /** Page navigation prompt (e.g. cancelled "Leave site?") — close only, keep reconnect eligible. */
+    private closeForPageLeave;
+    private stopSocketWithoutReconnect;
     cleanup(): void;
 }
 
@@ -2208,6 +2215,18 @@ interface WidgetOptions {
     openAdminFeedback?: OpenAdminFeedbackHandler;
     knowledgeAssist?: KnowledgeAssistOptions;
     assistantOptions?: Omit<EvaluateInput, 'assistantCode'>;
+    /**
+     * Mount the search overlay (command palette) next to the widget, so the widget's Search
+     * button and CMD+K open a search box inside the widget's own frame.
+     *
+     * Set this only when nothing else on the page already mounts a search box, for example an
+     * iframe whose host page has no Deepdesk SDK. When the host page already mounts one (it
+     * calls `mount()` and receives the widget's `ShowCommandPalette` event), leave it off:
+     * the search would open twice and the copy inside the widget would cover the widget.
+     *
+     * @default false
+     */
+    mountSearchOverlay?: boolean;
 }
 interface KnowledgeAssistantWidgetOptions extends KnowledgeAssistOptions {
     customStyles?: WidgetCustomStyles;
@@ -2223,6 +2242,7 @@ declare class DeepdeskSDK {
     private eventListeners;
     private unmountHandlers;
     private disposeHandlers;
+    private disposed;
     private inlineSuggestions;
     private aboveSuggestions;
     private belowSuggestions;
@@ -2235,6 +2255,8 @@ declare class DeepdeskSDK {
     private dialogOverlaysCustomStyles;
     /** OR of includeLoginOverlay across ensureDialogOverlays callers (mount can upgrade widget-only). */
     private dialogOverlaysIncludeLogin;
+    /** True while the rendered widget asked for the shared overlays (`mountSearchOverlay`). */
+    private widgetOwnsDialogOverlays;
     private nicknameDialogUnsubscribe;
     private nicknameDialogFailed;
     private dynamicThunkObject;
@@ -3541,6 +3563,11 @@ declare class DeepdeskSDK {
      */
     private ensureDialogOverlays;
     private disposeDialogOverlays;
+    /**
+     * `mount()` is done with the shared overlays. They go away unless the rendered widget asked
+     * for them (`mountSearchOverlay`); then only what `mount()` added, the login overlay, goes.
+     */
+    private releaseDialogOverlaysFromMount;
     private renderOverlays;
     /**
      * Renders the Deepdesk widget in a container element.
@@ -3552,10 +3579,11 @@ declare class DeepdeskSDK {
      * **Important:** Make sure to set the container element to a fixed or minimum size
      * (height and width) as the widget will grow to fill the container.
      *
-     * Also mounts dialog overlays (search command palette / CMD+K) so iframe-only
-     * integrations that never call {@link mount} still get search. Shared with `mount()` —
-     * only one overlays root exists per SDK instance. Does **not** mount `LoginOverlay`
-     * (iframe apps use their own sign-in); `mount()` still can.
+     * Mounts dialog overlays (search command palette / CMD+K) only when
+     * `options.mountSearchOverlay` is `true`, for iframe-only integrations that never call
+     * {@link mount} and whose host page has no search box. Shared with `mount()` — only one
+     * overlays root exists per SDK instance. Does **not** mount `LoginOverlay` (iframe apps
+     * use their own sign-in); `mount()` still can.
      *
      * **Note:** Only one widget can be rendered per SDK instance.
      *
@@ -3566,6 +3594,7 @@ declare class DeepdeskSDK {
      * @param options.isEmbedded - Whether the widget is embedded in another application
      * @param options.knowledgeAssist - Knowledge assistant configuration
      * @param options.assistantOptions - Assistant evaluation options
+     * @param options.mountSearchOverlay - Mount a search box inside the widget's frame (default: false)
      *
      * @example
      * ```typescript
@@ -3873,6 +3902,8 @@ declare function waitForElementVisibilityChange(element: HTMLElement, callback:
     isVisible: boolean;
 }) => void, interval?: number): Cancelable;
 
+declare function clearWidgetAssistantSessionId(externalConversationId: string | undefined): void;
+
 type LogEvent<T extends keyof SendEventArgumentMap, P extends T = T> = {
     name: T;
     data: SendEventArgumentMap[P]['data'];
@@ -3882,4 +3913,4 @@ declare function logEvent<T extends keyof SendEventArgumentMap>(event: LogEvent<
 type CSSModule = Record<string, string>;
 declare function useStyles<TStyles extends CSSModule>(componentName: string, defaultStyles: TStyles): TStyles;
 
-export { type AgentInfo, Card, ContentEditableInput, type Conversation, type ConversationAssistantResult, type ConversationMessage, DeepdeskAPI, DeepdeskSDK, type EvaluationAttachment, HTTPClient, InputMediator, type InputOverlayCustomStyles, InputType, KeyboardHint, Label, Locale, type Logger, type MountOptions, type OpenAdminFeedbackHandler, type PinnedMessage, type PlatformConfig, type ReloadConversationContextOptions, type RootState, Section, SectionList, type SelectionRange, Sources, Suggestion, type SuggestionEventMetrics, SuggestionList, type SuggestionMetrics, TextAreaInput, type TextSuggestion, ToggleButton, type UrlSuggestion, type VisitorInfo, type WidgetCustomStyles, type WidgetOptions, attachFile, authenticateWithKey, createFullRange, createOverlayContainer, createRangeFromOffsets, escapeHTML, formatTextMarkup, getRangeOffsets, getRangeText, insertCKEditor, isHTML, isSupportedInputElement, logEvent, updateContentEditable, updateTextArea, useClickOutsideRoot, useStyles, waitForElementVisibilityChange };
+export { type AgentInfo, Card, ContentEditableInput, type Conversation, type ConversationAssistantResult, type ConversationMessage, DeepdeskAPI, DeepdeskSDK, type EvaluationAttachment, HTTPClient, InputMediator, type InputOverlayCustomStyles, InputType, KeyboardHint, Label, Locale, type Logger, type MountOptions, type OpenAdminFeedbackHandler, type PinnedMessage, type PlatformConfig, type ReloadConversationContextOptions, type RootState, Section, SectionList, type SelectionRange, Sources, Suggestion, type SuggestionEventMetrics, SuggestionList, type SuggestionMetrics, TextAreaInput, type TextSuggestion, ToggleButton, type UrlSuggestion, type VisitorInfo, type WidgetCustomStyles, type WidgetOptions, attachFile, authenticateWithKey, clearWidgetAssistantSessionId, createFullRange, createOverlayContainer, createRangeFromOffsets, escapeHTML, formatTextMarkup, getRangeOffsets, getRangeText, insertCKEditor, isHTML, isSupportedInputElement, logEvent, updateContentEditable, updateTextArea, useClickOutsideRoot, useStyles, waitForElementVisibilityChange };

package/dist/index.d.ts

@@ -2048,16 +2048,23 @@ declare class WebsocketClient {
     private eventListeners;
     private url;
     private maxReconnectAttempts;
+    private readonly initialReconnectAttempts;
     private reconnectInterval;
     private shouldReconnect;
     private cleanupCallbacks;
+    private disposed;
+    private reconnectTimer?;
     constructor(options: WebsocketOptions);
     connect(): void;
+    private attachSocket;
     private setupListeners;
-    private reconnect;
+    private tryReconnect;
     send(event: string, data: any): void;
     on<T = unknown>(eventType: string, callback: EventCallback<T>): void;
     close(): void;
+    /** Page navigation prompt (e.g. cancelled "Leave site?") — close only, keep reconnect eligible. */
+    private closeForPageLeave;
+    private stopSocketWithoutReconnect;
     cleanup(): void;
 }
 
@@ -2208,6 +2215,18 @@ interface WidgetOptions {
     openAdminFeedback?: OpenAdminFeedbackHandler;
     knowledgeAssist?: KnowledgeAssistOptions;
     assistantOptions?: Omit<EvaluateInput, 'assistantCode'>;
+    /**
+     * Mount the search overlay (command palette) next to the widget, so the widget's Search
+     * button and CMD+K open a search box inside the widget's own frame.
+     *
+     * Set this only when nothing else on the page already mounts a search box, for example an
+     * iframe whose host page has no Deepdesk SDK. When the host page already mounts one (it
+     * calls `mount()` and receives the widget's `ShowCommandPalette` event), leave it off:
+     * the search would open twice and the copy inside the widget would cover the widget.
+     *
+     * @default false
+     */
+    mountSearchOverlay?: boolean;
 }
 interface KnowledgeAssistantWidgetOptions extends KnowledgeAssistOptions {
     customStyles?: WidgetCustomStyles;
@@ -2223,6 +2242,7 @@ declare class DeepdeskSDK {
     private eventListeners;
     private unmountHandlers;
     private disposeHandlers;
+    private disposed;
     private inlineSuggestions;
     private aboveSuggestions;
     private belowSuggestions;
@@ -2235,6 +2255,8 @@ declare class DeepdeskSDK {
     private dialogOverlaysCustomStyles;
     /** OR of includeLoginOverlay across ensureDialogOverlays callers (mount can upgrade widget-only). */
     private dialogOverlaysIncludeLogin;
+    /** True while the rendered widget asked for the shared overlays (`mountSearchOverlay`). */
+    private widgetOwnsDialogOverlays;
     private nicknameDialogUnsubscribe;
     private nicknameDialogFailed;
     private dynamicThunkObject;
@@ -3541,6 +3563,11 @@ declare class DeepdeskSDK {
      */
     private ensureDialogOverlays;
     private disposeDialogOverlays;
+    /**
+     * `mount()` is done with the shared overlays. They go away unless the rendered widget asked
+     * for them (`mountSearchOverlay`); then only what `mount()` added, the login overlay, goes.
+     */
+    private releaseDialogOverlaysFromMount;
     private renderOverlays;
     /**
      * Renders the Deepdesk widget in a container element.
@@ -3552,10 +3579,11 @@ declare class DeepdeskSDK {
      * **Important:** Make sure to set the container element to a fixed or minimum size
      * (height and width) as the widget will grow to fill the container.
      *
-     * Also mounts dialog overlays (search command palette / CMD+K) so iframe-only
-     * integrations that never call {@link mount} still get search. Shared with `mount()` —
-     * only one overlays root exists per SDK instance. Does **not** mount `LoginOverlay`
-     * (iframe apps use their own sign-in); `mount()` still can.
+     * Mounts dialog overlays (search command palette / CMD+K) only when
+     * `options.mountSearchOverlay` is `true`, for iframe-only integrations that never call
+     * {@link mount} and whose host page has no search box. Shared with `mount()` — only one
+     * overlays root exists per SDK instance. Does **not** mount `LoginOverlay` (iframe apps
+     * use their own sign-in); `mount()` still can.
      *
      * **Note:** Only one widget can be rendered per SDK instance.
      *
@@ -3566,6 +3594,7 @@ declare class DeepdeskSDK {
      * @param options.isEmbedded - Whether the widget is embedded in another application
      * @param options.knowledgeAssist - Knowledge assistant configuration
      * @param options.assistantOptions - Assistant evaluation options
+     * @param options.mountSearchOverlay - Mount a search box inside the widget's frame (default: false)
      *
      * @example
      * ```typescript
@@ -3873,6 +3902,8 @@ declare function waitForElementVisibilityChange(element: HTMLElement, callback:
     isVisible: boolean;
 }) => void, interval?: number): Cancelable;
 
+declare function clearWidgetAssistantSessionId(externalConversationId: string | undefined): void;
+
 type LogEvent<T extends keyof SendEventArgumentMap, P extends T = T> = {
     name: T;
     data: SendEventArgumentMap[P]['data'];
@@ -3882,4 +3913,4 @@ declare function logEvent<T extends keyof SendEventArgumentMap>(event: LogEvent<
 type CSSModule = Record<string, string>;
 declare function useStyles<TStyles extends CSSModule>(componentName: string, defaultStyles: TStyles): TStyles;
 
-export { type AgentInfo, Card, ContentEditableInput, type Conversation, type ConversationAssistantResult, type ConversationMessage, DeepdeskAPI, DeepdeskSDK, type EvaluationAttachment, HTTPClient, InputMediator, type InputOverlayCustomStyles, InputType, KeyboardHint, Label, Locale, type Logger, type MountOptions, type OpenAdminFeedbackHandler, type PinnedMessage, type PlatformConfig, type ReloadConversationContextOptions, type RootState, Section, SectionList, type SelectionRange, Sources, Suggestion, type SuggestionEventMetrics, SuggestionList, type SuggestionMetrics, TextAreaInput, type TextSuggestion, ToggleButton, type UrlSuggestion, type VisitorInfo, type WidgetCustomStyles, type WidgetOptions, attachFile, authenticateWithKey, createFullRange, createOverlayContainer, createRangeFromOffsets, escapeHTML, formatTextMarkup, getRangeOffsets, getRangeText, insertCKEditor, isHTML, isSupportedInputElement, logEvent, updateContentEditable, updateTextArea, useClickOutsideRoot, useStyles, waitForElementVisibilityChange };
+export { type AgentInfo, Card, ContentEditableInput, type Conversation, type ConversationAssistantResult, type ConversationMessage, DeepdeskAPI, DeepdeskSDK, type EvaluationAttachment, HTTPClient, InputMediator, type InputOverlayCustomStyles, InputType, KeyboardHint, Label, Locale, type Logger, type MountOptions, type OpenAdminFeedbackHandler, type PinnedMessage, type PlatformConfig, type ReloadConversationContextOptions, type RootState, Section, SectionList, type SelectionRange, Sources, Suggestion, type SuggestionEventMetrics, SuggestionList, type SuggestionMetrics, TextAreaInput, type TextSuggestion, ToggleButton, type UrlSuggestion, type VisitorInfo, type WidgetCustomStyles, type WidgetOptions, attachFile, authenticateWithKey, clearWidgetAssistantSessionId, createFullRange, createOverlayContainer, createRangeFromOffsets, escapeHTML, formatTextMarkup, getRangeOffsets, getRangeText, insertCKEditor, isHTML, isSupportedInputElement, logEvent, updateContentEditable, updateTextArea, useClickOutsideRoot, useStyles, waitForElementVisibilityChange };