generator

type AliasData struct {
	Comment    string
	TypeName   string
	TargetType string
	IsDefined  bool // true for defined type, false for type alias (=)
}

type AllOfData struct {
	Comment       string
	TypeName      string
	EmbeddedTypes []string
	Fields        []FieldData
}

type ClientFileData struct {
	Header           HeaderData
	DefaultUserAgent string
	Methods          []ClientMethodData
	ParamsStructs    []ParamsStructData
}

type ClientMethodData struct {
	Comment         string
	MethodName      string
	Params          string
	ResponseType    string
	PathTemplate    string
	PathArgs        []string
	HasQueryParams  bool
	QueryParamsType string
	HasBody         bool
	BodyType        string
	ContentType     string
	MethodBody      string // Complex body handled in Go
}

type CredentialGenerator struct {
	// PackageName is the Go package name for generated code.
	PackageName string
}

type EnumData struct {
	Comment  string
	TypeName string
	BaseType string
	Values   []EnumValueData
}

type EnumValueData struct {
	ConstName string
	Type      string
	Value     string
}

type FieldData struct {
	Comment string
	Name    string
	Type    string
	Tags    string
}

type FileGroup struct {
	// Name is the group name (e.g., "users", "mail").
	// Used for file naming: client_users.go, types_mail.go, etc.
	Name string

	// DisplayName is the human-readable name for documentation.
	DisplayName string

	// Operations contains the operation IDs in this group.
	Operations []string

	// Types contains the type names specific to this group.
	Types []string

	// IsShared is true if this group represents shared types (types.go).
	IsShared bool

	// EstimatedLines is the estimated lines of code for this group.
	EstimatedLines int

	// Tag is the original tag name (if grouped by tag).
	Tag string

	// PathPrefix is the path prefix (if grouped by path).
	PathPrefix string
}

type FileSplitter struct {
	// MaxLinesPerFile is the estimated maximum lines per file before splitting.
	// Default: 2000, 0 = no limit
	MaxLinesPerFile int

	// MaxTypesPerFile is the maximum types per file before splitting.
	// Default: 200, 0 = no limit
	MaxTypesPerFile int

	// MaxOperationsPerFile is the maximum operations per file before splitting.
	// Default: 100, 0 = no limit
	MaxOperationsPerFile int

	// SplitByTag enables splitting by operation tags.
	// Default: true
	SplitByTag bool

	// SplitByPathPrefix enables splitting by path prefix as a fallback.
	// Default: true
	SplitByPathPrefix bool
}

type GenerateIssue = issues.Issue

type GenerateResult struct {
	// Files contains all generated files
	Files []GeneratedFile
	// SourceVersion is the detected source OAS version string
	SourceVersion string
	// SourceOASVersion is the enumerated source OAS version
	SourceOASVersion parser.OASVersion
	// SourceFormat is the format of the source file (JSON or YAML)
	SourceFormat parser.SourceFormat
	// PackageName is the Go package name used in generation
	PackageName string
	// Issues contains all generation issues grouped by severity
	Issues []GenerateIssue
	// InfoCount is the total number of info messages
	InfoCount int
	// WarningCount is the total number of warnings
	WarningCount int
	// CriticalCount is the total number of critical issues
	CriticalCount int
	// Success is true if generation completed without critical issues
	Success bool
	// LoadTime is the time taken to load the source data
	LoadTime time.Duration
	// GenerateTime is the time taken to generate code
	GenerateTime time.Duration
	// SourceSize is the size of the source data in bytes
	SourceSize int64
	// Stats contains statistical information about the source document
	Stats parser.DocumentStats
	// GeneratedTypes is the count of types generated
	GeneratedTypes int
	// GeneratedOperations is the count of operations generated
	GeneratedOperations int
}

type GeneratedFile struct {
	// Name is the file name (e.g., "types.go", "client.go")
	Name string
	// Content is the generated Go source code
	Content []byte
}

type GeneratedFileSummary struct {
	// FileName is the name of the generated file.
	FileName string

	// Description describes what the file contains.
	Description string

	// LineCount is the number of lines in the file (optional).
	LineCount int
}

type Generator struct {
	// PackageName is the Go package name for generated code
	// If empty, defaults to "api"
	PackageName string

	// GenerateClient enables HTTP client generation
	GenerateClient bool

	// GenerateServer enables server interface generation
	GenerateServer bool

	// GenerateTypes enables schema/model type generation
	// This is always true when either client or server generation is enabled
	GenerateTypes bool

	// UsePointers uses pointer types for optional fields
	// Default: true
	UsePointers bool

	// IncludeValidation adds validation tags to generated structs
	// Default: true
	IncludeValidation bool

	// StrictMode causes generation to fail on any issues (even warnings)
	StrictMode bool

	// IncludeInfo determines whether to include informational messages
	IncludeInfo bool

	// UserAgent is the User-Agent string used when fetching URLs
	UserAgent string

	// MaxLinesPerFile is the maximum lines per generated file before splitting.
	// When exceeded, files are split by tag or path prefix.
	// Default: 2000, 0 = no limit
	MaxLinesPerFile int

	// MaxTypesPerFile is the maximum types per generated file before splitting.
	// Default: 200, 0 = no limit
	MaxTypesPerFile int

	// MaxOperationsPerFile is the maximum operations per generated file before splitting.
	// Default: 100, 0 = no limit
	MaxOperationsPerFile int

	// SplitByTag enables splitting files by operation tag.
	// Default: true
	SplitByTag bool

	// SplitByPathPrefix enables splitting files by path prefix as a fallback
	// when tags are not available.
	// Default: true
	SplitByPathPrefix bool

	// GenerateSecurity enables security helper generation.
	// When true, generates ClientOption functions for each security scheme.
	// Default: true when GenerateClient is true
	GenerateSecurity bool

	// GenerateOAuth2Flows enables OAuth2 token flow helper generation.
	// Generates token acquisition, refresh, and authorization code exchange.
	// Default: false
	GenerateOAuth2Flows bool

	// GenerateCredentialMgmt enables credential management interface generation.
	// Generates CredentialProvider interface and built-in implementations.
	// Default: false
	GenerateCredentialMgmt bool

	// GenerateSecurityEnforce enables security enforcement code generation.
	// Generates per-operation security requirements and validation middleware.
	// Default: false
	GenerateSecurityEnforce bool

	// GenerateOIDCDiscovery enables OpenID Connect discovery client generation.
	// Generates OIDC discovery client and auto-configuration helpers.
	// Default: false
	GenerateOIDCDiscovery bool

	// GenerateReadme enables README.md generation in the output directory.
	// The README includes regeneration commands, file listing, and usage examples.
	// Default: true
	GenerateReadme bool
}

type GeneratorConfigSummary struct {
	// GenerateTypes indicates if types were generated.
	GenerateTypes bool

	// GenerateClient indicates if client code was generated.
	GenerateClient bool

	// GenerateSecurity indicates if security helpers were generated.
	GenerateSecurity bool

	// GenerateOAuth2Flows indicates if OAuth2 flow helpers were generated.
	GenerateOAuth2Flows bool

	// GenerateCredentialMgmt indicates if credential management was generated.
	GenerateCredentialMgmt bool

	// GenerateSecurityEnforce indicates if security enforcement was generated.
	GenerateSecurityEnforce bool

	// GenerateOIDCDiscovery indicates if OIDC discovery was generated.
	GenerateOIDCDiscovery bool
}

type HeaderData struct {
	PackageName string
	Imports     []string
	Comment     string // Optional file-level comment
}

type OAuth2Generator struct {
	// Name is the security scheme name (used for function naming).
	Name string

	// Flows contains the OAuth2 flow configurations.
	Flows *parser.OAuthFlows

	// OAS2Flow is the OAS 2.0 style flow type.
	OAS2Flow string

	// OAS2AuthURL is the OAS 2.0 style authorization URL.
	OAS2AuthURL string

	// OAS2TokenURL is the OAS 2.0 style token URL.
	OAS2TokenURL string

	// OAS2Scopes is the OAS 2.0 style scopes.
	OAS2Scopes map[string]string
}

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

type OAuthFlows struct {
	Implicit          *OAuthFlow
	Password          *OAuthFlow
	ClientCredentials *OAuthFlow
	AuthorizationCode *OAuthFlow
}

type OIDCDiscoveryGenerator struct {
	// PackageName is the Go package name for generated code.
	PackageName string
}

type OneOfData struct {
	Comment               string
	TypeName              string
	Discriminator         string
	DiscriminatorField    string
	DiscriminatorJSONName string
	Variants              []OneOfVariant
	HasUnmarshal          bool
	UnmarshalCases        []UnmarshalCase
}

type OneOfVariant struct {
	Name string
	Type string
}

type OperationInfo struct {
	// OperationID is the unique operation identifier.
	OperationID string

	// Path is the URL path for the operation.
	Path string

	// Method is the HTTP method (GET, POST, etc.).
	Method string

	// Tags are the tags associated with this operation.
	Tags []string

	// ReferencedTypes contains the type names referenced by this operation.
	ReferencedTypes []string

	// EstimatedLines is the estimated lines of generated code.
	EstimatedLines int
}

type OperationSecurityRequirements map[string][]parser.SecurityRequirement

type Option func(*generateConfig) error

type ParamsStructData struct {
	MethodName string
	Fields     []FieldData
}

type ReadmeContext struct {
	// Timestamp is when the code was generated.
	Timestamp time.Time

	// OastoolsVersion is the version of oastools used.
	OastoolsVersion string

	// SourcePath is the path to the source OAS file(s).
	SourcePath string

	// OASVersion is the OpenAPI version (e.g., "3.0.3", "2.0").
	OASVersion string

	// APITitle is the title from the OAS info section.
	APITitle string

	// APIVersion is the version from the OAS info section.
	APIVersion string

	// APIDescription is the description from the OAS info section.
	APIDescription string

	// CLICommand is the command used to generate this code.
	CLICommand string

	// PackageName is the Go package name.
	PackageName string

	// GeneratedFiles lists all generated files with descriptions.
	GeneratedFiles []GeneratedFileSummary

	// SecuritySchemes describes the security schemes in the API.
	SecuritySchemes []SecuritySchemeSummary

	// SplitInfo contains information about file splitting (if applicable).
	SplitInfo *SplitSummary

	// Config contains the generator configuration used.
	Config *GeneratorConfigSummary
}

type ReadmeGenerator struct{}

type RequestTypeData struct {
	MethodName string
	Fields     []FieldData
}

type SecurityEnforceGenerator struct {
	// PackageName is the Go package name for generated code.
	PackageName string
}

type SecurityHelperGenerator struct {
	// PackageName is the Go package name for generated code.
	PackageName string
}

type SecurityScheme struct {
	Type             string
	Description      string
	Name             string
	In               string
	Scheme           string
	BearerFormat     string
	Flows            *OAuthFlows
	OpenIDConnectURL string
	Flow             string // OAS 2.0
}

type SecuritySchemeInfo struct {
	Name         string
	Type         string
	Scheme       string // For HTTP auth
	In           string // For API key
	Description  string
	Scopes       []string // For OAuth2
	FlowTypes    []string // For OAuth2
	DiscoveryURL string   // For OpenID Connect
}

type SecuritySchemeSummary struct {
	// Name is the security scheme name.
	Name string

	// Type is the security type (apiKey, http, oauth2, openIdConnect).
	Type string

	// Description is the security scheme description.
	Description string

	// Location is where the credential is sent (header, query, cookie) for apiKey.
	Location string

	// Scheme is the HTTP scheme (basic, bearer) for http type.
	Scheme string

	// Flows lists the OAuth2 flows available.
	Flows []string

	// OpenIDConnectURL is the OIDC discovery URL.
	OpenIDConnectURL string
}

type ServerFileData struct {
	Header       HeaderData
	Methods      []ServerMethodData
	RequestTypes []RequestTypeData
}

type ServerMethodData struct {
	Comment      string
	MethodName   string
	ResponseType string
}

type Severity = severity.Severity

type SplitPlan struct {
	// NeedsSplit is true if the document should be split into multiple files.
	NeedsSplit bool

	// Groups contains the file groups to generate.
	Groups []FileGroup

	// SharedTypes contains type names that are used across multiple groups
	// and should be placed in the main types.go file.
	SharedTypes []string

	// TotalOperations is the total number of operations in the document.
	TotalOperations int

	// TotalTypes is the total number of types/schemas in the document.
	TotalTypes int

	// EstimatedLines is the estimated total lines of generated code.
	EstimatedLines int
}

type SplitSummary struct {
	// WasSplit indicates if files were split.
	WasSplit bool

	// Strategy describes how files were split (by tag, by path prefix).
	Strategy string

	// Groups lists the split groups.
	Groups []string

	// SharedTypesFile is the name of the shared types file (if any).
	SharedTypesFile string
}

type StructData struct {
	Comment             string
	TypeName            string
	OriginalName        string
	Fields              []FieldData
	HasAdditionalProps  bool
	AdditionalPropsType string
}

type TypeDefinition struct {
	Kind string // "struct", "enum", "alias", "allof", "oneof"

	Struct *StructData
	Enum   *EnumData
	Alias  *AliasData
	AllOf  *AllOfData
	OneOf  *OneOfData
}

type TypeInfo struct {
	// Name is the type name.
	Name string

	// ReferencedBy contains operation IDs that reference this type.
	ReferencedBy []string

	// References contains type names this type references.
	References []string

	// EstimatedLines is the estimated lines of generated code.
	EstimatedLines int
}

type TypesFileData struct {
	Header HeaderData
	Types  []TypeDefinition
}

type UnmarshalCase struct {
	Value    string
	TypeName string
}