openapi

type FromPulseGenerator struct {
	// OpenAPIVersion specifies the target OpenAPI version (3.0 or 3.1)
	OpenAPIVersion string

	// Strict mode treats warnings as errors
	Strict bool
	// contains filtered or unexported fields
}

type GeneratedSpec struct {
	// Version is the OpenAPI version (3.0 or 3.1)
	Version string
	// T is the OpenAPI document
	T *openapi3.T
}

type Info struct {
	Title       string
	Description string
	Version     string
}

type OpenAPIType struct {
	// Type is the OpenAPI type (e.g., "string", "integer", "number", "boolean", "array", "object")
	Type string
	// Format is the OpenAPI format (e.g., "int32", "int64", "float", "double")
	Format string
	// Nullable indicates if the type is nullable (OpenAPI 3.1)
	Nullable bool
}

type Operation struct {
	ID          string
	Method      string
	Path        string
	Tag         string
	Summary     string
	Description string
	Tags        []string
	Parameters  []*Parameter
	RequestBody *SchemaInfo
	Responses   map[string]*Response
}

type Parameter struct {
	Name        string
	In          string // "path", "query", "header", "cookie"
	Description string
	Required    bool
	Schema      *SchemaInfo
}

type ParsedSpec struct {
	// Version is the OpenAPI version (e.g., "3.0.0", "3.1.0")
	Version string
	// Info contains metadata about the API
	Info Info
	// Paths maps path strings to path items
	Paths map[string]*PathItem
	// Schemas contains all components/schemas
	Schemas map[string]*SchemaInfo
	// Security contains security schemes
	Security map[string]*SecurityScheme
	// contains filtered or unexported fields
}

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

type PathItem struct {
	Path       string
	Operations map[string]*Operation
}

type PulseType struct {
	// Name is the type name (e.g., "string", "int", "User")
	Name string
	// IsOptional indicates if the type is optional ([optional])
	IsOptional bool
	// IsArray indicates if the type is an array
	IsArray bool
	// ArrayElementType is the element type for arrays
	ArrayElementType *PulseType
	// IsMap indicates if the type is a map
	IsMap bool
	// MapValueType is the value type for maps
	MapValueType *PulseType
	// IsPrimitive indicates if this is a primitive type
	IsPrimitive bool
	// IsCustom indicates if this is a custom/user-defined type
	IsCustom bool
}

type Response struct {
	Code        string
	Description string
	Schema      *SchemaInfo
}

type SchemaInfo struct {
	// Name is the schema name (from components/schemas or generated)
	Name string
	// Description is the schema description
	Description string
	// Type is the Pulse type
	Type PulseType
	// Required fields (for object schemas)
	Required map[string]bool
	// Properties map for object schemas
	Properties map[string]*SchemaInfo
	// IsArray indicates if this is an array type
	IsArray bool
	// Items type for array schemas
	Items *SchemaInfo
	// IsMap indicates if this is a map type
	IsMap bool
	// AdditionalProperties type for map schemas
	AdditionalProperties *SchemaInfo
	// Enum values for enum schemas
	Enum []string
	// AllOf schemas for composition
	AllOf []*SchemaInfo
	// RefName is the name of the referenced schema (for $ref)
	RefName string
	// IsCircular indicates if this schema has circular references
	IsCircular bool
	// IsEnum indicates if this is an enum type
	IsEnum bool
	// IsObject indicates if this is an object/struct type
	IsObject bool
}

type SecurityScheme struct {
	Type   string
	Scheme string
}

type ToPulseGenerator struct {
	// Parser is used to load OpenAPI specs
	Parser *Parser
	// Strict mode treats warnings as errors
	Strict bool
	// contains filtered or unexported fields
}

type TranslationContext struct {
	// Warnings collects warnings during translation
	Warnings *Warnings
	// Strict mode treats warnings as errors
	Strict bool
	// Schemas is the map of parsed schemas from OpenAPI spec
	Schemas map[string]*SchemaInfo
	// CircularRefTracker tracks circular references
	CircularRefTracker map[string]bool
}

type Warning struct {
	// Level is either "warning" or "error"
	Level string
	// Message is the warning message
	Message string
	// Location is the source location (e.g., file path, schema name)
	Location string
}

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