transform

type IgnoredOperation struct {
	// Operation is the JSONPatch operation that was ignored
	Operation jsonpatch.Operation

	// Plugin is the name of the plugin that generated this operation
	Plugin string

	// Reason describes why the operation was ignored (e.g., "path-conflict-priority")
	Reason string

	// WinnerPlugin is the name of the plugin whose operation was selected instead
	WinnerPlugin string
}

type Metadata interface {
	Metadata() PluginMetadata
}

type OptionalFields struct {
	FlagName string `json:"flagName"`
	Help     string `json:"help"`
	Example  string `json:"example"`
}

type PatchTarget struct {
	// Group is the API group (empty string for core resources)
	Group string

	// Version is the API version (e.g., "v1", "v1beta1")
	Version string

	// Kind is the resource kind (e.g., "Deployment", "Service")
	Kind string

	// Name is the resource name from metadata.name
	Name string

	// Namespace is the resource namespace from metadata.namespace (optional)
	Namespace string
}

type Plugin interface {
	PluginRun
	Metadata
}

type PluginMetadata struct {
	Name            string           `json:"name"`
	Version         string           `json:"version"`
	RequestVersion  []Version        `json:"requestVersion"`
	ResponseVersion []Version        `json:"responseVersion"`
	OptionalFields  []OptionalFields `json:"optionalFields,omitempty"`
}

type PluginOperation struct {
	PluginName string
	Operation  jsonpatch.Operation
}

type PluginRequest struct {
	unstructured.Unstructured `json:",inline"`
	Extras                    map[string]string `json:"extras,omitempty"`
}

type PluginResponse struct {
	Version      string                      `json:"version,omitempty"`
	IsWhiteOut   bool                        `json:"isWhiteOut,omitempty"`
	Patches      jsonpatch.Patch             `json:"patches,omitempty"`
	NewResources []unstructured.Unstructured `json:"newResources,omitempty"`
}

type PluginRun interface {
	// Determine for a given resources what the plugin is deciding to do with this
	Run(PluginRequest) (PluginResponse, error)
}

type ResourceGroup struct {
	// TypeKey is the unique identifier for this resource type
	// Format: "<kind>" for core resources, "<kind>.<group>" for others
	// Examples: "deployment", "service", "route.route.openshift.io"
	TypeKey string

	// Resources contains all resources of this type
	Resources []unstructured.Unstructured
}

type Runner struct {
	// This is where we need to put extra info
	// This should include generic args to be passed to each Plugin
	// This also needs to handle the options that it will need.
	// TODO: Figure out options that the runner will need and implement here.
	PluginPriorities map[string]int
	OptionalFlags    map[string]string
	Log              *logrus.Logger
}

type RunnerResponse struct {
	TransformFile  []byte
	HaveWhiteOut   bool
	IgnoredPatches []byte
	NewResources   []unstructured.Unstructured
}

type TransformArtifact struct {
	// Resource is the original Kubernetes resource
	Resource unstructured.Unstructured

	// HaveWhiteOut indicates if this resource should be excluded from output
	HaveWhiteOut bool

	// Patches contains all JSONPatch operations to be applied
	Patches jsonpatch.Patch

	// IgnoredOps contains operations that were ignored due to conflicts
	IgnoredOps []IgnoredOperation

	// Target contains the Kustomize patch target metadata
	Target PatchTarget

	// PluginName is the name of the plugin that generated this artifact (for multi-stage)
	PluginName string
}

type Version string