Architecture

This section describes the internal architecture and design rationale of Go Event Bus.

The library is composed of three orthogonal layers:

1. Event Definition & Serialization - Events, Registry, Envelopes, Upcasters
2. Execution Pipeline (Invoker Chain) - Cross-cutting concerns as composable middleware
3. Transport / Delivery Mechanism - LocalBus, NATS Core, JetStream

These layers are intentionally decoupled. You can change your transport without touching your invoker chain, evolve your schema without affecting handlers, and add middleware without modifying events.

This architecture prioritizes correctness, observability, and long-term maintainability over convenience.

---

Table of contents

• Execution Pipeline
• Transport Layer
• Distributed Safety
• Failure Model