openapi

type Operation struct {
	// ID is the operationId when the spec provides one, otherwise a synthesised
	// stable identifier. Used for logging and metrics labels.
	ID string
	// Method is the uppercase HTTP method.
	Method string
	// Path is the templated path as written in the spec, e.g.
	// "/orders/{orderId}". Metrics label on this, never the concrete URL, or
	// Prometheus cardinality grows without bound.
	Path string
	// Summary is the spec's human description, shown in dry-run output.
	Summary string
	// Params is the merged parameter set: path-item-level parameters plus
	// operation-level ones, with operation-level winning on conflict.
	Params []*openapi3.Parameter
	// RequestBody is nil for operations that take no body.
	RequestBody *openapi3.RequestBody
	// Deprecated mirrors the spec flag.
	Deprecated bool
}

type Selector interface {
	MethodAllowed(method string) bool
	PathAllowed(templatedPath string) bool
}

type Spec struct {
	Title      string
	Version    string
	Servers    []string
	Operations []*Operation
}