notification.go RawHistoryFolder

1package port
2
3import "context"
4
5// NotificationType indicates the visual style of a notification.
6type NotificationType int
7
8const (
9	// NotificationInfo is for informational messages.
10	NotificationInfo NotificationType = iota
11	// NotificationSuccess is for success confirmations.
12	NotificationSuccess
13	// NotificationError is for error messages.
14	NotificationError
15	// NotificationWarning is for warning messages.
16	NotificationWarning
17)
18
19// String returns a human-readable representation of the notification type.
20func (t NotificationType) String() string {
21	switch t {
22	case NotificationInfo:
23		return "info"
24	case NotificationSuccess:
25		return "success"
26	case NotificationError:
27		return "error"
28	case NotificationWarning:
29		return "warning"
30	default:
31		return "info"
32	}
33}
34
35// NotificationID uniquely identifies a displayed notification.
36type NotificationID string
37
38// Notification represents the port interface for user notifications/toasts.
39// This abstracts the presentation layer (GTK/libadwaita toasts, frontend overlay, etc.).
40type Notification interface {
41	// Show displays a notification with the given message and type.
42	// Duration is in milliseconds; pass 0 for default duration.
43	// Returns an ID that can be used to dismiss the notification.
44	Show(ctx context.Context, message string, notifType NotificationType, durationMs int) NotificationID
45
46	// ShowZoom displays a special zoom level notification.
47	// These typically appear in a fixed position and auto-dismiss.
48	ShowZoom(ctx context.Context, zoomPercent int) NotificationID
49
50	// Dismiss removes a specific notification by ID.
51	Dismiss(ctx context.Context, id NotificationID)
52
53	// Clear removes all displayed notifications.
54	Clear(ctx context.Context)
55}