@djangocfg/api 1.0.6 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "1.0.6",
+  "version": "1.2.0",
   "author": {
     "name": "DjangoCFG",
     "url": "https://djangocfg.com"
@@ -68,7 +68,7 @@
     "@types/node": "^22.15.3",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.1",
-    "@djangocfg/typescript-config": "^1.0.6",
+    "@djangocfg/typescript-config": "^1.2.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "tsup": "^8.5.0",

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

@@ -3,7 +3,7 @@
 import React, { createContext, useContext, type ReactNode } from 'react';
 import { api } from '../../BaseClient';
 import {
-  usePaymentsCurrenciesRetrieve,
+  usePaymentsCurrenciesList,
 } from '../../generated/_utils/hooks';
 import type { API } from '../../generated';
 
@@ -36,7 +36,7 @@ export function CurrenciesProvider({ children }: { children: ReactNode }) {
     error: currenciesError,
     isLoading: isLoadingCurrencies,
     mutate: mutateCurrencies,
-  } = usePaymentsCurrenciesRetrieve(api as unknown as API);
+  } = usePaymentsCurrenciesList(api as unknown as API);
 
   const refreshCurrencies = async () => {
     await mutateCurrencies();

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

@@ -6,7 +6,7 @@ import { api } from '../../BaseClient';
 import {
   usePaymentsBalanceRetrieve,
   usePaymentsPaymentsList,
-  usePaymentsTransactionsRetrieve,
+  usePaymentsTransactionsList,
   useCreatePaymentsPaymentsCreateCreate,
 } from '../../generated/_utils/hooks';
 import type { API } from '../../generated';
@@ -89,7 +89,7 @@ export function OverviewProvider({ children }: { children: ReactNode }) {
     error: transactionsError,
     isLoading: isLoadingTransactions,
     mutate: mutateTransactions,
-  } = usePaymentsTransactionsRetrieve(api as unknown as API);
+  } = usePaymentsTransactionsList({}, api as unknown as API);
 
   // Payment mutations
   const createPaymentMutation = useCreatePaymentsPaymentsCreateCreate();

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

@@ -3,7 +3,7 @@
 import React, { createContext, useContext, type ReactNode } from 'react';
 import { api } from '../../BaseClient';
 import {
-  usePaymentsCurrenciesRetrieve,
+  usePaymentsCurrenciesList,
 } from '../../generated/_utils/hooks';
 import type { API } from '../../generated';
 
@@ -37,7 +37,7 @@ export function RootPaymentsProvider({ children }: { children: ReactNode }) {
     error: currenciesError,
     isLoading: isLoadingCurrencies,
     mutate: mutateCurrencies,
-  } = usePaymentsCurrenciesRetrieve(api as unknown as API);
+  } = usePaymentsCurrenciesList(api as unknown as API);
 
   const refreshCurrencies = async () => {
     await mutateCurrencies();

package/src/cfg/generated/_utils/fetchers/cfg__payments.ts

@@ -29,6 +29,7 @@
  * const users = await getUsers({ page: 1 }, api)
  * ```
  */
+import { BalanceSchema, type Balance } from '../schemas/Balance.schema'
 import { PaginatedPaymentListListSchema, type PaginatedPaymentListList } from '../schemas/PaginatedPaymentListList.schema'
 import { PaymentDetailSchema, type PaymentDetail } from '../schemas/PaymentDetail.schema'
 import { PaymentListSchema, type PaymentList } from '../schemas/PaymentList.schema'
@@ -36,29 +37,29 @@ import { getAPIInstance } from '../../api-instance'
 import type { API } from '../../index'
 
 /**
- * API operation
+ * Get user balance
  *
  * @method GET
  * @path /cfg/payments/balance/
  */
 export async function getPaymentsBalanceRetrieve(  client?
-): Promise<any> {
+): Promise<Balance> {
   const api = client || getAPIInstance()
   const response = await api.cfg_payments.balanceRetrieve()
-  return response
+  return BalanceSchema.parse(response)
 }
 
 
 /**
- * API operation
+ * Get available currencies
  *
  * @method GET
  * @path /cfg/payments/currencies/
  */
-export async function getPaymentsCurrenciesRetrieve(  client?
+export async function getPaymentsCurrenciesList(  client?
 ): Promise<any> {
   const api = client || getAPIInstance()
-  const response = await api.cfg_payments.currenciesRetrieve()
+  const response = await api.cfg_payments.currenciesList()
   return response
 }
 
@@ -134,15 +135,15 @@ export async function createPaymentsPaymentsCreateCreate(  client?
 
 
 /**
- * API operation
+ * Get user transactions
  *
  * @method GET
  * @path /cfg/payments/transactions/
  */
-export async function getPaymentsTransactionsRetrieve(  client?
+export async function getPaymentsTransactionsList(  params?: { limit?: number; offset?: number; type?: string },  client?
 ): Promise<any> {
   const api = client || getAPIInstance()
-  const response = await api.cfg_payments.transactionsRetrieve()
+  const response = await api.cfg_payments.transactionsList(params?.limit, params?.offset, params?.type)
   return response
 }
 

package/src/cfg/generated/_utils/hooks/cfg__payments.ts

@@ -18,18 +18,19 @@ import useSWR from 'swr'
 import { useSWRConfig } from 'swr'
 import * as Fetchers from '../fetchers/cfg__payments'
 import type { API } from '../../index'
+import type { Balance } from '../schemas/Balance.schema'
 import type { PaginatedPaymentListList } from '../schemas/PaginatedPaymentListList.schema'
 import type { PaymentDetail } from '../schemas/PaymentDetail.schema'
 import type { PaymentList } from '../schemas/PaymentList.schema'
 
 /**
- * API operation
+ * Get user balance
  *
  * @method GET
  * @path /cfg/payments/balance/
  */
-export function usePaymentsBalanceRetrieve(client?: API): ReturnType<typeof useSWR<any>> {
-  return useSWR<any>(
+export function usePaymentsBalanceRetrieve(client?: API): ReturnType<typeof useSWR<Balance>> {
+  return useSWR<Balance>(
     'cfg-payments-balance',
     () => Fetchers.getPaymentsBalanceRetrieve(client)
   )
@@ -37,15 +38,15 @@ export function usePaymentsBalanceRetrieve(client?: API): ReturnType<typeof useS
 
 
 /**
- * API operation
+ * Get available currencies
  *
  * @method GET
  * @path /cfg/payments/currencies/
  */
-export function usePaymentsCurrenciesRetrieve(client?: API): ReturnType<typeof useSWR<any>> {
+export function usePaymentsCurrenciesList(client?: API): ReturnType<typeof useSWR<any>> {
   return useSWR<any>(
-    'cfg-payments-currencie',
-    () => Fetchers.getPaymentsCurrenciesRetrieve(client)
+    'cfg-payments-currencies',
+    () => Fetchers.getPaymentsCurrenciesList(client)
   )
 }
 
@@ -129,15 +130,15 @@ export function useCreatePaymentsPaymentsCreateCreate() {
 
 
 /**
- * API operation
+ * Get user transactions
  *
  * @method GET
  * @path /cfg/payments/transactions/
  */
-export function usePaymentsTransactionsRetrieve(client?: API): ReturnType<typeof useSWR<any>> {
+export function usePaymentsTransactionsList(params?: { limit?: number; offset?: number; type?: string }, client?: API): ReturnType<typeof useSWR<any>> {
   return useSWR<any>(
-    'cfg-payments-transaction',
-    () => Fetchers.getPaymentsTransactionsRetrieve(client)
+    params ? ['cfg-payments-transactions', params] : 'cfg-payments-transactions',
+    () => Fetchers.getPaymentsTransactionsList(params, client)
   )
 }
 

package/src/cfg/generated/_utils/schemas/Balance.schema.ts

@@ -0,0 +1,23 @@
+/**
+ * Zod schema for Balance
+ *
+ * This schema provides runtime validation and type inference.
+ *  * User balance serializer.
+ *  */
+import { z } from 'zod'
+
+/**
+ * User balance serializer.
+ */
+export const BalanceSchema = z.object({
+  balance_usd: z.string(),
+  balance_display: z.string(),
+  total_deposited: z.string(),
+  total_withdrawn: z.string(),
+  last_transaction_at: z.iso.datetime().nullable(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type Balance = z.infer<typeof BalanceSchema>

package/src/cfg/generated/_utils/schemas/Currency.schema.ts

@@ -0,0 +1,28 @@
+/**
+ * Zod schema for Currency
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Currency list serializer.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Currency list serializer.
+ */
+export const CurrencySchema = z.object({
+  code: z.string(),
+  name: z.string(),
+  token: z.string(),
+  network: z.string().nullable(),
+  display_name: z.string(),
+  symbol: z.string(),
+  decimal_places: z.int(),
+  is_active: z.boolean(),
+  min_amount_usd: z.string(),
+  sort_order: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type Currency = z.infer<typeof CurrencySchema>

package/src/cfg/generated/_utils/schemas/PaymentDetail.schema.ts

@@ -24,10 +24,10 @@ export const PaymentDetailSchema = z.object({
   status: z.nativeEnum(Enums.PaymentDetailStatus),
   status_display: z.string(),
   pay_address: z.string().nullable(),
-  qr_code_url: z.string(),
+  qr_code_url: z.string().nullable(),
   payment_url: z.url().nullable(),
   transaction_hash: z.string().nullable(),
-  explorer_link: z.string(),
+  explorer_link: z.string().nullable(),
   confirmations_count: z.int(),
   expires_at: z.iso.datetime().nullable(),
   completed_at: z.iso.datetime().nullable(),

package/src/cfg/generated/_utils/schemas/Transaction.schema.ts

@@ -0,0 +1,28 @@
+/**
+ * Zod schema for Transaction
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Transaction serializer.
+ *  */
+import { z } from 'zod'
+import * as Enums from '../../enums'
+
+/**
+ * Transaction serializer.
+ */
+export const TransactionSchema = z.object({
+  id: z.uuid(),
+  transaction_type: z.nativeEnum(Enums.TransactionTransactionType),
+  type_display: z.string(),
+  amount_usd: z.string(),
+  amount_display: z.string(),
+  balance_after: z.string(),
+  payment_id: z.string().nullable(),
+  description: z.string(),
+  created_at: z.iso.datetime(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type Transaction = z.infer<typeof TransactionSchema>

package/src/cfg/generated/_utils/schemas/index.ts

@@ -28,6 +28,7 @@ export * from './ArchiveProcessingResult.schema'
 export * from './ArchiveSearchRequestRequest.schema'
 export * from './ArchiveSearchResult.schema'
 export * from './ArchiveStatistics.schema'
+export * from './Balance.schema'
 export * from './BulkEmailRequest.schema'
 export * from './BulkEmailResponse.schema'
 export * from './ChatHistory.schema'
@@ -41,6 +42,7 @@ export * from './ChatSessionRequest.schema'
 export * from './ChatSource.schema'
 export * from './ChatSourceRequest.schema'
 export * from './ChunkRevectorizationRequestRequest.schema'
+export * from './Currency.schema'
 export * from './Document.schema'
 export * from './DocumentArchive.schema'
 export * from './DocumentArchiveDetail.schema'
@@ -124,6 +126,7 @@ export * from './Ticket.schema'
 export * from './TicketRequest.schema'
 export * from './TokenRefresh.schema'
 export * from './TokenRefreshRequest.schema'
+export * from './Transaction.schema'
 export * from './Unsubscribe.schema'
 export * from './UnsubscribeRequest.schema'
 export * from './User.schema'

package/src/cfg/generated/cfg__payments/client.ts

@@ -12,18 +12,21 @@ export class CfgPayments {
   }
 
   /**
-   * Get current user balance.
+   * Get user balance
+   * 
+   * Get current user balance and transaction statistics
    */
-  async balanceRetrieve(): Promise<any> {
+  async balanceRetrieve(): Promise<Models.Balance> {
     const response = await this.client.request('GET', "/cfg/payments/balance/");
     return response;
   }
 
   /**
-   * GET /api/v1/payments/currencies/ Returns list of available currencies
-   * with token+network info.
+   * Get available currencies
+   * 
+   * Returns list of available currencies with token+network info
    */
-  async currenciesRetrieve(): Promise<any> {
+  async currenciesList(): Promise<any> {
     const response = await this.client.request('GET', "/cfg/payments/currencies/");
     return response;
   }
@@ -91,11 +94,24 @@ export class CfgPayments {
     return response;
   }
 
+  async transactionsList(limit?: number, offset?: number, type?: string): Promise<any>;
+  async transactionsList(params?: { limit?: number; offset?: number; type?: string }): Promise<any>;
+
   /**
-   * Get user transactions with pagination.
+   * Get user transactions
+   * 
+   * Get user transactions with pagination and filtering
    */
-  async transactionsRetrieve(): Promise<any> {
-    const response = await this.client.request('GET', "/cfg/payments/transactions/");
+  async transactionsList(...args: any[]): Promise<any> {
+    const isParamsObject = args.length === 1 && typeof args[0] === 'object' && args[0] !== null && !Array.isArray(args[0]);
+    
+    let params;
+    if (isParamsObject) {
+      params = args[0];
+    } else {
+      params = { limit: args[0], offset: args[1], type: args[2] };
+    }
+    const response = await this.client.request('GET', "/cfg/payments/transactions/", { params });
     return response;
   }
 

package/src/cfg/generated/cfg__payments/models.ts

@@ -1,5 +1,22 @@
 import * as Enums from "../enums";
 
+/**
+ * User balance serializer.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface Balance {
+  /** Current balance in USD */
+  balance_usd: string;
+  balance_display: string;
+  /** Total amount deposited (lifetime) */
+  total_deposited: string;
+  /** Total amount withdrawn (lifetime) */
+  total_withdrawn: string;
+  /** When the last transaction occurred */
+  last_transaction_at: string | null;
+}
+
 /**
  * 
  * Response model (includes read-only fields).
@@ -61,12 +78,14 @@ export interface PaymentDetail {
   status_display: string;
   /** Cryptocurrency payment address */
   pay_address: string | null;
-  qr_code_url: string;
+  /** Get QR code URL. */
+  qr_code_url: string | null;
   /** Payment page URL (if provided by provider) */
   payment_url: string | null;
   /** Blockchain transaction hash */
   transaction_hash: string | null;
-  explorer_link: string;
+  /** Get blockchain explorer link. */
+  explorer_link: string | null;
   /** Number of blockchain confirmations */
   confirmations_count: number;
   /** When this payment expires (typically 30 minutes) */

package/src/cfg/generated/client.ts

@@ -23,7 +23,7 @@ import { withRetry, type RetryConfig } from "./retry";
 
 
 /**
- * Async API client for Django CFG Sample API.
+ * Async API client for Django CFG API.
  *
  * Usage:
  * ```typescript

package/src/cfg/generated/enums.ts

@@ -449,6 +449,26 @@ export enum TicketRequestStatus {
   CLOSED = "closed",
 }
 
+/**
+ * Type of transaction
+ * * `deposit` - Deposit
+ * * `withdrawal` - Withdrawal
+ * * `payment` - Payment
+ * * `refund` - Refund
+ * * `fee` - Fee
+ * * `bonus` - Bonus
+ * * `adjustment` - Adjustment
+ */
+export enum TransactionTransactionType {
+  DEPOSIT = "deposit",
+  WITHDRAWAL = "withdrawal",
+  PAYMENT = "payment",
+  REFUND = "refund",
+  FEE = "fee",
+  BONUS = "bonus",
+  ADJUSTMENT = "adjustment",
+}
+
 /**
  * Action to perform on workers
  * * `start` - start

package/src/cfg/generated/index.ts

@@ -1,5 +1,5 @@
 /**
- * Django CFG Sample API - API Client with JWT Management
+ * Django CFG API - API Client with JWT Management
  *
  * Usage:
  * ```typescript

package/src/cfg/generated/package.json

@@ -1,7 +1,7 @@
 {
   "name": "api-client",
   "version": "1.0.0",
-  "description": "Auto-generated TypeScript client for Django CFG Sample API",
+  "description": "Auto-generated TypeScript client for Django CFG API",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",