@djangocfg/ext-knowbase 1.0.0

package/src/contexts/knowbase/SessionsContext.tsx

@@ -0,0 +1,175 @@
+/**
+ * Knowbase Sessions Context
+ * Context for managing chat sessions
+ */
+
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+
+import { apiKnowbase } from '../../api';
+import {
+  useKnowbaseAdminSessionsList,
+  useKnowbaseAdminSessionsRetrieve,
+  useCreateKnowbaseAdminSessionsCreate,
+  useUpdateKnowbaseAdminSessionsUpdate,
+  usePartialUpdateKnowbaseAdminSessionsPartialUpdate,
+  useDeleteKnowbaseAdminSessionsDestroy,
+  useCreateKnowbaseAdminSessionsActivateCreate,
+  useCreateKnowbaseAdminSessionsArchiveCreate,
+} from '../../api/generated/ext_knowbase/_utils/hooks';
+import type {
+  PaginatedChatSessionList,
+  ChatSession,
+  ChatSessionCreateRequest,
+  ChatSessionRequest,
+  PatchedChatSessionRequest,
+} from './types';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface KnowbaseSessionsContextValue {
+  // Sessions list
+  sessions: PaginatedChatSessionList | undefined;
+  isLoadingSessions: boolean;
+  sessionsError: Error | undefined;
+  refreshSessions: () => Promise<void>;
+
+  // Session operations
+  getSession: (id: string) => Promise<ChatSession | undefined>;
+  createSession: (data: ChatSessionCreateRequest) => Promise<ChatSession>;
+  updateSession: (id: string, data: ChatSessionRequest) => Promise<ChatSession>;
+  partialUpdateSession: (id: string, data: PatchedChatSessionRequest) => Promise<ChatSession>;
+  deleteSession: (id: string) => Promise<void>;
+
+  // Session actions
+  activateSession: (id: string, data: ChatSessionRequest) => Promise<ChatSession>;
+  archiveSession: (id: string, data: ChatSessionRequest) => Promise<ChatSession>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const KnowbaseSessionsContext = createContext<KnowbaseSessionsContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function KnowbaseSessionsProvider({ children }: { children: ReactNode }) {
+  // List sessions (first page only for count)
+  const {
+    data: sessions,
+    error: sessionsError,
+    isLoading: isLoadingSessions,
+    mutate: mutateSessions,
+  } = useKnowbaseAdminSessionsList({ page: 1, page_size: 1 }, apiKnowbase);
+
+  const refreshSessions = async () => {
+    await mutateSessions();
+  };
+
+  // Mutations
+  const createSessionMutation = useCreateKnowbaseAdminSessionsCreate();
+  const updateSessionMutation = useUpdateKnowbaseAdminSessionsUpdate();
+  const partialUpdateSessionMutation = usePartialUpdateKnowbaseAdminSessionsPartialUpdate();
+  const deleteSessionMutation = useDeleteKnowbaseAdminSessionsDestroy();
+  const activateSessionMutation = useCreateKnowbaseAdminSessionsActivateCreate();
+  const archiveSessionMutation = useCreateKnowbaseAdminSessionsArchiveCreate();
+
+  // Get single session
+  const getSession = async (id: string): Promise<ChatSession | undefined> => {
+    const { data } = useKnowbaseAdminSessionsRetrieve(id, apiKnowbase);
+    return data;
+  };
+
+  // Create session
+  const createSession = async (data: ChatSessionCreateRequest): Promise<ChatSession> => {
+    const result = await createSessionMutation(data, apiKnowbase);
+    await refreshSessions();
+    return result as ChatSession;
+  };
+
+  // Update session
+  const updateSession = async (id: string, data: ChatSessionRequest): Promise<ChatSession> => {
+    const result = await updateSessionMutation(id, data, apiKnowbase);
+    await refreshSessions();
+    return result as ChatSession;
+  };
+
+  // Partial update session
+  const partialUpdateSession = async (
+    id: string,
+    data: PatchedChatSessionRequest
+  ): Promise<ChatSession> => {
+    const result = await partialUpdateSessionMutation(id, data, apiKnowbase);
+    await refreshSessions();
+    return result as ChatSession;
+  };
+
+  // Delete session
+  const deleteSession = async (id: string): Promise<void> => {
+    await deleteSessionMutation(id, apiKnowbase);
+    await refreshSessions();
+  };
+
+  // Activate session
+  const activateSession = async (id: string, data: ChatSessionRequest): Promise<ChatSession> => {
+    const result = await activateSessionMutation(id, data, apiKnowbase);
+    await refreshSessions();
+    return result as ChatSession;
+  };
+
+  // Archive session
+  const archiveSession = async (id: string, data: ChatSessionRequest): Promise<ChatSession> => {
+    const result = await archiveSessionMutation(id, data, apiKnowbase);
+    await refreshSessions();
+    return result as ChatSession;
+  };
+
+  const value: KnowbaseSessionsContextValue = {
+    sessions,
+    isLoadingSessions,
+    sessionsError,
+    refreshSessions,
+    getSession,
+    createSession,
+    updateSession,
+    partialUpdateSession,
+    deleteSession,
+    activateSession,
+    archiveSession,
+  };
+
+  return (
+    <KnowbaseSessionsContext.Provider value={value}>{children}</KnowbaseSessionsContext.Provider>
+  );
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useKnowbaseSessionsContext(): KnowbaseSessionsContextValue {
+  const context = useContext(KnowbaseSessionsContext);
+  if (!context) {
+    throw new Error('useKnowbaseSessionsContext must be used within KnowbaseSessionsProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types for external use
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  PaginatedChatSessionList,
+  ChatSession,
+  ChatSessionCreateRequest,
+  ChatSessionRequest,
+  PatchedChatSessionRequest,
+} from './types';
+

package/src/contexts/knowbase/index.ts

@@ -0,0 +1,63 @@
+/**
+ * Knowbase Contexts
+ *
+ * Contexts for knowledge base functionality:
+ * - ChatContext: RAG-powered chat
+ * - DocumentsContext: Documents and archives management
+ * - SessionsContext: Chat sessions management
+ */
+
+'use client';
+
+// Main Provider
+export { KnowbaseProvider } from './KnowbaseProvider';
+
+// Chat Context
+export {
+  KnowbaseChatProvider,
+  useKnowbaseChatContext,
+} from './ChatContext';
+export type {
+  KnowbaseChatContextValue,
+  PaginatedChatResponseList,
+  ChatResponse,
+  ChatResponseRequest,
+  PatchedChatResponseRequest,
+  ChatHistory,
+  ChatQueryRequest,
+} from './ChatContext';
+
+// Documents Context
+export {
+  KnowbaseDocumentsProvider,
+  useKnowbaseDocumentsContext,
+} from './DocumentsContext';
+export type {
+  KnowbaseDocumentsContextValue,
+  Document,
+  DocumentCreateRequest,
+  DocumentRequest,
+  PatchedDocumentRequest,
+  DocumentProcessingStatus,
+  DocumentStats,
+  DocumentArchive,
+  DocumentArchiveDetail,
+  PatchedDocumentArchiveRequest,
+  ArchiveProcessingResult,
+  ArchiveStatistics,
+} from './DocumentsContext';
+
+// Sessions Context
+export {
+  KnowbaseSessionsProvider,
+  useKnowbaseSessionsContext,
+} from './SessionsContext';
+export type {
+  KnowbaseSessionsContextValue,
+  ChatSession,
+  ChatSessionCreateRequest,
+  ChatSessionRequest,
+  PatchedChatSessionRequest,
+} from './SessionsContext';
+
+

package/src/contexts/knowbase/types.ts

@@ -0,0 +1,69 @@
+/**
+ * Knowbase Types
+ * Centralized type definitions for knowbase contexts
+ */
+
+import type {
+  useKnowbaseAdminChatList,
+  useKnowbaseAdminChatRetrieve,
+  useCreateKnowbaseAdminChatCreate,
+  usePartialUpdateKnowbaseAdminChatPartialUpdate,
+  useKnowbaseAdminChatHistoryRetrieve,
+  useCreateKnowbaseAdminChatQueryCreate,
+  useKnowbaseAdminDocumentsList,
+  useKnowbaseAdminDocumentsRetrieve,
+  useCreateKnowbaseAdminDocumentsCreate,
+  useUpdateKnowbaseAdminDocumentsUpdate,
+  usePartialUpdateKnowbaseAdminDocumentsPartialUpdate,
+  useKnowbaseAdminDocumentsStatusRetrieve,
+  useKnowbaseAdminDocumentsStatsRetrieve,
+  useKnowbaseSystemArchivesList,
+  useKnowbaseSystemArchivesRetrieve,
+  useCreateKnowbaseSystemArchivesCreate,
+  usePartialUpdateKnowbaseSystemArchivesPartialUpdate,
+  useKnowbaseSystemArchivesStatisticsRetrieve,
+  useKnowbaseAdminSessionsList,
+  useKnowbaseAdminSessionsRetrieve,
+  useCreateKnowbaseAdminSessionsCreate,
+  useUpdateKnowbaseAdminSessionsUpdate,
+  usePartialUpdateKnowbaseAdminSessionsPartialUpdate,
+} from '../../api/generated/ext_knowbase/_utils/hooks';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Chat Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type PaginatedChatResponseList = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminChatList>>['data']>;
+export type ChatResponse = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminChatRetrieve>>['data']>;
+export type ChatResponseRequest = Parameters<ReturnType<typeof useCreateKnowbaseAdminChatCreate>>[0];
+export type PatchedChatResponseRequest = Parameters<ReturnType<typeof usePartialUpdateKnowbaseAdminChatPartialUpdate>>[1];
+export type ChatHistory = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminChatHistoryRetrieve>>['data']>;
+export type ChatQueryRequest = Parameters<ReturnType<typeof useCreateKnowbaseAdminChatQueryCreate>>[0];
+
+// ─────────────────────────────────────────────────────────────────────────
+// Documents Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type PaginatedDocumentList = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminDocumentsList>>['data']>;
+export type Document = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminDocumentsRetrieve>>['data']>;
+export type DocumentCreateRequest = Parameters<ReturnType<typeof useCreateKnowbaseAdminDocumentsCreate>>[0];
+export type DocumentRequest = Parameters<ReturnType<typeof useUpdateKnowbaseAdminDocumentsUpdate>>[1];
+export type PatchedDocumentRequest = Parameters<ReturnType<typeof usePartialUpdateKnowbaseAdminDocumentsPartialUpdate>>[1];
+export type DocumentProcessingStatus = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminDocumentsStatusRetrieve>>['data']>;
+export type DocumentStats = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminDocumentsStatsRetrieve>>['data']>;
+export type PaginatedDocumentArchiveListList = NonNullable<Awaited<ReturnType<typeof useKnowbaseSystemArchivesList>>['data']>;
+export type DocumentArchive = NonNullable<Awaited<ReturnType<typeof useKnowbaseSystemArchivesRetrieve>>['data']>;
+export type DocumentArchiveDetail = NonNullable<Awaited<ReturnType<typeof useKnowbaseSystemArchivesRetrieve>>['data']>;
+export type PatchedDocumentArchiveRequest = Parameters<ReturnType<typeof usePartialUpdateKnowbaseSystemArchivesPartialUpdate>>[1];
+export type ArchiveProcessingResult = Awaited<ReturnType<ReturnType<typeof useCreateKnowbaseSystemArchivesCreate>>>;
+export type ArchiveStatistics = NonNullable<Awaited<ReturnType<typeof useKnowbaseSystemArchivesStatisticsRetrieve>>['data']>;
+
+// ─────────────────────────────────────────────────────────────────────────
+// Sessions Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type PaginatedChatSessionList = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminSessionsList>>['data']>;
+export type ChatSession = NonNullable<Awaited<ReturnType<typeof useKnowbaseAdminSessionsRetrieve>>['data']>;
+export type ChatSessionCreateRequest = Parameters<ReturnType<typeof useCreateKnowbaseAdminSessionsCreate>>[0];
+export type ChatSessionRequest = Parameters<ReturnType<typeof useUpdateKnowbaseAdminSessionsUpdate>>[1];
+export type PatchedChatSessionRequest = Parameters<ReturnType<typeof usePartialUpdateKnowbaseAdminSessionsPartialUpdate>>[1];

package/src/hooks/index.ts

@@ -0,0 +1,28 @@
+'use client';
+
+/**
+ * @djangocfg/ext-knowbase/hooks
+ *
+ * React hooks for knowbase extension.
+ * Use this entry point in client components.
+ */
+
+// Re-export everything from main entry (server-safe code)
+export * from '../index';
+
+// SWR hooks from generated API
+export * from '../api/generated/ext_knowbase/_utils/hooks';
+
+// Knowbase context providers and hooks
+export {
+  KnowbaseChatProvider,
+  useKnowbaseChatContext,
+  KnowbaseDocumentsProvider,
+  useKnowbaseDocumentsContext,
+  KnowbaseSessionsProvider,
+  useKnowbaseSessionsContext,
+} from '../contexts/knowbase';
+
+// Chat components
+export { KnowledgeChat, ChatWidget, ChatUIProvider, useChatUI, MessageList, MessageInput, SessionList } from '../components/Chat';
+export { default as Chat } from '../components/Chat';

package/src/index.ts

@@ -0,0 +1,22 @@
+/**
+ * @djangocfg/ext-knowbase
+ *
+ * Server-safe entry point.
+ * Use this in server components and API routes.
+ */
+
+// Export generated API types and client
+export * from './api/generated/ext_knowbase';
+export { API } from './api/generated/ext_knowbase';
+export { apiKnowbase } from './api';
+
+// Export component types (server-safe)
+// Only export types that are NOT already in the generated API
+export type {
+  ChatMessageWithSources,
+  ChatWidgetProps,
+  ChatUIState,
+  MessageListProps,
+  MessageInputProps,
+  SessionListProps,
+} from './components/Chat/types';

package/src/utils/logger.ts

@@ -0,0 +1,10 @@
+import { createConsola } from 'consola';
+
+const isDevelopment = process.env.NODE_ENV === 'development';
+
+export const logger = createConsola({
+  level: isDevelopment ? 4 : 1,
+}).withTag('ext-knowbase');
+
+export const knowbaseLogger = logger;
+export const chatLogger = logger;