services

type ServiceManager interface {

	// WriteServiceUnit writes a named service unit file.
	WriteServiceUnit(name, content string) error

	// WriteServiceUnitIfChanged writes the unit file only when the content has
	// changed. Returns true if the file was written (caller should DaemonReload).
	WriteServiceUnitIfChanged(name, content string) (bool, error)

	// RemoveServiceUnit removes the unit file for the named service.
	RemoveServiceUnit(name string) error

	// WriteTimerUnitIfChanged writes a timer unit file (paired with a
	// matching oneshot service) only when the content has changed. Used
	// for scheduled framework workers like Laravel 10's `schedule:run`,
	// which is a one-shot cron-style command rather than a daemon and
	// would otherwise restart-loop under the always-on worker model.
	// On platforms that lack a native timer concept the implementation
	// may be a no-op that returns (false, nil).
	WriteTimerUnitIfChanged(name, content string) (bool, error)

	// RemoveTimerUnit removes the timer unit file for the named worker.
	// May be a no-op on platforms without timer support.
	RemoveTimerUnit(name string) error

	// ListTimerUnits returns timer unit names whose files match nameGlob,
	// each suffixed with `.timer` (so callers can pass them straight to
	// systemctl without ambiguity against the sibling .service unit).
	// Platforms without native timer support return an empty slice.
	ListTimerUnits(nameGlob string) []string

	// ListServiceUnits returns unit names whose files match nameGlob.
	// e.g. nameGlob="lerd-queue-*" → ["lerd-queue-myapp", …]
	ListServiceUnits(nameGlob string) []string

	// WriteContainerUnit writes a named container unit file.
	WriteContainerUnit(name, content string) error

	// ContainerUnitInstalled returns true if the container unit file exists.
	ContainerUnitInstalled(name string) bool

	// RemoveContainerUnit removes the container unit file for the named unit.
	RemoveContainerUnit(name string) error

	// ListContainerUnits returns container unit names whose files match nameGlob.
	// e.g. nameGlob="lerd-*" → ["lerd-dns", "lerd-nginx", …]
	ListContainerUnits(nameGlob string) []string

	// DaemonReload reloads the service manager configuration.
	DaemonReload() error

	// Start starts a named unit.
	Start(name string) error

	// Stop stops a named unit.
	Stop(name string) error

	// Restart restarts a named unit.
	Restart(name string) error

	// Enable marks a named unit to start at login.
	Enable(name string) error

	// Disable removes a named unit from the login start set.
	Disable(name string) error

	// IsActive returns true if the named unit is currently running.
	IsActive(name string) bool

	// IsEnabled returns true if the named unit is set to start at login.
	IsEnabled(name string) bool

	// UnitStatus returns the active state string (e.g. "active", "inactive", "failed").
	UnitStatus(name string) (string, error)
}