@djangocfg/ext-payments 1.0.0

package/src/contexts/PaymentsContext.tsx

@@ -0,0 +1,121 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import * as ExtPaymentsFetchers from '../api/generated/ext_payments/_utils/fetchers';
+import { apiPayments } from '../api';
+import {
+  usePaymentsPaymentsList,
+  useCreatePaymentsPaymentsCreateCreate,
+  useCreatePaymentsPaymentsConfirmCreate,
+} 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

@@ -0,0 +1,55 @@
+/**
+ * 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 { RootPaymentsProvider } from './RootPaymentsContext';
+import { PaymentsProvider } from './PaymentsContext';
+import { BalancesProvider } from './BalancesContext';
+import { CurrenciesProvider } from './CurrenciesContext';
+import { OverviewProvider } from './OverviewContext';
+
+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

@@ -0,0 +1,201 @@
+# 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

@@ -0,0 +1,65 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } 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;
+}

package/src/contexts/index.ts

@@ -0,0 +1,45 @@
+// Payments
+export {
+  PaymentsProvider,
+  usePaymentsContext
+} from './PaymentsContext';
+export type {
+  PaymentsContextValue,
+} from './PaymentsContext';
+
+// Balances
+export {
+  BalancesProvider,
+  useBalancesContext
+} from './BalancesContext';
+export type {
+  BalancesContextValue,
+} from './BalancesContext';
+
+// Currencies
+export {
+  CurrenciesProvider,
+  useCurrenciesContext
+} from './CurrenciesContext';
+export type {
+  CurrenciesContextValue,
+} from './CurrenciesContext';
+
+// Overview
+export {
+  OverviewProvider,
+  useOverviewContext
+} from './OverviewContext';
+export type {
+  OverviewContextValue,
+} from './OverviewContext';
+
+// Root Payments (Global)
+export {
+  RootPaymentsProvider,
+  useRootPaymentsContext
+} from './RootPaymentsContext';
+export type {
+  RootPaymentsContextValue,
+} from './RootPaymentsContext';
+

package/src/contexts/types.ts

@@ -0,0 +1,40 @@
+/**
+ * Payments Types
+ * Centralized type definitions for payments contexts
+ */
+
+import type {
+  usePaymentsPaymentsList,
+  usePaymentsPaymentsRetrieve,
+  usePaymentsBalanceRetrieve,
+  usePaymentsCurrenciesList,
+  usePaymentsTransactionsList,
+} from '../api/generated/ext_payments/_utils/hooks';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Payments Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type PaginatedPaymentListList = NonNullable<Awaited<ReturnType<typeof usePaymentsPaymentsList>>['data']>;
+export type PaymentDetail = NonNullable<Awaited<ReturnType<typeof usePaymentsPaymentsRetrieve>>['data']>;
+export type PaymentList = NonNullable<Awaited<ReturnType<typeof usePaymentsPaymentsList>>['data']> extends { results: infer T } ? T extends Array<infer U> ? U : never : never;
+
+// ─────────────────────────────────────────────────────────────────────────
+// Balance Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type Balance = NonNullable<Awaited<ReturnType<typeof usePaymentsBalanceRetrieve>>['data']>;
+
+// ─────────────────────────────────────────────────────────────────────────
+// Currency Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type Currency = NonNullable<Awaited<ReturnType<typeof usePaymentsCurrenciesList>>['data']> extends { results: infer T } ? T extends Array<infer U> ? U : never : never;
+export type PaginatedCurrencyList = NonNullable<Awaited<ReturnType<typeof usePaymentsCurrenciesList>>['data']>;
+
+// ─────────────────────────────────────────────────────────────────────────
+// Transaction Types
+// ─────────────────────────────────────────────────────────────────────────
+
+export type Transaction = NonNullable<Awaited<ReturnType<typeof usePaymentsTransactionsList>>['data']> extends { results: infer T } ? T extends Array<infer U> ? U : never : never;
+export type PaginatedTransactionList = NonNullable<Awaited<ReturnType<typeof usePaymentsTransactionsList>>['data']>;

package/src/hooks/index.ts

@@ -0,0 +1,20 @@
+'use client';
+
+/**
+ * @djangocfg/ext-payments/hooks
+ *
+ * React hooks for payments 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_payments/_utils/hooks';
+
+// Payments contexts (from local contexts)
+export * from '../contexts';
+
+// Layout components (they use hooks internally)
+export * from '../layouts/PaymentsLayout/components';

package/src/index.ts

@@ -0,0 +1,36 @@
+/**
+ * @djangocfg/ext-payments
+ *
+ * Payments system extension.
+ * This entry point is server-safe (no SWR/React hooks).
+ *
+ * For React hooks, import from '@djangocfg/ext-payments/hooks'
+ */
+
+// API client (server-safe)
+export * from './api/generated/ext_payments';
+export { API } from './api/generated/ext_payments';
+export { apiPayments } from './api';
+
+// Layout components
+export { PaymentsLayout } from './layouts/PaymentsLayout';
+export type { PaymentsLayoutProps } from './layouts/PaymentsLayout/PaymentsLayout';
+
+// Events
+export * from './layouts/PaymentsLayout/events';
+
+// Types
+export type { PaymentTab } from './layouts/PaymentsLayout/types';
+
+// Re-export API types for convenience
+export type {
+  Balance,
+  Currency,
+  PaymentList,
+  PaymentDetail,
+  Transaction,
+  PaginatedPaymentListList,
+} from './api/generated/ext_payments/_utils/schemas';
+
+// Note: Hooks are NOT exported here to keep this bundle server-safe
+// Use: import { usePaymentsList } from '@djangocfg/ext-payments/hooks'

package/src/layouts/PaymentsLayout/PaymentsLayout.tsx

@@ -0,0 +1,92 @@
+// @ts-nocheck
+/**
+ * Payments Layout (v2.0 - Simplified)
+ *
+ * Simplified layout with 3 tabs: Overview, Payments, Transactions
+ * Removed: API Keys, Tariffs (deprecated in v2.0)
+ */
+
+'use client';
+
+import React from 'react';
+import {
+  PaymentsProvider,
+  OverviewProvider,
+  RootPaymentsProvider,
+} from '../../contexts';
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '@djangocfg/ui-nextjs';
+import { Wallet, CreditCard, History } from 'lucide-react';
+import { OverviewView } from './views/overview';
+import { PaymentsView } from './views/payments';
+import { TransactionsView } from './views/transactions';
+import { CreatePaymentDialog, PaymentDetailsDialog } from './components';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Payments Layout
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface PaymentsLayoutProps {
+  children?: React.ReactNode;
+}
+
+export const PaymentsLayout: React.FC<PaymentsLayoutProps> = () => {
+  return (
+    <RootPaymentsProvider>
+      <div className="h-full p-6 space-y-6">
+        {/* Page Header */}
+        <div>
+          <h1 className="text-3xl font-bold tracking-tight">Payments</h1>
+          <p className="text-muted-foreground">
+            Manage your payments, balance, and transaction history
+          </p>
+        </div>
+
+        {/* Main Content with Tabs */}
+        <Tabs defaultValue="overview" className="space-y-6">
+          <TabsList className="inline-flex h-10 items-center justify-center rounded-md bg-muted p-1 text-muted-foreground">
+            <TabsTrigger value="overview" className="inline-flex items-center gap-2 px-3 py-1.5">
+              <Wallet className="h-4 w-4" />
+              <span className="hidden sm:inline">Overview</span>
+            </TabsTrigger>
+            <TabsTrigger value="payments" className="inline-flex items-center gap-2 px-3 py-1.5">
+              <CreditCard className="h-4 w-4" />
+              <span className="hidden sm:inline">Payments</span>
+            </TabsTrigger>
+            <TabsTrigger value="transactions" className="inline-flex items-center gap-2 px-3 py-1.5">
+              <History className="h-4 w-4" />
+              <span className="hidden sm:inline">Transactions</span>
+            </TabsTrigger>
+          </TabsList>
+
+          {/* Overview Tab - Balance + Recent Payments */}
+          <TabsContent value="overview" className="space-y-6">
+            <OverviewProvider>
+              <PaymentsProvider>
+                <OverviewView />
+                <CreatePaymentDialog />
+              </PaymentsProvider>
+            </OverviewProvider>
+          </TabsContent>
+
+          {/* Payments Tab - Full Payment List */}
+          <TabsContent value="payments" className="space-y-6">
+            <PaymentsProvider>
+              <PaymentsView />
+              <CreatePaymentDialog />
+            </PaymentsProvider>
+          </TabsContent>
+
+          {/* Transactions Tab - Transaction History */}
+          <TabsContent value="transactions" className="space-y-6">
+            <OverviewProvider>
+              <TransactionsView />
+            </OverviewProvider>
+          </TabsContent>
+        </Tabs>
+
+        {/* Global Payment Details Dialog */}
+        <PaymentDetailsDialog />
+      </div>
+    </RootPaymentsProvider>
+  );
+};