@snf/qa-bot-core 0.1.0 → 0.2.1

package/dist/types/components/BotController.d.ts

@@ -3,6 +3,8 @@ import type { BotControllerHandle } from '../config';
 interface BotControllerProps {
     embedded: boolean;
     currentOpen?: boolean;
+    enabled: boolean;
+    onSetEnabled?: (enabled: boolean) => void;
 }
 /**
  * BotController Component

package/dist/types/components/LoginButton.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+/**
+ * LoginButton Component
+ *
+ * A standalone component for the login button that can be styled independently
+ *
+ * @param props - Component props
+ * @param props.loginUrl - URL to navigate to for login
+ * @param props.className - Optional CSS class for styling
+ * @param props.style - Optional inline styles
+ * @param props.isHeaderButton - Whether this is rendered in the header (different styling)
+ * @returns Rendered login button
+ */
+interface LoginButtonProps {
+    loginUrl: string;
+    className?: string;
+    style?: React.CSSProperties;
+    isHeaderButton?: boolean;
+}
+declare const LoginButton: React.FC<LoginButtonProps>;
+export default LoginButton;

package/dist/types/components/UserIcon.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+/**
+ * UserIcon Component
+ *
+ * A standalone component for the user icon that can be styled independently.
+ * Visibility controlled by CSS classes on the container.
+ *
+ * @returns Rendered user icon
+ */
+declare const UserIcon: React.FC;
+export default UserIcon;

package/dist/types/config.d.ts

@@ -14,6 +14,10 @@ export interface QABotProps {
     footerText?: string;
     footerLink?: string;
     tooltipText?: string;
+    enabled?: boolean;
+    loginUrl?: string;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
 }
 /**
  * Default values for overridable props
@@ -28,6 +32,8 @@ export declare const defaultValues: {
     errorMessage: string;
     embedded: boolean;
     tooltipText: string;
+    enabled: boolean;
+    loginUrl: string;
 };
 /**
  * Fixed react-chatbotify settings

package/dist/types/contexts/SessionContext.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+interface SessionContextType {
+    resetSession: () => void;
+    clearResettingFlag: () => void;
+}
+export declare const SessionProvider: React.FC<{
+    children: React.ReactNode;
+    resetSession: () => void;
+    clearResettingFlag: () => void;
+}>;
+export declare const useSession: () => SessionContextType;
+export {};

package/dist/types/hooks/useUpdateHeader.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Custom hook to update the chatbot header based on login state
+ * Adds/removes the 'bot-logged-in' CSS class to control visibility of login button vs user icon
+ *
+ * @param isLoggedIn - Whether the user is logged in
+ * @param containerRef - Reference to the chatbot container element
+ */
+declare const useUpdateHeader: (isLoggedIn: boolean, containerRef: React.RefObject<HTMLDivElement>) => void;
+export default useUpdateHeader;

package/dist/types/utils/flows/qa-flow.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 /**
  * Creates the basic Q&A conversation flow
  * Handles questions, responses, and optional ratings
@@ -6,20 +7,36 @@
  * @param {string} params.endpoint Q&A API endpoint (required)
  * @param {string} params.ratingEndpoint Rating API endpoint (optional)
  * @param {string} params.apiKey API key for authentication (optional)
- * @param {string} params.sessionId Session ID for tracking
+ * @param {Function} params.sessionId Function that returns current session ID
+ * @param {Function} params.isResetting Function that returns whether we're currently resetting
+ * @param {boolean} params.enabled Whether the user is logged in/enabled (optional)
+ * @param {string} params.loginUrl Login URL to redirect to (optional)
  * @returns {Object} Q&A flow configuration
  */
-export declare const createQAFlow: ({ endpoint, ratingEndpoint, apiKey, sessionId }: {
+export declare const createQAFlow: ({ endpoint, ratingEndpoint, apiKey, sessionId: getSessionId, isResetting, enabled, loginUrl }: {
     endpoint: any;
     ratingEndpoint: any;
     apiKey: any;
     sessionId: any;
+    isResetting?: () => boolean;
+    enabled?: boolean;
+    loginUrl?: string;
 }) => {
+    qa_loop: {
+        message: string;
+        component: React.JSX.Element;
+        chatDisabled: boolean;
+        path: string;
+        options?: undefined;
+        renderMarkdown?: undefined;
+    };
+} | {
     qa_loop: {
         message: (chatState: any) => Promise<"Thanks for the feedback! Feel free to ask another question." | "I apologize, but I'm having trouble processing your question. Please try again later.">;
         options: (chatState: any) => string[];
         renderMarkdown: string[];
         chatDisabled: boolean;
         path: string;
+        component?: undefined;
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snf/qa-bot-core",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "A configurable chatbot setup for quick integration of RAG-powered Q&A and rating system",
   "main": "./dist/qa-bot-core.umd.cjs",
   "module": "./dist/qa-bot-core.js",

package/dist/types/config/constants.d.ts

@@ -1,66 +0,0 @@
-/**
- * QA Bot Core - Runtime Constants and Usage Examples
- *
- * This file contains runtime constants and documentation that was previously
- * in the large api-reference.js file. TypeScript interfaces are now in types.ts.
- */
-import { CONSTANTS } from './types';
-export { CONSTANTS };
-/**
- * ===========================================
- * USAGE EXAMPLES & PATTERNS
- * ===========================================
- */
-export declare const USAGE_EXAMPLES: {
-    readonly SIMPLE: {
-        readonly name: "Level 1: Simple Usage";
-        readonly description: "Just business logic props - everything else uses sensible defaults";
-        readonly code: "\n<QABot\n  apiKey=\"your-key\"\n  endpoints={{ qa: 'https://your-api.com/chat' }}\n/>";
-        readonly requiredProps: readonly ["apiKey", "endpoints"];
-        readonly optionalProps: readonly ["userEmail", "welcomeMessage"];
-    };
-    readonly COMPLEX: {
-        readonly name: "Level 2: Complex Usage";
-        readonly description: "Business logic props + full react-chatbotify settings control";
-        readonly code: "\n<QABot\n  apiKey=\"your-key\"\n  endpoints={{ qa: 'https://your-api.com/chat' }}\n  welcomeMessage=\"Custom welcome!\"\n  settings={{\n    general: { primaryColor: '#brand-color' },\n    header: { title: 'Support Bot' }\n  }}\n/>";
-        readonly props: readonly ["...businessProps", "settings", "plugins", "...reactChatbotifyProps"];
-    };
-    readonly WRAPPER: {
-        readonly name: "Level 3: Wrapper Pattern";
-        readonly description: "Create organizational bots with pre-configured defaults";
-        readonly code: "\nfunction MyOrgBot({ settings = {}, ...props }: WrapperProps) {\n  return (\n    <QABot\n      endpoints={{ qa: 'https://org.com/api' }}\n      settings={{\n        general: { primaryColor: '#org-blue' },\n        ...settings\n      }}\n      {...props}\n    />\n  );\n}";
-    };
-};
-/**
- * ===========================================
- * CUSTOM FLOWS EXAMPLES
- * ===========================================
- */
-export declare const FLOW_EXAMPLES: {
-    readonly description: "Examples of custom conversation flows";
-    readonly simple: "\nconst customFlows = {\n  start: {\n    message: \"How can I help you?\",\n    options: [\"Ask Question\", \"Create Ticket\"],\n    paths: [\"qa_loop\", \"ticket_flow\"]\n  },\n\n  ticket_flow: {\n    message: \"Please describe your issue:\",\n    function: async (params) => {\n      const ticket = await createTicket(params.userInput);\n      return `Ticket #${ticket.id} created!`;\n    }\n  }\n};";
-    readonly advanced: "\nconst advancedFlows = {\n  start: {\n    message: \"Welcome! What would you like to do?\",\n    options: [\"General Q&A\", \"Create Support Ticket\", \"Report Security Issue\"],\n    paths: [\"qa_loop\", \"ticket_flow\", \"security_flow\"]\n  },\n\n  security_flow: {\n    message: \"Security reports are taken seriously. Please describe the issue:\",\n    function: async (params) => {\n      await createSecurityReport({\n        description: params.userInput,\n        userEmail: params.userEmail,\n        timestamp: new Date(),\n        sessionId: params.sessionId\n      });\n      return \"Thank you for the security report. Our team has been notified.\";\n    }\n  }\n};";
-};
-/**
- * ===========================================
- * MIGRATION GUIDE
- * ===========================================
- */
-export declare const MIGRATION_FROM_CONFIG_SYSTEM: {
-    readonly description: "How to migrate from the old config-based system to the new prop-based system";
-    readonly mappings: {
-        readonly 'config.core.auth.apiKey': "apiKey prop";
-        readonly 'config.core.endpoints.qa': "endpoints.qa prop";
-        readonly 'config.core.endpoints.rating': "endpoints.rating prop";
-        readonly 'config.user.email': "userEmail prop";
-        readonly 'config.user.name': "userName prop";
-        readonly 'config.user.loginUrl': "loginUrl prop";
-        readonly 'config.flows.welcomeMessage': "welcomeMessage prop";
-        readonly 'config.flows.customFlows': "customFlows prop";
-        readonly 'config.general.*': "settings.general.*";
-        readonly 'config.header.*': "settings.header.*";
-        readonly 'config.chatInput.*': "settings.chatInput.*";
-    };
-    readonly before: "\n// Old config-based system\n<QABot\n  config={{\n    core: {\n      auth: { apiKey: 'key' },\n      endpoints: { qa: '/api' }\n    },\n    flows: { welcomeMessage: 'Hi!' },\n    general: { primaryColor: '#blue' }\n  }}\n  embedded={true}  // Prop override confusion\n/>";
-    readonly after: "\n// New prop-based system\n<QABot\n  apiKey=\"key\"\n  endpoints={{ qa: '/api' }}\n  welcomeMessage=\"Hi!\"\n  settings={{\n    general: {\n      primaryColor: '#blue',\n      embedded: true\n    }\n  }}\n/>";
-};

package/dist/types/config/defaults.d.ts

@@ -1,118 +0,0 @@
-/**
- * Default react-chatbotify settings for QA Bot Core
- *
- * These are sensible defaults that provide a good out-of-the-box experience.
- * Users can override any of these by passing their own settings object.
- */
-import React from 'react';
-import type { CustomFlows } from './types';
-export interface ReactChatbotifySettings {
-    general?: {
-        primaryColor?: string;
-        secondaryColor?: string;
-        fontFamily?: string;
-        embedded?: boolean;
-        showHeader?: boolean;
-        showFooter?: boolean;
-    };
-    device?: {
-        desktopEnabled?: boolean;
-        mobileEnabled?: boolean;
-        applyMobileOptimizations?: boolean;
-    };
-    chatHistory?: {
-        disabled?: boolean;
-    };
-    chatButton?: {
-        icon?: string;
-    };
-    audio?: {
-        disabled?: boolean;
-    };
-    emoji?: {
-        disabled?: boolean;
-    };
-    fileAttachment?: {
-        disabled?: boolean;
-    };
-    notification?: {
-        disabled?: boolean;
-    };
-    footer?: {
-        text?: React.ReactElement;
-        buttons?: React.ReactElement[];
-    };
-    event?: {
-        rcbToggleChatWindow?: boolean;
-    };
-    tooltip?: {
-        mode?: 'CLOSE' | 'ALWAYS' | 'NEVER';
-        text?: string;
-    };
-    header?: {
-        title?: string | React.ReactElement;
-        showAvatar?: boolean;
-        avatar?: string;
-        buttons?: any[];
-    };
-    chatInput?: {
-        disabled?: boolean;
-        enabledPlaceholderText?: string;
-        disabledPlaceholderText?: string;
-        characterLimit?: number;
-        showCharacterCount?: boolean;
-        allowNewline?: boolean;
-        sendButtonStyle?: any;
-        sendButtonAriaLabel?: string;
-        ariaLabel?: string;
-        ariaDescribedBy?: string;
-    };
-    chatWindow?: {
-        defaultOpen?: boolean;
-        showScrollbar?: boolean;
-    };
-    botBubble?: {
-        simulateStream?: boolean;
-        streamSpeed?: number;
-        showAvatar?: boolean;
-        allowNewline?: boolean;
-        dangerouslySetInnerHTML?: boolean;
-        renderHtml?: boolean;
-        ariaLabel?: string;
-        role?: string;
-    };
-    userBubble?: {
-        showAvatar?: boolean;
-    };
-}
-export declare const defaultReactChatbotifySettings: ReactChatbotifySettings;
-/**
- * Default welcome message for Q&A flows
- */
-export declare const defaultWelcomeMessage: string;
-/**
- * Default business configuration structure
- * Used internally for flow generation and business logic
- */
-export interface BusinessConfig {
-    core: {
-        endpoints: {
-            qa?: string;
-            rating?: string;
-        };
-        auth: {
-            apiKey?: string;
-        };
-    };
-    user: {
-        email?: string;
-        name?: string;
-        loginUrl?: string;
-    };
-    flows: {
-        welcomeMessage: string;
-        customFlows?: CustomFlows;
-    };
-}
-export type { FlowStep, FlowParams } from './types';
-export declare const defaultBusinessConfig: BusinessConfig;

package/dist/types/config/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * QA Bot Core - Configuration Exports
- *
- * Central export point for all configuration, types, and constants.
- * This replaces the old complex api-reference.js system.
- */
-export type { QABotProps, QABotBusinessProps, EndpointsConfig, BrandingConfig, MessagesConfig, ReactChatbotifyFlow, ReactChatbotifyPlugin, ReactChatbotifyStyles, SimpleUsageProps, ThemeColors, BotControllerHandle, TooltipMode, FlowPath } from './types';
-export type { ReactChatbotifySettings, BusinessConfig } from './defaults';
-export type { CustomFlows, FlowStep, FlowParams } from './types';
-export { defaultReactChatbotifySettings, defaultWelcomeMessage, defaultBusinessConfig } from './defaults';
-export { CONSTANTS } from './types';

package/dist/types/config/types.d.ts

@@ -1,150 +0,0 @@
-/**
- * QA Bot Core - TypeScript Type Definitions
- *
- * SINGLE SOURCE OF TRUTH for all TypeScript interfaces and types.
- * This replaces the old api-reference.js with proper type definitions.
- */
-export interface CustomFlows {
-    [stepName: string]: FlowStep;
-}
-export interface FlowStep {
-    message: string;
-    options?: string[];
-    path?: string | ((input: string) => string | Promise<string>);
-    paths?: string[];
-    function?: (params: FlowParams) => string | Promise<string>;
-}
-export interface FlowParams {
-    userInput: string;
-    sessionId: string;
-    injectMessage: (message: string) => void;
-}
-/**
- * ===========================================
- * SIMPLE CONFIGURATION (For out-of-the-box users)
- * ===========================================
- */
-export interface BrandingConfig {
-    /** Logo/avatar URL for the chatbot header */
-    logo?: string;
-    /** Primary color for buttons, highlights (e.g., "#007bff") */
-    primaryColor?: string;
-    /** Secondary color for hover states (e.g., "#0056b3") */
-    secondaryColor?: string;
-    /** Primary font family for the chat interface */
-    primaryFont?: string;
-    /** Secondary font family for special text (code, etc.) */
-    secondaryFont?: string;
-    /** Name displayed in the chat header */
-    botName?: string;
-}
-export interface MessagesConfig {
-    /** Initial greeting message from the bot */
-    welcome?: string;
-    /** Placeholder text in the input field */
-    placeholder?: string;
-    /** Error message when something goes wrong */
-    error?: string;
-    /** Message shown when chat is disabled */
-    disabled?: string;
-}
-/**
- * ===========================================
- * BUSINESS LOGIC PROPS (QA Bot Core Specific)
- * ===========================================
- */
-export interface EndpointsConfig {
-    /** Q&A endpoint URL (e.g., "https://your-api.com/chat") */
-    qa: string;
-    /** Optional rating/feedback endpoint URL */
-    rating?: string;
-}
-export interface QABotBusinessProps {
-    /** API key for authenticating with your Q&A service */
-    apiKey?: string;
-    /** API endpoints for Q&A and rating services */
-    endpoints?: EndpointsConfig;
-    /** URL to redirect users for login/authentication */
-    loginUrl?: string;
-    /** Initial greeting message from the bot */
-    welcomeMessage?: string;
-    /** Custom conversation flow definitions */
-    customFlows?: CustomFlows;
-    /** Simple branding configuration */
-    branding?: BrandingConfig;
-    /** Simple message customization */
-    messages?: MessagesConfig;
-}
-/**
- * ===========================================
- * REACT-CHATBOTIFY INTEGRATION
- * ===========================================
- */
-export interface ReactChatbotifyFlow {
-    [stepName: string]: any;
-}
-export type ReactChatbotifyPlugin = (...args: unknown[]) => {
-    name: string;
-    settings?: any;
-    styles?: any;
-};
-export interface ReactChatbotifyStyles {
-    [key: string]: any;
-}
-/**
- * ===========================================
- * COMPLETE QABOT PROPS
- * ===========================================
- */
-export interface QABotProps extends QABotBusinessProps {
-}
-/**
- * ===========================================
- * USAGE TYPES (SIMPLIFIED)
- * ===========================================
- */
-export interface SimpleUsageProps {
-    apiKey: string;
-    endpoints: EndpointsConfig;
-    welcomeMessage?: string;
-}
-/**
- * ===========================================
- * INTERNAL TYPES
- * ===========================================
- */
-export interface ThemeColors {
-    primaryColor?: string;
-    secondaryColor?: string;
-    fontFamily?: string;
-}
-export interface BotControllerHandle {
-    addMessage: (message: string) => void;
-    openChat: () => void;
-    closeChat: () => void;
-    toggleChat: () => void;
-    setBotEnabled: (enabled: boolean) => void;
-}
-/**
- * ===========================================
- * CONSTANTS & ENUMS
- * ===========================================
- */
-export declare const CONSTANTS: {
-    readonly DEFAULT_WELCOME_MESSAGE: "Hello! What can I help you with?";
-    readonly DEFAULT_PRIMARY_COLOR: "#1a5b6e";
-    readonly DEFAULT_SECONDARY_COLOR: "#107180";
-    readonly DEFAULT_FONT_FAMILY: "Arial, sans-serif";
-    readonly DEFAULT_AVATAR: "/default-chat-icon.svg";
-    readonly DEFAULT_CHARACTER_LIMIT: 1000;
-    readonly DEFAULT_STREAM_SPEED: 10;
-    readonly TOOLTIP_MODES: readonly ["CLOSE", "ALWAYS", "NEVER"];
-    readonly FLOW_PATHS: {
-        readonly QA_LOOP: "qa_loop";
-        readonly QA_START: "qa_start";
-        readonly RATING: "rating";
-        readonly START: "start";
-    };
-};
-export type TooltipMode = typeof CONSTANTS.TOOLTIP_MODES[number];
-export type FlowPath = typeof CONSTANTS.FLOW_PATHS[keyof typeof CONSTANTS.FLOW_PATHS];

package/dist/types/utils/create-bot-flow.d.ts

@@ -1,12 +0,0 @@
-import type { BusinessConfig, CustomFlows, ReactChatbotifyFlow } from '../config';
-interface CreateBotFlowParams {
-    config: BusinessConfig;
-    customFlows?: CustomFlows;
-    sessionId: string;
-}
-/**
- * Creates the bot conversation flow
- * Supports both basic Q&A and custom flows via plugins
- */
-export declare function createBotFlow({ config, customFlows, sessionId }: CreateBotFlowParams): ReactChatbotifyFlow;
-export {};

package/dist/types/utils/deep-merge.d.ts

@@ -1,10 +0,0 @@
-/**
- * Deep merge utility for nested configuration objects
- * Handles proper merging of nested objects while preserving arrays and other types
- */
-export declare function deepMerge(target: any, source: any): any;
-/**
- * Merge multiple objects with deep merging
- * Objects are merged left-to-right (later objects have higher priority)
- */
-export declare function deepMergeAll(...objects: any[]): any;

package/dist/types/utils/flow-merger.d.ts

@@ -1,14 +0,0 @@
-import type { Flow } from 'react-chatbotify';
-import type { CustomFlows } from '../config';
-/**
- * Merges custom flows with the base Q&A flow
- * Custom flows can:
- * - Override existing flow steps
- * - Add new flow paths
- * - Integrate with Q&A loop via 'qa_loop' path
- */
-export declare function mergeFlows(baseFlow: Flow, customFlows?: CustomFlows): Flow;
-/**
- * Creates a flow that integrates custom flows with Q&A
- */
-export declare function createIntegratedFlow(qaFlow: Flow, customFlows?: CustomFlows, welcomeMessage?: string): Flow;

package/dist/types/utils/validation-utils.d.ts

@@ -1,19 +0,0 @@
-/**
- * Email validation utility functions
- */
-/**
- * Validates email format using a comprehensive regex pattern
- */
-export declare const isValidEmail: (email: string) => boolean;
-interface ValidationResult {
-    success: boolean;
-    promptContent?: string;
-    promptDuration?: number;
-    promptType?: string;
-    highlightTextArea?: boolean;
-}
-/**
- * Creates email validation for chat bot flows
- */
-export declare const validateEmail: (email: string) => ValidationResult;
-export {};