import { CliError } from "../utils/errors.js";
/** Raised when Stripe returns a non-2xx status or the API key is missing/invalid. */
export declare class StripeError extends CliError {
    readonly status: number;
    constructor(status: number, message: string, data?: Record<string, unknown>);
}
/** Query parameter value — Stripe form-encodes nested keys like `created[gte]` and `expand[]`. */
export type StripeParams = Record<string, string | number | undefined>;
export declare class StripeClient {
    private readonly apiKey;
    private readonly baseUrl;
    constructor(apiKey: string, baseUrl?: string);
    /** GET a single Stripe resource (e.g. `account`, `payouts/po_X`). */
    get<T = unknown>(path: string, params?: StripeParams): Promise<T>;
    /**
     * GET every page of a Stripe list endpoint, following `has_more` via
     * `starting_after`. Returns the concatenated `data` arrays.
     */
    listAll<T extends {
        id: string;
    }>(path: string, params?: StripeParams): Promise<T[]>;
}
/** Resolve STRIPE_API_KEY and return a StripeClient, or throw a clear auth error. */
export declare function getStripeClient(env?: NodeJS.ProcessEnv): StripeClient;