provider

type AppData struct {
	Owner     v1beta1.Username
	Targets   []dependency.OCIPullTarget
	TmpPath   string
	CleanupFn func() error
}

type ApplicationSpec struct {
	// Name of the application
	Name string
	// ID of the application
	ID string
	// Type of the application
	AppType v1beta1.AppType
	// User that the app should be run under
	User v1beta1.Username
	// Path to the application
	Path string
	// EnvVars are the environment variables to be passed to the application
	EnvVars map[string]string
	// Embedded is true if the application is embedded in the device
	Embedded bool

	// Volume manager.
	Volume VolumeManager

	// App-type-specific specs (only one will be set based on AppType)
	ContainerApp *v1beta1.ContainerApplication
	HelmApp      *v1beta1.HelmApplication
	ComposeApp   *v1beta1.ComposeApplication
	QuadletApp   *v1beta1.QuadletApplication
	// contains filtered or unexported fields
}

type CacheEntry struct {
	Name  string
	Owner v1beta1.Username
	// Parent is the parent image from which child OCI targets were extracted.
	Parent dependency.OCIPullTarget
	// Children are OCI targets extracted from parent image.
	Children []dependency.OCIPullTarget
}

type Diff struct {
	// Ensure contains both newly added and unchanged app provders
	Ensure []Provider
	// Removed contains app providers that are no longer part of the desired state
	Removed []Provider
	// Changed contains app providers that have changed between the current and desired state
	Changed []Provider
}

type OCITargetCache struct {
	// contains filtered or unexported fields
}

type ParseOpt func(*parseConfig)

type Provider interface {
	// Verify the application content is valid and dependencies are met.
	Verify(ctx context.Context) error
	// Install the application content to the device.
	Install(ctx context.Context) error
	// Remove the application content from the device.
	Remove(ctx context.Context) error
	// Name returns the name of the application.
	Name() string
	// ID returns the unique identifier for the application.
	ID() string
	// Spec returns the application spec.
	Spec() *ApplicationSpec
}

type Volume struct {
	// Name is the user defined name for the volume
	Name string
	// ID is a unique internal idenfier used to create the actual volume
	ID string
	// Reference is the reference used to populate the volume
	Reference string
	// Available is true if the volume has been created
	Available bool
	// ReclaimPolicy controls how the volume is handled when the application is removed
	ReclaimPolicy v1beta1.ApplicationVolumeReclaimPolicy
}

type VolumeManager interface {
	// Get returns the Volume by name, if it exists.
	Get(name string) (*Volume, bool)
	// Add adds a new Volume to the manager.
	Add(volume *Volume)
	// Update updates an existing Volume. Returns true if the volume existed and was updated.
	Update(volume *Volume) bool
	// Remove deletes the Volume by name. Returns true if the volume existed and was removed.
	Remove(name string) bool
	// List returns all managed Volumes.
	List() []*Volume
	// Status populates the given DeviceApplicationStatus with volume status information.
	Status(status *v1beta1.DeviceApplicationStatus)
	// UpdateStatus processes a Podman event and updates internal volume status as needed.
	UpdateStatus(event *client.PodmanEvent)
	// AddVolumes adds all specified volumes to the manager. An ID will be added if one does not exist
	AddVolumes([]*Volume)
}