goji-search 3.0.4 → 3.0.6

package/README.md

@@ -94,6 +94,10 @@ npm run test:coverage # Run tests with coverage
 
 ## Documentation
 
+See [docs/README.md](./docs/README.md) for the frontend documentation index.
+
 See [USAGE.md](./USAGE.md) for detailed documentation, advanced usage, and API reference.
 
+See [docs/FRONTEND_STATE_AND_TRANSPORT_MAP.md](./docs/FRONTEND_STATE_AND_TRANSPORT_MAP.md) for the widget architecture map, state ownership, and backend transport contract.
+
 See [CHANGELOG.md](./CHANGELOG.md) for version history.

package/dist/__tests__/integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/new-features-e2e.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * End-to-End Integration Tests for New Features
+ *
+ * Tests the complete flow of each new feature to ensure they work
+ * correctly in realistic scenarios.
+ */
+export {};

package/dist/goji-search/components/__tests__/goji-search-component.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/components/elements/__tests__/choice-bubbles.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/components/elements/__tests__/deep-analysis-card.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/components/elements/__tests__/email-input-box.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/components/elements/__tests__/expandable-section.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/components/elements/__tests__/message-list.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/components/elements/__tests__/roi-calculator-card.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/components/elements/__tests__/slide-panel.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/components/elements/action-buttons.d.ts

@@ -7,10 +7,7 @@ interface ActionButtonsProps {
     hideCalendar?: boolean;
     onSubmit: () => void;
     onVoiceSearch: () => void;
-    onClose: () => void;
     onCalendarClick: () => void;
-    showBookACall?: boolean;
 }
-export declare function ActionButtons({ size, isHovered, isStreaming, searchQuery, isRecording, hideCalendar, onSubmit, onVoiceSearch, onClose, onCalendarClick, // Added calendar click handler
-showBookACall, }: ActionButtonsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ActionButtons({ size, isHovered, isStreaming, searchQuery, isRecording, hideCalendar, onSubmit, onVoiceSearch, onCalendarClick, }: ActionButtonsProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/goji-search/components/elements/calendar-integration.d.ts

@@ -2,5 +2,5 @@ interface CalendarIntegrationProps {
     calLink?: string;
     onBooked?: () => void;
 }
-export default function CalendarIntegration(props?: CalendarIntegrationProps): import("react/jsx-runtime").JSX.Element;
+export default function CalendarIntegration({ calLink, onBooked, }?: CalendarIntegrationProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/goji-search/components/elements/deep-analysis-card.d.ts

@@ -1,4 +1,4 @@
-export type AnalysisType = "roi" | "comparison" | "cost_breakdown" | "key_metrics";
+export type AnalysisType = "roi" | "comparison";
 export type ConfidenceLevel = "high" | "medium" | "low";
 export interface DeepAnalysisData {
     analysis_type: AnalysisType;
@@ -8,9 +8,9 @@ export interface DeepAnalysisData {
     generated_at?: number;
 }
 export interface DeepAnalysisCardProps {
-    analysisType: AnalysisType;
+    analysisType: AnalysisType | string;
     data?: DeepAnalysisData;
     isLoading?: boolean;
-    onClick?: () => void;
+    onCollapse?: () => void;
 }
-export declare function DeepAnalysisCard({ analysisType, data, isLoading, onClick, }: DeepAnalysisCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function DeepAnalysisCard({ analysisType, data, isLoading, onCollapse, }: DeepAnalysisCardProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/goji-search/components/elements/email-input-box.d.ts

@@ -4,20 +4,22 @@
  * Displays a dedicated email input box when the backend requests email collection.
  * - Appears below follow-up questions (after ClosingCard if present)
  * - Includes email validation
- * - Animated entrance/exit
+ * - Animated entrance
  * - Respects localized prompt text from backend
+ *
+ * Lifecycle is controlled by the parent via mount/unmount (currentEmailRequest state).
  */
 interface EmailInputBoxProps {
     /** Localized prompt text from backend */
     promptText: string;
-    /** Session ID for submission */
-    sessionId?: string;
     /** Callback when email is submitted */
     onSubmit: (email: string) => Promise<void>;
     /** Callback when user dismisses the box */
     onDismiss?: () => void;
     /** Additional CSS class */
     className?: string;
+    /** Session ID for tracking */
+    sessionId?: string;
 }
-export declare function EmailInputBox({ promptText, sessionId, onSubmit, onDismiss, className, }: EmailInputBoxProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function EmailInputBox({ promptText, onSubmit, onDismiss, className, sessionId, }: EmailInputBoxProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/goji-search/components/elements/expandable-section.d.ts

@@ -2,6 +2,7 @@ interface ExpandableSectionProps {
     title: string;
     children: React.ReactNode;
     defaultExpanded?: boolean;
+    isLoading?: boolean;
 }
-export declare function ExpandableSection({ title, children, defaultExpanded }: ExpandableSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function ExpandableSection({ title, children, defaultExpanded, isLoading, }: ExpandableSectionProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/goji-search/components/elements/help-actions-row.d.ts

@@ -0,0 +1,15 @@
+import type { HelpAction } from "../../lib/goji-client";
+interface HelpActionsRowProps {
+    actions: HelpAction[];
+    heading?: string;
+    disabled?: boolean;
+    onActionClick?: (action: HelpAction) => void;
+}
+interface HelpActionChipProps {
+    action: HelpAction;
+    disabled?: boolean;
+    onActionClick?: (action: HelpAction) => void;
+}
+export declare function HelpActionChip({ action, disabled, onActionClick, }: HelpActionChipProps): import("react/jsx-runtime").JSX.Element;
+export declare function HelpActionsRow({ actions, heading, disabled, onActionClick, }: HelpActionsRowProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/goji-search/components/elements/inspiration-menu.d.ts

@@ -3,12 +3,12 @@ interface InspirationMenuProps {
     onQuestionClick: (question: string) => void;
     onClose: () => void;
     suggestedLabel?: string;
+    color?: string;
     showLanguageSelector?: boolean;
     supportedLanguages?: string[];
     currentLanguage?: string;
     onLanguageChange?: (lang: string) => void;
     languageLabels?: Record<string, string>;
-    color?: string;
 }
-export declare function InspirationMenu({ questions, onQuestionClick, onClose, suggestedLabel, showLanguageSelector, supportedLanguages, currentLanguage, onLanguageChange, languageLabels, color }: InspirationMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function InspirationMenu({ questions, onQuestionClick, onClose, suggestedLabel, color, showLanguageSelector, supportedLanguages, currentLanguage, onLanguageChange, languageLabels, }: InspirationMenuProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/goji-search/components/elements/message-list.d.ts

@@ -1,4 +1,4 @@
-import { DeepAnalysis, PendingAnalysis } from "../../lib/goji-client";
+import type { HelpAction, ROICalculatorConfig } from "../../lib/goji-client";
 interface ChatSource {
     index: number;
     url: string;
@@ -17,14 +17,11 @@ interface Message {
     choicesSelected?: boolean;
     choicesVariant?: "default" | "faded" | "dark";
     choiceMode?: "send" | "action";
-    deepAnalysis?: {
-        current?: DeepAnalysis;
-        pending?: PendingAnalysis;
-    };
-    emailRequest?: {
-        prompt: string;
-        sessionId?: string;
-    };
+    choicesHidden?: boolean;
+    helpActions?: HelpAction[];
+    helpActionsSelected?: boolean;
+    roiCalculatorConfig?: ROICalculatorConfig;
+    roiCalculatorOpen?: boolean;
 }
 interface MessageListProps {
     messages: Message[];
@@ -33,11 +30,19 @@ interface MessageListProps {
     size?: "m" | "l" | "xl" | "s" | "xs";
     brandName?: string;
     onChoiceClick?: (messageIndex: number, choice: string) => void;
-    onDeepAnalysisClick?: () => void;
-    onEmailSubmit?: (email: string, sessionId?: string) => Promise<void>;
+    onHelpActionClick?: (messageIndex: number, action: HelpAction) => void;
+    onRoiOpenClick?: (messageIndex: number) => void;
+    helpActionsHeading?: string;
+    roiSuggestionLabel?: string;
+    roiSuggestionPrompt?: string;
+    roiOpenLabel?: string;
+    roiOpenPrompt?: string;
+    roiCalculatorTitle?: string;
+    roiEstimatedResultLabel?: string;
+    roiLocale?: string;
     userMessageBackgroundColor?: string;
-    aiColor?: string;
     showLogo?: boolean;
+    aiColor?: string;
 }
-export declare function MessageList({ messages, isStreaming, aiAvatarSrc, size, brandName, onChoiceClick, onDeepAnalysisClick, onEmailSubmit, userMessageBackgroundColor, aiColor, showLogo, }: MessageListProps): import("react/jsx-runtime").JSX.Element;
+export declare function MessageList({ messages, isStreaming, aiAvatarSrc, size, brandName, onChoiceClick, onHelpActionClick, onRoiOpenClick, helpActionsHeading, roiSuggestionLabel, roiSuggestionPrompt, roiOpenLabel, roiOpenPrompt, roiCalculatorTitle, roiEstimatedResultLabel, roiLocale, userMessageBackgroundColor, showLogo, aiColor, }: MessageListProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/goji-search/components/elements/roi-calculator-card.d.ts

@@ -0,0 +1,9 @@
+import type { ROICalculatorConfig } from "../../lib/goji-client";
+export interface ROICalculatorCardProps {
+    config: ROICalculatorConfig;
+    title?: string;
+    estimatedResultLabel?: string;
+    locale?: string;
+    initiallyExpanded?: boolean;
+}
+export declare function ROICalculatorCard({ config, title, estimatedResultLabel, locale, initiallyExpanded, }: ROICalculatorCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/goji-search/components/elements/search-input.d.ts

@@ -20,5 +20,5 @@ interface SearchInputProps {
     forceMenuOpenToken?: number;
     color?: string;
 }
-export declare function SearchInput({ value, onChange, onFocus, onBlur, placeholder, size, setSize, inputRef, inspirationQuestions, onInspirationClick, sparkleRef, suggestedLabel, showLanguageSelector, supportedLanguages, currentLanguage, onLanguageChange, languageLabels, forceMenuOpenToken, color }: SearchInputProps): import("react/jsx-runtime").JSX.Element;
+export declare function SearchInput({ value, onChange, onFocus, onBlur, placeholder, size, setSize, inputRef, inspirationQuestions, onInspirationClick, sparkleRef, suggestedLabel, showLanguageSelector, supportedLanguages, currentLanguage, onLanguageChange, languageLabels, forceMenuOpenToken, color, }: SearchInputProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/goji-search/components/goji-search-component.d.ts

@@ -27,21 +27,17 @@ export interface GojiSearchComponentProps {
      * @example "#E8E8FF"
      */
     userMessageBackgroundColor?: string;
-    /**
-     * Widget position on the horizontal axis.
-     * - "left": anchored to the left side
-     * - "center": centered (default)
-     * - "right": anchored to the right side
-     */
+    /** Widget horizontal position */
     position?: "left" | "center" | "right";
-    /**
-     * If set to "left" or "right", the widget will "merge" into that edge
-     * by the given fraction of its own width. Value between 0 and 0.5.
-     * Example: `mergeAmount={0.2}` will shift the widget 20% off-screen.
-     */
+    /** Merge widget into a page edge */
     mergeFrom?: "left" | "right" | null;
+    /** How much to merge (0 to 0.5) */
     mergeAmount?: number;
+    /** Show "Book a call" button */
     showBookACall?: boolean;
+    /** Show AI logo in messages */
     showLogo?: boolean;
+    /** Link to logo */
+    logoUrl?: string;
 }
-export declare function GojiSearchComponent({ apiUrl, companyId, apiKey, aiColor, userMessageBackgroundColor, position, mergeFrom, mergeAmount, showBookACall, showLogo }: GojiSearchComponentProps): import("react/jsx-runtime").JSX.Element;
+export declare function GojiSearchComponent({ apiUrl, companyId, apiKey, aiColor, userMessageBackgroundColor, position, mergeFrom, mergeAmount, showBookACall, showLogo, logoUrl }: GojiSearchComponentProps): import("react/jsx-runtime").JSX.Element;

package/dist/goji-search/config/company.d.ts

@@ -19,6 +19,12 @@ interface LanguageConfig {
     bookDemoDialogDescription: string;
     errorMessage: string;
     suggested: string;
+    roiChipLabel: string;
+    roiSuggestionPrompt: string;
+    roiOpenButtonLabel: string;
+    roiOpenPrompt: string;
+    roiCalculatorTitle: string;
+    roiEstimatedResult: string;
 }
 export declare const companyConfig: {
     brandName: string;

package/dist/goji-search/hooks/__tests__/useCompanyTheme.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/hooks/__tests__/useIdleReengagement.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/hooks/__tests__/useReturningVisitor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/hooks/useChatStream.d.ts

@@ -1,4 +1,4 @@
-import type { GojiSearchClient, ChatSource, CTACard, EmailRequest, DeepAnalysis, PendingAnalysis, VisualSlide } from "../lib/goji-client";
+import type { GojiSearchClient, ChatSource, CTACard, EmailRequest, DeepAnalysis, HelpAction, PendingAnalysis, VisualSlide, ROICalculatorConfig, SupportModeInfo } from "../lib/goji-client";
 import type { VisitorContext } from "../lib/utm-capture";
 export interface Message {
     role: "user" | "assistant";
@@ -11,18 +11,23 @@ export interface Message {
     choicesSelected?: boolean;
     choicesVariant?: "default" | "faded" | "dark";
     choiceMode?: "send" | "action";
+    choicesHidden?: boolean;
+    helpActions?: HelpAction[];
+    helpActionsSelected?: boolean;
     emailToken?: string;
-    deepAnalysis?: {
-        current?: DeepAnalysis;
-        pending?: PendingAnalysis;
-    };
+    roiCalculatorConfig?: ROICalculatorConfig;
+    roiCalculatorOpen?: boolean;
+    supportMode?: SupportModeInfo;
 }
 export interface UseChatStreamOptions {
     client: GojiSearchClient;
     visitorId: string | undefined;
     companyId: string;
     supportedLanguages: string[];
+    supportContactCtaLabel?: string;
+    supportContactQuestion?: string;
     onLanguageDetected?: (lang: string) => void;
+    onStreamingStart?: () => void;
     onResponseComplete?: () => void;
     resetIdleTimerRef: React.MutableRefObject<() => void>;
 }
@@ -45,8 +50,10 @@ export interface UseChatStreamReturn {
     backendSuggestedQuestions: string[] | null;
     setBackendSuggestedQuestions: React.Dispatch<React.SetStateAction<string[] | null>>;
     streamingCancelRef: React.MutableRefObject<(() => void) | null>;
-    sendMessage: (message: string, language: string, visitorContext: VisitorContext | undefined, options?: {
+    sendMessage: (message: string, language: string | undefined, visitorContext: VisitorContext | undefined, options?: {
         preAction?: () => void;
+        helpActionId?: string;
+        helpActionDetail?: string;
     }) => Promise<void>;
 }
-export declare function useChatStream({ client, visitorId, companyId, supportedLanguages, onLanguageDetected, onResponseComplete, resetIdleTimerRef, }: UseChatStreamOptions): UseChatStreamReturn;
+export declare function useChatStream({ client, visitorId, companyId, supportedLanguages, supportContactCtaLabel, supportContactQuestion, onLanguageDetected, onStreamingStart, onResponseComplete, resetIdleTimerRef, }: UseChatStreamOptions): UseChatStreamReturn;

package/dist/goji-search/hooks/useCompanyTheme.d.ts

@@ -17,6 +17,21 @@ interface CompanyTheme {
         default: string;
     };
     calendar_link?: string;
+    roi_calculator?: {
+        enabled: boolean;
+        currency: string;
+        inputs: Array<{
+            id: string;
+            label: string;
+            type: "number" | "percent" | "currency";
+            default: number;
+            min: number;
+            max: number;
+            step: number;
+        }>;
+        formula: string;
+        output_template: string;
+    };
 }
 export interface ThemeCSSVars {
     '--brand-color': string;
@@ -26,7 +41,7 @@ export interface ThemeCSSVars {
     '--brand-color-rgb': string;
     '--brand-color-dark-rgb': string;
 }
-export declare function useCompanyTheme(apiUrl: string, companyId: string, apiKey: string): {
+export declare function useCompanyTheme(apiUrl: string, companyId: string, apiKey: string, language?: string): {
     theme: CompanyTheme | null;
     cssVars: ThemeCSSVars | null;
     loading: boolean;

package/dist/goji-search/lib/__tests__/goji-client.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/lib/__tests__/utm-capture.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/lib/__tests__/visitor-id.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/goji-search/lib/calendar-config.d.ts

@@ -3,7 +3,7 @@ export interface CalendarConfig {
     link: string;
     namespace?: string;
     theme?: "light" | "dark";
-    layout?: "month_view" | "week_view" | "agenda";
+    layout?: "month_view" | "week_view" | "column_view";
 }
 export declare const calendarConfig: CalendarConfig;
 export declare function getCalendarConfig(): CalendarConfig;

package/dist/goji-search/lib/formula-parser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Safe formula parser — recursive descent, no eval().
+ *
+ * Supports: numbers, +, -, *, /, parentheses, variable names.
+ * Variables are substituted from a Record<string, number>.
+ * Rejects unknown tokens or unresolved variables.
+ *
+ * Grammar:
+ *   expr     → term (('+' | '-') term)*
+ *   term     → factor (('*' | '/') factor)*
+ *   factor   → NUMBER | VARIABLE | '(' expr ')'
+ */
+/**
+ * Evaluate a formula string with variable substitution.
+ * Returns the computed number, or null if the formula is invalid.
+ */
+export declare function evaluateFormula(formula: string, vars: Record<string, number>): number | null;

package/dist/goji-search/lib/goji-client.d.ts

@@ -35,8 +35,25 @@ export interface EmailRequest {
     reason: string;
     email_token?: string;
 }
+/** ROI Calculator types */
+export interface ROICalculatorInput {
+    id: string;
+    label: string;
+    type: "number" | "percent" | "currency";
+    default: number;
+    min: number;
+    max: number;
+    step: number;
+}
+export interface ROICalculatorConfig {
+    enabled: boolean;
+    currency: string;
+    inputs: ROICalculatorInput[];
+    formula: string;
+    output_template: string;
+}
 /** Deep analysis types */
-export type DeepAnalysisType = "roi" | "comparison" | "cost_breakdown" | "key_metrics";
+export type DeepAnalysisType = "roi" | "comparison";
 export type ConfidenceLevel = "high" | "medium" | "low";
 /** Deep analysis data from backend */
 export interface DeepAnalysis {
@@ -53,6 +70,14 @@ export interface PendingAnalysis {
     session_id: string;
     analysis_id?: string;
 }
+export interface HelpAction {
+    id: string;
+    category: string;
+    label: string;
+    icon: string;
+    detail?: string;
+    subtitle?: string;
+}
 /** Returning visitor context from backend */
 export interface ReturningVisitorContext {
     visitor_id: string;
@@ -86,6 +111,7 @@ export interface ChatResponse {
     session_id: string;
     answer: string;
     sources: ChatSource[];
+    help_actions?: HelpAction[];
     email_token?: string;
     suggested_questions?: string[];
     cta_card?: CTACard;
@@ -94,6 +120,7 @@ export interface ChatResponse {
     visual_slides?: VisualSlide[];
     request_email?: EmailRequest;
     pending_analysis?: PendingAnalysis;
+    roi_calculator?: ROICalculatorConfig;
     choices?: string[];
     choices_variant?: "default" | "faded" | "dark";
     choice_mode?: "send" | "action";
@@ -110,6 +137,7 @@ export interface StreamDoneMessage {
     session_id: string;
     answer: string;
     sources: ChatSource[];
+    help_actions?: HelpAction[];
     email_token?: string;
     suggested_questions?: string[];
     cta_card?: CTACard;
@@ -118,6 +146,7 @@ export interface StreamDoneMessage {
     visual_slides?: VisualSlide[];
     request_email?: EmailRequest;
     pending_analysis?: PendingAnalysis;
+    roi_calculator?: ROICalculatorConfig;
     choices?: string[];
     choices_variant?: "default" | "faded" | "dark";
     choice_mode?: "send" | "action";
@@ -225,6 +254,8 @@ export declare class GojiSearchClient {
      */
     chat(params: {
         message: string;
+        helpActionId?: string;
+        helpActionDetail?: string;
         sessionId?: string;
         visitorId?: string;
         language?: string;
@@ -236,6 +267,8 @@ export declare class GojiSearchClient {
      */
     streamChat(params: {
         message: string;
+        helpActionId?: string;
+        helpActionDetail?: string;
         sessionId?: string;
         visitorId?: string;
         language?: string;
@@ -336,4 +369,8 @@ export declare class GojiSearchClient {
  * ```
  */
 export declare function createGojiClient(apiUrl?: string, apiKey?: string): GojiSearchClient;
-export declare function getGojiClient(): GojiSearchClient;
+/**
+ * Default client instance for convenience (points to localhost)
+ * For production use, create your own instance with createGojiClient()
+ */
+export declare const gojiClient: GojiSearchClient;