@elqnt/chat 3.0.2 → 3.0.3

package/dist/hooks/index.d.ts

@@ -1,5 +1,8 @@
-import { ChatEvent, Chat, ChatMessage } from '../models/index.js';
+export { UseAsyncOptions, UseAsyncReturn, useApiAsync } from '@elqnt/api-client/hooks';
+import { ChatEvent, Chat, ChatMessage, ChatSummary } from '../models/index.js';
 import { C as ChatTransport, e as TransportError, g as TransportState, R as RetryConfig, b as ConnectionMetrics, U as Unsubscribe } from '../types-7UNI1iYv.js';
+import { ApiClientOptions } from '@elqnt/api-client';
+import { Queue, AgentSession } from '../api/index.js';
 import '@elqnt/kg';
 import '@elqnt/types';
 import '@elqnt/docs';
@@ -79,4 +82,98 @@ interface UseChatReturn {
  */
 declare function useChat(options: UseChatOptions): UseChatReturn;
 
-export { type UseChatOptions, type UseChatReturn, useChat };
+type UseChatHistoryOptions = ApiClientOptions;
+interface ChatHistoryResult {
+    chats: ChatSummary[];
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Hook for chat history CRUD operations
+ *
+ * @example
+ * ```tsx
+ * const { loading, error, getChatHistory, deleteChat } = useChatHistory({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * const { chats, total, hasMore } = await getChatHistory({ limit: 20 });
+ * await deleteChat(chatKey);
+ * ```
+ */
+declare function useChatHistory(options: UseChatHistoryOptions): {
+    loading: boolean;
+    error: string | null;
+    getChatHistory: (params?: {
+        limit?: number;
+        offset?: number;
+        skipCache?: boolean;
+    } | undefined) => Promise<{
+        chats: ChatSummary[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    getChat: (chatKey: string) => Promise<ChatSummary | null>;
+    updateChat: (chatKey: string, updates: {
+        title?: string;
+        pinned?: boolean;
+    }) => Promise<boolean>;
+    deleteChat: (chatKey: string) => Promise<boolean>;
+    getChatsByUser: (userEmail: string) => Promise<ChatSummary[]>;
+};
+
+type UseChatMonitoringOptions = ApiClientOptions;
+/**
+ * Hook for monitoring active/waiting chats and queues
+ *
+ * @example
+ * ```tsx
+ * const { loading, error, getActiveChats, getWaitingChatsCount } = useChatMonitoring({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * const activeChats = await getActiveChats(24); // last 24 hours
+ * const waitingCount = await getWaitingChatsCount();
+ * ```
+ */
+declare function useChatMonitoring(options: UseChatMonitoringOptions): {
+    loading: boolean;
+    error: string | null;
+    getActiveChats: (pastHours?: number | undefined) => Promise<ChatSummary[]>;
+    getActiveChatsCount: () => Promise<number>;
+    getWaitingChatsCount: () => Promise<number>;
+    listQueues: () => Promise<Queue[]>;
+};
+
+type UseHumanAgentSessionsOptions = ApiClientOptions;
+/**
+ * Hook for human agent session management
+ *
+ * @example
+ * ```tsx
+ * const { loading, error, getOnlineSessions, getAgentSession } = useHumanAgentSessions({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * const sessions = await getOnlineSessions();
+ * const session = await getAgentSession(agentId);
+ * ```
+ */
+declare function useHumanAgentSessions(options: UseHumanAgentSessionsOptions): {
+    loading: boolean;
+    error: string | null;
+    getOnlineSessions: () => Promise<AgentSession[]>;
+    getAgentSession: (agentId: string) => Promise<AgentSession | null>;
+};
+
+/**
+ * Creates a ref that stays synchronized with the provided options.
+ * Useful for accessing current options values in callbacks without
+ * causing re-renders or stale closure issues.
+ */
+declare function useOptionsRef<T>(options: T): React.MutableRefObject<T>;
+
+export { type ChatHistoryResult, type UseChatHistoryOptions, type UseChatMonitoringOptions, type UseChatOptions, type UseChatReturn, type UseHumanAgentSessionsOptions, useChat, useChatHistory, useChatMonitoring, useHumanAgentSessions, useOptionsRef };