event

Documentation

Overview

Package event. event provides a strongly-typed event bus system for decoupling core logic from side effects.

Index

• type Event
  • func NewEvent(eventType EventType, data any) *Event
  • func (e *Event) WithMetadata(key string, value any) *Event
• type EventType

Types

type Event

type Event struct {
	Type      EventType      // Strongly-typed event identifier
	Timestamp time.Time      // When the event occurred
	Data      any            // Event-specific payload
	Metadata  map[string]any // Additional context (e.g., request ID, user agent)
}

Event represents a generic event that flows through the system.

func NewEvent

func NewEvent(eventType EventType, data any) *Event

NewEvent creates a new event with the given type and data.

func (*Event) WithMetadata

func (e *Event) WithMetadata(key string, value any) *Event

WithMetadata adds metadata to the event and returns the event for chaining.

type EventType

type EventType string

EventType represents a strongly-typed event identifier to prevent typos and ensure consistency.