@djangocfg/api 1.0.1

package/src/cfg/contexts/NewsletterContext.tsx

@@ -0,0 +1,244 @@
+/**
+ * Newsletter Context
+ * 
+ * Manages newsletter campaigns and subscriptions using generated SWR hooks
+ * 
+ * Features:
+ * - Campaign management (create, update, delete, send)
+ * - Subscription management (subscribe, unsubscribe)
+ * - Campaign lists with pagination
+ * - Subscription lists with pagination
+ */
+
+"use client";
+
+import { createContext, useContext, ReactNode } from 'react';
+import { SWRConfig, useSWRConfig } from 'swr';
+import { api } from '../BaseClient';
+import {
+  useNewsletterCampaignsList,
+  useNewsletterCampaignsRetrieve,
+  useCreateNewsletterCampaignsCreate,
+  useUpdateNewsletterCampaignsUpdate,
+  usePartialUpdateNewsletterCampaignsPartialUpdate,
+  useDeleteNewsletterCampaignsDestroy,
+  useCreateNewsletterCampaignsSendCreate,
+  useNewsletterSubscriptionsList,
+  useCreateNewsletterSubscribeCreate,
+  useCreateNewsletterUnsubscribeCreate,
+} from '../generated/_utils/hooks';
+import type { API } from '../generated';
+import type {
+  NewsletterCampaign,
+  NewsletterCampaignRequest,
+  PatchedNewsletterCampaignRequest,
+  NewsletterSubscription,
+  PaginatedNewsletterCampaignList,
+  PaginatedNewsletterSubscriptionList,
+  SubscribeRequest,
+  SubscribeResponse,
+  UnsubscribeRequest,
+  SuccessResponse,
+  SendCampaignRequest,
+  SendCampaignResponse,
+} from '../generated/_utils/schemas';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface NewsletterContextValue {
+  // Campaigns list state
+  campaigns: NewsletterCampaign[];
+  isLoadingCampaigns: boolean;
+  campaignsError: Error | null;
+  pagination?: {
+    count: number;
+    next: number | null;
+    previous: number | null;
+  };
+
+  // Campaign operations
+  getCampaign: (id: number) => { data?: NewsletterCampaign; error?: Error; isLoading: boolean };
+  createCampaign: (data: NewsletterCampaignRequest) => Promise<NewsletterCampaign>;
+  updateCampaign: (id: number, data: NewsletterCampaignRequest) => Promise<NewsletterCampaign>;
+  partialUpdateCampaign: (id: number, data: PatchedNewsletterCampaignRequest) => Promise<NewsletterCampaign>;
+  deleteCampaign: (id: number) => Promise<void>;
+  sendCampaign: (campaignId: number) => Promise<SendCampaignResponse>;
+
+  // Subscriptions list state
+  subscriptions: NewsletterSubscription[];
+  isLoadingSubscriptions: boolean;
+  subscriptionsError: Error | null;
+
+  // Subscription operations
+  subscribe: (data: SubscribeRequest) => Promise<SubscribeResponse>;
+  unsubscribe: (data: UnsubscribeRequest) => Promise<SuccessResponse>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const NewsletterContext = createContext<NewsletterContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider Props
+// ─────────────────────────────────────────────────────────────────────────
+
+interface NewsletterProviderProps {
+  children: ReactNode;
+  page?: number;
+  pageSize?: number;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider Component
+// ─────────────────────────────────────────────────────────────────────────
+
+export function NewsletterProvider({ 
+  children, 
+  page = 1, 
+  pageSize = 100 
+}: NewsletterProviderProps) {
+  const { mutate } = useSWRConfig();
+  
+  const swrConfig = {
+    revalidateOnFocus: false,
+    revalidateOnReconnect: false,
+    revalidateIfStale: false,
+  };
+
+  // List params for proper revalidation
+  const listParams = { page, page_size: pageSize };
+
+  // Campaigns list
+  const {
+    data: campaignsData,
+    error: campaignsError,
+    isLoading: isLoadingCampaigns,
+  } = useNewsletterCampaignsList(listParams, api as unknown as API);
+
+  // Subscriptions list
+  const {
+    data: subscriptionsData,
+    error: subscriptionsError,
+    isLoading: isLoadingSubscriptions,
+  } = useNewsletterSubscriptionsList(listParams, api as unknown as API);
+
+  // Mutation hooks
+  const createCampaignMutation = useCreateNewsletterCampaignsCreate();
+  const updateCampaignMutation = useUpdateNewsletterCampaignsUpdate();
+  const partialUpdateCampaignMutation = usePartialUpdateNewsletterCampaignsPartialUpdate();
+  const deleteCampaignMutation = useDeleteNewsletterCampaignsDestroy();
+  const sendCampaignMutation = useCreateNewsletterCampaignsSendCreate();
+  const subscribeMutation = useCreateNewsletterSubscribeCreate();
+  const unsubscribeMutation = useCreateNewsletterUnsubscribeCreate();
+
+  // Extract data from paginated responses
+  const campaigns = campaignsData?.results || [];
+  const subscriptions = subscriptionsData?.results || [];
+
+  // Get single campaign
+  const getCampaign = (id: number) => {
+    const { data, error, isLoading } = useNewsletterCampaignsRetrieve(id, api as unknown as API);
+    return { data, error, isLoading };
+  };
+
+  // Create campaign
+  const createCampaign = async (data: NewsletterCampaignRequest): Promise<NewsletterCampaign> => {
+    const result = await createCampaignMutation(data, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+    return result as NewsletterCampaign;
+  };
+
+  // Update campaign (full)
+  const updateCampaign = async (id: number, data: NewsletterCampaignRequest): Promise<NewsletterCampaign> => {
+    const result = await updateCampaignMutation(id, data, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+    await mutate(['cfg-newsletter-campaigns-retrieve', id]);
+    return result as NewsletterCampaign;
+  };
+
+  // Partial update campaign (currently not supported by generated API)
+  const partialUpdateCampaign = async (id: number, data: PatchedNewsletterCampaignRequest): Promise<NewsletterCampaign> => {
+    // TODO: Fix generator to include data parameter for PATCH requests
+    // const result = await partialUpdateCampaignMutation(id, data, api as unknown as API);
+    // For now, fallback to full update
+    const result = await updateCampaignMutation(id, data as NewsletterCampaignRequest, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+    await mutate(['cfg-newsletter-campaigns-retrieve', id]);
+    return result as NewsletterCampaign;
+  };
+
+  // Delete campaign
+  const deleteCampaign = async (id: number): Promise<void> => {
+    await deleteCampaignMutation(id, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+  };
+
+  // Send campaign
+  const sendCampaign = async (campaignId: number): Promise<SendCampaignResponse> => {
+    const result = await sendCampaignMutation({ campaign_id: campaignId }, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+    await mutate(['cfg-newsletter-campaigns-retrieve', campaignId]);
+    return result as SendCampaignResponse;
+  };
+
+  // Subscribe
+  const subscribe = async (data: SubscribeRequest): Promise<SubscribeResponse> => {
+    const result = await subscribeMutation(data, api as unknown as API);
+    await mutate(['cfg-newsletter-subscriptions-list', listParams]);
+    return result as SubscribeResponse;
+  };
+
+  // Unsubscribe
+  const unsubscribe = async (data: UnsubscribeRequest): Promise<SuccessResponse> => {
+    const result = await unsubscribeMutation(data, api as unknown as API);
+    await mutate(['cfg-newsletter-subscriptions-list', listParams]);
+    return result as SuccessResponse;
+  };
+
+  const value: NewsletterContextValue = {
+    campaigns,
+    isLoadingCampaigns,
+    campaignsError,
+    pagination: campaignsData ? {
+      count: campaignsData.count,
+      next: campaignsData.next_page ?? null,
+      previous: campaignsData.previous_page ?? null,
+    } : undefined,
+    getCampaign,
+    createCampaign,
+    updateCampaign,
+    partialUpdateCampaign,
+    deleteCampaign,
+    sendCampaign,
+    subscriptions,
+    isLoadingSubscriptions,
+    subscriptionsError,
+    subscribe,
+    unsubscribe,
+  };
+
+  return (
+    <SWRConfig value={swrConfig}>
+      <NewsletterContext.Provider value={value}>
+        {children}
+      </NewsletterContext.Provider>
+    </SWRConfig>
+  );
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useNewsletterContext(): NewsletterContextValue {
+  const context = useContext(NewsletterContext);
+  if (!context) {
+    throw new Error('useNewsletterContext must be used within NewsletterProvider');
+  }
+  return context;
+}
+

package/src/cfg/contexts/SupportContext.tsx

@@ -0,0 +1,256 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { api } from '../BaseClient';
+import {
+  useSupportTicketsList,
+  useSupportTicketsRetrieve,
+  useCreateSupportTicketsCreate,
+  useUpdateSupportTicketsUpdate,
+  usePartialUpdateSupportTicketsPartialUpdate,
+  useDeleteSupportTicketsDestroy,
+  useSupportTicketsMessagesList,
+  useSupportTicketsMessagesRetrieve,
+  useCreateSupportTicketsMessagesCreate,
+  useUpdateSupportTicketsMessagesUpdate,
+  usePartialUpdateSupportTicketsMessagesPartialUpdate,
+  useDeleteSupportTicketsMessagesDestroy,
+} from '../generated/_utils/hooks';
+import type { API } from '../generated';
+import type {
+  Ticket,
+  TicketRequest,
+  PatchedTicketRequest,
+  Message,
+  MessageRequest,
+  MessageCreateRequest,
+  PatchedMessageRequest,
+} from '../generated/_utils/schemas';
+
+// ─────────────────────────────────────────────────────────────────────────
+// 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
+  const {
+    data: ticketsData,
+    error: ticketsError,
+    isLoading: isLoadingTickets,
+    mutate: mutateTickets,
+  } = useSupportTicketsList(undefined, 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, undefined, 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/cfg/contexts/index.ts

@@ -0,0 +1,48 @@
+/**
+ * CFG API Contexts
+ * 
+ * Centralized React contexts for all CFG API modules
+ * Uses generated SWR hooks for optimal data fetching and caching
+ */
+
+// Accounts (Auth & Profile)
+export { 
+  AccountsProvider, 
+  useAccountsContext,
+  PatchedUserProfileUpdateRequestSchema
+} from './AccountsContext';
+export type { 
+  AccountsContextValue,
+  PatchedUserProfileUpdateRequest
+} from './AccountsContext';
+
+// Newsletter (Campaigns & Subscriptions)
+export { NewsletterProvider, useNewsletterContext } from './NewsletterContext';
+export type { NewsletterContextValue } from './NewsletterContext';
+
+// Leads (Lead Submissions)
+export { LeadsProvider, useLeadsContext } from './LeadsContext';
+export type { LeadsContextValue } 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';
+