corvix.notifications.models

Domain event models for notification delivery.

Classes

NotificationEvent	Canonical event produced when a new unread notification is detected.
DeliveryResult	Result of a single target's delivery attempt.
DispatchResult	Aggregated result of a fan-out dispatch to all enabled targets.

Module Contents

class corvix.notifications.models.NotificationEvent

Canonical event produced when a new unread notification is detected.

This is the payload passed to every delivery target. It is deliberately decoupled from the internal NotificationRecord so targets only depend on this stable interface.

event_id: str

Stable identifier: {account_id}:{thread_id}.

thread_id: str

repository: str

reason: str

subject_title: str

subject_type: str

web_url: str | None

updated_at: datetime.datetime

score: float

unread: bool

account_id: str = 'primary'

class corvix.notifications.models.DeliveryResult

Result of a single target’s delivery attempt.

target: str

events_attempted: int

events_delivered: int

errors: list[str] = []

property success: bool

class corvix.notifications.models.DispatchResult

Aggregated result of a fan-out dispatch to all enabled targets.

events: list[NotificationEvent]

results: list[DeliveryResult] = []

property total_delivered: int

property total_errors: int