parser

type GlobalMetadata struct {
	GlobalTitle       string
	GlobalVersion     string
	GlobalDescription string
}

type Header struct {
	StatusCode  string
	Name        string
	Type        string
	Required    bool
	Description string
}

type Parameter struct {
	Name        string
	In          string // path, query, header, cookie
	Required    bool
	Schema      string // string, integer, etc.
	Description string
}

type RequestBody struct {
	Model       string
	Required    bool
	MediaType   string // Default: application/json
	Description string
}

type Response struct {
	Model       string
	MediaType   string
	StatusCode  string
	Description string
}

type RouteDoc struct {
	Summary         string
	Description     string
	Method          string
	Path            string
	Tags            []string
	Params          []Parameter
	RequestBody     *RequestBody
	Responses       map[string]Response
	Headers         []Header
	SecuritySchemes []SecurityScheme
	Deprecated      bool
}

type SecurityScheme struct {
	Name       string // e.g., "ApiKeyAuth", "BearerAuth"
	HeaderName string // For ApiKeyAuth: custom header name (optional)
}