devcontainer

type BuildConfig struct {
	Dockerfile string            `json:"dockerfile,omitempty"`
	Context    string            `json:"context,omitempty"`
	Args       map[string]string `json:"args,omitempty"`
	Target     string            `json:"target,omitempty"`
	CacheFrom  []string          `json:"cacheFrom,omitempty"`
}

type ContainerConfigInfo struct {
	Env    []string
	Labels map[string]string
}

type ContainerCreateOptions struct {
	Name        string
	Image       string
	Cmd         []string
	Env         []string // KEY=VALUE pairs
	Labels      map[string]string
	WorkingDir  string
	User        string
	ExtraHosts  []string // "host:ip" entries for /etc/hosts
	Binds       []string // "src:dst[:opts]" bind mounts
	CapAdd      []string // added capabilities
	SecurityOpt []string // security options
	Privileged  bool
	NetworkMode string
	ShmSize     int64
}

type ContainerInspectResponse struct {
	ID     string
	Name   string
	State  ContainerState
	Image  string
	Config ContainerConfigInfo
}

type ContainerListOptions struct {
	All          bool              // include stopped containers
	LabelFilters map[string]string // label key=value pairs
	NameFilter   string            // filter by container name (Docker regex match)
}

type ContainerRemoveOptions struct {
	Force         bool
	RemoveVolumes bool
}

type ContainerState struct {
	Status   string // "running", "exited", "created", etc.
	Running  bool
	ExitCode int
}

type ContainerSummary struct {
	ID     string
	Names  []string
	Image  string
	State  string // "running", "exited", etc.
	Labels map[string]string
}

type DevcontainerConfig struct {
	Name                 string                 `json:"name,omitempty"`
	Image                string                 `json:"image,omitempty"`
	Build                *BuildConfig           `json:"build,omitempty"`
	DockerFile           string                 `json:"dockerFile,omitempty"`
	Features             map[string]interface{} `json:"features,omitempty"`
	Mounts               []interface{}          `json:"mounts,omitempty"`
	RunArgs              []string               `json:"runArgs,omitempty"`
	ForwardPorts         []interface{}          `json:"forwardPorts,omitempty"`
	RemoteEnv            map[string]string      `json:"remoteEnv,omitempty"`
	ContainerEnv         map[string]string      `json:"containerEnv,omitempty"`
	RemoteUser           string                 `json:"remoteUser,omitempty"`
	ContainerUser        string                 `json:"containerUser,omitempty"`
	WorkspaceFolder      string                 `json:"workspaceFolder,omitempty"`
	CapAdd               []string               `json:"capAdd,omitempty"`
	SecurityOpt          []string               `json:"securityOpt,omitempty"`
	Privileged           bool                   `json:"privileged,omitempty"`
	OverrideCommand      *bool                  `json:"overrideCommand,omitempty"`
	InitializeCommand    interface{}            `json:"initializeCommand,omitempty"`
	OnCreateCommand      interface{}            `json:"onCreateCommand,omitempty"`
	UpdateContentCommand interface{}            `json:"updateContentCommand,omitempty"`
	PostCreateCommand    interface{}            `json:"postCreateCommand,omitempty"`
	PostStartCommand     interface{}            `json:"postStartCommand,omitempty"`
	PostAttachCommand    interface{}            `json:"postAttachCommand,omitempty"`
}

type DockerClient interface {
	// Image operations
	ImageBuild(ctx context.Context, buildContext io.Reader, opts ImageBuildOptions) (io.ReadCloser, error)
	ImagePull(ctx context.Context, ref string, opts ImagePullOptions) (io.ReadCloser, error)
	ImageInspect(ctx context.Context, imageRef string) (ImageInspectResponse, error)
	ImageList(ctx context.Context, opts ImageListOptions) ([]ImageSummary, error)

	// Container lifecycle
	ContainerCreate(ctx context.Context, opts ContainerCreateOptions) (string, error)
	ContainerStart(ctx context.Context, containerID string) error
	ContainerStop(ctx context.Context, containerID string, timeout *int) error
	ContainerRemove(ctx context.Context, containerID string, opts ContainerRemoveOptions) error
	ContainerInspect(ctx context.Context, containerID string) (ContainerInspectResponse, error)
	ContainerList(ctx context.Context, opts ContainerListOptions) ([]ContainerSummary, error)
	ContainerLogs(ctx context.Context, containerID string, opts LogsOptions) (io.ReadCloser, error)
	// ContainerCommit commits the container as an image. env entries are baked
	// into the image as ENV so feature-contributed variables (e.g. the node and
	// go features' PATH additions) persist into containers created from the image.
	ContainerCommit(ctx context.Context, containerID string, ref string, env map[string]string) (string, error)

	// File transfer
	CopyToContainer(ctx context.Context, containerID, dstPath string, content io.Reader) error

	// Exec for lifecycle hooks and user commands.
	ExecCreate(ctx context.Context, containerID string, cmd []string, opts ExecOptions) (string, error)
	ExecAttach(ctx context.Context, execID string) (ExecAttachResponse, error)
	ExecInspect(ctx context.Context, execID string) (ExecInspectResponse, error)

	Close() error
}

type ExecAttachResponse struct {
	Reader io.Reader
	Conn   io.Closer
}

type ExecInspectResponse struct {
	ExitCode int
	Running  bool
}

type ExecOptions struct {
	User         string
	WorkingDir   string
	Env          []string // KEY=VALUE pairs
	AttachStdout bool
	AttachStderr bool
	AttachStdin  bool
	Tty          bool
}

type FeatureMeta struct {
	ID            string                   `json:"id"`
	Version       string                   `json:"version"`
	Name          string                   `json:"name"`
	Options       map[string]FeatureOption `json:"options"`
	InstallsAfter []string                 `json:"installsAfter"`
	ContainerEnv  map[string]string        `json:"containerEnv"`
}

type FeatureOption struct {
	Type    string      `json:"type"`
	Default interface{} `json:"default"`
}

type FeaturePuller interface {
	Pull(ctx context.Context, ref string) (installSh []byte, meta *FeatureMeta, err error)
}

type HumanConfig struct {
	ConfigDir string `yaml:"configdir"`
}

type ImageBuildOptions struct {
	Dockerfile string
	Tags       []string
	BuildArgs  map[string]*string
	Target     string
	CacheFrom  []string
	Remove     bool // remove intermediate containers
}

type ImageBuilder struct {
	Docker DockerClient
	Logger zerolog.Logger
	// Puller fetches devcontainer features; defaults to an OCI registry puller
	// when nil. Injectable so feature installation can be tested without a registry.
	Puller FeaturePuller
}

type ImageInspectResponse struct {
	ID   string
	Tags []string
}

type ImageListOptions struct {
	LabelFilters map[string]string // label key=value pairs
}

type ImagePullOptions struct {
	RegistryAuth string // base64-encoded auth for private registries
}

type ImageSummary struct {
	ID   string
	Tags []string
}

type LogsOptions struct {
	Follow     bool
	Tail       string // number of lines, e.g. "100"
	ShowStdout bool
	ShowStderr bool
}

type Manager struct {
	Docker DockerClient
	Logger zerolog.Logger
}

type Meta struct {
	Name          string    `json:"name"`
	ProjectDir    string    `json:"project_dir"`
	ContainerID   string    `json:"container_id"`
	ContainerName string    `json:"container_name"`
	ImageID       string    `json:"image_id"`
	ImageName     string    `json:"image_name"`
	Status        Status    `json:"status"`
	CreatedAt     time.Time `json:"created_at"`
	StartedAt     time.Time `json:"started_at,omitempty"`
	StoppedAt     time.Time `json:"stopped_at,omitempty"`
	WorkspaceDir  string    `json:"workspace_dir"`
	RemoteUser    string    `json:"remote_user"`
	DaemonAddr    string    `json:"daemon_addr,omitempty"`
	ConfigHash    string    `json:"config_hash"`
}

type OCIFeaturePuller struct{}

type Status string

type UpOptions struct {
	ProjectDir    string
	Rebuild       bool
	DaemonInfo    *daemon.DaemonInfo // nil = no daemon injection
	Out           io.Writer
	ContainerName string // override container name (default: derived from project dir)
	SourceDir     string // override mount source (default: same as ProjectDir)
}