resource

type ApplyOptions struct {
	// FieldManager identifies the actor for managed-fields tracking.
	// Defaults to "apoxy-cli" when empty.
	FieldManager string
	// Force resolves field-ownership conflicts in this caller's favor.
	Force bool
}

type CustomPrinterConfig[T, TList any] struct {
	Header   func(showLabels bool) pretty.Header
	BuildRow func(item T, showLabels bool) []interface{}
	GetItems func(list TList) []T
}

type Object interface {
	runtime.Object
	metav1.Object
}

type ResourceClient[T, TList any] interface {
	Get(ctx context.Context, name string, opts metav1.GetOptions) (T, error)
	List(ctx context.Context, opts metav1.ListOptions) (TList, error)
	Create(ctx context.Context, obj T, opts metav1.CreateOptions) (T, error)
	Delete(ctx context.Context, name string, opts metav1.DeleteOptions) error
	Patch(ctx context.Context, name string, pt types.PatchType, data []byte, opts metav1.PatchOptions, subresources ...string) (T, error)
}

type ResourceCommand[T Object, TList runtime.Object] struct {
	Use      string
	Aliases  []string
	Short    string
	Long     string
	KindName string

	ClientFunc func(*rest.APIClient) ResourceClient[T, TList]

	// Exactly one of these must be set.
	TablePrinter  *TablePrinterConfig[T, TList]
	CustomPrinter *CustomPrinterConfig[T, TList]

	// PostGet is an optional hook called after Get to display additional information.
	PostGet func(ctx context.Context, c *rest.APIClient, name string, obj T) error

	// ListFlags registers custom flags on both the root and list commands.
	// Returns a function that produces a field selector string from those flags.
	ListFlags func(cmd *cobra.Command) func() string

	// ListLabelFlags registers custom flags on both the root and list commands.
	// Returns a function that produces a label selector string from those flags.
	ListLabelFlags func(cmd *cobra.Command) func() string

	// ListArgLabelSelector, if set, allows the root and list commands to
	// accept an optional single positional argument (typically a parent
	// resource's name) and turns it into a label selector, mirroring how
	// `get <name>` takes its name positionally instead of via a flag.
	ListArgLabelSelector func(arg string) string

	// NameTransform converts a user-facing name argument into the internal
	// metadata.name used by the API. If nil, the argument is used as-is.
	NameTransform func(string) (string, error)

	// ResolveName converts a user-facing name argument into the internal
	// metadata.name, with API access for lookups (e.g. resolving an alias
	// or a spec field back to the object name). Takes precedence over
	// NameTransform in get and delete when set.
	ResolveName func(ctx context.Context, c *rest.APIClient, arg string) (string, error)

	// DefaultName derives metadata.name from the object's spec when
	// metadata.name is empty. Used by the apply command.
	// If nil, metadata.name must be provided in the input.
	DefaultName func(T) (string, error)

	// PreApply is called before server-side apply and may mutate the object
	// (e.g. set annotations). If nil, no pre-processing is done.
	PreApply func(ctx context.Context, obj T) error
}

type TableConverter interface {
	ConvertToTable(ctx context.Context, tableOptions runtime.Object) (*metav1.Table, error)
}

type TablePrinterConfig[T, TList any] struct {
	ObjToTable  func(T) TableConverter
	ListToTable func(TList) TableConverter
}