image

type BuildOptions struct {
	ArtifactID string
	// PostRootfsExport is invoked after the image rootfs has been exported to
	// the working directory but before mkfs.ext4 runs, so callers can mutate
	// the rootfs (e.g. bake the CubeEgress root CA into the trust store). The
	// callback receives the rootfs directory path that mkfs.ext4 will consume.
	// A non-nil error aborts the build.
	PostRootfsExport func(ctx context.Context, rootfsDir string) error
}

type BuildResult struct {
	Ext4Path  string
	SHA256    string
	SizeBytes int64
}

type DockerImageConfig struct {
	Entrypoint []string `json:"Entrypoint"`
	Cmd        []string `json:"Cmd"`
	Env        []string `json:"Env"`
	WorkingDir string   `json:"WorkingDir"`
	User       string   `json:"User"`
}

type ExportMode string

type PreparedSource struct {
	LocalRef       string
	Digest         string
	Config         DockerImageConfig
	ConfigJSON     string
	MasterNodeIP   string
	SkopeoAuthFile string
	// CompressedSizeBytes is the sum of compressed layer blob sizes reported by
	// skopeo inspect on the dockerless path, or by the image manifest on the
	// native path. It lets disk-space pre-checks estimate image size without
	// invoking the docker daemon. Zero means "unknown".
	CompressedSizeBytes int64
	// ExportMode is determined during the Prepare phase and controls which path is used during the Export phase.
	// An empty value is equivalent to ExportModeDocker (for backward compatibility).
	ExportMode ExportMode

	// RegistryAuth preserves the original Registry credentials for use by the native path.
	RegistryAuth *RegistryAuthConfig

	Cleanup func(context.Context)
	// OnPullProgress is propagated from SourceSpec so that the export phase
	// (skopeo copy on the dockerless path) can stream pull progress even
	// though it runs after PrepareSource has returned.
	OnPullProgress ProgressFunc
	// contains filtered or unexported fields
}

type ProgressFunc func(PullProgress)

type PullProgress struct {
	TotalBytes      int64
	DownloadedBytes int64
	TotalLayers     int
	CompletedLayers int
	SpeedBPS        int64
	Percent         float64
}

type RegistryAuthConfig struct {
	Username string
	Password string
}

type SourceSpec struct {
	ImageRef         string
	RegistryUsername string
	RegistryPassword string
	DownloadBaseURL  string
	// OnPullProgress, when non-nil, receives best-effort source-image pull
	// progress updates while the image is fetched (docker pull on the docker
	// path, skopeo copy on the dockerless path). A nil value disables progress
	// streaming and preserves the original buffered-exec behaviour.
	OnPullProgress ProgressFunc
}