oci

type BuildOptions struct {
	// Name is the artifact name (defaults to repository's last segment if empty).
	Name string
	// SourcePath is the directory containing Kubernetes manifest files (required).
	SourcePath string
	// RegistryEndpoint is the registry host:port (required, protocol prefixes are stripped).
	RegistryEndpoint string
	// Repository is the repository path (defaults to source directory basename if empty).
	Repository string
	// Version is the artifact tag (required, can be any non-empty string such as "dev", "latest", or a semantic version).
	Version string
	// GitOpsEngine specifies the GitOps engine for which to optimize the artifact structure.
	// When set to GitOpsEngineFlux, files are placed at the root.
	// When set to GitOpsEngineArgoCD, files are placed under a prefix directory.
	// When empty or GitOpsEngineNone, files are placed at both locations for compatibility (default).
	GitOpsEngine v1alpha1.GitOpsEngine
}

type BuildResult struct {
	// Artifact contains the complete OCI artifact metadata after successful push.
	Artifact v1alpha1.OCIArtifact
}

type Reference struct {
	Host       string
	Port       int32
	Repository string
	Variant    string
	Ref        string
}

type ValidatedBuildOptions struct {
	// Name is the normalized artifact name.
	Name string
	// SourcePath is the absolute path to the manifest directory.
	SourcePath string
	// RegistryEndpoint is the normalized registry host:port.
	RegistryEndpoint string
	// Repository is the normalized repository path.
	Repository string
	// Version is the validated version string.
	Version string
	// GitOpsEngine specifies the target GitOps engine for artifact structure optimization.
	GitOpsEngine v1alpha1.GitOpsEngine
}

type WorkloadArtifactBuilder interface {
	// Build validates the supplied options, constructs an OCI artifact from manifests,
	// and pushes it to the registry. Returns BuildResult with artifact metadata on success.
	Build(ctx context.Context, opts BuildOptions) (BuildResult, error)
}