How pablitovicente/mqtt-to-nats works
MQTT to NATS is a Go bridge that subscribes to MQTT topic filters and stores received messages in NATS JetStream. Users provide one route through flags or several through a YAML file; the CLI loads and validates settings, then the bridge prepares streams and starts one independent MQTT client, queue, and publisher per route. Publishers convert topics to NATS subjects, retry unconfirmed writes, and drain queued messages during shutdown. The README documents reconnect handling, TLS, stream sharing, message IDs, and operational counters; unsampled implementations are represented only where their paths are supported. Arrows are limited to relationships visible in excerpts or explicitly documented.
Main entry points: publisher.go Publish and retry · paho.go MQTT client · root.go CLI command · bridge.go Bridge orchestration
Components 18
Configuration
- CLI command
internal/cli/root.go - Routes YAML
internal/cli/routes_file.go - Settings validation
internal/cli/config.go - Process entry
cmd/main.go
Bridge runtime
- Bridge orchestration
internal/bridge/bridge.go - Stream setup
internal/bridge/streams.go - Route lifecycle
internal/bridge/route.go - Message queue
internal/bridge/queue.go - Publish and retry
internal/bridge/publisher.go - Route statistics
internal/bridge/stats.go
Protocol clients
- MQTT client
internal/broker/paho.go - Broker interface
internal/broker/broker.go - MQTT TLS
internal/broker/tls.go
Topic mapping
- Filter rules
internal/topics/filter.go - Subject conversion
internal/topics/subject.go
Other components
- Operator
- MQTT broker
- NATS JetStream
Connections 23
- Operator → Process entry: starts
cmd/main.go - Process entry → CLI command: executes
cmd/main.go - Operator → Routes YAML: supplies routes
README.md - CLI command → Routes YAML: loads
internal/cli/routes_file.go - CLI command → Settings validation: validates
internal/cli/config.go - CLI command → Bridge orchestration: runs
internal/cli/root.go - Settings validation → Filter rules: checks routes
internal/cli/config.go - Settings validation → Subject conversion: checks subjects
internal/cli/config.go - Bridge orchestration → Stream setup: sets up streams
internal/bridge/bridge.go - Bridge orchestration → Route lifecycle: starts routes
internal/bridge/bridge.go - Bridge orchestration → Route statistics: reports counters
internal/bridge/bridge.go - Route lifecycle → MQTT client: connects
internal/bridge/route.go - Route lifecycle → Message queue: creates
internal/bridge/route.go - Route lifecycle → Publish and retry: starts
internal/bridge/route.go - MQTT client → Broker interface: implements
internal/broker/paho.go - MQTT client → MQTT TLS: configures TLS
- MQTT client → MQTT broker: subscribes
internal/broker/paho.go - MQTT broker → MQTT client: delivers messages
README.md - Publish and retry → Message queue: drains messages
internal/bridge/publisher.go - Publish and retry → Subject conversion: converts topics
internal/bridge/publisher.go - Publish and retry → NATS JetStream: publishes
internal/bridge/publisher.go - Stream setup → NATS JetStream: creates streams
README.md - Route statistics → Publish and retry: reads counters