devices

type Device struct {
	SerialNumber        string      `json:"serial_number"`
	Groups              []string    `json:"groups"`
	MDMUserOrDeviceName *string     `json:"mdm_user_or_device_name"` // nullable
	LastSeenAt          TimeOrNever `json:"last_seen_at"`            // date-time or "Never"
	CommandLastRunAt    TimeOrNever `json:"command_last_run_at"`     // date-time or "Never"
	DeviceType          string      `json:"device_type"`
	OSVersion           string      `json:"os_version"`
	HomebrewPrefix      string      `json:"homebrew_prefix"`
	HomebrewVersion     string      `json:"homebrew_version"`
	WorkbrewVersion     string      `json:"workbrew_version"`
	FormulaeCount       int         `json:"formulae_count"`
	CasksCount          int         `json:"casks_count"`
}

type DevicesResponse []Device

type DevicesServiceInterface interface {
	// ListDevices returns a list of devices
	//
	// Returns devices with serial numbers, group assignments, MDM names, last seen timestamps, device types,
	// OS versions, Homebrew/Workbrew versions, and installed package counts.
	ListDevices(ctx context.Context) (*DevicesResponse, *interfaces.Response, error)

	// ListDevicesCSV returns a list of devices in CSV format
	//
	// Returns device data as CSV with columns: serial_number, groups, mdm_user_or_device_name, last_seen_at,
	// command_last_run_at, device_type, os_version, homebrew_prefix, homebrew_version, workbrew_version, formulae_count, casks_count.
	ListDevicesCSV(ctx context.Context) ([]byte, *interfaces.Response, error)
}

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

type TimeOrNever struct {
	Time  *time.Time
	Never bool
}

type TimeOrStatus struct {
	Time   *time.Time
	Status string // "Never", "Not Started", "Not Finished", or empty if Time is set
}