setup

type ClusterConfig struct {
	Name              string      // Name of the k3d cluster
	ControlPlaneNodes int         // Number of Control Plane Nodes (k3s calls these server nodes)
	WorkerNodes       int         // Number of worker nodes (called agents in k3s terminology)
	Image             string      // Docker image to use for k3d cluster (e.g., "rancher/k3s:v1.28.8-k3s1")
	HostPort          string      // Port on host to expose Kubernetes API (e.g., "6550")
	LoadBalancerPort  string      // Load balancer port mapping in format "hostPort:containerPort" (e.g., "8080:80")
	NodeLabels        []NodeLabel // Kubernetes labels to apply with specific node filters
	WorkerNodeTaints  []NodeTaint // Taints to apply to worker nodes
	WorkerMemory      string      // Memory allocation for worker/agent nodes (e.g., "150m")
	EnableRegistry    bool        // Enable built-in Docker registry
	RegistryPort      string      // Port for the Docker registry (e.g., "5001")
}

type GroveConfig struct {
	// InstallCRDs controls whether CRDs should be installed/updated.
	InstallCRDs bool
	// Webhooks contains webhook-specific configuration.
	Webhooks WebhooksConfig
}

type HelmInstallConfig struct {
	// RestConfig is the Kubernetes REST configuration. If nil, uses default kubeconfig.
	RestConfig *rest.Config
	// ReleaseName is the name of the Helm release. Required unless GenerateName is true.
	ReleaseName string
	// ChartRef is the chart reference (path, URL, or chart name). Required.
	ChartRef string
	// ChartVersion is the version of the chart to install. Required.
	ChartVersion string
	// Namespace is the Kubernetes namespace to install into. Required.
	Namespace string
	// CreateNamespace creates the namespace if it doesn't exist.
	CreateNamespace bool
	// Wait blocks until all resources are ready.
	Wait bool
	// GenerateName generates a random release name with ReleaseName as prefix.
	GenerateName bool
	// Values are the chart values to use for the installation.
	Values map[string]interface{}
	// HelmLoggerFunc is called for Helm operation logging.
	HelmLoggerFunc func(format string, v ...interface{})
	// Logger is the full logger for component operations.
	Logger *utils.Logger
	// RepoURL is the base URL of the Helm repository (optional, for direct chart downloads).
	RepoURL string
	// ReuseValues reuses the last release's values and merges in the new values.
	ReuseValues bool
	// Timeout is the time to wait for Kubernetes operations (default: 5 minutes).
	Timeout time.Duration
}

type NodeLabel struct {
	Key   string // Label key
	Value string // Label value
	// k3s refers to worker nodes as agent nodes
	NodeFilters []string // Node filters (e.g., "server:*", "agent:*", "server:0", "agent:1")
}

type NodeTaint struct {
	Key    string
	Value  string
	Effect string
}

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

type SkaffoldInstallConfig struct {
	// SkaffoldYAMLPath is the path to the skaffold.yaml file. Required.
	SkaffoldYAMLPath string
	// RestConfig is the Kubernetes REST configuration. Required.
	RestConfig *rest.Config
	// Profiles are the Skaffold profiles to activate (optional).
	Profiles []string
	// PushRepo is the repository to push images to (e.g., "localhost:5001"). Required.
	PushRepo string
	// PullRepo is the repository to pull images from (e.g., "registry:5001"). Required.
	PullRepo string
	// Namespace is the target namespace for deployment (optional, defaults to "default").
	Namespace string
	// Env are environment variables required by skaffold.yaml (e.g., VERSION, LD_FLAGS).
	Env map[string]string
	// Logger is the logger for operations (optional, will use default if nil).
	Logger *utils.Logger
}

type WebhooksConfig struct {
	// CertProvisionMode controls how webhook certificates are provisioned.
	// Use configv1alpha1.CertProvisionModeAuto for automatic provisioning,
	// configv1alpha1.CertProvisionModeManual for external cert management.
	CertProvisionMode configv1alpha1.CertProvisionMode
	// SecretName is the name of the Kubernetes secret containing TLS certificates.
	SecretName string
	// Annotations to apply to webhook configurations (e.g., for cert-manager CA injection).
	// These annotations are applied to all webhook configurations.
	Annotations map[string]string
}