@xcelsior/ui-chat 1.0.4 → 1.0.6

package/src/hooks/useChatWidgetState.ts

@@ -0,0 +1,68 @@
+import { useCallback, useState } from 'react';
+
+export type ChatWidgetState = 'open' | 'minimized' | 'closed' | 'undefined';
+
+export interface UseChatWidgetStateOptions {
+    /**
+     * Controlled state. When provided, the component is controlled.
+     */
+    state?: ChatWidgetState;
+    /**
+     * Default state for uncontrolled mode
+     * @default 'minimized'
+     */
+    defaultState?: ChatWidgetState;
+    /**
+     * Callback when state changes
+     */
+    onStateChange?: (state: ChatWidgetState) => void;
+}
+
+export interface UseChatWidgetStateReturn {
+    /**
+     * Current state of the widget
+     */
+    currentState: ChatWidgetState;
+    /**
+     * Function to update the state
+     */
+    setState: (newState: ChatWidgetState) => void;
+    /**
+     * Whether the state is controlled
+     */
+    isControlled: boolean;
+}
+
+/**
+ * Hook to manage chat widget state (controlled vs uncontrolled)
+ * Encapsulates the logic for handling both controlled and uncontrolled state patterns
+ */
+export function useChatWidgetState({
+    state: controlledState,
+    defaultState = 'minimized',
+    onStateChange,
+}: UseChatWidgetStateOptions): UseChatWidgetStateReturn {
+    // Handle controlled vs uncontrolled state
+    const [uncontrolledState, setUncontrolledState] = useState<ChatWidgetState>(defaultState);
+    const isControlled = controlledState !== undefined && controlledState !== 'undefined';
+    const currentState = isControlled ? controlledState : uncontrolledState;
+
+    // State setter that works for both controlled and uncontrolled modes
+    const setState = useCallback(
+        (newValue: ChatWidgetState) => {
+            // Update internal state if uncontrolled
+            if (!isControlled) {
+                setUncontrolledState(newValue);
+            }
+            // Always call the change handler if provided
+            onStateChange?.(newValue);
+        },
+        [isControlled, onStateChange]
+    );
+
+    return {
+        currentState,
+        setState,
+        isControlled,
+    };
+}

package/src/index.tsx

@@ -1,6 +1,6 @@
 // Main components
 export { ChatWidget } from './components/ChatWidget';
-import type { ChatWidgetProps } from './components/ChatWidget';
+export type { ChatWidgetProps } from './components/ChatWidget';
 export { Chat } from './components/Chat';
 
 // Individual components (for custom implementations)
@@ -16,6 +16,12 @@ export { useWebSocket } from './hooks/useWebSocket';
 export { useMessages } from './hooks/useMessages';
 export { useFileUpload } from './hooks/useFileUpload';
 export { useTypingIndicator } from './hooks/useTypingIndicator';
+export { useChatWidgetState } from './hooks/useChatWidgetState';
+export type {
+    ChatWidgetState,
+    UseChatWidgetStateOptions,
+    UseChatWidgetStateReturn,
+} from './hooks/useChatWidgetState';
 
 // Utilities
 export { fetchMessages } from './utils/api';
@@ -40,7 +46,7 @@ import type {
     ConversationChannel,
 } from './types';
 
-export {
+export type {
     IUser,
     IMessage,
     IConversation,
@@ -57,5 +63,4 @@ export {
     ConversationStatus,
     ConversationPriority,
     ConversationChannel,
-    ChatWidgetProps,
 };