notifications

type NotificationAction struct {
	ID          string `json:"id,omitempty"`
	Title       string `json:"title,omitempty"`
	Destructive bool   `json:"destructive,omitempty"` // (macOS-specific)
}

type NotificationAttachment struct {
	ID   string `json:"id,omitempty"`
	Path string `json:"path"`
	// Type is an optional placement/UTI hint.
	//   On macOS: a UTI like "public.png" / "public.audio" (often inferred).
	//   On Windows: "hero" | "appLogoOverride" | "inline" (default "inline").
	//   On Linux: ignored (always image-path hint).
	Type string `json:"type,omitempty"`
}

type NotificationCategory struct {
	ID               string               `json:"id,omitempty"`
	Actions          []NotificationAction `json:"actions,omitempty"`
	HasReplyField    bool                 `json:"hasReplyField,omitempty"`
	ReplyPlaceholder string               `json:"replyPlaceholder,omitempty"`
	ReplyButtonTitle string               `json:"replyButtonTitle,omitempty"`
}

type NotificationOptions struct {
	ID         string                 `json:"id"`
	Title      string                 `json:"title"`
	Subtitle   string                 `json:"subtitle,omitempty"` // (macOS and Linux only)
	Body       string                 `json:"body,omitempty"`
	CategoryID string                 `json:"categoryId,omitempty"`
	Data       map[string]interface{} `json:"data,omitempty"`

	// Sound controls the sound played on delivery.
	//   nil                                -> platform default sound
	//   &NotificationSound{Silent: true}   -> no sound
	//   &NotificationSound{Name: "Ping"}   -> named/bundled sound
	// On macOS, Name is resolved by [UNNotificationSound soundNamed:] and
	// requires the audio file to live under the bundle's Library/Sounds.
	// On Windows, Name is used as-is if it begins with "ms-winsoundevent:" or
	// "ms-appx:"; otherwise it is wrapped in "ms-winsoundevent:" for built-in
	// event names. On Linux it is forwarded as the freedesktop "sound-name"
	// hint (theme-dependent).
	Sound *NotificationSound `json:"sound,omitempty"`

	// Attachments are media files shown alongside the notification. macOS
	// supports multiple attachments of any media type; Windows and Linux
	// honour the first image-typed attachment (Linux limits to one per spec).
	Attachments []NotificationAttachment `json:"attachments,omitempty"`

	// ThreadID groups related notifications together in Notification Center
	// (macOS) / Action Center (Windows) / the notification daemon (Linux).
	ThreadID string `json:"threadId,omitempty"`

	// InterruptionLevel controls notification priority. One of "passive",
	// "active" (default), "timeSensitive", "critical". Critical requires
	// macOS 12+ and the Critical Alert entitlement. Linux maps to the
	// freedesktop urgency hint; Windows maps to <toast scenario="...">.
	InterruptionLevel string `json:"interruptionLevel,omitempty"`

	// Schedule defers delivery. macOS uses a native trigger and persists
	// across app restarts. Windows and Linux fall back to an in-process
	// time.AfterFunc timer that does NOT survive an app exit.
	Schedule *NotificationSchedule `json:"schedule,omitempty"`
}

type NotificationResponse struct {
	ID               string                 `json:"id,omitempty"`
	ActionIdentifier string                 `json:"actionIdentifier,omitempty"`
	CategoryID       string                 `json:"categoryIdentifier,omitempty"`
	Title            string                 `json:"title,omitempty"`
	Subtitle         string                 `json:"subtitle,omitempty"` // (macOS and Linux only)
	Body             string                 `json:"body,omitempty"`
	UserText         string                 `json:"userText,omitempty"`
	UserInfo         map[string]interface{} `json:"userInfo,omitempty"`
}

type NotificationResult struct {
	Response NotificationResponse
	Error    error
}

type NotificationSchedule struct {
	DelaySeconds int   `json:"delaySeconds,omitempty"`
	At           int64 `json:"at,omitempty"`
}

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

type NotificationSound struct {
	Silent bool   `json:"silent,omitempty"`
	Name   string `json:"name,omitempty"`
}