client

type APIError struct {
	Method     string // HTTP method of the failed request
	URL        string // request URL (path + query)
	StatusCode int    // HTTP status code
	Message    string // human-readable message extracted from the body
	TypeKey    string // Azure DevOps "typeKey", when present
	Body       string // raw response body (truncated)

	// RetryAfter is the raw "Retry-After" response header value (seconds, or
	// an HTTP-date), when present. Azure DevOps sets this on HTTP 429
	// responses once a caller exceeds its TSTU rate-limit budget; surfacing
	// it lets a caller (or the LLM driving this MCP server) know to wait
	// before retrying instead of treating the failure as opaque.
	RetryAfter string
}

type Authorizer interface {
	// Authorize mutates the request to carry authentication.
	Authorize(*http.Request)
}

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

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

type List[T any] struct {
	Count int `json:"count"`
	Value []T `json:"value"`
}

type Option func(*Client)

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

type RawBody struct {
	Bytes       []byte
	ContentType string
}

type Request struct {
	// Method is the HTTP method (GET, POST, PATCH, PUT, DELETE).
	Method string

	// Path is appended to the client's base URL. A leading slash is optional.
	Path string

	// Query holds URL query parameters. The "api-version" parameter, if not
	// present here, is added from the client default when set.
	Query url.Values

	// Body, when non-nil, is JSON-encoded and sent as the request body.
	// If Body already implements io.Reader it is sent verbatim.
	Body any

	// ContentType overrides the request Content-Type. Defaults to
	// "application/json" when a body is present.
	ContentType string

	// APIVersion overrides the client's default api-version for this request.
	APIVersion string

	// Header holds extra request headers (e.g. "If-Match" for conditional
	// updates). These are applied after defaults, so they take precedence.
	Header http.Header

	// Out, when non-nil, receives the JSON-decoded response body.
	Out any
}

type Response struct {
	StatusCode int
	Header     http.Header

	// ContinuationToken is the value of the x-ms-continuationtoken header used
	// by Azure DevOps to page through large result sets. Empty when absent.
	ContinuationToken string
}