@gengage/assistant-fe 0.1.0

package/dist/chat/index.d.ts

@@ -0,0 +1,192 @@
+import { ActionPayload, PageContext } from '../common/types.js';
+import { BaseWidget } from '../common/widget-base.js';
+import { ChatWidgetConfig } from './types.js';
+export declare class GengageChat extends BaseWidget<ChatWidgetConfig> {
+    private _shadow;
+    private _rootEl;
+    private _launcher;
+    private _drawer;
+    private _bridge;
+    private _activityTracker;
+    private _proactiveShown;
+    private _drawerVisible;
+    private _messages;
+    private _currentBotText;
+    private _currentMessageId;
+    private _abortController;
+    /** Current thread cursor — only messages with threadId <= this are visible. */
+    private _currentThreadId;
+    /** Most recent threadId ever created — used to detect branch points. */
+    private _lastThreadId;
+    /** Timestamp when the chat session was created (ISO 8601). */
+    private _chatCreatedAt;
+    /** Last backend-streamed context object — sent back with every request. */
+    private _lastBackendContext;
+    /** Panel content snapshots keyed by bot message ID for history navigation. */
+    private _panelSnapshots;
+    /** Component type for each panel snapshot (for topbar title restoration). */
+    private _panelSnapshotTypes;
+    /** Currently active (highlighted) message ID in the chat pane. */
+    private _activePanelMessageId;
+    private _productSort;
+    private _comparisonSelectMode;
+    private _comparisonSelectedSkus;
+    private _thumbnailEntries;
+    private _choicePrompterEl;
+    private _openState;
+    private _mobileBreakpoint;
+    private _isMobileViewport;
+    private _pdpLaunched;
+    private _currentPanelType;
+    private _i18n;
+    private _extendedModeManager;
+    /** Thread IDs that have panel content, in order of creation. */
+    private _panelThreads;
+    /** Active typewriter animation handle — cancelled on new action or drawer close. */
+    private _activeTypewriter;
+    /** IndexedDB persistence layer — null when unavailable. */
+    private _indexedDB;
+    /** Active request thread ID — guards against stale stream events from cancelled requests. */
+    private _activeRequestThreadId;
+    /** Accumulated SKU → product item map from outputText events. */
+    private _skuToProductItem;
+    /** Current conversation mode from the latest outputText event. */
+    private _conversationMode;
+    /** Whether initialization (including IDB restore) has completed. */
+    private _initComplete;
+    /** Queue of actions received before init completes. Max 10, FIFO discard. */
+    private _pendingActions;
+    /** Favorited product SKUs (loaded from IDB). */
+    private _favoritedSkus;
+    /** Supplemental context received from host via bridge (e.g. PDP detail context). */
+    private _bridgeContext;
+    /** Last cart quantity received from host via bridge. */
+    private _cartQuantity;
+    private _threadsWithFirstBot;
+    protected onInit(config: ChatWidgetConfig): Promise<void>;
+    protected onUpdate(_context: Partial<PageContext>): void;
+    protected onShow(): void;
+    protected onHide(): void;
+    protected onDestroy(): void;
+    open(options?: {
+        state?: 'full' | 'half';
+        initialMessage?: string;
+    }): void;
+    openWithAction(action: ActionPayload, options?: {
+        sku?: string;
+    }): void;
+    close(): void;
+    saveSession(sessionId: string, sku: string): void;
+    get isOpen(): boolean;
+    private _handleBridgeMessage;
+    private _registerPublicAPI;
+    private _showDrawer;
+    private _showProactivePopup;
+    private _hideDrawer;
+    private _syncViewportState;
+    private _applyOpenStateClasses;
+    private _handleAttachment;
+    private _sendMessage;
+    private _sendAction;
+    /** Return messages visible at the current thread cursor. */
+    private _getVisibleMessages;
+    /** Handle rollback-on-click from a user message bubble. */
+    private _appendSimilarsToPanel;
+    private _handleRollback;
+    /** Rewind the conversation to the given thread. */
+    private _rollbackToThread;
+    /**
+     * Persist current session state to IndexedDB.
+     * Called after each stream completion (onDone). Non-fatal on failure.
+     */
+    private _persistToIndexedDB;
+    /**
+     * Persist session to IndexedDB, then send openURLInNewTab bridge message.
+     * Used by product clicks and bot HTML link clicks so the session can be
+     * restored when the user returns from navigation.
+     */
+    private _saveSessionAndOpenURL;
+    /**
+     * Load a UISpec payload from IndexedDB with retry logic.
+     * Returns null if not found or all retries fail.
+     */
+    private _loadPayload;
+    /**
+     * Attempt to restore chat session from IndexedDB.
+     * Always restores when IDB has session data for the current sessionId.
+     * Best-effort — failures are silently ignored.
+     */
+    private _restoreFromIndexedDB;
+    /**
+     * Build a ChatUISpecRenderContext with all callbacks wired up.
+     * Used both during streaming and during session restore.
+     */
+    private _buildRenderContext;
+    private _toggleFavorite;
+    /**
+     * Re-render inline UISpec elements for a restored bot message.
+     * Inserts them into the messages container after the message bubble.
+     */
+    private _restoreInlineUISpec;
+    private _createMessage;
+    private _resolveI18n;
+    private _resolveUISpecRegistry;
+    private _renderUISpec;
+    /**
+     * Deep-clone the current panel content (excluding topbar/thumbnails) and store
+     * it keyed by message ID. Called when a stream completes so panel content can
+     * be restored later without duplicating the topbar.
+     */
+    private _snapshotPanelForMessage;
+    /**
+     * Attach a click handler to a bot message bubble so clicking it restores
+     * the panel content that was active when that message was received.
+     */
+    private _attachMessageClickHandler;
+    /**
+     * Restore the panel content snapshot associated with a given message ID.
+     * Highlights the active message and de-highlights the previous one.
+     * Also restores the panel topbar title for the snapshot's component type.
+     * Returns true if the snapshot was found and restored.
+     */
+    private _restorePanelForMessage;
+    /**
+     * Send maximize-pdp / minify-pdp bridge messages with production-matching delays.
+     * Called by the extended mode manager (Group H) when panel extension state changes.
+     */
+    private _notifyPanelExtension;
+    /**
+     * Derive panel title from UISpec root element type using i18n strings.
+     */
+    private _panelTitleForComponent;
+    /**
+     * Update the panel top bar navigation state and title.
+     */
+    private _updatePanelTopBar;
+    /**
+     * Set panel topbar title during loading (before actual panel content arrives).
+     * Maps backend pending types to the same i18n titles used for final content.
+     */
+    private _updatePanelTopBarForLoading;
+    /**
+     * Map UISpec component types to PanelContentType for the extended mode manager.
+     */
+    private _updateExtendedModeForPanel;
+    /** Navigate to the previous panel thread. */
+    private _navigatePanelBack;
+    /** Navigate to the next panel thread. */
+    private _navigatePanelForward;
+    /**
+     * Panel route shaping:
+     * - product details => expanded LHS panel (`ProductDetailsPanel`)
+     * - all other panel-routed specs keep their original component types
+     */
+    private _toPanelSpec;
+}
+export declare function createChatWidget(): GengageChat;
+export type { ChatWidgetConfig, ChatMessage, ChatSession, ChatUIComponents, ChatI18n, ChatRendererConfig, ChatUISpecRenderContext, ChatUISpecRegistry, ProductSortState, SerializableChatMessage, } from './types.js';
+export { renderUISpec, createDefaultChatUISpecRegistry, defaultChatUnknownUISpecRenderer, } from './components/renderUISpec.js';
+export type { UISpecRenderContext } from './components/renderUISpec.js';
+export { chatCatalog } from './catalog.js';
+export type { ChatCatalog, ChatComponentName } from './catalog.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"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"}

package/dist/chat/locales/en.d.ts

@@ -0,0 +1,3 @@
+import { ChatI18n } from '../types.js';
+export declare const CHAT_I18N_EN: ChatI18n;
+//# sourceMappingURL=en.d.ts.map

package/dist/chat/locales/en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/chat/locales/en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,YAAY,EAAE,QAsC1B,CAAC"}

package/dist/chat/locales/index.d.ts

@@ -0,0 +1,6 @@
+import { ChatI18n } from '../types.js';
+import { CHAT_I18N_TR } from './tr.js';
+import { CHAT_I18N_EN } from './en.js';
+export declare function resolveChatLocale(locale?: string): ChatI18n;
+export { CHAT_I18N_TR, CHAT_I18N_EN };
+//# sourceMappingURL=index.d.ts.map

package/dist/chat/locales/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chat/locales/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAOvC,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAO3D;AAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/chat/locales/tr.d.ts

@@ -0,0 +1,3 @@
+import { ChatI18n } from '../types.js';
+export declare const CHAT_I18N_TR: ChatI18n;
+//# sourceMappingURL=tr.d.ts.map

package/dist/chat/locales/tr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../../src/chat/locales/tr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,YAAY,EAAE,QAsC1B,CAAC"}

package/dist/chat/types.d.ts

@@ -0,0 +1,212 @@
+import { BaseWidgetConfig, ActionPayload } from '../common/types.js';
+import { UnknownActionPolicy } from '../common/config-schema.js';
+import { UISpecDomRegistry, UISpecRendererOverrides } from '../common/renderer/index.js';
+export interface ChatWidgetConfig extends BaseWidgetConfig {
+    /**
+     * Widget display variant:
+     *   - 'floating'  : Launcher button + slide-in drawer (default)
+     *   - 'inline'    : Renders directly into mountTarget, no launcher
+     *   - 'overlay'   : Full-screen modal, triggered programmatically
+     */
+    variant?: 'floating' | 'inline' | 'overlay';
+    /**
+     * Initial open state for mobile.
+     * 'half' shows a half-height sheet; 'full' is full-screen.
+     */
+    mobileInitialState?: 'half' | 'full';
+    /** Custom launcher button SVG markup. */
+    launcherSvg?: string;
+    /** Tooltip text shown on launcher hover. */
+    launcherTooltip?: string;
+    /** Header display title (overrides i18n.headerTitle). */
+    headerTitle?: string;
+    /** Header avatar image URL. */
+    headerAvatarUrl?: string;
+    /** Header badge text (e.g. "BETA"). */
+    headerBadge?: string;
+    /** Header cart link URL (e.g. "/sepetim"). Shows a cart icon in the header. */
+    headerCartUrl?: string;
+    /** Show a favorites (heart) toggle button in the header. */
+    headerFavoritesToggle?: boolean;
+    /** Callback fired when the favorites header button is clicked. */
+    onFavoritesClick?: () => void;
+    /** Hide the launcher on mobile viewports. */
+    hideMobileLauncher?: boolean;
+    /** Mobile breakpoint in px (default: 768). */
+    mobileBreakpoint?: number;
+    /**
+     * Panel display mode:
+     *   - 'auto'      : Panel appears/hides with content; user can toggle (default)
+     *   - 'collapsed'  : Panel starts collapsed; user can expand
+     *   - 'expanded'   : Panel always expanded (empty placeholder if no content)
+     */
+    panelMode?: 'auto' | 'collapsed' | 'expanded';
+    /**
+     * Locale for built-in i18n strings.
+     * Provide a custom `i18n` object to override any string.
+     */
+    locale?: string;
+    i18n?: Partial<ChatI18n>;
+    renderer?: ChatRendererConfig;
+    /** Controls how streamed actions are routed (policy for unknowns, script_call gating). */
+    actionHandling?: {
+        unknownActionPolicy?: UnknownActionPolicy;
+        allowScriptCall?: boolean;
+    };
+    /**
+     * Whether this is a demo website. When true, `productDetails` content
+     * triggers the extended panel (host PDP maximize). Regular accounts
+     * render product details inline in the chat pane.
+     */
+    isDemoWebsite?: boolean;
+    /** Proactive popup message shown after idle timeout. */
+    proactiveMessage?: string;
+    /** Delay in ms before proactive popup appears (default: 30000). */
+    proactiveDelayMs?: number;
+    /** Accept button label for proactive popup. */
+    proactiveAcceptLabel?: string;
+    /** Minimum scroll depth (0–1) before proactive popup can appear (default: 0 = no threshold). */
+    proactiveMinScrollDepth?: number;
+    onOpen?: () => void;
+    onClose?: () => void;
+    onReady?: () => void;
+    onScriptCall?: (params: {
+        name: string;
+        payload?: Record<string, unknown>;
+    }) => void;
+}
+export interface ChatI18n {
+    headerTitle: string;
+    inputPlaceholder: string;
+    sendButton: string;
+    closeButton: string;
+    openButton: string;
+    newChatButton: string;
+    poweredBy: string;
+    errorMessage: string;
+    loadingMessage: string;
+    productCtaLabel: string;
+    attachImageButton: string;
+    removeAttachmentButton: string;
+    invalidFileType: string;
+    fileTooLarge: string;
+    aiTopPicksTitle: string;
+    roleWinner: string;
+    roleBestValue: string;
+    roleBestAlternative: string;
+    viewDetails: string;
+    groundingReviewCta: string;
+    variantsLabel: string;
+    sortRelated: string;
+    sortPriceAsc: string;
+    sortPriceDesc: string;
+    compareSelected: string;
+    panelTitleProductDetails: string;
+    panelTitleSimilarProducts: string;
+    panelTitleComparisonResults: string;
+    panelTitleCategories: string;
+    inStockLabel: string;
+    outOfStockLabel: string;
+    findSimilarLabel: string;
+    choicePrompterHeading: string;
+    choicePrompterSuggestion: string;
+    choicePrompterCta: string;
+    viewMoreLabel: string;
+    similarProductsLabel: string;
+}
+export interface ChatUISpecRenderContext {
+    onAction: (action: ActionPayload) => void;
+    onProductClick?: (params: {
+        sku: string;
+        url: string;
+    }) => void;
+    onAddToCart?: (params: {
+        sku: string;
+        cartCode: string;
+        quantity: number;
+    }) => void;
+    onProductSelect?: (product: Record<string, unknown>) => void;
+    i18n?: Pick<ChatI18n, 'productCtaLabel' | 'aiTopPicksTitle' | 'roleWinner' | 'roleBestValue' | 'roleBestAlternative' | 'viewDetails' | 'groundingReviewCta' | 'variantsLabel' | 'sortRelated' | 'sortPriceAsc' | 'sortPriceDesc' | 'compareSelected' | 'panelTitleProductDetails' | 'panelTitleSimilarProducts' | 'panelTitleComparisonResults' | 'panelTitleCategories' | 'inStockLabel' | 'outOfStockLabel' | 'findSimilarLabel' | 'viewMoreLabel' | 'similarProductsLabel'>;
+    productSort?: ProductSortState | undefined;
+    onSortChange?: ((sort: ProductSortState) => void) | undefined;
+    comparisonSelectMode?: boolean | undefined;
+    comparisonSelectedSkus?: string[] | undefined;
+    onToggleComparisonSku?: ((sku: string) => void) | undefined;
+    favoritedSkus?: Set<string> | undefined;
+    onFavoriteToggle?: ((sku: string, product: Record<string, unknown>) => void) | undefined;
+    topPicksLoadingSku?: string | null | undefined;
+}
+export interface ProductSortState {
+    type: 'related' | 'price';
+    direction?: 'asc' | 'desc' | undefined;
+}
+export type ChatUISpecRegistry = UISpecDomRegistry<ChatUISpecRenderContext>;
+export type ChatRendererConfig = UISpecRendererOverrides<ChatUISpecRenderContext>;
+export interface ChatMessage {
+    id: string;
+    threadId?: string;
+    role: 'user' | 'assistant';
+    /** Plain text content. */
+    content?: string;
+    /** json-render UI spec attached to this message (e.g. product cards). */
+    uiSpec?: import('../common/types.js').UISpec;
+    /** Image attachment (user-uploaded). Stored in-memory until send. */
+    attachment?: File;
+    /** Snapshot of panel DOM at time this message's stream completed. */
+    panelSnapshot?: HTMLElement;
+    /** Silent messages are hidden from the conversation but kept for context. */
+    silent?: boolean;
+    timestamp: number;
+    status: 'streaming' | 'done' | 'error';
+}
+export interface ChatSession {
+    sessionId: string;
+    messages: ChatMessage[];
+    /** SKU associated with this session (for cross-page restore). */
+    sku?: string;
+}
+/**
+ * Serializable subset of ChatMessage for IndexedDB persistence.
+ * Omits `attachment` (File) and `panelSnapshot` (HTMLElement) which are not
+ * structurally cloneable.
+ */
+export interface SerializableChatMessage {
+    id: string;
+    threadId?: string | undefined;
+    role: 'user' | 'assistant';
+    content?: string | undefined;
+    silent?: boolean | undefined;
+    timestamp: number;
+    status: 'streaming' | 'done' | 'error';
+}
+export interface ChatUIComponents {
+    /** A single text message bubble. */
+    MessageBubble: {
+        role: 'user' | 'assistant';
+        content: string;
+        timestamp?: number;
+    };
+    /** A product card shown inline in the chat stream. */
+    ProductCard: {
+        sku: string;
+        name: string;
+        imageUrl?: string;
+        price?: string;
+        originalPrice?: string;
+        url: string;
+    };
+    /** A row of quick-reply action buttons. */
+    ActionButtons: {
+        buttons: Array<{
+            label: string;
+            action: ActionPayload;
+        }>;
+    };
+    /** A "typing..." indicator. */
+    TypingIndicator: Record<string, never>;
+    /** A divider with an optional label (e.g. "New conversation"). */
+    Divider: {
+        label?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/chat/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/chat/types.ts"],"names":[],"mappings":"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"}

package/dist/chat.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./types-CeON7iBO.cjs");const e=require("./index-Dfl89zpe.cjs");exports.GengageChat=e.GengageChat;exports.chatCatalog=e.chatCatalog;exports.createChatWidget=e.createChatWidget;exports.createDefaultChatUISpecRegistry=e.createDefaultChatUISpecRegistry;exports.defaultChatUnknownUISpecRenderer=e.defaultChatUnknownUISpecRenderer;exports.renderUISpec=e.renderUISpec;
+//# sourceMappingURL=chat.cjs.map

package/dist/chat.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}