export interface ClientOptions {
  /** Override API base URL */
  baseUrl?: string;
  /** Request timeout in milliseconds (default: 30000) */
  timeout?: number;
}

export interface RateLimitInfo {
  limit: number | null;
  remaining: number | null;
  reset: number | null;
}

export interface RequestOptions {
  /** Request body for POST/PUT/PATCH */
  body?: Record<string, unknown>;
  /** Query parameters */
  query?: Record<string, string | number | boolean | undefined | null>;
}

/**
 * HTTP client with authentication and error handling
 */
export class Client {
  apiKey: string;
  baseUrl: string;
  timeout: number;
  rateLimit: RateLimitInfo;

  constructor(apiKey: string, options?: ClientOptions);

  /**
   * Make an HTTP request to the API
   */
  request<T = Record<string, unknown>>(method: string, path: string, options?: RequestOptions): Promise<T>;

  /**
   * GET request
   */
  get<T = Record<string, unknown>>(path: string, query?: Record<string, string | number | boolean | undefined | null>): Promise<T>;

  /**
   * POST request
   */
  post<T = Record<string, unknown>>(path: string, body?: Record<string, unknown>): Promise<T>;

  /**
   * PUT request
   */
  put<T = Record<string, unknown>>(path: string, body?: Record<string, unknown>): Promise<T>;

  /**
   * PATCH request
   */
  patch<T = Record<string, unknown>>(path: string, body?: Record<string, unknown>): Promise<T>;

  /**
   * DELETE request
   */
  delete<T = Record<string, unknown>>(path: string): Promise<T>;
}