@djangocfg/ext-payments 1.0.19 → 1.0.21

package/dist/hooks-DG8taGyN.d.cts

@@ -0,0 +1,1172 @@
+import useSWR from 'swr';
+import { ConsolaInstance } from 'consola';
+import { z } from 'zod';
+
+/**
+ * Current payment status
+ * * `pending` - Pending
+ * * `confirming` - Confirming
+ * * `confirmed` - Confirmed
+ * * `completed` - Completed
+ * * `partially_paid` - Partially Paid
+ * * `failed` - Failed
+ * * `expired` - Expired
+ * * `cancelled` - Cancelled
+ */
+declare enum PaymentDetailStatus {
+    PENDING = "pending",
+    CONFIRMING = "confirming",
+    CONFIRMED = "confirmed",
+    COMPLETED = "completed",
+    PARTIALLY_PAID = "partially_paid",
+    FAILED = "failed",
+    EXPIRED = "expired",
+    CANCELLED = "cancelled"
+}
+/**
+ * Current payment status
+ * * `pending` - Pending
+ * * `confirming` - Confirming
+ * * `confirmed` - Confirmed
+ * * `completed` - Completed
+ * * `partially_paid` - Partially Paid
+ * * `failed` - Failed
+ * * `expired` - Expired
+ * * `cancelled` - Cancelled
+ */
+declare enum PaymentListStatus {
+    PENDING = "pending",
+    CONFIRMING = "confirming",
+    CONFIRMED = "confirmed",
+    COMPLETED = "completed",
+    PARTIALLY_PAID = "partially_paid",
+    FAILED = "failed",
+    EXPIRED = "expired",
+    CANCELLED = "cancelled"
+}
+/**
+ * Type of transaction
+ * * `deposit` - Deposit
+ * * `withdrawal` - Withdrawal
+ * * `payment` - Payment
+ * * `refund` - Refund
+ * * `fee` - Fee
+ * * `bonus` - Bonus
+ * * `adjustment` - Adjustment
+ */
+declare enum TransactionTransactionType {
+    DEPOSIT = "deposit",
+    WITHDRAWAL = "withdrawal",
+    PAYMENT = "payment",
+    REFUND = "refund",
+    FEE = "fee",
+    BONUS = "bonus",
+    ADJUSTMENT = "adjustment"
+}
+/**
+ * Withdrawal status
+ * * `pending` - Pending
+ * * `approved` - Approved
+ * * `processing` - Processing
+ * * `completed` - Completed
+ * * `rejected` - Rejected
+ * * `cancelled` - Cancelled
+ */
+declare enum WithdrawalDetailStatus {
+    PENDING = "pending",
+    APPROVED = "approved",
+    PROCESSING = "processing",
+    COMPLETED = "completed",
+    REJECTED = "rejected",
+    CANCELLED = "cancelled"
+}
+/**
+ * Withdrawal status
+ * * `pending` - Pending
+ * * `approved` - Approved
+ * * `processing` - Processing
+ * * `completed` - Completed
+ * * `rejected` - Rejected
+ * * `cancelled` - Cancelled
+ */
+declare enum WithdrawalListStatus {
+    PENDING = "pending",
+    APPROVED = "approved",
+    PROCESSING = "processing",
+    COMPLETED = "completed",
+    REJECTED = "rejected",
+    CANCELLED = "cancelled"
+}
+
+type enums_PaymentDetailStatus = PaymentDetailStatus;
+declare const enums_PaymentDetailStatus: typeof PaymentDetailStatus;
+type enums_PaymentListStatus = PaymentListStatus;
+declare const enums_PaymentListStatus: typeof PaymentListStatus;
+type enums_TransactionTransactionType = TransactionTransactionType;
+declare const enums_TransactionTransactionType: typeof TransactionTransactionType;
+type enums_WithdrawalDetailStatus = WithdrawalDetailStatus;
+declare const enums_WithdrawalDetailStatus: typeof WithdrawalDetailStatus;
+type enums_WithdrawalListStatus = WithdrawalListStatus;
+declare const enums_WithdrawalListStatus: typeof WithdrawalListStatus;
+declare namespace enums {
+  export { enums_PaymentDetailStatus as PaymentDetailStatus, enums_PaymentListStatus as PaymentListStatus, enums_TransactionTransactionType as TransactionTransactionType, enums_WithdrawalDetailStatus as WithdrawalDetailStatus, enums_WithdrawalListStatus as WithdrawalListStatus };
+}
+
+/**
+ * User balance serializer.
+ *
+ * Response model (includes read-only fields).
+ */
+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).
+ */
+interface PaginatedPaymentListList {
+    /** Total number of items across all pages */
+    count: number;
+    /** Current page number (1-based) */
+    page: number;
+    /** Total number of pages */
+    pages: number;
+    /** Number of items per page */
+    page_size: number;
+    /** Whether there is a next page */
+    has_next: boolean;
+    /** Whether there is a previous page */
+    has_previous: boolean;
+    /** Next page number (null if no next page) */
+    next_page?: number | null;
+    /** Previous page number (null if no previous page) */
+    previous_page?: number | null;
+    /** Array of items for current page */
+    results: Array<PaymentList$1>;
+}
+/**
+ * Detailed payment information.
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaymentDetail {
+    /** Unique identifier for this record */
+    id: string;
+    /** Internal payment identifier (PAY_YYYYMMDDHHMMSS_UUID) */
+    internal_payment_id: string;
+    /** Payment amount in USD */
+    amount_usd: string;
+    currency_code: string;
+    currency_name: string;
+    currency_token: string;
+    currency_network: string;
+    pay_amount?: string | null;
+    actual_amount?: string | null;
+    actual_amount_usd?: string | null;
+    /** Current payment status
+  
+    * `pending` - Pending
+    * `confirming` - Confirming
+    * `confirmed` - Confirmed
+    * `completed` - Completed
+    * `partially_paid` - Partially Paid
+    * `failed` - Failed
+    * `expired` - Expired
+    * `cancelled` - Cancelled */
+    status: PaymentDetailStatus;
+    status_display: string;
+    pay_address?: string | null;
+    /** Get QR code URL. */
+    qr_code_url?: string | null;
+    payment_url?: string | null;
+    transaction_hash?: string | null;
+    /** Get blockchain explorer link. */
+    explorer_link?: string | null;
+    /** Number of blockchain confirmations */
+    confirmations_count: number;
+    expires_at?: string | null;
+    completed_at?: string | null;
+    /** When this record was created */
+    created_at: string;
+    is_completed: boolean;
+    is_failed: boolean;
+    is_expired: boolean;
+    /** Payment description */
+    description: string;
+}
+/**
+ * Payment list item (lighter than detail).
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaymentList$1 {
+    /** Unique identifier for this record */
+    id: string;
+    /** Internal payment identifier (PAY_YYYYMMDDHHMMSS_UUID) */
+    internal_payment_id: string;
+    /** Payment amount in USD */
+    amount_usd: string;
+    currency_code: string;
+    currency_token: string;
+    /** Current payment status
+  
+    * `pending` - Pending
+    * `confirming` - Confirming
+    * `confirmed` - Confirmed
+    * `completed` - Completed
+    * `partially_paid` - Partially Paid
+    * `failed` - Failed
+    * `expired` - Expired
+    * `cancelled` - Cancelled */
+    status: PaymentListStatus;
+    status_display: string;
+    /** When this record was created */
+    created_at: string;
+    /** When this payment was completed */
+    completed_at?: string | null;
+}
+/**
+ * Serializer for creating payment.
+ *
+ * Request model (no read-only fields).
+ */
+interface PaymentCreateRequest$1 {
+    /** Payment amount in USD */
+    amount_usd: string;
+    /** Currency code (e.g., USDTTRC20) */
+    currency_code: string;
+    /** Optional payment description */
+    description?: string;
+}
+/**
+ * Response for payment creation.
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaymentCreateResponse$1 {
+    success: boolean;
+    payment: PaymentDetail;
+    qr_code_url: string | null;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaginatedWithdrawalListList {
+    /** Total number of items across all pages */
+    count: number;
+    /** Current page number (1-based) */
+    page: number;
+    /** Total number of pages */
+    pages: number;
+    /** Number of items per page */
+    page_size: number;
+    /** Whether there is a next page */
+    has_next: boolean;
+    /** Whether there is a previous page */
+    has_previous: boolean;
+    /** Next page number (null if no next page) */
+    next_page?: number | null;
+    /** Previous page number (null if no previous page) */
+    previous_page?: number | null;
+    /** Array of items for current page */
+    results: Array<WithdrawalList>;
+}
+/**
+ * Detailed withdrawal information.
+ *
+ * Response model (includes read-only fields).
+ */
+interface WithdrawalDetail {
+    /** Unique identifier for this record */
+    id: string;
+    /** Internal withdrawal identifier (WD_YYYYMMDDHHMMSS_UUID) */
+    internal_withdrawal_id: string;
+    /** Withdrawal amount in USD (min $10) */
+    amount_usd: string;
+    currency_code: string;
+    currency_name: string;
+    currency_token: string;
+    currency_network: string;
+    /** Destination wallet address */
+    wallet_address: string;
+    /** Network transaction fee in USD */
+    network_fee_usd: string;
+    /** Service fee in USD */
+    service_fee_usd: string;
+    /** Total fee (network + service) in USD */
+    total_fee_usd: string;
+    /** Final amount to receive (amount - total_fee) */
+    final_amount_usd: string;
+    crypto_amount?: string | null;
+    /** Withdrawal status
+  
+    * `pending` - Pending
+    * `approved` - Approved
+    * `processing` - Processing
+    * `completed` - Completed
+    * `rejected` - Rejected
+    * `cancelled` - Cancelled */
+    status: WithdrawalDetailStatus;
+    status_display: string;
+    transaction_hash?: string | null;
+    /** Get blockchain explorer link. */
+    explorer_link?: string | null;
+    /** Admin notes (reason for rejection, etc.) */
+    admin_notes: string;
+    /** When this record was created */
+    created_at: string;
+    approved_at?: string | null;
+    completed_at?: string | null;
+    rejected_at?: string | null;
+    cancelled_at?: string | null;
+}
+/**
+ * Response for withdrawal cancellation.
+ *
+ * Response model (includes read-only fields).
+ */
+interface WithdrawalCancelResponse$1 {
+    success: boolean;
+    withdrawal: WithdrawalDetail;
+    message: string;
+}
+/**
+ * Serializer for creating withdrawal request.
+ *
+ * Request model (no read-only fields).
+ */
+interface WithdrawalCreateRequest$1 {
+    /** Withdrawal amount in USD (min $10) */
+    amount_usd: string;
+    /** Currency code (e.g., USDTTRC20) */
+    currency_code: string;
+    /** Destination wallet address */
+    wallet_address: string;
+}
+/**
+ * Response for withdrawal creation.
+ *
+ * Response model (includes read-only fields).
+ */
+interface WithdrawalCreateResponse$1 {
+    success: boolean;
+    withdrawal: WithdrawalDetail;
+    message: string;
+}
+/**
+ * Withdrawal list item (lighter than detail).
+ *
+ * Response model (includes read-only fields).
+ */
+interface WithdrawalList {
+    /** Unique identifier for this record */
+    id: string;
+    /** Internal withdrawal identifier (WD_YYYYMMDDHHMMSS_UUID) */
+    internal_withdrawal_id: string;
+    /** Withdrawal amount in USD (min $10) */
+    amount_usd: string;
+    /** Final amount to receive (amount - total_fee) */
+    final_amount_usd: string;
+    currency_code: string;
+    currency_token: string;
+    /** Withdrawal status
+  
+    * `pending` - Pending
+    * `approved` - Approved
+    * `processing` - Processing
+    * `completed` - Completed
+    * `rejected` - Rejected
+    * `cancelled` - Cancelled */
+    status: WithdrawalListStatus;
+    status_display: string;
+    /** When this record was created */
+    created_at: string;
+    /** When withdrawal was completed */
+    completed_at?: string | null;
+}
+
+type models_Balance = Balance;
+type models_PaginatedPaymentListList = PaginatedPaymentListList;
+type models_PaginatedWithdrawalListList = PaginatedWithdrawalListList;
+type models_PaymentDetail = PaymentDetail;
+type models_WithdrawalDetail = WithdrawalDetail;
+type models_WithdrawalList = WithdrawalList;
+declare namespace models {
+  export type { models_Balance as Balance, models_PaginatedPaymentListList as PaginatedPaymentListList, models_PaginatedWithdrawalListList as PaginatedWithdrawalListList, PaymentCreateRequest$1 as PaymentCreateRequest, PaymentCreateResponse$1 as PaymentCreateResponse, models_PaymentDetail as PaymentDetail, PaymentList$1 as PaymentList, WithdrawalCancelResponse$1 as WithdrawalCancelResponse, WithdrawalCreateRequest$1 as WithdrawalCreateRequest, WithdrawalCreateResponse$1 as WithdrawalCreateResponse, models_WithdrawalDetail as WithdrawalDetail, models_WithdrawalList as WithdrawalList };
+}
+
+/**
+ * API endpoints for Payments.
+ */
+declare class ExtPaymentsPayments {
+    private client;
+    constructor(client: any);
+    /**
+     * Get user balance
+     *
+     * Get current user balance and transaction statistics
+     */
+    balanceRetrieve(): Promise<Balance>;
+    /**
+     * Get available currencies
+     *
+     * Returns list of available currencies with token+network info, popular
+     * first
+     */
+    currenciesList(): Promise<any>;
+    currenciesEstimateRetrieve(code: string, amount?: number): Promise<any>;
+    currenciesEstimateRetrieve(code: string, params?: {
+        amount?: number;
+    }): Promise<any>;
+    currenciesWithdrawalEstimateRetrieve(code: string, amount?: number): Promise<any>;
+    currenciesWithdrawalEstimateRetrieve(code: string, params?: {
+        amount?: number;
+    }): Promise<any>;
+    paymentsList(page?: number, page_size?: number): Promise<PaginatedPaymentListList>;
+    paymentsList(params?: {
+        page?: number;
+        page_size?: number;
+    }): Promise<PaginatedPaymentListList>;
+    /**
+     * ViewSet for payment operations. Endpoints: - GET /payments/ - List
+     * user's payments - GET /payments/{id}/ - Get payment details - POST
+     * /payments/create/ - Create new payment - GET /payments/{id}/status/ -
+     * Check payment status - POST /payments/{id}/confirm/ - Confirm payment
+     */
+    paymentsRetrieve(id: string): Promise<PaymentDetail>;
+    /**
+     * POST /api/v1/payments/{id}/confirm/ Confirm payment (user clicked "I
+     * have paid"). Checks status with provider and creates transaction if
+     * completed.
+     */
+    paymentsConfirmCreate(id: string): Promise<PaymentList$1>;
+    /**
+     * GET /api/v1/payments/{id}/status/?refresh=true Check payment status
+     * (with optional refresh from provider). Query params: - refresh: boolean
+     * (default: false) - Force refresh from provider
+     */
+    paymentsStatusRetrieve(id: string): Promise<PaymentList$1[]>;
+    /**
+     * Create payment
+     *
+     * Create a new payment with specified amount and currency
+     */
+    paymentsCreateCreate(data: PaymentCreateRequest$1): Promise<PaymentCreateResponse$1>;
+    transactionsList(limit?: number, offset?: number, type?: string): Promise<any>;
+    transactionsList(params?: {
+        limit?: number;
+        offset?: number;
+        type?: string;
+    }): Promise<any>;
+    withdrawalsList(page?: number, page_size?: number): Promise<PaginatedWithdrawalListList>;
+    withdrawalsList(params?: {
+        page?: number;
+        page_size?: number;
+    }): Promise<PaginatedWithdrawalListList>;
+    /**
+     * ViewSet for withdrawal operations. Endpoints: - GET /withdrawals/ - List
+     * user's withdrawal requests - GET /withdrawals/{id}/ - Get withdrawal
+     * details - POST /withdrawals/create/ - Create withdrawal request - POST
+     * /withdrawals/{id}/cancel/ - Cancel pending withdrawal
+     */
+    withdrawalsRetrieve(id: string): Promise<WithdrawalDetail>;
+    /**
+     * Cancel withdrawal request
+     *
+     * Cancel a pending withdrawal request
+     */
+    withdrawalsCancelCreate(id: string): Promise<WithdrawalCancelResponse$1>;
+    /**
+     * Create withdrawal request
+     *
+     * Create a new withdrawal request (requires admin approval)
+     */
+    withdrawalsCreateCreate(data: WithdrawalCreateRequest$1): Promise<WithdrawalCreateResponse$1>;
+}
+
+/**
+ * API Logger with Consola
+ * Beautiful console logging for API requests and responses
+ *
+ * Installation:
+ *   npm install consola
+ */
+
+/**
+ * Request log data
+ */
+interface RequestLog {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: any;
+    timestamp: number;
+}
+/**
+ * Response log data
+ */
+interface ResponseLog {
+    status: number;
+    statusText: string;
+    data?: any;
+    duration: number;
+    timestamp: number;
+}
+/**
+ * Error log data
+ */
+interface ErrorLog {
+    message: string;
+    statusCode?: number;
+    fieldErrors?: Record<string, string[]>;
+    duration: number;
+    timestamp: number;
+}
+/**
+ * Logger configuration
+ */
+interface LoggerConfig {
+    /** Enable logging */
+    enabled: boolean;
+    /** Log requests */
+    logRequests: boolean;
+    /** Log responses */
+    logResponses: boolean;
+    /** Log errors */
+    logErrors: boolean;
+    /** Log request/response bodies */
+    logBodies: boolean;
+    /** Log headers (excluding sensitive ones) */
+    logHeaders: boolean;
+    /** Custom consola instance */
+    consola?: ConsolaInstance;
+}
+/**
+ * API Logger class
+ */
+declare class APILogger {
+    private config;
+    private consola;
+    constructor(config?: Partial<LoggerConfig>);
+    /**
+     * Enable logging
+     */
+    enable(): void;
+    /**
+     * Disable logging
+     */
+    disable(): void;
+    /**
+     * Update configuration
+     */
+    setConfig(config: Partial<LoggerConfig>): void;
+    /**
+     * Filter sensitive headers
+     */
+    private filterHeaders;
+    /**
+     * Log request
+     */
+    logRequest(request: RequestLog): void;
+    /**
+     * Log response
+     */
+    logResponse(request: RequestLog, response: ResponseLog): void;
+    /**
+     * Log error
+     */
+    logError(request: RequestLog, error: ErrorLog): void;
+    /**
+     * Log general info
+     */
+    info(message: string, ...args: any[]): void;
+    /**
+     * Log warning
+     */
+    warn(message: string, ...args: any[]): void;
+    /**
+     * Log error
+     */
+    error(message: string, ...args: any[]): void;
+    /**
+     * Log debug
+     */
+    debug(message: string, ...args: any[]): void;
+    /**
+     * Log success
+     */
+    success(message: string, ...args: any[]): void;
+    /**
+     * Create a sub-logger with prefix
+     */
+    withTag(tag: string): ConsolaInstance;
+}
+
+/**
+ * Retry Configuration and Utilities
+ *
+ * Provides automatic retry logic for failed HTTP requests using p-retry.
+ * Retries only on network errors and server errors (5xx), not client errors (4xx).
+ */
+/**
+ * Information about a failed retry attempt.
+ */
+interface FailedAttemptInfo {
+    /** The error that caused the failure */
+    error: Error;
+    /** The attempt number (1-indexed) */
+    attemptNumber: number;
+    /** Number of retries left */
+    retriesLeft: number;
+}
+/**
+ * Retry configuration options.
+ *
+ * Uses exponential backoff with jitter by default to avoid thundering herd.
+ */
+interface RetryConfig {
+    /**
+     * Maximum number of retry attempts.
+     * @default 3
+     */
+    retries?: number;
+    /**
+     * Exponential backoff factor.
+     * @default 2
+     */
+    factor?: number;
+    /**
+     * Minimum wait time between retries (ms).
+     * @default 1000
+     */
+    minTimeout?: number;
+    /**
+     * Maximum wait time between retries (ms).
+     * @default 60000
+     */
+    maxTimeout?: number;
+    /**
+     * Add randomness to wait times (jitter).
+     * Helps avoid thundering herd problem.
+     * @default true
+     */
+    randomize?: boolean;
+    /**
+     * Callback called on each failed attempt.
+     */
+    onFailedAttempt?: (info: FailedAttemptInfo) => void;
+}
+/**
+ * Default retry configuration.
+ */
+declare const DEFAULT_RETRY_CONFIG: Required<RetryConfig>;
+/**
+ * Determine if an error should trigger a retry.
+ *
+ * Retries on:
+ * - Network errors (connection refused, timeout, etc.)
+ * - Server errors (5xx status codes)
+ * - Rate limiting (429 status code)
+ *
+ * Does NOT retry on:
+ * - Client errors (4xx except 429)
+ * - Authentication errors (401, 403)
+ * - Not found (404)
+ *
+ * @param error - The error to check
+ * @returns true if should retry, false otherwise
+ */
+declare function shouldRetry(error: any): boolean;
+/**
+ * Wrap a function with retry logic.
+ *
+ * @param fn - Async function to retry
+ * @param config - Retry configuration
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   async () => fetch('https://api.example.com/users'),
+ *   { retries: 5, minTimeout: 2000 }
+ * );
+ * ```
+ */
+declare function withRetry<T>(fn: () => Promise<T>, config?: RetryConfig): Promise<T>;
+
+/**
+ * Storage adapters for cross-platform token storage.
+ *
+ * Supports:
+ * - LocalStorage (browser)
+ * - Cookies (SSR/browser)
+ * - Memory (Node.js/Electron/testing)
+ */
+
+/**
+ * Storage adapter interface for cross-platform token storage.
+ */
+interface StorageAdapter {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/**
+ * LocalStorage adapter with safe try-catch for browser environments.
+ * Works in modern browsers with localStorage support.
+ *
+ * Note: This adapter uses window.localStorage and should only be used in browser/client environments.
+ * For server-side usage, use MemoryStorageAdapter or CookieStorageAdapter instead.
+ */
+declare class LocalStorageAdapter implements StorageAdapter {
+    private logger?;
+    constructor(logger?: APILogger);
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/**
+ * Cookie-based storage adapter for SSR and browser environments.
+ * Useful for Next.js, Nuxt.js, and other SSR frameworks.
+ */
+declare class CookieStorageAdapter implements StorageAdapter {
+    private logger?;
+    constructor(logger?: APILogger);
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/**
+ * In-memory storage adapter for Node.js, Electron, and testing environments.
+ * Data is stored in RAM and cleared when process exits.
+ */
+declare class MemoryStorageAdapter implements StorageAdapter {
+    private storage;
+    private logger?;
+    constructor(logger?: APILogger);
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+
+/**
+ * Zod schema for PaymentCreateRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for creating payment.
+ *  */
+
+/**
+ * Serializer for creating payment.
+ */
+declare const PaymentCreateRequestSchema: z.ZodObject<{
+    amount_usd: z.ZodString;
+    currency_code: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Infer TypeScript type from Zod schema
+ */
+type PaymentCreateRequest = z.infer<typeof PaymentCreateRequestSchema>;
+
+/**
+ * Response for payment creation.
+ */
+declare const PaymentCreateResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    payment: z.ZodObject<{
+        id: z.ZodString;
+        internal_payment_id: z.ZodString;
+        amount_usd: z.ZodString;
+        currency_code: z.ZodString;
+        currency_name: z.ZodString;
+        currency_token: z.ZodString;
+        currency_network: z.ZodString;
+        pay_amount: z.ZodNullable<z.ZodString>;
+        actual_amount: z.ZodNullable<z.ZodString>;
+        actual_amount_usd: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<typeof PaymentDetailStatus>;
+        status_display: z.ZodString;
+        pay_address: z.ZodNullable<z.ZodString>;
+        qr_code_url: z.ZodNullable<z.ZodString>;
+        payment_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
+        transaction_hash: z.ZodNullable<z.ZodString>;
+        explorer_link: z.ZodNullable<z.ZodString>;
+        confirmations_count: z.ZodInt;
+        expires_at: z.ZodNullable<z.ZodString>;
+        completed_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        is_completed: z.ZodBoolean;
+        is_failed: z.ZodBoolean;
+        is_expired: z.ZodBoolean;
+        description: z.ZodString;
+    }, z.core.$strip>;
+    qr_code_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
+}, z.core.$strip>;
+/**
+ * Infer TypeScript type from Zod schema
+ */
+type PaymentCreateResponse = z.infer<typeof PaymentCreateResponseSchema>;
+
+/**
+ * Zod schema for PaymentList
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Payment list item (lighter than detail).
+ *  */
+
+/**
+ * Payment list item (lighter than detail).
+ */
+declare const PaymentListSchema: z.ZodObject<{
+    id: z.ZodString;
+    internal_payment_id: z.ZodString;
+    amount_usd: z.ZodString;
+    currency_code: z.ZodString;
+    currency_token: z.ZodString;
+    status: z.ZodEnum<typeof PaymentListStatus>;
+    status_display: z.ZodString;
+    created_at: z.ZodString;
+    completed_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Infer TypeScript type from Zod schema
+ */
+type PaymentList = z.infer<typeof PaymentListSchema>;
+
+/**
+ * Response for withdrawal cancellation.
+ */
+declare const WithdrawalCancelResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    withdrawal: z.ZodObject<{
+        id: z.ZodString;
+        internal_withdrawal_id: z.ZodString;
+        amount_usd: z.ZodString;
+        currency_code: z.ZodString;
+        currency_name: z.ZodString;
+        currency_token: z.ZodString;
+        currency_network: z.ZodString;
+        wallet_address: z.ZodString;
+        network_fee_usd: z.ZodString;
+        service_fee_usd: z.ZodString;
+        total_fee_usd: z.ZodString;
+        final_amount_usd: z.ZodString;
+        crypto_amount: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<typeof WithdrawalDetailStatus>;
+        status_display: z.ZodString;
+        transaction_hash: z.ZodNullable<z.ZodString>;
+        explorer_link: z.ZodNullable<z.ZodString>;
+        admin_notes: z.ZodString;
+        created_at: z.ZodString;
+        approved_at: z.ZodNullable<z.ZodString>;
+        completed_at: z.ZodNullable<z.ZodString>;
+        rejected_at: z.ZodNullable<z.ZodString>;
+        cancelled_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    message: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Infer TypeScript type from Zod schema
+ */
+type WithdrawalCancelResponse = z.infer<typeof WithdrawalCancelResponseSchema>;
+
+/**
+ * Zod schema for WithdrawalCreateRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for creating withdrawal request.
+ *  */
+
+/**
+ * Serializer for creating withdrawal request.
+ */
+declare const WithdrawalCreateRequestSchema: z.ZodObject<{
+    amount_usd: z.ZodString;
+    currency_code: z.ZodString;
+    wallet_address: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Infer TypeScript type from Zod schema
+ */
+type WithdrawalCreateRequest = z.infer<typeof WithdrawalCreateRequestSchema>;
+
+/**
+ * Response for withdrawal creation.
+ */
+declare const WithdrawalCreateResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    withdrawal: z.ZodObject<{
+        id: z.ZodString;
+        internal_withdrawal_id: z.ZodString;
+        amount_usd: z.ZodString;
+        currency_code: z.ZodString;
+        currency_name: z.ZodString;
+        currency_token: z.ZodString;
+        currency_network: z.ZodString;
+        wallet_address: z.ZodString;
+        network_fee_usd: z.ZodString;
+        service_fee_usd: z.ZodString;
+        total_fee_usd: z.ZodString;
+        final_amount_usd: z.ZodString;
+        crypto_amount: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<typeof WithdrawalDetailStatus>;
+        status_display: z.ZodString;
+        transaction_hash: z.ZodNullable<z.ZodString>;
+        explorer_link: z.ZodNullable<z.ZodString>;
+        admin_notes: z.ZodString;
+        created_at: z.ZodString;
+        approved_at: z.ZodNullable<z.ZodString>;
+        completed_at: z.ZodNullable<z.ZodString>;
+        rejected_at: z.ZodNullable<z.ZodString>;
+        cancelled_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    message: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Infer TypeScript type from Zod schema
+ */
+type WithdrawalCreateResponse = z.infer<typeof WithdrawalCreateResponseSchema>;
+
+/**
+ * Cmdop API - API Client with JWT Management
+ *
+ * Usage:
+ * ```typescript
+ * import { API } from './api';
+ *
+ * const api = new API('https://api.example.com');
+ *
+ * // Set JWT token
+ * api.setToken('your-jwt-token', 'refresh-token');
+ *
+ * // Use API
+ * const posts = await api.posts.list();
+ * const user = await api.users.retrieve(1);
+ *
+ * // Check authentication
+ * if (api.isAuthenticated()) {
+ *   // ...
+ * }
+ *
+ * // Custom storage with logging (for Electron/Node.js)
+ * import { MemoryStorageAdapter, APILogger } from './storage';
+ * const logger = new APILogger({ enabled: true, logLevel: 'debug' });
+ * const api = new API('https://api.example.com', {
+ *   storage: new MemoryStorageAdapter(logger),
+ *   loggerConfig: { enabled: true, logLevel: 'debug' }
+ * });
+ *
+ * // Get OpenAPI schema
+ * const schema = api.getSchema();
+ * ```
+ */
+
+declare const TOKEN_KEY = "auth_token";
+declare const REFRESH_TOKEN_KEY = "refresh_token";
+interface APIOptions {
+    /** Custom storage adapter (defaults to LocalStorageAdapter) */
+    storage?: StorageAdapter;
+    /** Retry configuration for failed requests */
+    retryConfig?: RetryConfig;
+    /** Logger configuration */
+    loggerConfig?: Partial<LoggerConfig>;
+}
+declare class API {
+    private baseUrl;
+    private _client;
+    private _token;
+    private _refreshToken;
+    private storage;
+    private options?;
+    ext_payments_payments: ExtPaymentsPayments;
+    constructor(baseUrl: string, options?: APIOptions);
+    private _loadTokensFromStorage;
+    private _reinitClients;
+    private _injectAuthHeader;
+    /**
+     * Get current JWT token
+     */
+    getToken(): string | null;
+    /**
+     * Get current refresh token
+     */
+    getRefreshToken(): string | null;
+    /**
+     * Set JWT token and refresh token
+     * @param token - JWT access token
+     * @param refreshToken - JWT refresh token (optional)
+     */
+    setToken(token: string, refreshToken?: string): void;
+    /**
+     * Clear all tokens
+     */
+    clearTokens(): void;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Update base URL and reinitialize clients
+     * @param url - New base URL
+     */
+    setBaseUrl(url: string): void;
+    /**
+     * Get current base URL
+     */
+    getBaseUrl(): string;
+    /**
+     * Get OpenAPI schema path
+     * @returns Path to the OpenAPI schema JSON file
+     *
+     * Note: The OpenAPI schema is available in the schema.json file.
+     * You can load it dynamically using:
+     * ```typescript
+     * const schema = await fetch('./schema.json').then(r => r.json());
+     * // or using fs in Node.js:
+     * // const schema = JSON.parse(fs.readFileSync('./schema.json', 'utf-8'));
+     * ```
+     */
+    getSchemaPath(): string;
+}
+
+/**
+ * SWR Hooks for Payments
+ *
+ * React hooks powered by SWR for data fetching with automatic caching,
+ * revalidation, and optimistic updates.
+ *
+ * Usage:
+ * ```typescript
+ * // Query hooks (GET)
+ * const { data, error, isLoading } = useUsers({ page: 1 })
+ *
+ * // Mutation hooks (POST/PUT/PATCH/DELETE)
+ * const createUser = useCreateUser()
+ * await createUser({ name: 'John', email: 'john@example.com' })
+ * ```
+ */
+
+/**
+ * Get user balance
+ *
+ * @method GET
+ * @path /cfg/payments/balance/
+ */
+declare function usePaymentsBalanceRetrieve(client?: API): ReturnType<typeof useSWR<Balance>>;
+/**
+ * Get available currencies
+ *
+ * @method GET
+ * @path /cfg/payments/currencies/
+ */
+declare function usePaymentsCurrenciesList(client?: API): ReturnType<typeof useSWR<any>>;
+/**
+ * Get currency estimate
+ *
+ * @method GET
+ * @path /cfg/payments/currencies/{code}/estimate/
+ */
+declare function usePaymentsCurrenciesEstimateRetrieve(code: string, params?: {
+    amount?: number;
+}, client?: API): ReturnType<typeof useSWR<any>>;
+/**
+ * Get withdrawal estimate
+ *
+ * @method GET
+ * @path /cfg/payments/currencies/{code}/withdrawal-estimate/
+ */
+declare function usePaymentsCurrenciesWithdrawalEstimateRetrieve(code: string, params?: {
+    amount?: number;
+}, client?: API): ReturnType<typeof useSWR<any>>;
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/payments/
+ */
+declare function usePaymentsPaymentsList(params?: {
+    page?: number;
+    page_size?: number;
+}, client?: API): ReturnType<typeof useSWR<PaginatedPaymentListList>>;
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/payments/{id}/
+ */
+declare function usePaymentsPaymentsRetrieve(id: string, client?: API): ReturnType<typeof useSWR<PaymentDetail>>;
+/**
+ * API operation
+ *
+ * @method POST
+ * @path /cfg/payments/payments/{id}/confirm/
+ */
+declare function useCreatePaymentsPaymentsConfirmCreate(): (id: string, client?: API) => Promise<PaymentList>;
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/payments/{id}/status/
+ */
+declare function usePaymentsPaymentsStatusRetrieve(id: string, client?: API): ReturnType<typeof useSWR<PaymentList>>;
+/**
+ * Create payment
+ *
+ * @method POST
+ * @path /cfg/payments/payments/create/
+ */
+declare function useCreatePaymentsPaymentsCreateCreate(): (data: PaymentCreateRequest, client?: API) => Promise<PaymentCreateResponse>;
+/**
+ * Get user transactions
+ *
+ * @method GET
+ * @path /cfg/payments/transactions/
+ */
+declare function usePaymentsTransactionsList(params?: {
+    limit?: number;
+    offset?: number;
+    type?: string;
+}, client?: API): ReturnType<typeof useSWR<any>>;
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/withdrawals/
+ */
+declare function usePaymentsWithdrawalsList(params?: {
+    page?: number;
+    page_size?: number;
+}, client?: API): ReturnType<typeof useSWR<PaginatedWithdrawalListList>>;
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/withdrawals/{id}/
+ */
+declare function usePaymentsWithdrawalsRetrieve(id: string, client?: API): ReturnType<typeof useSWR<WithdrawalDetail>>;
+/**
+ * Cancel withdrawal request
+ *
+ * @method POST
+ * @path /cfg/payments/withdrawals/{id}/cancel/
+ */
+declare function useCreatePaymentsWithdrawalsCancelCreate(): (id: string, client?: API) => Promise<WithdrawalCancelResponse>;
+/**
+ * Create withdrawal request
+ *
+ * @method POST
+ * @path /cfg/payments/withdrawals/create/
+ */
+declare function useCreatePaymentsWithdrawalsCreateCreate(): (data: WithdrawalCreateRequest, client?: API) => Promise<WithdrawalCreateResponse>;
+
+export { API as A, useCreatePaymentsWithdrawalsCancelCreate as B, useCreatePaymentsWithdrawalsCreateCreate as C, type APIOptions as D, ExtPaymentsPayments as E, LocalStorageAdapter as F, CookieStorageAdapter as G, TOKEN_KEY as H, REFRESH_TOKEN_KEY as I, models as J, enums as K, type LoggerConfig as L, MemoryStorageAdapter as M, type RequestLog as N, type ResponseLog as O, PaymentListStatus as P, type ErrorLog as Q, type RetryConfig as R, type StorageAdapter as S, TransactionTransactionType as T, APILogger as U, type FailedAttemptInfo as V, WithdrawalListStatus as W, withRetry as X, shouldRetry as Y, DEFAULT_RETRY_CONFIG as Z, PaymentDetailStatus as a, WithdrawalDetailStatus as b, type PaymentList as c, type PaymentCreateRequest as d, type PaymentCreateResponse as e, type WithdrawalCancelResponse as f, type WithdrawalCreateRequest as g, type WithdrawalCreateResponse as h, PaymentCreateRequestSchema as i, PaymentCreateResponseSchema as j, PaymentListSchema as k, WithdrawalCancelResponseSchema as l, WithdrawalCreateRequestSchema as m, WithdrawalCreateResponseSchema as n, usePaymentsCurrenciesList as o, usePaymentsCurrenciesEstimateRetrieve as p, usePaymentsCurrenciesWithdrawalEstimateRetrieve as q, usePaymentsPaymentsList as r, usePaymentsPaymentsRetrieve as s, useCreatePaymentsPaymentsConfirmCreate as t, usePaymentsBalanceRetrieve as u, usePaymentsPaymentsStatusRetrieve as v, useCreatePaymentsPaymentsCreateCreate as w, usePaymentsTransactionsList as x, usePaymentsWithdrawalsList as y, usePaymentsWithdrawalsRetrieve as z };