notificationpreferenceep

type ListNotificationPreferencesEndpoint struct{}

type ListNotificationPreferencesRequest struct{}

type NotificationPreferenceSvc interface {
	ListNotificationPreferences(ctx context.Context, req *ListNotificationPreferencesRequest) (*apiresource.List[apiresource.NotificationPreference], *apierror.APIError)
	UpsertNotificationPreference(ctx context.Context, req *UpsertNotificationPreferenceRequest) (*apiresource.NotificationPreference, *apierror.APIError)
}

type NotificationPreferenceSvcConfig struct {
	// MessagingClient (required) is the notification-service MessagingService gRPC client.
	MessagingClient pb.MessagingServiceClient
}

type UpsertNotificationPreferenceEndpoint struct{}

type UpsertNotificationPreferenceRequest struct {
	// The notification category these settings apply to, such as `chat.message`.
	//
	// Leave it out to set the global default used for every category without its own preference.
	Category field.Clearable[string] `json:"category,omitzero"`
	// Whether notifications in this category appear in the user's in-app feed.
	//
	// A direct @mention is always delivered in-app, even when this is off.
	InAppEnabled bool `json:"in_app_enabled"`
	// Whether notifications in this category are also emailed to the user.
	//
	// Email is additionally suppressed for a conversation the user has muted, and only sent on the cadence set by `digest`.
	EmailEnabled bool `json:"email_enabled"`
	// Whether notifications in this category are also sent as push notifications.
	//
	// Push delivery is not available yet; the choice is stored for when it is.
	PushEnabled bool `json:"push_enabled"`
	// How often email for this category is sent.
	//
	// - `instant`: send an email as soon as an eligible notification occurs.
	// - `hourly`: collect eligible notifications into a single hourly email.
	// - `daily`: collect eligible notifications into a single daily email.
	// - `off`: never send email for this category, even when email is otherwise enabled.
	//
	// This governs email only; in-app delivery is unaffected. Batched sending is not running yet, so `hourly` and `daily` currently hold email back in the same way as `off`.
	Digest field.Optional[constants.NotificationDigest] `json:"digest,omitzero" default:"instant"`
}