How eukalpia/podbus works
PodBus is a Dart messaging toolkit, not a broker. An application uses shared contracts to publish or consume typed messages, or enqueue durable jobs; a selected transport provides broker delivery, while policy and PostgreSQL helpers support retries, idempotency, and database-publish reliability. The README also describes observability and Serverpod integration. Connections below follow documented package capabilities and examples; individual implementation call paths were not sampled.
Main entry points: message_bus.dart Messaging contracts · durable_job_queue.dart Durable job contract · nats_message_bus.dart NATS Core bus · nats_jetstream_job_queue.dart JetStream jobs
Components 17
Core contracts
- Messaging contracts
packages/podbus_core/lib/src/message_bus.dart - Typed JSON codec
packages/podbus_core/lib/src/codec.dart - Capability checks
packages/podbus_core/lib/src/capabilities.dart - Retry policies
packages/podbus_core/lib/src/policies.dart - Durable job contract
packages/podbus_core/lib/src/durable_job_queue.dart
Transport adapters
- NATS Core bus
packages/podbus_nats/lib/src/nats_message_bus.dart - JetStream jobs
packages/podbus_nats/lib/src/nats_jetstream_job_queue.dart - RabbitMQ adapter
packages/podbus_rabbitmq/lib/src/rabbitmq_message_bus.dart - Kafka adapter
packages/podbus_kafka/lib/src/kafka_event_bus.dart
Reliability state
- Transactional outbox
packages/podbus_postgres/lib/src/postgres_outbox.dart - Inbox leases
packages/podbus_postgres/lib/src/postgres_inbox.dart - Persistent idempotency
packages/podbus_postgres/lib/src/postgres_idempotency_store.dart
Operations integrations
- Metrics and tracing
packages/podbus_observability/lib/src/instrumentation.dart - Health probes
packages/podbus_observability/lib/src/health_probe.dart - Serverpod lifecycle
packages/podbus_serverpod/lib/src/serverpod_messaging.dart
Other components
- Dart application
- Message brokers
Connections 19
- Dart application → Messaging contracts: uses API
README.md - Dart application → Capability checks: checks support
README.md - Messaging contracts → Typed JSON codec: encodes payloads
README.md - Messaging contracts → NATS Core bus: selects transport
README.md - Messaging contracts → RabbitMQ adapter: selects transport
README.md - Messaging contracts → Kafka adapter: selects transport
README.md - Dart application → Durable job contract: enqueues jobs
README.md - Durable job contract → JetStream jobs: implemented by
README.md - NATS Core bus → Message brokers: publishes messages
README.md - JetStream jobs → Message brokers: runs durable workers
README.md - RabbitMQ adapter → Message brokers: publishes messages
README.md - Kafka adapter → Message brokers: publishes messages
README.md - Dart application → Retry policies: configures retries
README.md - Dart application → Transactional outbox: uses for atomic publish
README.md - Dart application → Inbox leases: uses for deduplication
README.md - Dart application → Persistent idempotency: uses persistent keys
README.md - Dart application → Metrics and tracing: configures hooks
README.md - Dart application → Health probes: uses probes
README.md - Dart application → Serverpod lifecycle: integrates lifecycle
README.md