/**
 * Segment client types.
 */

import type { BaseIntegrationClient } from "../../types.js";
import type { SupportsApiRequest } from "../base/index.js";

/**
 * Segment client for API interactions.
 *
 * Provides generic API request method for interacting with Segment's API.
 * Use apiRequest() to make calls to any Segment API endpoint.
 *
 * @example
 * ```typescript
 * // Declare in api(): integrations: { segment: segment(INTEGRATION_ID) }
 * // In run(), access via ctx.integrations.segment
 *
 * // Make API requests
 * const ResponseSchema = z.object({
 *   // Define your response schema
 * });
 *
 * const result = await segment.apiRequest(
 *   {
 *     method: 'POST',
 *     path: '/v1/track',
 *   },
 *   { response: ResponseSchema }
 * );
 * ```
 */
export interface SegmentClient
  extends BaseIntegrationClient, SupportsApiRequest {
  // apiRequest() method inherited from SupportsApiRequest
}