openapi

type ContextStats struct {
	MaxDepth        int  `json:"max_depth"`
	CurrentDepth    int  `json:"current_depth"`
	DepthRemaining  int  `json:"depth_remaining"`
	VisitedCount    int  `json:"visited_count"`
	ArraySizesCount int  `json:"array_sizes_count"`
	IsAtMaxDepth    bool `json:"is_at_max_depth"`
	IsNearMaxDepth  bool `json:"is_near_max_depth"`
}

type DataGenerator interface {
	// Generate creates mock data based on the provided schema and context
	Generate(schema *Schema, ctx *GenerationContext) (interface{}, error)

	// SetSeed sets the random seed for deterministic generation
	SetSeed(seed int64)

	// SetLocale sets the locale for data generation
	SetLocale(locale string)
}

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

type Endpoint struct {
	Path        string
	Method      string
	OperationID string
	Parameters  []Parameter
	Responses   map[string]Response
	Operation   *Operation
}

type ExampleObject struct {
	Summary       string      `json:"summary,omitempty"`
	Description   string      `json:"description,omitempty"`
	Value         interface{} `json:"value,omitempty"`
	ExternalValue string      `json:"externalValue,omitempty"`
}

type FormatGenerator func(schema *Schema, ctx *GenerationContext) (interface{}, error)

type FormatGeneratorInfo struct {
	Format      string `json:"format"`
	Description string `json:"description"`
	Example     string `json:"example"`
}

type GenerationContext struct {
	MaxDepth         int
	CurrentDepth     int
	Visited          map[string]bool
	ArraySizes       map[string]int
	Required         bool
	Parent           string
	Locale           string
	Seed             int64
	Timestamp        time.Time
	RequestedExample string // Header X-Mock-Example value for selecting specific examples
}

type GenerationContextEnhanced struct {
	MaxDepth         int             `json:"max_depth"`
	CurrentDepth     int             `json:"current_depth"`
	Visited          map[string]bool `json:"visited"`
	ArraySizes       map[string]int  `json:"array_sizes"`
	Required         bool            `json:"required"`
	Parent           string          `json:"parent"`
	Locale           string          `json:"locale"`
	Seed             int64           `json:"seed"`
	Timestamp        time.Time       `json:"timestamp"`
	PreferExamples   bool            `json:"prefer_examples"`
	DefaultArraySize int             `json:"default_array_size"`
	CircularRefCount map[string]int  `json:"circular_ref_count"`
	Path             []string        `json:"path"`
}

type Header struct {
	Description string  `json:"description,omitempty"`
	Schema      *Schema `json:"schema,omitempty"`
}

type InfoObject struct {
	Title       string `json:"title"`
	Description string `json:"description,omitempty"`
	Version     string `json:"version"`
}

type MediaTypeObject struct {
	Schema   *Schema                  `json:"schema,omitempty"`
	Example  interface{}              `json:"example,omitempty"`
	Examples map[string]ExampleObject `json:"examples,omitempty"`
}

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

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

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

type PathItem struct {
	GET    *Operation `json:"get,omitempty"`
	POST   *Operation `json:"post,omitempty"`
	PUT    *Operation `json:"put,omitempty"`
	DELETE *Operation `json:"delete,omitempty"`
	PATCH  *Operation `json:"patch,omitempty"`
}

type RequestBody struct {
	Description string                     `json:"description,omitempty"`
	Content     map[string]MediaTypeObject `json:"content"`
	Required    bool                       `json:"required,omitempty"`
}

type Response struct {
	Description string                     `json:"description"`
	Content     map[string]MediaTypeObject `json:"content,omitempty"`
	Headers     map[string]Header          `json:"headers,omitempty"`
}

type Schema struct {
	Type                 string                   `json:"type,omitempty"`
	Format               string                   `json:"format,omitempty"`
	Description          string                   `json:"description,omitempty"`
	Enum                 []interface{}            `json:"enum,omitempty"`
	Default              interface{}              `json:"default,omitempty"`
	Example              interface{}              `json:"example,omitempty"`
	Examples             map[string]ExampleObject `json:"examples,omitempty"`
	Properties           map[string]*Schema       `json:"properties,omitempty"`
	Items                *Schema                  `json:"items,omitempty"`
	Required             []string                 `json:"required,omitempty"`
	AdditionalProperties interface{}              `json:"additionalProperties,omitempty"`
	Pattern              string                   `json:"pattern,omitempty"`
	Minimum              *float64                 `json:"minimum,omitempty"`
	Maximum              *float64                 `json:"maximum,omitempty"`
	MinItems             *int                     `json:"minItems,omitempty"`
	MaxItems             *int                     `json:"maxItems,omitempty"`
	MinLength            *int                     `json:"minLength,omitempty"`
	MaxLength            *int                     `json:"maxLength,omitempty"`
}

type SecurityRequirement map[string][]string

type SpecParser interface {
	Parse(data []byte) (*Specification, error)
	Validate(spec *Specification) error
	GetEndpoints() []Endpoint
	GetSchemas() map[string]*Schema
}

type Specification struct {
	Version  string                `json:"version"`
	Info     InfoObject            `json:"info"`
	Paths    map[string]PathItem   `json:"paths"`
	Schemas  map[string]*Schema    `json:"schemas"`
	Security []SecurityRequirement `json:"security"`
}

type ValidationResult struct {
	Valid  bool     `json:"valid"`
	Errors []string `json:"errors"`
}