openapi

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

type Contact struct {
	Name  string `json:"name,omitempty"`
	URL   string `json:"url,omitempty"`
	Email string `json:"email,omitempty"`
}

type FlowConfig struct {
	AuthorizationURL string            `json:"authorizationUrl,omitempty"`
	TokenURL         string            `json:"tokenUrl,omitempty"`
	RefreshURL       string            `json:"refreshUrl,omitempty"`
	Scopes           map[string]string `json:"scopes"`
}

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

type GeneratorConfig struct {
	Title       string
	Description string
	Version     string
	Servers     []Server
	Contact     *Contact
	License     *License

	// SecuritySchemes to include in components.
	SecuritySchemes map[string]*SecurityScheme

	// GlobalSecurity applied to all operations by default.
	GlobalSecurity []map[string][]string

	// ExcludePatterns defines path prefixes to skip (e.g. "/_").
	ExcludePatterns []string

	// TagDescriptions allows adding descriptions to tags.
	TagDescriptions map[string]string

	// BasePath prefix stripped from paths.
	BasePath string
}

type Info struct {
	Title          string   `json:"title"`
	Description    string   `json:"description,omitempty"`
	Version        string   `json:"version"`
	TermsOfService string   `json:"termsOfService,omitempty"`
	Contact        *Contact `json:"contact,omitempty"`
	License        *License `json:"license,omitempty"`
}

type License struct {
	Name string `json:"name"`
	URL  string `json:"url,omitempty"`
}

type MediaType struct {
	Schema *Schema `json:"schema,omitempty"`
}

type OAuthFlow struct {
	Implicit          *FlowConfig `json:"implicit,omitempty"`
	Password          *FlowConfig `json:"password,omitempty"`
	ClientCredentials *FlowConfig `json:"clientCredentials,omitempty"`
	AuthorizationCode *FlowConfig `json:"authorizationCode,omitempty"`
}

type Operation struct {
	OperationID string                `json:"operationId,omitempty"`
	Summary     string                `json:"summary,omitempty"`
	Description string                `json:"description,omitempty"`
	Tags        []string              `json:"tags,omitempty"`
	Parameters  []Parameter           `json:"parameters,omitempty"`
	RequestBody *RequestBody          `json:"requestBody,omitempty"`
	Responses   map[string]*Response  `json:"responses"`
	Security    []map[string][]string `json:"security,omitempty"`
	Deprecated  bool                  `json:"deprecated,omitempty"`
}

type Parameter struct {
	Name        string  `json:"name"`
	In          string  `json:"in"` // query, header, path, cookie
	Description string  `json:"description,omitempty"`
	Required    bool    `json:"required,omitempty"`
	Schema      *Schema `json:"schema,omitempty"`
}

type PathItem struct {
	Get     *Operation `json:"get,omitempty"`
	Post    *Operation `json:"post,omitempty"`
	Put     *Operation `json:"put,omitempty"`
	Patch   *Operation `json:"patch,omitempty"`
	Delete  *Operation `json:"delete,omitempty"`
	Head    *Operation `json:"head,omitempty"`
	Options *Operation `json:"options,omitempty"`
}

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

type PluginConfig struct {
	// Path prefix for the docs UI (default: "/_docs").
	Path string

	// Generator config for OpenAPI spec generation.
	Generator GeneratorConfig

	// Enabled controls whether docs are served (default true).
	Enabled bool

	// CustomCSS is injected into the Swagger UI page.
	CustomCSS string

	// HideModels hides the Models section in Swagger UI.
	HideModels bool

	// DeepLinking enables deep linking to operations.
	DeepLinking bool

	// TryItOutEnabled enables the "Try it out" feature by default.
	TryItOutEnabled bool
}

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

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

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

type Schema struct {
	Type        string             `json:"type,omitempty"`
	Format      string             `json:"format,omitempty"`
	Description string             `json:"description,omitempty"`
	Properties  map[string]*Schema `json:"properties,omitempty"`
	Items       *Schema            `json:"items,omitempty"`
	Required    []string           `json:"required,omitempty"`
	Ref         string             `json:"$ref,omitempty"`
	Enum        []any              `json:"enum,omitempty"`
	Example     any                `json:"example,omitempty"`
	Nullable    bool               `json:"nullable,omitempty"`
	OneOf       []*Schema          `json:"oneOf,omitempty"`
	AllOf       []*Schema          `json:"allOf,omitempty"`
	AnyOf       []*Schema          `json:"anyOf,omitempty"`
	Default     any                `json:"default,omitempty"`
	Minimum     *float64           `json:"minimum,omitempty"`
	Maximum     *float64           `json:"maximum,omitempty"`
	MinLength   *int               `json:"minLength,omitempty"`
	MaxLength   *int               `json:"maxLength,omitempty"`
	Pattern     string             `json:"pattern,omitempty"`
}

type SecurityScheme struct {
	Type         string     `json:"type"` // apiKey, http, oauth2, openIdConnect
	Description  string     `json:"description,omitempty"`
	Name         string     `json:"name,omitempty"` // for apiKey
	In           string     `json:"in,omitempty"`   // header, query, cookie
	Scheme       string     `json:"scheme,omitempty"`
	BearerFormat string     `json:"bearerFormat,omitempty"`
	Flows        *OAuthFlow `json:"flows,omitempty"`
}

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

type Spec struct {
	OpenAPI    string                `json:"openapi"`
	Info       Info                  `json:"info"`
	Servers    []Server              `json:"servers,omitempty"`
	Paths      map[string]*PathItem  `json:"paths"`
	Components *Components           `json:"components,omitempty"`
	Tags       []Tag                 `json:"tags,omitempty"`
	Security   []map[string][]string `json:"security,omitempty"`
}

type Tag struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
}