desktop.go RawHistoryFolder

1package port
2
3import "context"
4
5// DesktopIntegrationStatus represents the current state of desktop integration.
6type DesktopIntegrationStatus struct {
7	DesktopFileInstalled bool
8	DesktopFilePath      string
9	IconInstalled        bool
10	IconFilePath         string
11	IsDefaultBrowser     bool
12	ExecutablePath       string
13}
14
15// DesktopIntegration provides desktop environment integration operations.
16type DesktopIntegration interface {
17	// GetStatus checks the current desktop integration state.
18	GetStatus(ctx context.Context) (*DesktopIntegrationStatus, error)
19
20	// InstallDesktopFile writes the desktop file to XDG applications directory.
21	// Returns the path where the file was installed.
22	// Idempotent: safe to call multiple times.
23	InstallDesktopFile(ctx context.Context) (string, error)
24
25	// InstallIcon writes the icon file to XDG icons directory.
26	// Returns the path where the icon was installed.
27	// Idempotent: safe to call multiple times.
28	InstallIcon(ctx context.Context, svgData []byte) (string, error)
29
30	// RemoveDesktopFile removes the desktop file from XDG applications directory.
31	// Idempotent: returns nil if file doesn't exist.
32	RemoveDesktopFile(ctx context.Context) error
33
34	// RemoveIcon removes the icon file from XDG icons directory.
35	// Idempotent: returns nil if file doesn't exist.
36	RemoveIcon(ctx context.Context) error
37
38	// SetAsDefaultBrowser sets dumber as the default web browser using xdg-settings.
39	// Returns error if desktop file is not installed.
40	SetAsDefaultBrowser(ctx context.Context) error
41
42	// UnsetAsDefaultBrowser resets default browser if dumber is currently default.
43	// Idempotent: returns nil if not currently default.
44	UnsetAsDefaultBrowser(ctx context.Context) error
45}