scanner

type Config struct {
	// Pattern is the package pattern to scan (e.g., "./...", "./api/...")
	Pattern string
	// Dir is the directory path to scan from
	Dir string
	// IgnorePaths contains path patterns to exclude during scanning
	IgnorePaths []string
}

type ContactInfo struct {
	Name  string
	URL   string
	Email string
}

type DiscriminatorInfo struct {
	PropertyName string            // The property name that holds the discriminating value
	Mapping      map[string]string // Maps discriminator values to schema names
}

type EmbeddedTypeInfo struct {
	Name  string // Type name (e.g., "pagination.Pagination")
	Index int    // Position in the struct where it was declared
}

type EnumInfo struct {
	TypeName    string
	BaseType    string
	Example     any
	Values      map[string]any
	Description string
	SourceFile  string
}

type ExternalDocsInfo struct {
	Description string
	URL         string
}

type FieldInfo struct {
	Name             string
	Type             string
	Description      string
	Default          string
	Example          string
	Required         bool
	Nullable         bool
	Validations      map[string]string
	Enum             string
	Tags             map[string]string
	IsArray          bool
	IsPointer        bool
	IsMap            bool
	MapKeyType       string
	IsRequestBody    bool
	In               string // Parameter location: query, path, header, cookie, body
	InlineStruct     *StructInfo
	IsInlineStruct   bool
	HasOmitempty     bool
	ExplicitRequired bool
	ExplicitOptional bool
	Index            int // Position in the original struct declaration (for ordering)
}

type LicenseInfo struct {
	Name string
	URL  string
}

type MetaInfo struct {
	Title           string
	Description     string
	Version         string
	TermsOfService  string
	Contact         *ContactInfo
	License         *LicenseInfo
	Host            string
	BasePath        string
	ExternalDocs    *ExternalDocsInfo
	Tags            []*TagInfo
	SecuritySchemes map[string]*SecuritySchemeInfo
	Consumes        []string
	Produces        []string
	Schemes         []string
	Specs           []string // Multi-spec: which specs this meta belongs to (empty = general/default)
}

type OAuthFlowInfo struct {
	AuthorizationURL string
	TokenURL         string
	RefreshURL       string
	Scopes           map[string]string
}

type OAuthFlowsInfo struct {
	Implicit          *OAuthFlowInfo
	Password          *OAuthFlowInfo
	ClientCredentials *OAuthFlowInfo
	AuthorizationCode *OAuthFlowInfo
}

type Option func(*Config)

type ResponseInfo struct {
	StatusCode  string
	Type        string
	Description string
	IsArray     bool
	IsMap       bool
	MapKeyType  string
}

type RouteInfo struct {
	Method            string
	Path              string
	Tags              []string
	OperationID       string
	Summary           string
	Description       string
	Deprecated        bool
	Responses         []*ResponseInfo
	Security          []string
	Consumes          []string
	Produces          []string
	IgnoredParameters []string
	SourceFile        string
	Specs             []string // Multi-spec: which specs this route belongs to (empty = default spec)
}

type Scanner struct {

	// Extracted data
	Meta    *MetaInfo   // General meta (first meta without spec: directive)
	Metas   []*MetaInfo // All metas including spec-specific ones
	Enums   map[string]*EnumInfo
	Structs map[string]*StructInfo
	Routes  map[string]*RouteInfo

	// Type mappings
	TypeToEnum   map[string]string // Go type name -> enum name
	TypeToStruct map[string]string // Go type name -> struct name
	TypeAliases  map[string]string // alias type name -> original type name (e.g., "model.FeeType" -> "workspace.FeeType")

	// Source file mappings
	EnumSources   map[string]string // enum name -> source file
	StructSources map[string]string // struct name -> source file
	RouteSources  map[string]string // operation ID -> source file
	// contains filtered or unexported fields
}

type SecuritySchemeInfo struct {
	Type             string // apiKey, http, oauth2, openIdConnect
	Description      string
	Name             string // For apiKey
	In               string // For apiKey: query, header, cookie
	Scheme           string // For http: bearer, basic
	BearerFormat     string // For http bearer
	Flows            *OAuthFlowsInfo
	OpenIdConnectUrl string
}

type StructInfo struct {
	Name              string
	Fields            []*FieldInfo
	EmbeddedTypes     []string            // Embedded types that need to be resolved (e.g., "pagination.Pagination")
	EmbeddedTypeInfos []*EmbeddedTypeInfo // Embedded types with position information
	Description       string
	IsParameter       bool
	IsModel           bool
	SourceFile        string
	OneOf             []string // Legacy: inline oneOf references from "oneOf:" directive
	AllOf             []string // Legacy: inline allOf references from "allOf:" directive
	AnyOf             []string // Legacy: inline anyOf references from "anyOf:" directive
	Specs             []string // Multi-spec: which specs this model belongs to (empty = all specs)

	// New oneOf/anyOf model support (swagger:oneOf / swagger:anyOf)
	IsOneOfModel  bool               // True if struct is marked with swagger:oneOf
	IsAnyOfModel  bool               // True if struct is marked with swagger:anyOf
	OneOfOptions  []string           // Types marked with swagger:oneOfOption
	AnyOfOptions  []string           // Types marked with swagger:anyOfOption
	Discriminator *DiscriminatorInfo // Discriminator configuration for polymorphism
}

type TagInfo struct {
	Name         string
	Description  string
	ExternalDocs *ExternalDocsInfo
}