deploy

type BuildConfig struct {
	// Context is the build context path.
	Context string `yaml:"context" json:"context"`

	// Dockerfile is the path to the Dockerfile.
	Dockerfile string `yaml:"dockerfile" json:"dockerfile"`

	// Args are build arguments.
	Args map[string]string `yaml:"args" json:"args"`
}

type Capabilities struct {
	// AutoScaling indicates the provider supports auto-scaling.
	AutoScaling bool `json:"auto_scaling"`

	// CustomDomain indicates the provider supports custom domain mapping.
	CustomDomain bool `json:"custom_domain"`

	// HTTPS indicates the provider supports HTTPS termination.
	HTTPS bool `json:"https"`

	// VPC indicates the provider supports VPC networking.
	VPC bool `json:"vpc"`

	// SecretsIntegration indicates the provider integrates with secrets managers.
	SecretsIntegration bool `json:"secrets_integration"`

	// Preview indicates the provider supports deployment previews.
	Preview bool `json:"preview"`

	// Rollback indicates the provider supports deployment rollback.
	Rollback bool `json:"rollback"`

	// MaxMemoryMB is the maximum memory allocation in MB.
	MaxMemoryMB int `json:"max_memory_mb"`
}

type ConfigError struct {
	Field string
	Err   error
}

type DeployConfig struct {
	// Stack contains the core stack configuration.
	Stack StackConfig `yaml:"stack" json:"stack"`

	// Provider is the deployment provider name ("lightsail", "ecs", "cloudrun", "docker").
	Provider string `yaml:"provider" json:"provider"`

	// ProviderConfig contains provider-specific configuration.
	// Use type assertion to access (e.g., cfg.ProviderConfig.(*LightsailConfig)).
	ProviderConfig any `yaml:"provider_config" json:"provider_config"`

	// PulumiBackend is the Pulumi state backend URL.
	// Examples: "file://~/.pulumi", "s3://my-bucket/pulumi", "https://api.pulumi.com"
	PulumiBackend string `yaml:"pulumi_backend" json:"pulumi_backend"`

	// DryRun performs a preview without making changes.
	DryRun bool `yaml:"dry_run" json:"dry_run"`

	// AutoApprove skips confirmation prompts.
	AutoApprove bool `yaml:"auto_approve" json:"auto_approve"`
}

type DeploymentError struct {
	StackName string
	State     DeploymentState
	Err       error
}

type DeploymentState string

type DeploymentStatus struct {
	// StackName is the unique identifier for this deployment.
	StackName string `json:"stack_name"`

	// State is the current deployment state.
	State DeploymentState `json:"state"`

	// Provider is the name of the provider used.
	Provider string `json:"provider"`

	// Version is the deployment version (e.g., git sha, timestamp).
	Version string `json:"version,omitempty"`

	// StartTime is when the deployment started.
	StartTime time.Time `json:"start_time"`

	// EndTime is when the deployment ended (zero if still running).
	EndTime time.Time `json:"end_time,omitempty"`

	// Duration is the elapsed time.
	Duration time.Duration `json:"duration,omitempty"`

	// Resources lists the deployed resources.
	Resources []Resource `json:"resources,omitempty"`

	// Outputs contains deployment outputs (e.g., URLs, IPs).
	Outputs map[string]string `json:"outputs,omitempty"`

	// Error contains error details if the deployment failed.
	Error string `json:"error,omitempty"`

	// Message provides additional status information.
	Message string `json:"message,omitempty"`

	// Metadata contains provider-specific metadata.
	Metadata map[string]any `json:"metadata,omitempty"`
}

type HealthCheckConfig struct {
	// Path is the HTTP health check path.
	Path string `yaml:"path" json:"path"`

	// IntervalSeconds is the check interval.
	IntervalSeconds int `yaml:"interval_seconds" json:"interval_seconds"`

	// TimeoutSeconds is the check timeout.
	TimeoutSeconds int `yaml:"timeout_seconds" json:"timeout_seconds"`

	// HealthyThreshold is the number of successful checks required.
	HealthyThreshold int `yaml:"healthy_threshold" json:"healthy_threshold"`

	// UnhealthyThreshold is the number of failed checks before unhealthy.
	UnhealthyThreshold int `yaml:"unhealthy_threshold" json:"unhealthy_threshold"`
}

type ImageConfig struct {
	// Repository is the container image repository.
	Repository string `yaml:"repository" json:"repository"`

	// Tag is the image tag (default: "latest").
	Tag string `yaml:"tag" json:"tag"`

	// Digest is the image digest for immutable deployments.
	Digest string `yaml:"digest" json:"digest"`

	// Build contains build configuration if building from source.
	Build *BuildConfig `yaml:"build" json:"build"`
}

type LogEntry struct {
	// Timestamp is the time the log was generated.
	Timestamp string `json:"timestamp"`

	// Level is the log level (info, warn, error).
	Level string `json:"level"`

	// Message is the log message.
	Message string `json:"message"`

	// Source identifies where the log came from.
	Source string `json:"source,omitempty"`
}

type LogProvider interface {
	Provider

	// StreamLogs streams deployment logs to the provided channel.
	StreamLogs(ctx context.Context, stackName string, logs chan<- LogEntry) error
}

type PreviewProvider interface {
	Provider

	// Preview shows what would be deployed without making changes.
	Preview(ctx context.Context, cfg *DeployConfig) (*PreviewResult, error)
}

type PreviewResult struct {
	// StackName is the name of the stack.
	StackName string `json:"stack_name"`

	// Creates lists resources that would be created.
	Creates []ResourcePreview `json:"creates,omitempty"`

	// Updates lists resources that would be updated.
	Updates []ResourcePreview `json:"updates,omitempty"`

	// Deletes lists resources that would be deleted.
	Deletes []ResourcePreview `json:"deletes,omitempty"`

	// Summary provides a human-readable summary.
	Summary string `json:"summary"`
}

type Provider interface {
	// Deploy deploys the configuration to the target platform.
	// Returns a DeploymentStatus on success or error on failure.
	Deploy(ctx context.Context, cfg *DeployConfig) (*DeploymentStatus, error)

	// Status returns the current status of a deployment.
	Status(ctx context.Context, stackName string) (*DeploymentStatus, error)

	// Destroy removes all resources associated with a deployment.
	Destroy(ctx context.Context, stackName string) error

	// Name returns the unique identifier for this provider.
	Name() string

	// Capabilities returns the capabilities of this provider.
	Capabilities() Capabilities

	// Close releases any resources held by the provider.
	Close() error
}

type ProviderError struct {
	Provider string
	Op       string
	Err      error
}

type ProviderFactory func(cfg *DeployConfig) (Provider, error)

type ProviderInfo struct {
	Name     ProviderName `json:"name"`
	Priority int          `json:"priority"`
}

type ProviderName string

type Resource struct {
	// URN is the unique resource name in Pulumi format.
	URN string `json:"urn"`

	// Type is the resource type (e.g., "aws:lightsail:ContainerService").
	Type string `json:"type"`

	// Name is the resource name.
	Name string `json:"name"`

	// ID is the provider-specific resource ID.
	ID string `json:"id,omitempty"`

	// State is the resource state (e.g., "created", "updated", "deleted").
	State string `json:"state"`

	// Outputs contains resource-specific outputs.
	Outputs map[string]any `json:"outputs,omitempty"`
}

type ResourceConfig struct {
	// CPU is the CPU allocation (e.g., "0.25", "1", "2").
	CPU string `yaml:"cpu" json:"cpu"`

	// Memory is the memory allocation (e.g., "512", "1024", "2048" in MB).
	Memory string `yaml:"memory" json:"memory"`

	// Port is the container port to expose.
	Port int `yaml:"port" json:"port"`
}

type ResourcePreview struct {
	// URN is the unique resource name.
	URN string `json:"urn"`

	// Type is the resource type.
	Type string `json:"type"`

	// Name is the resource name.
	Name string `json:"name"`

	// Details provides additional information about the change.
	Details map[string]any `json:"details,omitempty"`
}

type ResourceSummary struct {
	// Total is the total number of resources.
	Total int `json:"total"`

	// Created is the number of resources created.
	Created int `json:"created"`

	// Updated is the number of resources updated.
	Updated int `json:"updated"`

	// Deleted is the number of resources deleted.
	Deleted int `json:"deleted"`

	// Unchanged is the number of unchanged resources.
	Unchanged int `json:"unchanged"`
}

type RollbackProvider interface {
	Provider

	// Rollback reverts to a previous deployment version.
	Rollback(ctx context.Context, stackName string, targetVersion string) (*DeploymentStatus, error)

	// ListVersions returns available versions for rollback.
	ListVersions(ctx context.Context, stackName string) ([]string, error)
}

type ScalingConfig struct {
	// MinInstances is the minimum number of instances.
	MinInstances int `yaml:"min_instances" json:"min_instances"`

	// MaxInstances is the maximum number of instances.
	MaxInstances int `yaml:"max_instances" json:"max_instances"`

	// TargetCPUPercent is the target CPU utilization for scaling.
	TargetCPUPercent int `yaml:"target_cpu_percent" json:"target_cpu_percent"`
}

type SecretRef struct {
	// Source is the secret source ("env", "ssm", "secrets-manager", "vault").
	Source string `yaml:"source" json:"source"`

	// Key is the secret key or path.
	Key string `yaml:"key" json:"key"`

	// Version is the secret version (optional).
	Version string `yaml:"version" json:"version"`
}

type StackConfig struct {
	// Name is the stack name (e.g., "myapp-prod", "invest-advisor-staging").
	Name string `yaml:"name" json:"name"`

	// Project is the Pulumi project name.
	Project string `yaml:"project" json:"project"`

	// Description provides a human-readable description.
	Description string `yaml:"description" json:"description"`

	// Region is the cloud region for deployment.
	Region string `yaml:"region" json:"region"`

	// Tags are resource tags applied to all resources.
	Tags map[string]string `yaml:"tags" json:"tags"`

	// Image is the container image configuration.
	Image ImageConfig `yaml:"image" json:"image"`

	// Resources defines compute resources.
	Resources ResourceConfig `yaml:"resources" json:"resources"`

	// Environment contains environment variables.
	Environment map[string]string `yaml:"environment" json:"environment"`

	// Secrets contains secret references.
	Secrets map[string]SecretRef `yaml:"secrets" json:"secrets"`

	// HealthCheck defines the health check configuration.
	HealthCheck *HealthCheckConfig `yaml:"health_check" json:"health_check"`

	// Scaling defines the scaling configuration.
	Scaling *ScalingConfig `yaml:"scaling" json:"scaling"`
}