@djangocfg/api 1.0.1

package/src/cfg/contexts/knowbase/index.ts

@@ -0,0 +1,58 @@
+/**
+ * Knowbase Contexts
+ * 
+ * Contexts for knowledge base functionality:
+ * - ChatContext: RAG-powered chat
+ * - DocumentsContext: Documents and archives management
+ * - SessionsContext: Chat sessions management
+ */
+
+// Chat Context
+export {
+  KnowbaseChatProvider,
+  useKnowbaseChatContext,
+} from './ChatContext';
+export type {
+  KnowbaseChatContextValue,
+  ChatResponse,
+  ChatResponseRequest,
+  PatchedChatResponseRequest,
+  ChatHistory,
+  ChatQueryRequest,
+  ChatMessage,
+  ChatSource,
+} 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/cfg/contexts/payments/ApiKeysContext.tsx

@@ -0,0 +1,115 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { api } from '../../BaseClient';
+import {
+  usePaymentsApiKeysList,
+  usePaymentsApiKeysRetrieve,
+  useCreatePaymentsApiKeysCreate,
+  useDeletePaymentsApiKeysDestroy,
+} from '../../generated/_utils/hooks';
+import type { API } from '../../generated';
+import type {
+  APIKeyDetail,
+  APIKeyCreateRequest,
+  PaginatedAPIKeyListList,
+} from '../../generated/_utils/schemas';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface ApiKeysContextValue {
+  // List
+  apiKeys: PaginatedAPIKeyListList | undefined;
+  isLoadingApiKeys: boolean;
+  apiKeysError: Error | undefined;
+  refreshApiKeys: () => Promise<void>;
+
+  // Operations
+  getApiKey: (id: string) => Promise<APIKeyDetail | undefined>;
+  createApiKey: (data: APIKeyCreateRequest) => Promise<APIKeyDetail>;
+  deleteApiKey: (id: string) => Promise<void>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const ApiKeysContext = createContext<ApiKeysContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function ApiKeysProvider({ children }: { children: ReactNode }) {
+  // List API keys
+  const {
+    data: apiKeys,
+    error: apiKeysError,
+    isLoading: isLoadingApiKeys,
+    mutate: mutateApiKeys,
+  } = usePaymentsApiKeysList({}, api as unknown as API);
+
+  const refreshApiKeys = async () => {
+    await mutateApiKeys();
+  };
+
+  // Mutations
+  const createApiKeyMutation = useCreatePaymentsApiKeysCreate();
+  const deleteApiKeyMutation = useDeletePaymentsApiKeysDestroy();
+
+  // Get API key
+  const getApiKey = async (id: string): Promise<APIKeyDetail | undefined> => {
+    const { data } = usePaymentsApiKeysRetrieve(id, api as unknown as API);
+    return data;
+  };
+
+  // Create API key
+  const createApiKey = async (data: APIKeyCreateRequest): Promise<APIKeyDetail> => {
+    const result = await createApiKeyMutation(data, api as unknown as API);
+    await refreshApiKeys();
+    return result as APIKeyDetail;
+  };
+
+  // Delete API key
+  const deleteApiKey = async (id: string): Promise<void> => {
+    await deleteApiKeyMutation(id, api as unknown as API);
+    await refreshApiKeys();
+  };
+
+  const value: ApiKeysContextValue = {
+    apiKeys,
+    isLoadingApiKeys,
+    apiKeysError,
+    refreshApiKeys,
+    getApiKey,
+    createApiKey,
+    deleteApiKey,
+  };
+
+  return <ApiKeysContext.Provider value={value}>{children}</ApiKeysContext.Provider>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useApiKeysContext(): ApiKeysContextValue {
+  const context = useContext(ApiKeysContext);
+  if (!context) {
+    throw new Error('useApiKeysContext must be used within ApiKeysProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  APIKeyDetail,
+  APIKeyCreateRequest,
+  PaginatedAPIKeyListList,
+};
+

package/src/cfg/contexts/payments/BalancesContext.tsx

@@ -0,0 +1,118 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { api } from '../../BaseClient';
+import {
+  usePaymentsBalancesList,
+  usePaymentsBalancesSummaryRetrieve,
+} from '../../generated/_utils/hooks';
+import { getPaymentsBalancesRetrieve } from '../../generated/_utils/fetchers';
+import { defaultLogger } from '../../generated/logger';
+import type { API } from '../../generated';
+import type {
+  UserBalance,
+  PaginatedUserBalanceList,
+} from '../../generated/_utils/schemas';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface BalancesContextValue {
+  // List
+  balances: PaginatedUserBalanceList | undefined;
+  isLoadingBalances: boolean;
+  balancesError: Error | undefined;
+  refreshBalances: () => Promise<void>;
+
+  // Summary
+  balanceSummary: UserBalance | undefined;
+  isLoadingSummary: boolean;
+  summaryError: Error | undefined;
+  refreshSummary: () => Promise<void>;
+
+  // Retrieve balance by ID mutation
+  retrieveBalance: (id: number) => Promise<UserBalance | undefined>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const BalancesContext = createContext<BalancesContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function BalancesProvider({ children }: { children: ReactNode }) {
+  // List balances
+  const {
+    data: balances,
+    error: balancesError,
+    isLoading: isLoadingBalances,
+    mutate: mutateBalances,
+  } = usePaymentsBalancesList({}, api as unknown as API);
+
+  // Balance summary
+  const {
+    data: balanceSummary,
+    error: summaryError,
+    isLoading: isLoadingSummary,
+    mutate: mutateSummary,
+  } = usePaymentsBalancesSummaryRetrieve(api as unknown as API);
+
+  const refreshBalances = async () => {
+    await mutateBalances();
+  };
+
+  const refreshSummary = async () => {
+    await mutateSummary();
+  };
+
+  // Retrieve balance by ID
+  const retrieveBalance = async (id: number): Promise<UserBalance | undefined> => {
+    try {
+      const result = await getPaymentsBalancesRetrieve(id, api as unknown as API);
+      return result;
+    } catch (error) {
+      defaultLogger.error('Failed to retrieve balance:', error);
+      return undefined;
+    }
+  };
+
+  const value: BalancesContextValue = {
+    balances,
+    isLoadingBalances,
+    balancesError,
+    refreshBalances,
+    balanceSummary,
+    isLoadingSummary,
+    summaryError,
+    refreshSummary,
+    retrieveBalance,
+  };
+
+  return <BalancesContext.Provider value={value}>{children}</BalancesContext.Provider>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useBalancesContext(): BalancesContextValue {
+  const context = useContext(BalancesContext);
+  if (!context) {
+    throw new Error('useBalancesContext must be used within BalancesProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  UserBalance,
+  PaginatedUserBalanceList,
+};

package/src/cfg/contexts/payments/CurrenciesContext.tsx

@@ -0,0 +1,105 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { api } from '../../BaseClient';
+import {
+  usePaymentsCurrenciesList,
+  usePaymentsCurrenciesRetrieve,
+  usePaymentsCurrenciesRatesRetrieve,
+} from '../../generated/_utils/hooks';
+import type { API } from '../../generated';
+import type {
+  Currency,
+  PaginatedCurrencyListList,
+} from '../../generated/_utils/schemas';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface CurrenciesContextValue {
+  // List
+  currencies: PaginatedCurrencyListList | undefined;
+  isLoadingCurrencies: boolean;
+  currenciesError: Error | undefined;
+  refreshCurrencies: () => Promise<void>;
+
+  // Operations
+  getCurrency: (id: number) => Promise<Currency | undefined>;
+  getCurrencyRates: (baseCurrency: string, currencies: string) => Promise<Currency | undefined>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const CurrenciesContext = createContext<CurrenciesContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function CurrenciesProvider({ children }: { children: ReactNode }) {
+  // List currencies
+  const {
+    data: currencies,
+    error: currenciesError,
+    isLoading: isLoadingCurrencies,
+    mutate: mutateCurrencies,
+  } = usePaymentsCurrenciesList({}, api as unknown as API);
+
+  const refreshCurrencies = async () => {
+    await mutateCurrencies();
+  };
+
+  // Get currency
+  const getCurrency = async (id: number): Promise<Currency | undefined> => {
+    const { data } = usePaymentsCurrenciesRetrieve(id, api as unknown as API);
+    return data;
+  };
+
+  // Get currency rates
+  const getCurrencyRates = async (
+    baseCurrency: string,
+    currencies: string
+  ): Promise<Currency | undefined> => {
+    const { data } = usePaymentsCurrenciesRatesRetrieve(
+      { base_currency: baseCurrency, currencies },
+      api as unknown as API
+    );
+    return data;
+  };
+
+  const value: CurrenciesContextValue = {
+    currencies,
+    isLoadingCurrencies,
+    currenciesError,
+    refreshCurrencies,
+    getCurrency,
+    getCurrencyRates,
+  };
+
+  return <CurrenciesContext.Provider value={value}>{children}</CurrenciesContext.Provider>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useCurrenciesContext(): CurrenciesContextValue {
+  const context = useContext(CurrenciesContext);
+  if (!context) {
+    throw new Error('useCurrenciesContext must be used within CurrenciesProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  Currency,
+  PaginatedCurrencyListList,
+};
+

package/src/cfg/contexts/payments/OverviewContext.tsx

@@ -0,0 +1,141 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { SWRConfig } from 'swr';
+import { api } from '../../BaseClient';
+import {
+  usePaymentsOverviewDashboardOverviewRetrieve,
+  usePaymentsOverviewDashboardMetricsRetrieve,
+  usePaymentsOverviewDashboardBalanceOverviewRetrieve,
+  usePaymentsOverviewDashboardApiKeysOverviewRetrieve,
+  usePaymentsOverviewDashboardChartDataRetrieve,
+  usePaymentsOverviewDashboardRecentPaymentsList,
+  usePaymentsOverviewDashboardRecentTransactionsList,
+  usePaymentsOverviewDashboardSubscriptionOverviewRetrieve,
+} from '../../generated/_utils/hooks';
+import type { API } from '../../generated';
+import type {
+  PaymentsDashboardOverview,
+  PaymentsMetrics,
+  BalanceOverview,
+  APIKeysOverview,
+  PaymentsChartResponse,
+  PaginatedRecentPaymentList,
+  PaginatedRecentTransactionList,
+  SubscriptionOverview,
+} from '../../generated/_utils/schemas';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface OverviewContextValue {
+  // Dashboard data
+  overview: PaymentsDashboardOverview | undefined;
+  metrics: PaymentsMetrics | undefined;
+  balanceOverview: BalanceOverview | undefined;
+  apiKeysOverview: APIKeysOverview | undefined;
+  subscriptionOverview: SubscriptionOverview | undefined;
+  chartData: PaymentsChartResponse | undefined;
+  recentPayments: PaginatedRecentPaymentList | undefined;
+  recentTransactions: PaginatedRecentTransactionList | undefined;
+
+  // Loading states
+  isLoadingOverview: boolean;
+  overviewError: Error | undefined;
+
+  // Operations
+  refreshOverview: () => Promise<void>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const OverviewContext = createContext<OverviewContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function OverviewProvider({ children }: { children: ReactNode }) {
+  // SWR config for overview data - disable auto-revalidation
+  const swrConfig = {
+    revalidateOnFocus: false,
+    revalidateOnReconnect: false,
+    revalidateIfStale: false,
+  };
+
+  // Dashboard overview
+  const { data: overview, error: overviewError, isLoading: isLoadingOverview1, mutate: mutateOverview } = usePaymentsOverviewDashboardOverviewRetrieve(api as unknown as API);
+  const { data: metrics, mutate: mutateMetrics } = usePaymentsOverviewDashboardMetricsRetrieve(api as unknown as API);
+  const { data: balanceOverview, mutate: mutateBalanceOverview } = usePaymentsOverviewDashboardBalanceOverviewRetrieve(api as unknown as API);
+  const { data: apiKeysOverview, mutate: mutateApiKeysOverview } = usePaymentsOverviewDashboardApiKeysOverviewRetrieve(api as unknown as API);
+  const { data: subscriptionOverview, mutate: mutateSubscriptionOverview } = usePaymentsOverviewDashboardSubscriptionOverviewRetrieve(api as unknown as API);
+  const { data: chartData, mutate: mutateChartData } = usePaymentsOverviewDashboardChartDataRetrieve({}, api as unknown as API);
+  const { data: recentPayments, mutate: mutateRecentPayments } = usePaymentsOverviewDashboardRecentPaymentsList({}, api as unknown as API);
+  const { data: recentTransactions, mutate: mutateRecentTransactions } = usePaymentsOverviewDashboardRecentTransactionsList({}, api as unknown as API);
+
+  const isLoadingOverview = isLoadingOverview1;
+
+  const refreshOverview = async () => {
+    await Promise.all([
+      mutateOverview(),
+      mutateMetrics(),
+      mutateBalanceOverview(),
+      mutateApiKeysOverview(),
+      mutateSubscriptionOverview(),
+      mutateChartData(),
+      mutateRecentPayments(),
+      mutateRecentTransactions(),
+    ]);
+  };
+
+  const value: OverviewContextValue = {
+    overview,
+    metrics,
+    balanceOverview,
+    apiKeysOverview,
+    subscriptionOverview,
+    chartData,
+    recentPayments,
+    recentTransactions,
+    isLoadingOverview,
+    overviewError,
+    refreshOverview,
+  };
+
+  return (
+    <SWRConfig value={swrConfig}>
+      <OverviewContext.Provider value={value}>{children}</OverviewContext.Provider>
+    </SWRConfig>
+  );
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useOverviewContext(): OverviewContextValue {
+  const context = useContext(OverviewContext);
+  if (!context) {
+    throw new Error('useOverviewContext must be used within OverviewProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  PaymentsDashboardOverview,
+  PaymentsMetrics,
+  BalanceOverview,
+  APIKeysOverview,
+  SubscriptionOverview,
+  PaymentsChartResponse,
+  PaginatedRecentPaymentList,
+  PaginatedRecentTransactionList,
+};
+

package/src/cfg/contexts/payments/PaymentsContext.tsx

@@ -0,0 +1,131 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { api } from '../../BaseClient';
+import {
+  usePaymentsPaymentList,
+  usePaymentsPaymentRetrieve,
+  useCreatePaymentsPaymentCreate,
+  useCreatePaymentsPaymentCancelCreate,
+  useCreatePaymentsPaymentCheckStatusCreate,
+} from '../../generated/_utils/hooks';
+import type { API } from '../../generated';
+import type {
+  Payment,
+  PaymentCreate,
+  PaymentCreateRequest,
+  PaymentRequest,
+  PaginatedPaymentListList,
+} from '../../generated/_utils/schemas';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface PaymentsContextValue {
+  // List
+  payments: PaginatedPaymentListList | undefined;
+  isLoadingPayments: boolean;
+  paymentsError: Error | undefined;
+  refreshPayments: () => Promise<void>;
+
+  // Operations
+  getPayment: (id: string) => Promise<Payment | undefined>;
+  createPayment: (data: PaymentCreateRequest) => Promise<PaymentCreate>;
+  cancelPayment: (id: string, data: PaymentRequest) => Promise<Payment>;
+  checkPaymentStatus: (id: string, data: PaymentRequest) => Promise<Payment>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const PaymentsContext = createContext<PaymentsContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function PaymentsProvider({ children }: { children: ReactNode }) {
+  // List payments
+  const {
+    data: payments,
+    error: paymentsError,
+    isLoading: isLoadingPayments,
+    mutate: mutatePayments,
+  } = usePaymentsPaymentList({}, api as unknown as API);
+
+  const refreshPayments = async () => {
+    await mutatePayments();
+  };
+
+  // Mutations
+  const createPaymentMutation = useCreatePaymentsPaymentCreate();
+  const cancelPaymentMutation = useCreatePaymentsPaymentCancelCreate();
+  const checkStatusMutation = useCreatePaymentsPaymentCheckStatusCreate();
+
+  // Get single payment
+  const getPayment = async (id: string): Promise<Payment | undefined> => {
+    const { data } = usePaymentsPaymentRetrieve(id, api as unknown as API);
+    return data;
+  };
+
+  // Create payment
+  const createPayment = async (data: PaymentCreateRequest): Promise<PaymentCreate> => {
+    const result = await createPaymentMutation(data, api as unknown as API);
+    await refreshPayments();
+    return result as PaymentCreate;
+  };
+
+  // Cancel payment
+  const cancelPayment = async (id: string, data: PaymentRequest): Promise<Payment> => {
+    const result = await cancelPaymentMutation(id, data, api as unknown as API);
+    await refreshPayments();
+    return result as Payment;
+  };
+
+  // Check payment status
+  const checkPaymentStatus = async (id: string, data: PaymentRequest): Promise<Payment> => {
+    const result = await checkStatusMutation(id, data, api as unknown as API);
+    await refreshPayments();
+    return result as Payment;
+  };
+
+  const value: PaymentsContextValue = {
+    payments,
+    isLoadingPayments,
+    paymentsError,
+    refreshPayments,
+    getPayment,
+    createPayment,
+    cancelPayment,
+    checkPaymentStatus,
+  };
+
+  return <PaymentsContext.Provider value={value}>{children}</PaymentsContext.Provider>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function usePaymentsContext(): PaymentsContextValue {
+  const context = useContext(PaymentsContext);
+  if (!context) {
+    throw new Error('usePaymentsContext must be used within PaymentsProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  Payment,
+  PaymentCreate,
+  PaymentCreateRequest,
+  PaymentRequest,
+  PaginatedPaymentListList,
+};
+