@djangocfg/layouts 2.0.4 → 2.0.6

package/src/contexts/SupportContext.tsx

@@ -0,0 +1,256 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { api } from '@djangocfg/api';
+import {
+  useSupportTicketsList,
+  useSupportTicketsRetrieve,
+  useCreateSupportTicketsCreate,
+  useUpdateSupportTicketsUpdate,
+  usePartialUpdateSupportTicketsPartialUpdate,
+  useDeleteSupportTicketsDestroy,
+  useSupportTicketsMessagesList,
+  useSupportTicketsMessagesRetrieve,
+  useCreateSupportTicketsMessagesCreate,
+  useUpdateSupportTicketsMessagesUpdate,
+  usePartialUpdateSupportTicketsMessagesPartialUpdate,
+  useDeleteSupportTicketsMessagesDestroy,
+} from '@djangocfg/api';
+import type { API } from '@djangocfg/api';
+import type {
+  Ticket,
+  TicketRequest,
+  PatchedTicketRequest,
+  Message,
+  MessageRequest,
+  MessageCreateRequest,
+  PatchedMessageRequest,
+} from '@djangocfg/api';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface SupportContextValue {
+  // Tickets
+  tickets: Ticket[] | undefined;
+  isLoadingTickets: boolean;
+  ticketsError: Error | undefined;
+  refreshTickets: () => Promise<void>;
+
+  // Ticket operations
+  getTicket: (uuid: string) => Promise<Ticket | undefined>;
+  createTicket: (data: TicketRequest) => Promise<Ticket>;
+  updateTicket: (uuid: string, data: TicketRequest) => Promise<Ticket>;
+  partialUpdateTicket: (uuid: string, data: PatchedTicketRequest) => Promise<Ticket>;
+  deleteTicket: (uuid: string) => Promise<void>;
+
+  // Messages
+  getMessages: (ticketUuid: string) => Promise<Message[] | undefined>;
+  getMessage: (ticketUuid: string, messageUuid: string) => Promise<Message | undefined>;
+  createMessage: (ticketUuid: string, data: MessageCreateRequest) => Promise<Message>;
+  updateMessage: (ticketUuid: string, messageUuid: string, data: MessageRequest) => Promise<Message>;
+  partialUpdateMessage: (
+    ticketUuid: string,
+    messageUuid: string,
+    data: PatchedMessageRequest
+  ) => Promise<Message>;
+  deleteMessage: (ticketUuid: string, messageUuid: string) => Promise<void>;
+  refreshMessages: (ticketUuid: string) => Promise<void>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const SupportContext = createContext<SupportContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function SupportProvider({ children }: { children: ReactNode }) {
+  // List tickets (first page only for count)
+  const {
+    data: ticketsData,
+    error: ticketsError,
+    isLoading: isLoadingTickets,
+    mutate: mutateTickets,
+  } = useSupportTicketsList({ page: 1, page_size: 1 }, api as unknown as API);
+
+  const refreshTickets = async () => {
+    await mutateTickets();
+  };
+
+  // Ticket mutations
+  const createTicketMutation = useCreateSupportTicketsCreate();
+  const updateTicketMutation = useUpdateSupportTicketsUpdate();
+  const partialUpdateTicketMutation = usePartialUpdateSupportTicketsPartialUpdate();
+  const deleteTicketMutation = useDeleteSupportTicketsDestroy();
+
+  // Message mutations
+  const createMessageMutation = useCreateSupportTicketsMessagesCreate();
+  const updateMessageMutation = useUpdateSupportTicketsMessagesUpdate();
+  const partialUpdateMessageMutation = usePartialUpdateSupportTicketsMessagesPartialUpdate();
+  const deleteMessageMutation = useDeleteSupportTicketsMessagesDestroy();
+
+  // Get single ticket
+  const getTicket = async (uuid: string): Promise<Ticket | undefined> => {
+    const { data } = useSupportTicketsRetrieve(uuid, api as unknown as API);
+    return data;
+  };
+
+  // Create ticket
+  const createTicket = async (data: TicketRequest): Promise<Ticket> => {
+    const result = await createTicketMutation(data, api as unknown as API);
+    await refreshTickets();
+    return result as Ticket;
+  };
+
+  // Update ticket
+  const updateTicket = async (uuid: string, data: TicketRequest): Promise<Ticket> => {
+    const result = await updateTicketMutation(uuid, data, api as unknown as API);
+    await refreshTickets();
+    return result as Ticket;
+  };
+
+  // Partial update ticket (currently not supported by generated API)
+  const partialUpdateTicket = async (
+    uuid: string,
+    data: PatchedTicketRequest
+  ): Promise<Ticket> => {
+    // TODO: Fix generator to include data parameter for PATCH requests
+    // const result = await partialUpdateTicketMutation(uuid, data, api as unknown as API);
+    // For now, fallback to full update
+    const result = await updateTicketMutation(uuid, data as unknown as TicketRequest, api as unknown as API);
+    await refreshTickets();
+    return result as Ticket;
+  };
+
+  // Delete ticket
+  const deleteTicket = async (uuid: string): Promise<void> => {
+    await deleteTicketMutation(uuid, api as unknown as API);
+    await refreshTickets();
+  };
+
+  // Get messages for ticket
+  const getMessages = async (ticketUuid: string): Promise<Message[] | undefined> => {
+    const { data } = useSupportTicketsMessagesList(ticketUuid, { page: 1, page_size: 100 }, api as unknown as API);
+    return data?.results;
+  };
+
+  // Get single message
+  const getMessage = async (
+    ticketUuid: string,
+    messageUuid: string
+  ): Promise<Message | undefined> => {
+    const { data } = useSupportTicketsMessagesRetrieve(
+      ticketUuid,
+      messageUuid,
+      api as unknown as API
+    );
+    return data;
+  };
+
+  // Create message
+  const createMessage = async (
+    ticketUuid: string,
+    data: MessageCreateRequest
+  ): Promise<Message> => {
+    const result = await createMessageMutation(ticketUuid, data, api as unknown as API);
+    return result as Message;
+  };
+
+  // Update message
+  const updateMessage = async (
+    ticketUuid: string,
+    messageUuid: string,
+    data: MessageRequest
+  ): Promise<Message> => {
+    const result = await updateMessageMutation(
+      ticketUuid,
+      messageUuid,
+      data,
+      api as unknown as API
+    );
+    return result as Message;
+  };
+
+  // Partial update message (currently not supported by generated API)
+  const partialUpdateMessage = async (
+    ticketUuid: string,
+    messageUuid: string,
+    data: PatchedMessageRequest
+  ): Promise<Message> => {
+    // TODO: Fix generator to include data parameter for PATCH requests
+    // const result = await partialUpdateMessageMutation(ticketUuid, messageUuid, data, api as unknown as API);
+    // For now, fallback to full update
+    const result = await updateMessageMutation(
+      ticketUuid,
+      messageUuid,
+      data as MessageRequest,
+      api as unknown as API
+    );
+    return result as Message;
+  };
+
+  // Delete message
+  const deleteMessage = async (ticketUuid: string, messageUuid: string): Promise<void> => {
+    await deleteMessageMutation(ticketUuid, messageUuid, api as unknown as API);
+  };
+
+  // Refresh messages for specific ticket
+  const refreshMessages = async (ticketUuid: string): Promise<void> => {
+    // We'll use mutate from the hook, but we need to get it dynamically
+    // For now, we can just refresh tickets which will update everything
+    await refreshTickets();
+  };
+
+  const value: SupportContextValue = {
+    tickets: ticketsData?.results,
+    isLoadingTickets,
+    ticketsError,
+    refreshTickets,
+    getTicket,
+    createTicket,
+    updateTicket,
+    partialUpdateTicket,
+    deleteTicket,
+    getMessages,
+    getMessage,
+    createMessage,
+    updateMessage,
+    partialUpdateMessage,
+    deleteMessage,
+    refreshMessages,
+  };
+
+  return <SupportContext.Provider value={value}>{children}</SupportContext.Provider>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useSupportContext(): SupportContextValue {
+  const context = useContext(SupportContext);
+  if (!context) {
+    throw new Error('useSupportContext must be used within SupportProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types for external use
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  Ticket,
+  TicketRequest,
+  PatchedTicketRequest,
+  Message,
+  MessageRequest,
+  MessageCreateRequest,
+  PatchedMessageRequest,
+};
+

package/src/contexts/index.ts

@@ -0,0 +1,59 @@
+/**
+ * CFG API Contexts
+ * 
+ * Centralized React contexts for all CFG API modules
+ * Uses generated SWR hooks for optimal data fetching and caching
+ */
+
+'use client';
+
+// Newsletter (Campaigns & Subscriptions)
+export { NewsletterProvider, useNewsletterContext } from './NewsletterContext';
+export type {
+  NewsletterContextValue,
+  NewsletterCampaign,
+  NewsletterCampaignRequest,
+  PatchedNewsletterCampaignRequest,
+  NewsletterSubscription,
+  PaginatedNewsletterCampaignList,
+  PaginatedNewsletterSubscriptionList,
+  SubscribeRequest,
+  SubscribeResponse,
+  UnsubscribeRequest,
+  SuccessResponse,
+  SendCampaignRequest,
+  SendCampaignResponse,
+} from './NewsletterContext';
+
+// Leads (Lead Submissions)
+export { LeadsProvider, useLeadsContext } from './LeadsContext';
+export type {
+  LeadsContextValue,
+  LeadSubmission,
+  LeadSubmissionRequest,
+  PatchedLeadSubmissionRequest,
+  PaginatedLeadSubmissionList,
+} from './LeadsContext';
+
+// Support (Tickets & Messages)
+export { 
+  SupportProvider, 
+  useSupportContext 
+} from './SupportContext';
+export type { 
+  SupportContextValue,
+  Ticket,
+  TicketRequest,
+  PatchedTicketRequest,
+  Message,
+  MessageRequest,
+  MessageCreateRequest,
+  PatchedMessageRequest,
+} from './SupportContext';
+
+// Payments (Payments, Balances, Currencies, API Keys, Overview)
+export * from './payments';
+
+// Knowbase (Chat, Documents, Sessions)
+export * from './knowbase';
+

package/src/contexts/knowbase/ChatContext.tsx

@@ -0,0 +1,174 @@
+/**
+ * Knowbase Chat Context
+ * Context for RAG-powered chat functionality
+ */
+
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { api } from '@djangocfg/api';
+import {
+  useKnowbaseAdminChatList,
+  useKnowbaseAdminChatRetrieve,
+  useCreateKnowbaseAdminChatCreate,
+  useUpdateKnowbaseAdminChatUpdate,
+  usePartialUpdateKnowbaseAdminChatPartialUpdate,
+  useDeleteKnowbaseAdminChatDestroy,
+  useKnowbaseAdminChatHistoryRetrieve,
+  useCreateKnowbaseAdminChatQueryCreate,
+} from '@djangocfg/api';
+import type { API } from '@djangocfg/api';
+import type {
+  PaginatedChatResponseList,
+  ChatResponse,
+  ChatResponseRequest,
+  PatchedChatResponseRequest,
+  ChatHistory,
+  ChatQueryRequest,
+} from '@djangocfg/api';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface KnowbaseChatContextValue {
+  // Chat list
+  chats: PaginatedChatResponseList | undefined;
+  isLoadingChats: boolean;
+  chatsError: Error | undefined;
+  refreshChats: () => Promise<void>;
+
+  // Chat operations
+  getChat: (id: string) => Promise<ChatResponse | undefined>;
+  getChatHistory: (id: string) => Promise<ChatHistory | undefined>;
+  createChat: (data: ChatResponseRequest) => Promise<ChatResponse>;
+  updateChat: (id: string, data: ChatResponseRequest) => Promise<ChatResponse>;
+  partialUpdateChat: (id: string, data: PatchedChatResponseRequest) => Promise<ChatResponse>;
+  deleteChat: (id: string) => Promise<void>;
+
+  // RAG Query
+  sendQuery: (data: ChatQueryRequest) => Promise<ChatResponse>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const KnowbaseChatContext = createContext<KnowbaseChatContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function KnowbaseChatProvider({ children }: { children: ReactNode }) {
+  // List chats
+  const {
+    data: chats,
+    error: chatsError,
+    isLoading: isLoadingChats,
+    mutate: mutateChats,
+  } = useKnowbaseAdminChatList({}, api as unknown as API);
+
+  const refreshChats = async () => {
+    await mutateChats();
+  };
+
+  // Mutations
+  const createChatMutation = useCreateKnowbaseAdminChatCreate();
+  const updateChatMutation = useUpdateKnowbaseAdminChatUpdate();
+  const partialUpdateChatMutation = usePartialUpdateKnowbaseAdminChatPartialUpdate();
+  const deleteChatMutation = useDeleteKnowbaseAdminChatDestroy();
+  const sendQueryMutation = useCreateKnowbaseAdminChatQueryCreate();
+
+  // Get single chat
+  const getChat = async (id: string): Promise<ChatResponse | undefined> => {
+    const { data } = useKnowbaseAdminChatRetrieve(id, api as unknown as API);
+    return data;
+  };
+
+  // Get chat history
+  const getChatHistory = async (id: string): Promise<ChatHistory | undefined> => {
+    const { data } = useKnowbaseAdminChatHistoryRetrieve(id, api as unknown as API);
+    return data;
+  };
+
+  // Create chat
+  const createChat = async (data: ChatResponseRequest): Promise<ChatResponse> => {
+    const result = await createChatMutation(data, api as unknown as API);
+    await refreshChats();
+    return result as ChatResponse;
+  };
+
+  // Update chat
+  const updateChat = async (id: string, data: ChatResponseRequest): Promise<ChatResponse> => {
+    const result = await updateChatMutation(id, data, api as unknown as API);
+    await refreshChats();
+    return result as ChatResponse;
+  };
+
+  // Partial update chat
+  const partialUpdateChat = async (
+    id: string,
+    data: PatchedChatResponseRequest
+  ): Promise<ChatResponse> => {
+    const result = await partialUpdateChatMutation(id, data, api as unknown as API);
+    await refreshChats();
+    return result as ChatResponse;
+  };
+
+  // Delete chat
+  const deleteChat = async (id: string): Promise<void> => {
+    await deleteChatMutation(id, api as unknown as API);
+    await refreshChats();
+  };
+
+  // Send RAG query
+  const sendQuery = async (data: ChatQueryRequest): Promise<ChatResponse> => {
+    const result = await sendQueryMutation(data, api as unknown as API);
+    await refreshChats();
+    return result as ChatResponse;
+  };
+
+  const value: KnowbaseChatContextValue = {
+    chats,
+    isLoadingChats,
+    chatsError,
+    refreshChats,
+    getChat,
+    getChatHistory,
+    createChat,
+    updateChat,
+    partialUpdateChat,
+    deleteChat,
+    sendQuery,
+  };
+
+  return <KnowbaseChatContext.Provider value={value}>{children}</KnowbaseChatContext.Provider>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useKnowbaseChatContext(): KnowbaseChatContextValue {
+  const context = useContext(KnowbaseChatContext);
+  if (!context) {
+    throw new Error('useKnowbaseChatContext must be used within KnowbaseChatProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types for external use
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  ChatResponse,
+  ChatResponseRequest,
+  PatchedChatResponseRequest,
+  ChatHistory,
+  ChatQueryRequest,
+  ChatMessage,
+  ChatSource,
+} from '@djangocfg/api';
+