http

type APIError struct {
	// Service is the name of the integration (e.g., "jira", "gitlab").
	Service string

	// StatusCode is the HTTP status code returned.
	StatusCode int

	// Message is the error message from the API.
	Message string

	// Endpoint is the API endpoint that was called.
	Endpoint string

	// RequestID is the request ID for debugging (if available).
	RequestID string
}

type AuthError struct {
	// Service is the integration that failed authentication.
	Service string

	// Reason explains why authentication failed.
	Reason string
}

type Client struct {
	// contains filtered or unexported fields
}

type ClientConfig struct {
	Client        *http.Client
	BaseURL       string
	ServiceName   string
	MaxRetries    int
	RetryWait     time.Duration
	BeforeRequest func(req *http.Request)
}

type PageFetcher[T any] func(ctx context.Context, page int) (items []T, hasMore bool, err error)

type PageIterator[T any] struct {
	// contains filtered or unexported fields
}

type RateLimitError struct {
	// Service is the integration that rate limited.
	Service string

	// RetryAfter is how long to wait before retrying.
	RetryAfter time.Duration

	// Limit is the rate limit that was exceeded (if known).
	Limit int

	// Remaining is how many requests remain (usually 0).
	Remaining int
}

type ValidationError struct {
	// Service is the integration that rejected the request.
	Service string

	// Field is the field that failed validation.
	Field string

	// Message explains the validation failure.
	Message string
}