openapi

type APISpec struct {
	Title   string     `json:"title"`
	Version string     `json:"version"`
	Paths   []PathItem `json:"paths"`
}

type GETOperation struct {
	Path        string
	OperationID string
	Parameters  []Parameter
}

type Loader interface {
	Load(ctx context.Context, ref string) (APISpec, error)
}

type NestedSpec struct {
	Title   string    `json:"title"`
	Version string    `json:"version"`
	Paths   *PathNode `json:"paths"`
}

type Operation struct {
	OperationID string      `json:"operationId"`
	Parameters  []Parameter `json:"parameters,omitempty"`
}

type OperationSpec struct {
	ID           string          `json:"id"`
	PathTemplate string          `json:"pathTemplate"`
	PathFormat   string          `json:"pathFormat"`
	PathArgNames []string        `json:"pathArgNames"`
	QueryParams  []ParameterSpec `json:"queryParams"`
	HeaderParams []ParameterSpec `json:"headerParams"`
}

type Parameter struct {
	Name     string `json:"name"`
	In       string `json:"in"`
	Required bool   `json:"required"`
}

type ParameterSpec struct {
	Name     string `json:"name"`
	Required bool   `json:"required"`
}

type Parser interface {
	Parse(ctx context.Context, spec string) (APISpec, error)
}

type PathItem struct {
	Path       string      `json:"path"`
	Parameters []Parameter `json:"parameters,omitempty"`
	Get        *Operation  `json:"get,omitempty"`
}

type PathNode struct {
	Operation *OperationSpec       `json:"operation,omitempty"`
	Children  map[string]*PathNode `json:"children,omitempty"`
}