@sdkrouter/payments 0.1.2

package/dist/_api/index.d.ts

@@ -0,0 +1,950 @@
+import { ConsolaInstance } from 'consola';
+
+/**
+ * * `created` - Created
+ * * `waiting` - Waiting for payment
+ * * `paid` - Paid
+ * * `expired` - Expired
+ * * `underpaid` - Underpaid
+ * * `overpaid` - Overpaid
+ * * `cancelled` - Cancelled
+ */
+declare enum CustomerInvoiceDetailStatus {
+    CREATED = "created",
+    WAITING = "waiting",
+    PAID = "paid",
+    EXPIRED = "expired",
+    UNDERPAID = "underpaid",
+    OVERPAID = "overpaid",
+    CANCELLED = "cancelled"
+}
+/**
+ * * `deposit` - Deposit
+ * * `withdrawal` - Withdrawal
+ * * `refund` - Refund
+ * * `fee` - Fee
+ * * `adjustment` - Adjustment
+ */
+declare enum CustomerTransactionResponseTransactionType {
+    DEPOSIT = "deposit",
+    WITHDRAWAL = "withdrawal",
+    REFUND = "refund",
+    FEE = "fee",
+    ADJUSTMENT = "adjustment"
+}
+/**
+ * * `pending` - Pending
+ * * `approved` - Approved
+ * * `processing` - Processing
+ * * `completed` - Completed
+ * * `rejected` - Rejected
+ * * `cancelled` - Cancelled
+ */
+declare enum CustomerWithdrawalResponseStatus {
+    PENDING = "pending",
+    APPROVED = "approved",
+    PROCESSING = "processing",
+    COMPLETED = "completed",
+    REJECTED = "rejected",
+    CANCELLED = "cancelled"
+}
+
+type enums_CustomerInvoiceDetailStatus = CustomerInvoiceDetailStatus;
+declare const enums_CustomerInvoiceDetailStatus: typeof CustomerInvoiceDetailStatus;
+type enums_CustomerTransactionResponseTransactionType = CustomerTransactionResponseTransactionType;
+declare const enums_CustomerTransactionResponseTransactionType: typeof CustomerTransactionResponseTransactionType;
+type enums_CustomerWithdrawalResponseStatus = CustomerWithdrawalResponseStatus;
+declare const enums_CustomerWithdrawalResponseStatus: typeof CustomerWithdrawalResponseStatus;
+declare namespace enums {
+  export { enums_CustomerInvoiceDetailStatus as CustomerInvoiceDetailStatus, enums_CustomerTransactionResponseTransactionType as CustomerTransactionResponseTransactionType, enums_CustomerWithdrawalResponseStatus as CustomerWithdrawalResponseStatus };
+}
+
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaginatedCustomerInvoiceDetailList {
+    /** 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<CustomerInvoiceDetail>;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface Balance {
+    balance_usd: any;
+    total_deposited: any;
+    total_withdrawn: any;
+    last_transaction_at?: string | null;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaginatedTransactionList {
+    /** 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<Transaction>;
+}
+/**
+ * Public view — no ownership data.
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaymentLinkPublic {
+    id: string;
+    title: string;
+    description: string;
+    /** Fixed amount. Null = buyer chooses. */
+    amount_usd?: any | null;
+    network: string;
+    exchange: string;
+    success_url: string;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaymentLink {
+    id: string;
+    project: string;
+    title: string;
+    description?: string;
+    /** Fixed amount. Null = buyer chooses. */
+    amount_usd?: any | null;
+    network?: string;
+    exchange?: string;
+    is_active?: boolean;
+    success_url?: string;
+    metadata?: Record<string, any>;
+    total_payments: number;
+    total_collected_usd: any;
+    pay_url: string;
+    created_at: string;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaginatedPaymentLinkList {
+    /** 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<PaymentLink>;
+}
+/**
+ * Compact response after creating an invoice.
+ *
+ * Response model (includes read-only fields).
+ */
+interface CustomerInvoiceResponse {
+    invoice_id: string;
+    amount_usd: any;
+    pay_amount: any;
+    pay_address: string;
+    coin: string;
+    network: string;
+    exchange: string;
+    status: string;
+    expires_at: string;
+}
+/**
+ * Full invoice details for customer.
+ *
+ * Response model (includes read-only fields).
+ */
+interface CustomerInvoiceDetail {
+    id: string;
+    amount_usd: any;
+    /** Unique amount with fractional suffix shown to customer */
+    pay_amount: any;
+    /** Actual amount received from exchange deposit */
+    actual_amount?: any | null;
+    pay_address: string;
+    coin: string;
+    network: string;
+    exchange: string;
+    /** * `created` - Created
+    * `waiting` - Waiting for payment
+    * `paid` - Paid
+    * `expired` - Expired
+    * `underpaid` - Underpaid
+    * `overpaid` - Overpaid
+    * `cancelled` - Cancelled */
+    status: CustomerInvoiceDetailStatus;
+    tx_id?: string | null;
+    /** Confirmation progress, e.g. "3/12" */
+    confirm_times: string;
+    description: string;
+    expires_at: string;
+    completed_at?: string | null;
+    created_at: string;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface Withdrawal {
+    id: string;
+    project: string;
+    customer: string;
+    amount_usd: any;
+    fee_usd: any;
+    final_amount_usd: any;
+    network: string;
+    wallet_address: string;
+    /** * `pending` - Pending
+    * `approved` - Approved
+    * `processing` - Processing
+    * `completed` - Completed
+    * `rejected` - Rejected
+    * `cancelled` - Cancelled */
+    status: CustomerWithdrawalResponseStatus;
+    tx_id?: string | null;
+    created_at: string;
+}
+/**
+ * Public invoice status — minimal info for polling.
+ *
+ * Response model (includes read-only fields).
+ */
+interface PublicInvoiceStatus {
+    invoice_id: string;
+    status: string;
+    confirm_times: string | null;
+    tx_id: string | null;
+    completed_at: string | null;
+}
+/**
+ * Input for customer creating a withdrawal.
+ *
+ * Request model (no read-only fields).
+ */
+interface CustomerWithdrawalCreateRequest {
+    amount_usd: any;
+    network: string;
+    wallet_address: string;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaginatedInvoiceDetailList {
+    /** 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<InvoiceDetail>;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface InvoiceDetail {
+    id: string;
+    project: string;
+    customer: string;
+    amount_usd: any;
+    /** Unique amount with fractional suffix shown to customer */
+    pay_amount: any;
+    /** Actual amount received from exchange deposit */
+    actual_amount?: any | null;
+    pay_address: string;
+    coin: string;
+    network: string;
+    exchange: string;
+    /** * `created` - Created
+    * `waiting` - Waiting for payment
+    * `paid` - Paid
+    * `expired` - Expired
+    * `underpaid` - Underpaid
+    * `overpaid` - Overpaid
+    * `cancelled` - Cancelled */
+    status: CustomerInvoiceDetailStatus;
+    tx_id?: string | null;
+    /** Confirmation progress, e.g. "3/12" */
+    confirm_times: string;
+    description: string;
+    expires_at: string;
+    completed_at?: string | null;
+    created_at: string;
+}
+/**
+ *
+ * Request model (no read-only fields).
+ */
+interface PaymentLinkCreateRequest {
+    title: string;
+    description?: string;
+    amount_usd?: any | null;
+    network?: string;
+    exchange?: string;
+    success_url?: string;
+    project_slug: string;
+    metadata?: Record<string, any>;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface CustomerWithdrawalResponse {
+    id: string;
+    amount_usd: any;
+    fee_usd: any;
+    final_amount_usd: any;
+    network: string;
+    wallet_address: string;
+    /** * `pending` - Pending
+    * `approved` - Approved
+    * `processing` - Processing
+    * `completed` - Completed
+    * `rejected` - Rejected
+    * `cancelled` - Cancelled */
+    status: CustomerWithdrawalResponseStatus;
+    tx_id?: string | null;
+    created_at: string;
+}
+/**
+ *
+ * Request model (no read-only fields).
+ */
+interface WithdrawalCreateRequest {
+    amount_usd: any;
+    network: string;
+    wallet_address: string;
+    customer_id: string;
+    project_slug: string;
+}
+/**
+ * Input for paying via a payment link.
+ *
+ * Request model (no read-only fields).
+ */
+interface PaymentLinkPayInputRequest {
+    email?: string | null;
+    name?: string;
+    amount_usd?: any | null;
+    external_id?: string | null;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface CustomerBalanceResponse {
+    balance_usd: any;
+    total_deposited: any;
+    total_withdrawn: any;
+    last_transaction_at?: string | null;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface InvoiceResponse {
+    invoice_id: string;
+    amount_usd: any;
+    pay_amount: any;
+    pay_address: string;
+    coin: string;
+    network: string;
+    exchange: string;
+    status: string;
+    expires_at: string;
+}
+/**
+ * Response for invoice status polling.
+ *
+ * Response model (includes read-only fields).
+ */
+interface InvoiceStatusResponse {
+    invoice_id: string;
+    status: string;
+    confirm_times: number;
+    actual_amount: string | null;
+    tx_id: string | null;
+    completed_at: string | null;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaginatedCustomerWithdrawalResponseList {
+    /** 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<CustomerWithdrawalResponse>;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface PaginatedCustomerTransactionResponseList {
+    /** 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<CustomerTransactionResponse>;
+}
+/**
+ *
+ * Request model (no read-only fields).
+ */
+interface InvoiceCreateRequest {
+    amount_usd: any;
+    network?: string;
+    exchange?: string | null;
+    description?: string;
+    customer_id: string;
+    project_slug: string;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface Transaction {
+    id: string;
+    /** * `deposit` - Deposit
+    * `withdrawal` - Withdrawal
+    * `refund` - Refund
+    * `fee` - Fee
+    * `adjustment` - Adjustment */
+    transaction_type: CustomerTransactionResponseTransactionType;
+    amount_usd: any;
+    balance_after: any;
+    invoice?: string | null;
+    withdrawal?: string | null;
+    description: string;
+    created_at: string;
+}
+/**
+ *
+ * Response model (includes read-only fields).
+ */
+interface CustomerTransactionResponse {
+    id: string;
+    /** * `deposit` - Deposit
+    * `withdrawal` - Withdrawal
+    * `refund` - Refund
+    * `fee` - Fee
+    * `adjustment` - Adjustment */
+    transaction_type: CustomerTransactionResponseTransactionType;
+    amount_usd: any;
+    balance_after: any;
+    invoice?: string | null;
+    withdrawal?: string | null;
+    description: string;
+    created_at: string;
+}
+
+/**
+ * API endpoints for Payments.
+ */
+declare class PaymentsPayments {
+    private client;
+    constructor(client: any);
+    /**
+     * Mixin for views that need owner-scoped queries. Supports both API key
+     * auth and JWT auth. Use in payment admin views to get projects/keys for
+     * the current owner.
+     */
+    balanceRetrieve(): Promise<Balance>;
+    /**
+     * GET /customer/balance/ — customer balance (always 200).
+     */
+    customerBalanceRetrieve(): Promise<CustomerBalanceResponse>;
+    customerInvoicesList(ordering?: string, page?: number, page_size?: number, search?: string): Promise<PaginatedCustomerInvoiceDetailList>;
+    customerInvoicesList(params?: {
+        ordering?: string;
+        page?: number;
+        page_size?: number;
+        search?: string;
+    }): Promise<PaginatedCustomerInvoiceDetailList>;
+    /**
+     * GET /customer/invoices/{id}/ — invoice detail.
+     */
+    customerInvoicesRetrieve(id: string): Promise<CustomerInvoiceDetail>;
+    /**
+     * GET /customer/profile/ — customer profile (always 200).
+     */
+    customerProfileRetrieve(): Promise<any>;
+    customerTransactionsList(ordering?: string, page?: number, page_size?: number, search?: string): Promise<PaginatedCustomerTransactionResponseList>;
+    customerTransactionsList(params?: {
+        ordering?: string;
+        page?: number;
+        page_size?: number;
+        search?: string;
+    }): Promise<PaginatedCustomerTransactionResponseList>;
+    customerWithdrawalsList(ordering?: string, page?: number, page_size?: number, search?: string): Promise<PaginatedCustomerWithdrawalResponseList>;
+    customerWithdrawalsList(params?: {
+        ordering?: string;
+        page?: number;
+        page_size?: number;
+        search?: string;
+    }): Promise<PaginatedCustomerWithdrawalResponseList>;
+    /**
+     * POST /customer/withdrawals/create/ — create withdrawal.
+     */
+    customerWithdrawalsCreateCreate(data: CustomerWithdrawalCreateRequest): Promise<CustomerWithdrawalResponse>;
+    invoicesList(ordering?: string, page?: number, page_size?: number, search?: string): Promise<PaginatedInvoiceDetailList>;
+    invoicesList(params?: {
+        ordering?: string;
+        page?: number;
+        page_size?: number;
+        search?: string;
+    }): Promise<PaginatedInvoiceDetailList>;
+    invoicesRetrieve(id: string): Promise<InvoiceDetail>;
+    invoicesCancelCreate(id: string): Promise<InvoiceDetail>;
+    invoicesStatusRetrieve(id: string): Promise<InvoiceStatusResponse>;
+    /**
+     * Mixin for views that need owner-scoped queries. Supports both API key
+     * auth and JWT auth. Use in payment admin views to get projects/keys for
+     * the current owner.
+     */
+    invoicesCreateCreate(data: InvoiceCreateRequest): Promise<InvoiceResponse>;
+    linksList(ordering?: string, page?: number, page_size?: number, search?: string): Promise<PaginatedPaymentLinkList>;
+    linksList(params?: {
+        ordering?: string;
+        page?: number;
+        page_size?: number;
+        search?: string;
+    }): Promise<PaginatedPaymentLinkList>;
+    /**
+     * Mixin for views that need owner-scoped queries. Supports both API key
+     * auth and JWT auth. Use in payment admin views to get projects/keys for
+     * the current owner.
+     */
+    linksCreateCreate(data: PaymentLinkCreateRequest): Promise<PaymentLink>;
+    /**
+     * GET /invoices/{id}/status/ — public polling endpoint.
+     */
+    publicInvoicesStatusRetrieve(id: string): Promise<PublicInvoiceStatus>;
+    /**
+     * GET /links/{id}/ — public.
+     */
+    publicLinksRetrieve(id: string): Promise<PaymentLinkPublic>;
+    /**
+     * POST /links/{id}/pay/ — public.
+     */
+    publicLinksPayCreate(id: string, data: PaymentLinkPayInputRequest): Promise<CustomerInvoiceResponse>;
+    transactionsList(ordering?: string, page?: number, page_size?: number, search?: string): Promise<PaginatedTransactionList>;
+    transactionsList(params?: {
+        ordering?: string;
+        page?: number;
+        page_size?: number;
+        search?: string;
+    }): Promise<PaginatedTransactionList>;
+    /**
+     * Mixin for views that need owner-scoped queries. Supports both API key
+     * auth and JWT auth. Use in payment admin views to get projects/keys for
+     * the current owner.
+     */
+    withdrawalsCreate(data: WithdrawalCreateRequest): Promise<Withdrawal>;
+    withdrawalsRetrieve(id: string): Promise<Withdrawal>;
+    withdrawalsCancelCreate(id: string): Promise<Withdrawal>;
+}
+
+/**
+ * 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;
+}
+
+/**
+ * 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;
+}
+/**
+ * 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;
+}
+
+/**
+ * SDKRouter 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();
+ * ```
+ */
+
+interface APIOptions {
+    /** Custom storage adapter (defaults to LocalStorageAdapter) */
+    storage?: StorageAdapter;
+    /** Custom HTTP client adapter (defaults to FetchAdapter) */
+    httpClient?: HttpClientAdapter;
+    /** Retry configuration for failed requests */
+    retryConfig?: RetryConfig;
+    /** Logger configuration */
+    loggerConfig?: Partial<LoggerConfig>;
+    /** Locale for Accept-Language header (e.g. 'en', 'ko', 'ru') */
+    locale?: string;
+}
+declare class API {
+    private baseUrl;
+    private _client;
+    private _token;
+    private _refreshToken;
+    private _locale;
+    private storage;
+    private options?;
+    payments_payments: PaymentsPayments;
+    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;
+    /**
+     * Set locale for Accept-Language header
+     * @param locale - Locale string (e.g. 'en', 'ko', 'ru') or null to clear
+     */
+    setLocale(locale: string | null): void;
+    /**
+     * Get current locale
+     */
+    getLocale(): string | null;
+    /**
+     * 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;
+}
+
+declare function createPaymentsApi(baseUrl: string): API;
+
+export { API, type Balance, type CustomerBalanceResponse, type CustomerInvoiceDetail, type CustomerInvoiceResponse, type CustomerTransactionResponse, type CustomerWithdrawalCreateRequest, type CustomerWithdrawalResponse, enums as Enums, type InvoiceCreateRequest, type InvoiceDetail, type InvoiceResponse, MemoryStorageAdapter, type PaginatedCustomerInvoiceDetailList, type PaginatedCustomerTransactionResponseList, type PaginatedCustomerWithdrawalResponseList, type PaginatedInvoiceDetailList, type PaginatedPaymentLinkList, type PaginatedTransactionList, type PaymentLink, type PaymentLinkCreateRequest, type PaymentLinkPayInputRequest, type PaymentLinkPublic, API as PaymentsAPI, type Transaction, type Withdrawal, type WithdrawalCreateRequest, createPaymentsApi };