notification

type DBNotification struct {
	ID             string     `gorm:"primaryKey;size:36" json:"id"`
	Type           string     `gorm:"size:255;index" json:"type"`
	NotifiableID   string     `gorm:"size:255;index:idx_notifiable" json:"notifiable_id"`
	NotifiableType string     `gorm:"size:255;index:idx_notifiable" json:"notifiable_type"`
	Data           string     `gorm:"type:text" json:"data"` // JSON-encoded
	ReadAt         *time.Time `json:"read_at"`
	CreatedAt      time.Time  `json:"created_at"`
	UpdatedAt      time.Time  `json:"updated_at"`
}

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

type DatabaseNotification interface {
	Notification
	// ToDatabase returns the data map to store in the notifications table.
	// Return nil to skip the database channel.
	ToDatabase() map[string]any
}

type DiscordChannel struct {
	WebhookURL string
	// Client overrides the HTTP client (default: 10s timeout).
	Client *http.Client
}

type DiscordEmbed struct {
	Title       string              `json:"title,omitempty"`
	Description string              `json:"description,omitempty"`
	URL         string              `json:"url,omitempty"`
	Color       int                 `json:"color,omitempty"` // decimal color value
	Fields      []DiscordEmbedField `json:"fields,omitempty"`
	Footer      *DiscordEmbedFooter `json:"footer,omitempty"`
	Timestamp   string              `json:"timestamp,omitempty"` // ISO8601
}

type DiscordEmbedField struct {
	Name   string `json:"name"`
	Value  string `json:"value"`
	Inline bool   `json:"inline,omitempty"`
}

type DiscordEmbedFooter struct {
	Text    string `json:"text"`
	IconURL string `json:"icon_url,omitempty"`
}

type DiscordMessage struct {
	Content   string         `json:"content,omitempty"`
	Username  string         `json:"username,omitempty"`
	AvatarURL string         `json:"avatar_url,omitempty"`
	Embeds    []DiscordEmbed `json:"embeds,omitempty"`
}

type DiscordNotification interface {
	Notification
	// ToDiscord returns the Discord webhook message, or nil to skip.
	ToDiscord() *DiscordMessage
}

type Notification interface {
	// ToMail returns the mail message for this notification, or nil to skip mail.
	ToMail() *mail.Message
	// ToBroadcast returns the channel and payload for realtime broadcasts.
	// Return empty channel to skip broadcast.
	ToBroadcast() (channel string, payload any)
}

type SlackAttachment struct {
	Color    string       `json:"color,omitempty"`
	Title    string       `json:"title,omitempty"`
	Text     string       `json:"text,omitempty"`
	Fields   []SlackField `json:"fields,omitempty"`
	Footer   string       `json:"footer,omitempty"`
	Fallback string       `json:"fallback,omitempty"`
}

type SlackChannel struct {
	WebhookURL string
	// Client overrides the HTTP client (default: 10s timeout).
	Client *http.Client
}

type SlackField struct {
	Title string `json:"title"`
	Value string `json:"value"`
	Short bool   `json:"short,omitempty"`
}

type SlackMessage struct {
	Channel     string            `json:"channel,omitempty"`
	Text        string            `json:"text,omitempty"`
	Username    string            `json:"username,omitempty"`
	IconEmoji   string            `json:"icon_emoji,omitempty"`
	Attachments []SlackAttachment `json:"attachments,omitempty"`
}

type SlackNotification interface {
	Notification
	// ToSlack returns the Slack message, or nil to skip.
	ToSlack() *SlackMessage
}