openapi

type Document struct {
	Title      string
	APIVersion string
	Servers    []Server
	Operations []Operation
	// Warnings collects non-fatal notes from parsing, such as operations skipped
	// because they consume formData. Callers surface these to the operator.
	Warnings []string
}

type Operation struct {
	Method      string // upper-case: GET, POST, ...
	Path        string // template form, e.g. /pets/{petId}
	OperationID string
	Summary     string
	Description string
	Tags        []string
	Parameters  []Parameter
	RequestBody *RequestBody
}

type Parameter struct {
	Name        string
	In          string // path | query | header | cookie
	Description string
	Required    bool
	Schema      map[string]any // JSON-schema fragment, $refs inlined
}

type RequestBody struct {
	Description string
	Required    bool
	Schema      map[string]any // JSON-schema fragment, $refs inlined
}

type Server struct {
	URL         string
	Description string
	Variables   map[string]string
}