openapi

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

type ApiVersions []ApiVersion

type Body struct {
	MediaType string
	Fields    []Field
}

type Field struct {
	Path        string
	Type        string
	Required    bool
	Description string
}

type MediaType struct {
	Name string
	// Kind is empty for a type of no meshObject.
	Kind string
	// ApiVersion is zero for a type of no version, such as application/json.
	ApiVersion ApiVersion
}

type Operation struct {
	Method       string
	PathTemplate PathTemplate
	// Kind is the meshObject kind below whose path the operation is, such as meshBuildingBlock, or
	// empty outside the path of a kind.
	Kind string
	// Action names the operation within its kind, as a command of the CLI would: list, show,
	// create, update, delete, or the path below the kind's object, such as trigger-run.
	Action string
	// MediaTypes are those of the request body and of every response, each once.
	MediaTypes []MediaType
	// contains filtered or unexported fields
}

type OperationDoc struct {
	Summary       string
	Description   string
	Parameters    []Parameter
	RequestBodies []Body
	Responses     []Response
}

type Parameter struct {
	Name, In    string
	Required    bool
	Type        string
	Description string
	// PathKey names the metadata field that fills a path parameter, such as metadata.uuid, or a
	// template of several in braces, such as {metadata.ownedByWorkspace}.{metadata.name}.
	PathKey string
}

type PathTemplate string

type Response struct {
	Status, Description string
	Bodies              []Body
}

type Selector struct {
	// Kind and Action select by Operation.Kind and Operation.Action. Kind is matched in any case.
	Kind   string
	Action string
	// Method is empty for every method.
	Method string
	// Path is a request path such as /api/meshobjects/meshtenants/<uuid>, or empty for every path.
	Path string
	// ApiVersion is zero for the latest version each operation offers.
	ApiVersion ApiVersion
}

type Spec struct {
	Operations []Operation
	// contains filtered or unexported fields
}