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 FieldInfo struct {
	Name             string
	Description      string
	Example          interface{}
	Required         bool
	Format           string
	ContentMediaType string // For images: image/png, image/jpeg, etc.
	Minimum          *float64
	Maximum          *float64
	MinLength        *int
	MaxLength        *int
	Pattern          string
	Enum             []interface{}
}

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

type Info struct {
	Title       string   `json:"title"`
	Description string   `json:"description,omitempty"`
	Version     string   `json:"version"`
	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"`
}

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

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

type PathItem map[string]Operation // key is method (get, post, etc.)

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 RouteInfo interface {
	GetMethod() string
	GetPath() string
	GetName() string
	GetSummary() string
	GetDescription() string
	GetTags() []string
	GetMetadata() []interface{}
	IsOpenApiEnabled() bool
	GetApiSecurityRequirements() []map[string][]string
}

type Schema struct {
	Type             string            `json:"type,omitempty"`
	Description      string            `json:"description,omitempty"`
	Format           string            `json:"format,omitempty"`
	ContentMediaType string            `json:"contentMediaType,omitempty"` // For Base64 images, e.g., image/png
	Example          interface{}       `json:"example,omitempty"`
	Properties       map[string]Schema `json:"properties,omitempty"`
	Items            *Schema           `json:"items,omitempty"` // for array
	Ref              string            `json:"$ref,omitempty"`
	Enum             []interface{}     `json:"enum,omitempty"`
	Required         []string          `json:"required,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"`
	Nullable         bool              `json:"nullable,omitempty"`
}

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

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"`           // for apiKey (query, header, cookie)
	Scheme       string `json:"scheme,omitempty"`       // for http (bearer, basic)
	BearerFormat string `json:"bearerFormat,omitempty"` // for http bearer
}

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

type Specification 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"`
	Security   []map[string][]string `json:"security,omitempty"`
	Tags       []Tag                 `json:"tags,omitempty"`
}

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