native

type BuildOptions struct {
	// Context is the build context directory
	Context string

	// Dockerfile is the path to the Dockerfile (relative to context)
	Dockerfile string

	// Tags are the image tags to apply
	Tags []string

	// BuildArgs are build-time variables
	BuildArgs map[string]string

	// Target is the build target stage
	Target string

	// Platform is the target platform (e.g., "linux/amd64")
	Platform string

	// NoCache disables build cache
	NoCache bool

	// Pull always pulls base images
	Pull bool

	// Labels to apply to the image
	Labels map[string]string

	// Output writers for build logs
	Stdout io.Writer
	Stderr io.Writer
}

type BuildResult struct {
	// ImageID is the built image ID
	ImageID string

	// Tags are the tags applied to the image
	Tags []string

	// Digest is the image digest (if pushed)
	Digest string

	// Size is the image size in bytes
	Size int64
}

type ContainerInfo struct {
	ID    string
	Name  string
	Ports map[string]int
}

type ContainerOptions struct {
	Image            string
	Name             string
	Command          []string
	Entrypoint       []string
	Environment      map[string]string
	Ports            []PortMapping
	Volumes          []VolumeMount
	Network          string
	Restart          string
	Healthcheck      *Healthcheck
	LogDriver        string            // Docker logging driver (e.g., "fluentd", "json-file")
	LogOptions       map[string]string // Options for the logging driver
	ExtraHosts       []string          // Additional /etc/hosts entries (e.g., "host.docker.internal:host-gateway")
	ResolveLocalhost bool              // Replace "localhost" in env var values with "host.docker.internal"
	Wait             bool              // Wait for container to exit before returning (for one-shot tasks)
	OnProgress       func(string)      // Optional callback for sub-status updates (e.g., "pulling image...", "health check 5/30")
}

type DestroyCommand struct {
	Command     []interface{}          `yaml:"command"`               // Command to execute
	Image       string                 `yaml:"image,omitempty"`       // If set, run in a Docker container
	Network     string                 `yaml:"network,omitempty"`     // Docker network (when using image)
	WorkDir     string                 `yaml:"working_dir,omitempty"` // Working directory
	Environment map[string]interface{} `yaml:"environment,omitempty"` // Environment variables
}

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

type EvalContext struct {
	Inputs    map[string]interface{}
	Resources map[string]*ResourceState
}

type GracefulStop struct {
	Signal  string        // Signal name (e.g., "SIGTERM")
	Timeout time.Duration // Time to wait before SIGKILL
}

type Healthcheck struct {
	Command     []string
	Interval    string
	Timeout     string
	Retries     int
	StartPeriod string
}

type InputDef struct {
	Type        string      `yaml:"type"`
	Required    bool        `yaml:"required"`
	Default     interface{} `yaml:"default"`
	Description string      `yaml:"description"`
	Sensitive   bool        `yaml:"sensitive"`
}

type Module struct {
	Plugin    string               `yaml:"plugin"` // Must be "native"
	Type      string               `yaml:"type"`   // Primary resource type hint
	Inputs    map[string]InputDef  `yaml:"inputs"`
	Resources map[string]Resource  `yaml:"resources"`
	Outputs   map[string]OutputDef `yaml:"outputs"`

	// ResourceOrder preserves the YAML declaration order of resources.
	// The Apply loop iterates in this order so that sequentially-declared
	// resources execute top-to-bottom (matching author expectations).
	ResourceOrder []string `yaml:"-"`
}

type OutputDef struct {
	Value       string `yaml:"value"` // Expression to evaluate
	Description string `yaml:"description"`
	Sensitive   bool   `yaml:"sensitive"`
}

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

type PortMapping struct {
	ContainerPort int
	HostPort      int
	Protocol      string
}

type ProcessInfo struct {
	PID         int
	Name        string
	Command     []string
	Environment map[string]string
	WorkingDir  string
}

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

type ProcessOptions struct {
	Name        string
	WorkingDir  string
	Command     []string
	Environment map[string]string
	// Readiness check configuration
	Readiness *ReadinessCheck
	// Graceful stop configuration
	GracefulStop *GracefulStop
	// Stdout receives process stdout. If nil, output is discarded.
	Stdout io.Writer
	// Stderr receives process stderr. If nil, output is discarded.
	Stderr io.Writer
}

type ReadinessCheck struct {
	Type     string        // "http" or "tcp"
	Endpoint string        // For HTTP: full URL, for TCP: host:port
	Interval time.Duration // How often to check
	Timeout  time.Duration // Total time to wait for ready
}

type ResolvedDestroyCommand struct {
	Command     []string          `json:"command"`
	Image       string            `json:"image,omitempty"`
	Network     string            `json:"network,omitempty"`
	WorkDir     string            `json:"working_dir,omitempty"`
	Environment map[string]string `json:"environment,omitempty"`
}

type Resource struct {
	Type       string                 `yaml:"type"`
	When       string                 `yaml:"when,omitempty"`
	Properties map[string]interface{} `yaml:"properties"`
	DependsOn  []string               `yaml:"depends_on"`
	Destroy    *DestroyCommand        `yaml:"destroy,omitempty"`
}

type ResourceState struct {
	Type       string                 `json:"type"`
	ID         interface{}            `json:"id"`
	Properties map[string]interface{} `json:"properties"`
	Outputs    map[string]interface{} `json:"outputs"`
	// DestroyCmd holds a resolved destroy command to execute during teardown.
	// Nil if the resource has no custom destroy behaviour.
	DestroyCmd *ResolvedDestroyCommand `json:"destroy_cmd,omitempty"`
}

type RunOneShotOptions struct {
	Image            string
	Command          []string
	Environment      map[string]string
	Network          string
	WorkDir          string
	ResolveLocalhost bool // Replace "localhost" in env var values with "host.docker.internal"
}

type State struct {
	ModulePath string                    `json:"module_path"`
	Inputs     map[string]interface{}    `json:"inputs"`
	Resources  map[string]*ResourceState `json:"resources"`
	Outputs    map[string]interface{}    `json:"outputs"`
}

type VolumeMount struct {
	Name   string
	Source string
	Path   string
}