internal

type ArrayLocation struct {
	ContainerPath  string `json:"container_path"`   // Path to the container
	ArrayFieldName string `json:"array_field_name"` // Name of the array field
	ContainerRef   any    `json:"-"`                // Reference to the container (not serialized)
}

type ArrayUtils struct{}

type CacheInterface interface {
	Get(key string) (any, bool)
	Set(key string, value any)
	ClearCache()
	GetStats() interface{} // Returns CacheStats but as interface{} to avoid circular dependency
}

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

type CacheStats struct {
	Size      int64   `json:"size"`
	Memory    int64   `json:"memory"`
	HitCount  int64   `json:"hit_count"`
	MissCount int64   `json:"miss_count"`
	HitRatio  float64 `json:"hit_ratio"`
	Evictions int64   `json:"evictions"`
}

type CheckResult struct {
	Healthy bool   `json:"healthy"`
	Message string `json:"message"`
}

type ConfigInterface interface {

	// Cache configuration
	IsCacheEnabled() bool
	GetMaxCacheSize() int
	GetCacheTTL() time.Duration

	// Performance configuration
	GetMaxJSONSize() int64
	GetMaxPathDepth() int
	GetMaxConcurrency() int
	IsMetricsEnabled() bool
	IsHealthCheckEnabled() bool

	// Parsing configuration
	IsStrictMode() bool
	AllowComments() bool
	PreserveNumbers() bool

	// Operation configuration
	ShouldCreatePaths() bool
	ShouldCleanupNulls() bool
	ShouldCompactArrays() bool

	// Security configuration
	ShouldValidateInput() bool
	GetMaxNestingDepth() int
	IsRateLimitEnabled() bool
	GetRateLimitPerSec() int
	ShouldValidateFilePath() bool

	// Memory management
	AreResourcePoolsEnabled() bool
	GetMaxPoolSize() int
	GetPoolCleanupInterval() time.Duration
}

type EncodeConfigInterface interface {
	// Formatting options
	IsPretty() bool
	GetIndent() string
	GetPrefix() string
	ShouldSortKeys() bool
	ShouldEscapeHTML() bool

	// Output options
	IsCompactOutput() bool
	HasTrailingComma() bool

	// Number formatting
	ShouldPreserveNumbers() bool
	GetFloatPrecision() int

	// String handling
	ShouldEscapeUnicode() bool
	GetQuoteStyle() int

	// Advanced options
	ShouldOmitEmpty() bool
	ShouldIncludeNulls() bool
	ShouldValidateUTF8() bool
	GetMaxDepth() int
	GetBufferSize() int
}

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

type HealthCheckerInterface interface {
	CheckHealth() interface{} // Returns HealthStatus but as interface{} to avoid circular dependency
}

type HealthStatus struct {
	Timestamp time.Time              `json:"timestamp"`
	Healthy   bool                   `json:"healthy"`
	Checks    map[string]CheckResult `json:"checks"`
}

type MappingInfo struct {
	OriginalContainers []any  `json:"-"`                // Original container references
	ArrayFieldName     string `json:"array_field_name"` // Array field name
	TargetIndices      []int  `json:"target_indices"`   // Target indices for each container
}

type Metrics struct {
	// Operation metrics
	TotalOperations int64 `json:"total_operations"`
	SuccessfulOps   int64 `json:"successful_ops"`
	FailedOps       int64 `json:"failed_ops"`
	CacheHits       int64 `json:"cache_hits"`
	CacheMisses     int64 `json:"cache_misses"`

	// Performance metrics
	TotalProcessingTime time.Duration `json:"total_processing_time"`
	AvgProcessingTime   time.Duration `json:"avg_processing_time"`
	MaxProcessingTime   time.Duration `json:"max_processing_time"`
	MinProcessingTime   time.Duration `json:"min_processing_time"`

	// Memory metrics
	TotalMemoryAllocated int64 `json:"total_memory_allocated"`
	PeakMemoryUsage      int64 `json:"peak_memory_usage"`
	CurrentMemoryUsage   int64 `json:"current_memory_usage"`

	// Concurrency metrics
	ActiveConcurrentOps int64 `json:"active_concurrent_ops"`
	MaxConcurrentOps    int64 `json:"max_concurrent_ops"`

	// Runtime metrics
	RuntimeMemStats runtime.MemStats `json:"runtime_mem_stats"`
	Uptime          time.Duration    `json:"uptime"`
	ErrorsByType    map[string]int64 `json:"errors_by_type"`
}

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

type MetricsInterface interface {
	RecordOperation(duration time.Duration, success bool, memoryUsed int64)
	RecordCacheHit()
	RecordCacheMiss()
	StartConcurrentOperation()
	EndConcurrentOperation()
	RecordError(errorType string)
	GetMetrics() interface{} // Returns Metrics but as interface{} to avoid circular dependency
	Reset()
	GetSummary() string
}

type OperationContext struct {
	ExtractionPath string          `json:"extraction_path"` // Path used for extraction
	TargetArrays   []ArrayLocation `json:"target_arrays"`   // Target array locations
	OperationType  string          `json:"operation_type"`  // "get", "set", "delete"
}

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

type PathParserInterface interface {
	ParsePath(path string) ([]interface{}, error) // Returns []PathSegment but as []interface{}
	ValidatePath(path string) error
	SplitPathIntoSegments(path string) []interface{} // Returns []PathSegmentInfo but as []interface{}
}

type PathPatterns struct {

	// Compiled patterns for common operations
	SimpleProperty *regexp.Regexp
	NumericIndex   *regexp.Regexp
	// contains filtered or unexported fields
}

type PathSegment struct {
	// New structured fields
	Type       PathSegmentType `json:"type"`
	Key        string          `json:"key"`
	Index      int             `json:"index"`
	Start      *int            `json:"start,omitempty"`
	End        *int            `json:"end,omitempty"`
	Step       *int            `json:"step,omitempty"`
	IsNegative bool            `json:"is_negative"`
	IsSlice    bool            `json:"is_slice"`
	IsWildcard bool            `json:"is_wildcard"`
	IsFlat     bool            `json:"is_flat"` // Whether this is a flat extraction operation

	// Distributed operation support
	IsDistributed    bool              `json:"is_distributed"`    // Whether this is a distributed operation
	OperationContext *OperationContext `json:"operation_context"` // Operation context for distributed operations
	MappingInfo      *MappingInfo      `json:"mapping_info"`      // Reverse mapping information

	Value   string `json:"value"`   // The actual segment value
	Extract string `json:"extract"` // For extract operations: the property to extract
}

type PathSegmentType int

type ProcessorOptionsInterface interface {
	GetContext() interface{} // Returns context.Context but as interface{} to avoid import
	ShouldCacheResults() bool
	IsStrictMode() bool
	GetMaxDepth() int
	AllowComments() bool
	PreserveNumbers() bool
	ShouldCreatePaths() bool
	ShouldCleanupNulls() bool
	ShouldCompactArrays() bool
}

type StatsInterface interface {
	GetCacheSize() int64
	GetCacheMemory() int64
	GetMaxCacheSize() int
	GetHitCount() int64
	GetMissCount() int64
	GetHitRatio() float64
	GetCacheTTL() time.Duration
	IsCacheEnabled() bool
	GetOperationCount() int64
	GetErrorCount() int64
}