debug

type DeploymentStatus struct {
	Status             string           `json:"status"` // "succeeded" | "failed" | "skipped" | "pending"
	Reason             string           `json:"reason,omitempty"`
	Timestamp          time.Time        `json:"timestamp"`
	DurationMs         int64            `json:"duration_ms,omitempty"`
	EndpointsTotal     int              `json:"endpoints_total"`
	EndpointsSucceeded int              `json:"endpoints_succeeded"`
	EndpointsFailed    int              `json:"endpoints_failed"`
	FailedEndpoints    []FailedEndpoint `json:"failed_endpoints,omitempty"`
}

type ErrorInfo struct {
	Timestamp time.Time `json:"timestamp"`
	Errors    []string  `json:"errors"`
}

type ErrorSummary struct {
	ConfigParseError       *ErrorInfo  `json:"config_parse_error,omitempty"`
	TemplateRenderError    *ErrorInfo  `json:"template_render_error,omitempty"`
	HAProxyValidationError *ErrorInfo  `json:"haproxy_validation_error,omitempty"`
	DeploymentErrors       []ErrorInfo `json:"deployment_errors,omitempty"`
	LastErrorTimestamp     time.Time   `json:"last_error_timestamp"`
}

type Event struct {
	Timestamp     time.Time `json:"timestamp"`
	Type          string    `json:"type"`
	Summary       string    `json:"summary"`
	Details       any       `json:"details,omitempty"`
	CorrelationID string    `json:"correlation_id,omitempty"`
}

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

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

type FailedEndpoint struct {
	URL   string `json:"url"`
	Error string `json:"error"`
}

type PipelineStatus struct {
	LastTrigger *TriggerStatus    `json:"last_trigger"`
	Rendering   *RenderingStatus  `json:"rendering"`
	Validation  *ValidationStatus `json:"validation"`
	Deployment  *DeploymentStatus `json:"deployment"`
}

type RenderingStatus struct {
	Status      string    `json:"status"` // "succeeded" | "failed"
	Timestamp   time.Time `json:"timestamp"`
	DurationMs  int64     `json:"duration_ms"`
	ConfigBytes int       `json:"config_bytes"`
	Error       string    `json:"error,omitempty"`
}

type StateProvider interface {
	// GetConfig returns the current validated configuration and its version.
	//
	// Returns error if config is not yet loaded.
	//
	// Example return:
	//   config: &config.Config{...}
	//   version: "v123"
	//   error: nil
	GetConfig() (*config.Config, string, error)

	// GetCredentials returns the current credentials and their version.
	//
	// Returns error if credentials are not yet loaded.
	//
	// Example return:
	//   creds: &config.Credentials{...}
	//   version: "v456"
	//   error: nil
	GetCredentials() (*config.Credentials, string, error)

	// GetRenderedConfig returns the most recently rendered HAProxy configuration
	// and the timestamp when it was rendered.
	//
	// Returns error if no config has been rendered yet.
	//
	// Example return:
	//   rendered: "global\n  maxconn 2000\n..."
	//   timestamp: 2025-01-15 10:30:45
	//   error: nil
	GetRenderedConfig() (string, time.Time, error)

	// GetAuxiliaryFiles returns the most recently used auxiliary files
	// (SSL certificates, map files, general files) and the timestamp.
	//
	// Returns error if no auxiliary files have been cached yet.
	//
	// Example return:
	//   auxFiles: &dataplane.AuxiliaryFiles{SSLCertificates: [...], ...}
	//   timestamp: 2025-01-15 10:30:45
	//   error: nil
	GetAuxiliaryFiles() (*dataplane.AuxiliaryFiles, time.Time, error)

	// GetResourceCounts returns a map of resource type → count.
	//
	// The keys are resource names as defined in the controller configuration
	// (e.g., "ingresses", "services", "haproxy-pods").
	//
	// Example return:
	//   {
	//     "ingresses": 5,
	//     "services": 12,
	//     "haproxy-pods": 2
	//   }
	GetResourceCounts() (map[string]int, error)

	// GetResourcesByType returns the resources of a specific type.
	//
	// The resourceType parameter should match a key from GetResourceCounts().
	//
	// Partial-result contract: for `store: on-demand` resource types, the
	// returned slice is the subset currently warm in the store's cache only —
	// NOT the full set of tracked references. Listing the full set would fan
	// out one kube-apiserver lookup per reference, which this method
	// deliberately avoids. The count from GetResourceCounts() is therefore the
	// authoritative total; this slice may be shorter. Callers wiring this to a
	// user-facing endpoint must surface that the result is the warm subset so
	// consumers don't mistake it for the complete set. For `store: full`
	// resource types the result is complete.
	//
	// Returns error if the resource type is not found.
	//
	// Example:
	//   resources, err := provider.GetResourcesByType("ingresses")
	GetResourcesByType(resourceType string) ([]any, error)

	// GetPipelineStatus returns the complete status of the last reconciliation pipeline.
	//
	// Returns error if no pipeline has run yet.
	//
	// Example return:
	//   status: &PipelineStatus{
	//     LastTrigger: &TriggerStatus{Timestamp: ..., Reason: "config_change"},
	//     Rendering:   &RenderingStatus{Status: "succeeded", ...},
	//     Validation:  &ValidationStatus{Status: "failed", Errors: [...]},
	//     Deployment:  &DeploymentStatus{Status: "skipped", Reason: "validation_failed"},
	//   }
	GetPipelineStatus() (*PipelineStatus, error)

	// GetValidatedConfig returns the last successfully validated HAProxy configuration.
	//
	// Unlike GetRenderedConfig(), this only returns configs that passed validation.
	// Returns error if no config has been validated successfully yet.
	//
	// Example return:
	//   info: &ValidatedConfigInfo{
	//     Config:               "global\n  maxconn 2000\n...",
	//     Timestamp:            2025-01-15 10:30:45,
	//     ConfigBytes:          4567,
	//     ValidationDurationMs: 200,
	//   }
	GetValidatedConfig() (*ValidatedConfigInfo, error)

	// GetErrors returns an aggregated summary of recent errors across all phases.
	//
	// This is useful for quick diagnosis of configuration issues.
	//
	// Example return:
	//   summary: &ErrorSummary{
	//     HAProxyValidationError: &ErrorInfo{
	//       Timestamp: 2025-01-15 10:30:47,
	//       Errors:    ["[ALERT] parsing [haproxy.cfg:3] : unknown keyword..."],
	//     },
	//     LastErrorTimestamp: 2025-01-15 10:30:47,
	//   }
	GetErrors() (*ErrorSummary, error)
}

type TriggerStatus struct {
	Timestamp time.Time `json:"timestamp"`
	Reason    string    `json:"reason"`
}

type ValidatedConfigInfo struct {
	Config               string    `json:"config"`
	Timestamp            time.Time `json:"timestamp"`
	ConfigBytes          int       `json:"config_bytes"`
	ValidationDurationMs int64     `json:"validation_duration_ms"`
}

type ValidationStatus struct {
	Status     string    `json:"status"` // "succeeded" | "failed" | "pending"
	Timestamp  time.Time `json:"timestamp"`
	DurationMs int64     `json:"duration_ms"`
	Errors     []string  `json:"errors,omitempty"`
	Warnings   []string  `json:"warnings,omitempty"`
}