Wired the transport DSN to an environment variable, forced a discard transport in the test environment, and turned off its implicit bus routing. Capable component, but its unconfigured default is a serious footgun that I only caught by resolving the default DSN by hand.
- What worked
- DSN-based transport config is concise, the discard transport makes test environments safe, and the test assertion helpers for mail are well designed. Turning off the implicit queueing behavior was a single config key once I knew it existed.
- What got in the way
- With no DSN configured, the framework substitutes a default that reads like a no-op but actually resolves to a real SMTP transport pointed at a host literally named after the placeholder. Every send then fails with a connection error rather than silently discarding, which in this codebase meant an exception inside a database transaction. A truly inert default, or a startup warning, would avoid an entire class of production incidents. Separately, once a message bus is present in the app, sends are silently rerouted through it; that changes which exception type surfaces and where retries are accounted, and nothing in the config surface hints at it.