openapi

type Components struct {
	Schemas         map[string]*jsonschema.Schema `json:"schemas,omitzero"`
	SecuritySchemes map[string]*SecurityScheme    `json:"securitySchemes,omitzero"`
}

type Doc struct {
	OpenAPI    string                           `json:"openapi"`
	Info       Info                             `json:"info"`
	Servers    []*Server                        `json:"servers,omitzero"`
	Paths      map[string]map[string]*Operation `json:"paths,omitzero"`
	Components *Components                      `json:"components,omitzero"`
}

type Endpoint struct {
	Type           string
	Name           string
	Route          string
	Summary        string
	Description    string
	InputArgs      any
	OutputArgs     any
	Method         string
	RequiredClaims string
}

type Info struct {
	Title       string `json:"title"`
	Description string `json:"description,omitzero"`
	Version     string `json:"version,omitzero"`
}

type MediaType struct {
	Description string             `json:"description,omitzero"`
	Schema      *jsonschema.Schema `json:"schema,omitzero"`
}

type Operation struct {
	Summary      string                 `json:"summary"`
	Description  string                 `json:"description,omitzero"`
	XFeatureType string                 `json:"x-feature-type,omitzero"`
	Parameters   []*Parameter           `json:"parameters,omitzero"`
	RequestBody  *RequestBody           `json:"requestBody,omitzero"`
	Responses    map[string]*Response   `json:"responses,omitzero"`
	Security     []*SecurityRequirement `json:"security,omitzero"`
}

type Parameter struct {
	Name        string             `json:"name"`
	In          string             `json:"in"`
	Description string             `json:"description,omitzero"`
	Schema      *jsonschema.Schema `json:"schema,omitzero"`
	Style       string             `json:"style,omitzero"`
	Explode     bool               `json:"explode,omitzero"`
	Required    bool               `json:"required,omitzero"`
}

type RequestBody struct {
	Description string                `json:"description,omitzero"`
	Required    bool                  `json:"required,omitzero"`
	Content     map[string]*MediaType `json:"content,omitzero"`
}

type Response struct {
	Description string                `json:"description,omitzero"`
	Content     map[string]*MediaType `json:"content,omitzero"`
}

type SecurityRequirement map[string][]string

type SecurityScheme struct {
	Type         string `json:"type,omitzero"`
	Description  string `json:"description,omitzero"`
	Scheme       string `json:"scheme,omitzero"`
	BearerFormat string `json:"bearerFormat,omitzero"`
}

type Server struct {
	URL         string `json:"url"`
	Description string `json:"description,omitzero"`
}

type Service struct {
	ServiceName string
	Description string
	Version     int
	Endpoints   []*Endpoint
	RemoteURI   string
}