types

type Delivery interface {
	Dispatch(ctx context.Context, n Payload, receivers []*Receiver) error
}

type DeliveryResult struct {
	Status     string // Target-specific status (e.g., HTTP status).
	StatusCode int    // Numeric status code when available.
	Response   string // Target-specific response summary/body.
}

type HeartbeatMeta struct {
	Title     string        // Heartbeat title.
	Interval  time.Duration // Expected heartbeat interval.
	LateAfter time.Duration // Late window duration.
}

type HeartbeatRegistry interface {
	RegisterHeartbeat(heartbeatID string, meta HeartbeatMeta)
}

type Notification interface {
	HeartbeatID() string
	Status() string
	Payload() string
	Since() time.Duration
	Timestamp() time.Time
	ReceiverNames() []string
}

type Notifier interface {
	Enqueue(n Notification) string
}

type Payload struct {
	HeartbeatID string        // Heartbeat identifier.
	Title       string        // Heartbeat title.
	Status      string        // Status identifier.
	Payload     string        // Raw last payload.
	Timestamp   time.Time     // Event time.
	Interval    time.Duration // Expected heartbeat interval.
	LateAfter   time.Duration // Late window duration.
	Since       time.Duration // Time since last heartbeat.
}

type Receiver struct {
	Name    string         // Receiver name.
	Retry   RetryConfig    // Retry policy.
	Targets []Target       // Delivery targets.
	Vars    map[string]any // Receiver variables.
}

type ReceiverRegistry interface {
	Register(heartbeatID string, receivers map[string]*Receiver)
}

type ResultTarget interface {
	SendResult(n Payload) (DeliveryResult, error)
}

type RetryConfig struct {
	Count int           // Number of retries.
	Delay time.Duration // Delay between retries.
}

type Target interface {
	Send(n Payload) error
	Type() string
}

type TargetType int