@djangocfg/ext-payments 1.0.14 → 1.0.19

package/src/contexts/OverviewContext.tsx

@@ -1,173 +0,0 @@
-'use client';
-
-import React, { createContext, ReactNode, useContext } from 'react';
-import { SWRConfig } from 'swr';
-
-import { apiPayments } from '../api';
-import {
-    useCreatePaymentsPaymentsCreateCreate, usePaymentsBalanceRetrieve, usePaymentsPaymentsList,
-    usePaymentsTransactionsList
-} from '../api/generated/ext_payments/_utils/hooks';
-
-import type {
-  PaginatedPaymentListList,
-  PaymentList,
-} from './types';
-
-// ─────────────────────────────────────────────────────────────────────────
-// Context Type
-// ─────────────────────────────────────────────────────────────────────────
-
-export interface OverviewContextValue {
-  // Balance data
-  balance: any | undefined;
-  isLoadingBalance: boolean;
-  balanceError: Error | undefined;
-  refreshBalance: () => Promise<void>;
-
-  // Payments data
-  payments: PaginatedPaymentListList | undefined;
-  isLoadingPayments: boolean;
-  paymentsError: Error | undefined;
-  refreshPayments: () => Promise<void>;
-
-  // Transactions data
-  transactions: any | undefined;
-  isLoadingTransactions: boolean;
-  transactionsError: Error | undefined;
-  refreshTransactions: () => Promise<void>;
-
-  // Payment operations
-  createPayment: () => Promise<PaymentList>;
-
-  // 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,
-  };
-
-  // Balance
-  const {
-    data: balance,
-    error: balanceError,
-    isLoading: isLoadingBalance,
-    mutate: mutateBalance,
-  } = usePaymentsBalanceRetrieve(apiPayments);
-
-  // Payments list
-  const {
-    data: payments,
-    error: paymentsError,
-    isLoading: isLoadingPayments,
-    mutate: mutatePayments,
-  } = usePaymentsPaymentsList({}, apiPayments);
-
-  // Transactions
-  const {
-    data: transactions,
-    error: transactionsError,
-    isLoading: isLoadingTransactions,
-    mutate: mutateTransactions,
-  } = usePaymentsTransactionsList({}, apiPayments);
-
-  // Payment mutations
-  const createPaymentMutation = useCreatePaymentsPaymentsCreateCreate();
-
-  const isLoadingOverview = isLoadingBalance || isLoadingPayments || isLoadingTransactions;
-  const overviewError = balanceError || paymentsError || transactionsError;
-
-  const refreshBalance = async () => {
-    await mutateBalance();
-  };
-
-  const refreshPayments = async () => {
-    await mutatePayments();
-  };
-
-  const refreshTransactions = async () => {
-    await mutateTransactions();
-  };
-
-  const refreshOverview = async () => {
-    await Promise.all([
-      mutateBalance(),
-      mutatePayments(),
-      mutateTransactions(),
-    ]);
-  };
-
-  // Create payment
-  const createPayment = async (): Promise<PaymentList> => {
-    const result = await createPaymentMutation(apiPayments);
-    // Refresh overview data to show new payment
-    await refreshOverview();
-    return result as PaymentList;
-  };
-
-  const value: OverviewContextValue = {
-    balance,
-    isLoadingBalance,
-    balanceError,
-    refreshBalance,
-    payments,
-    isLoadingPayments,
-    paymentsError,
-    refreshPayments,
-    transactions,
-    isLoadingTransactions,
-    transactionsError,
-    refreshTransactions,
-    createPayment,
-    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 {
-  PaginatedPaymentListList,
-  PaymentList,
-};
-

package/src/contexts/PaymentsContext.tsx

@@ -1,122 +0,0 @@
-'use client';
-
-import React, { createContext, ReactNode, useContext } from 'react';
-
-import { apiPayments } from '../api';
-import * as ExtPaymentsFetchers from '../api/generated/ext_payments/_utils/fetchers';
-import {
-    useCreatePaymentsPaymentsConfirmCreate, useCreatePaymentsPaymentsCreateCreate,
-    usePaymentsPaymentsList
-} from '../api/generated/ext_payments/_utils/hooks';
-
-import type {
-  PaginatedPaymentListList,
-  PaymentDetail,
-  PaymentList,
-} from './types';
-
-// ─────────────────────────────────────────────────────────────────────────
-// Context Type
-// ─────────────────────────────────────────────────────────────────────────
-
-export interface PaymentsContextValue {
-  // List
-  payments: PaginatedPaymentListList | undefined;
-  isLoadingPayments: boolean;
-  paymentsError: Error | undefined;
-  refreshPayments: () => Promise<void>;
-
-  // Operations
-  getPayment: (id: string) => Promise<PaymentDetail | undefined>;
-  createPayment: () => Promise<PaymentList>;
-  confirmPayment: (id: string) => Promise<PaymentList>;
-  checkPaymentStatus: (id: string) => Promise<PaymentList | undefined>;
-}
-
-// ─────────────────────────────────────────────────────────────────────────
-// Context
-// ─────────────────────────────────────────────────────────────────────────
-
-const PaymentsContext = createContext<PaymentsContextValue | undefined>(undefined);
-
-// ─────────────────────────────────────────────────────────────────────────
-// Provider
-// ─────────────────────────────────────────────────────────────────────────
-
-export function PaymentsProvider({ children }: { children: ReactNode }) {
-  // List payments (first page only for count)
-  const {
-    data: payments,
-    error: paymentsError,
-    isLoading: isLoadingPayments,
-    mutate: mutatePayments,
-  } = usePaymentsPaymentsList({ page: 1, page_size: 1 }, apiPayments);
-
-  const refreshPayments = async () => {
-    await mutatePayments();
-  };
-
-  // Mutations
-  const createPaymentMutation = useCreatePaymentsPaymentsCreateCreate();
-  const confirmPaymentMutation = useCreatePaymentsPaymentsConfirmCreate();
-
-  // Get single payment
-  const getPayment = async (id: string): Promise<PaymentDetail | undefined> => {
-    return ExtPaymentsFetchers.getPaymentsPaymentsRetrieve(id, apiPayments);
-  };
-
-  // Create payment
-  const createPayment = async (): Promise<PaymentList> => {
-    const result = await createPaymentMutation(apiPayments);
-    await refreshPayments();
-    return result as PaymentList;
-  };
-
-  // Confirm payment (user clicked "I paid")
-  const confirmPayment = async (id: string): Promise<PaymentList> => {
-    const result = await confirmPaymentMutation(id, apiPayments);
-    await refreshPayments();
-    return result as PaymentList;
-  };
-
-  // Check payment status
-  const checkPaymentStatus = async (id: string): Promise<PaymentList | undefined> => {
-    return ExtPaymentsFetchers.getPaymentsPaymentsStatusRetrieve(id, apiPayments);
-  };
-
-  const value: PaymentsContextValue = {
-    payments,
-    isLoadingPayments,
-    paymentsError,
-    refreshPayments,
-    getPayment,
-    createPayment,
-    confirmPayment,
-    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 {
-  PaginatedPaymentListList,
-  PaymentDetail,
-  PaymentList,
-};
-

package/src/contexts/PaymentsExtensionProvider.tsx

@@ -1,56 +0,0 @@
-/**
- * Main Payments Extension Provider
- *
- * Wraps all payments contexts with ExtensionProvider for proper registration
- */
-
-'use client';
-
-import type { ReactNode } from 'react';
-import { ExtensionProvider } from '@djangocfg/ext-base/hooks';
-
-import { extensionConfig } from '../config';
-import { BalancesProvider } from './BalancesContext';
-import { CurrenciesProvider } from './CurrenciesContext';
-import { OverviewProvider } from './OverviewContext';
-import { PaymentsProvider } from './PaymentsContext';
-import { RootPaymentsProvider } from './RootPaymentsContext';
-
-interface PaymentsExtensionProviderProps {
-  children: ReactNode;
-}
-
-/**
- * Main provider for Payments extension
- *
- * Provides all payments contexts:
- * - Root payments context (currencies)
- * - Payments context (payment operations)
- * - Balances context (balance management)
- * - Currencies context (currency operations)
- * - Overview context (payment statistics)
- *
- * @example
- * ```tsx
- * <PaymentsExtensionProvider>
- *   <YourApp />
- * </PaymentsExtensionProvider>
- * ```
- */
-export function PaymentsExtensionProvider({ children }: PaymentsExtensionProviderProps) {
-  return (
-    <ExtensionProvider metadata={extensionConfig}>
-      <RootPaymentsProvider>
-        <PaymentsProvider>
-          <BalancesProvider>
-            <CurrenciesProvider>
-              <OverviewProvider>
-                {children}
-              </OverviewProvider>
-            </CurrenciesProvider>
-          </BalancesProvider>
-        </PaymentsProvider>
-      </RootPaymentsProvider>
-    </ExtensionProvider>
-  );
-}

package/src/contexts/README.md

@@ -1,201 +0,0 @@
-# Payments Contexts
-
-Декомпозированные контексты для модуля Payments.
-
-## Структура
-
-### PaymentsContext
-**Файл:** `PaymentsContext.tsx`  
-**Назначение:** Управление платежами
-
-**API:**
-- `payments: PaginatedPaymentListList` - список платежей (пагинированный)
-- `isLoadingPayments: boolean` - статус загрузки
-- `refreshPayments()` - обновить список
-- `getPayment(id)` - получить конкретный платеж
-- `createPayment(data)` - создать платеж
-- `cancelPayment(id, data)` - отменить платеж
-- `checkPaymentStatus(id, data)` - проверить статус платежа
-
-**Использование:**
-```tsx
-import { PaymentsProvider, usePaymentsContext } from '@djangocfg/layouts/contexts';
-
-function PaymentsList() {
-  const { payments, isLoadingPayments, refreshPayments } = usePaymentsContext();
-  // ...
-}
-```
-
----
-
-### BalancesContext
-**Файл:** `BalancesContext.tsx`  
-**Назначение:** Управление балансами пользователей (read-only)
-
-**API:**
-- `balances: PaginatedUserBalanceList` - список балансов
-- `isLoadingBalances: boolean` - статус загрузки
-- `refreshBalances()` - обновить список
-- `getBalance(id)` - получить конкретный баланс
-- `getBalanceSummary()` - получить сводку по балансу
-
-**Использование:**
-```tsx
-import { BalancesProvider, useBalancesContext } from '@djangocfg/layouts/contexts';
-
-function Balance() {
-  const { balances, getBalanceSummary } = useBalancesContext();
-  // ...
-}
-```
-
----
-
-### CurrenciesContext
-**Файл:** `CurrenciesContext.tsx`  
-**Назначение:** Управление валютами и курсами обмена (read-only)
-
-**API:**
-- `currencies: PaginatedCurrencyListList` - список валют
-- `isLoadingCurrencies: boolean` - статус загрузки
-- `refreshCurrencies()` - обновить список
-- `getCurrency(id)` - получить конкретную валюту
-- `getCurrencyRates(baseCurrency, currencies)` - получить курсы обмена
-
-**Использование:**
-```tsx
-import { CurrenciesProvider, useCurrenciesContext } from '@djangocfg/layouts/contexts';
-
-function CurrencySelector() {
-  const { currencies, getCurrencyRates } = useCurrenciesContext();
-  // ...
-}
-```
-
----
-
-### ApiKeysContext
-**Файл:** `ApiKeysContext.tsx`  
-**Назначение:** Управление API ключами
-
-**API:**
-- `apiKeys: PaginatedAPIKeyListList` - список API ключей
-- `isLoadingApiKeys: boolean` - статус загрузки
-- `refreshApiKeys()` - обновить список
-- `getApiKey(id)` - получить конкретный ключ
-- `createApiKey(data)` - создать ключ
-- `deleteApiKey(id)` - удалить ключ
-
-**Использование:**
-```tsx
-import { ApiKeysProvider, useApiKeysContext } from '@djangocfg/layouts/contexts';
-
-function ApiKeysList() {
-  const { apiKeys, createApiKey, deleteApiKey } = useApiKeysContext();
-  // ...
-}
-```
-
----
-
-### OverviewContext
-**Файл:** `OverviewContext.tsx`  
-**Назначение:** Дашборд и метрики платежной системы (read-only)
-
-**API:**
-- `overview: PaymentsDashboardOverview` - общий обзор
-- `metrics: PaymentsMetrics` - метрики
-- `balanceOverview: BalanceOverview` - обзор баланса
-- `apiKeysOverview: APIKeysOverview` - обзор API ключей
-- `subscriptionOverview: SubscriptionOverview` - обзор подписок
-- `chartData: PaymentsChartResponse` - данные для графиков
-- `recentPayments: PaginatedRecentPaymentList` - последние платежи
-- `recentTransactions: PaginatedRecentTransactionList` - последние транзакции
-- `isLoadingOverview: boolean` - статус загрузки
-- `refreshOverview()` - обновить все данные
-
-**Использование:**
-```tsx
-import { OverviewProvider, useOverviewContext } from '@djangocfg/layouts/contexts';
-
-function Dashboard() {
-  const { overview, metrics, chartData } = useOverviewContext();
-  // ...
-}
-```
-
----
-
-## Композиция провайдеров
-
-Если нужно использовать несколько контекстов:
-
-```tsx
-import { 
-  PaymentsProvider, 
-  BalancesProvider, 
-  OverviewProvider 
-} from '@djangocfg/layouts/contexts';
-
-function PaymentsDashboard() {
-  return (
-    <OverviewProvider>
-      <PaymentsProvider>
-        <BalancesProvider>
-          <YourComponent />
-        </BalancesProvider>
-      </PaymentsProvider>
-    </OverviewProvider>
-  );
-}
-```
-
----
-
-## Миграция со старого PaymentsContext
-
-**Было:**
-```tsx
-import { PaymentsProvider, usePaymentsContext } from '@djangocfg/layouts/contexts';
-
-const { payments, balances, apiKeys } = usePaymentsContext();
-```
-
-**Стало:**
-```tsx
-import { 
-  PaymentsProvider, usePaymentsContext,
-  BalancesProvider, useBalancesContext,
-  ApiKeysProvider, useApiKeysContext
-} from '@djangocfg/layouts/contexts';
-
-// В разных компонентах или комбинируя:
-const { payments } = usePaymentsContext();
-const { balances } = useBalancesContext();
-const { apiKeys } = useApiKeysContext();
-```
-
----
-
-## Преимущества декомпозиции
-
-1. **Модульность** - каждый контекст отвечает за свою область
-2. **Производительность** - меньше ненужных ре-рендеров
-3. **Гибкость** - можно использовать только нужные контексты
-4. **Читаемость** - явное разделение зон ответственности
-5. **Масштабируемость** - проще добавлять новую функциональность
-
----
-
-## Не включенные сущности
-
-В текущей декомпозиции **не включены** (могут быть добавлены позже):
-- `SubscriptionsContext` - управление подписками (CRUD)
-- `TransactionsContext` - история транзакций (read-only)
-- `TariffsContext` - тарифные планы (read-only)
-- `NetworksContext` - блокчейн сети (read-only)
-- `AdminContext` - админ-функции (для админки)
-
-Эти сущности можно добавить по мере необходимости, следуя той же структуре.
-

package/src/contexts/RootPaymentsContext.tsx

@@ -1,66 +0,0 @@
-'use client';
-
-import React, { createContext, ReactNode, useContext } from 'react';
-
-import { apiPayments } from '../api';
-import { usePaymentsCurrenciesList } from '../api/generated/ext_payments/_utils/hooks';
-
-// ─────────────────────────────────────────────────────────────────────────
-// Context Type
-// ─────────────────────────────────────────────────────────────────────────
-
-export interface RootPaymentsContextValue {
-  // Currencies - simplified to single endpoint
-  currencies: any | undefined;
-  isLoadingCurrencies: boolean;
-  currenciesError: Error | undefined;
-  refreshCurrencies: () => Promise<void>;
-}
-
-// ─────────────────────────────────────────────────────────────────────────
-// Context
-// ─────────────────────────────────────────────────────────────────────────
-
-const RootPaymentsContext = createContext<RootPaymentsContextValue | undefined>(undefined);
-
-// ─────────────────────────────────────────────────────────────────────────
-// Provider
-// ─────────────────────────────────────────────────────────────────────────
-
-export function RootPaymentsProvider({ children }: { children: ReactNode }) {
-  // Get currencies list from /cfg/payments/currencies/
-  // In v2.0, this returns all currencies with network info embedded
-  const {
-    data: currencies,
-    error: currenciesError,
-    isLoading: isLoadingCurrencies,
-    mutate: mutateCurrencies,
-  } = usePaymentsCurrenciesList(apiPayments);
-
-  const refreshCurrencies = async () => {
-    await mutateCurrencies();
-  };
-
-  const value: RootPaymentsContextValue = {
-    currencies,
-    isLoadingCurrencies,
-    currenciesError,
-    refreshCurrencies,
-  };
-
-  return (
-    <RootPaymentsContext.Provider value={value}>{children}</RootPaymentsContext.Provider>
-  );
-}
-
-// ─────────────────────────────────────────────────────────────────────────
-// Hook
-// ─────────────────────────────────────────────────────────────────────────
-
-export function useRootPaymentsContext(): RootPaymentsContextValue {
-  const context = useContext(RootPaymentsContext);
-  if (!context) {
-    throw new Error('useRootPaymentsContext must be used within RootPaymentsProvider');
-  }
-  return context;
-}