How mustafaa428/tinyoutbox works
TinyOutbox is a .NET transactional outbox and inbox library. Its main workflow atomically enqueues an event with application data, then a hosted worker polls pending records, publishes them to RabbitMQ, and updates retry or completion state. Consumers can use the inbox service for idempotent execution; hosted cleanup removes expired records. PostgreSQL/Dapper and EF Core provide alternative storage implementations. The README documents these capabilities; relationships among sampled components are shown where source references support them.
Main entry points: OutboxBackgroundWorker.cs Outbox worker · RabbitMqMessagePublisher.cs RabbitMQ publisher · IOutboxStorage.cs Outbox storage contract · OutboxCleanupWorker.cs Cleanup worker
Components 26
Core messaging
- Outbox API
TinyOutbox/TinyOutbox.Core/Services/Abstract/ITinyOutbox.cs - Outbox service
TinyOutbox/TinyOutbox.Core/Services/Concrate/TinyOutboxService.cs - Outbox message
TinyOutbox/TinyOutbox.Core/OutboxMessage.cs - Outbox storage contract
TinyOutbox/TinyOutbox.Core/Services/Abstract/IOutboxStorage.cs - Inbox service
TinyOutbox/TinyOutbox.Core/Services/Concrate/TinyInboxService.cs - Inbox storage contract
TinyOutbox/TinyOutbox.Core/Services/Abstract/IInboxStorage.cs - Publisher contract
TinyOutbox/TinyOutbox.Core/Services/Abstract/IMessagePublisher.cs
Hosted processing
- Outbox worker
TinyOutbox/TinyOutbox.Hosting/OutboxBackgroundWorker.cs - Cleanup worker
TinyOutbox/TinyOutbox.Hosting/OutboxCleanupWorker.cs - Worker options
TinyOutbox/TinyOutbox.Hosting/OutboxOptions.cs - Hosting setup
TinyOutbox/TinyOutbox.Hosting/TinyOutboxExtensions.cs
Storage providers
- EF outbox storage
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/EfCoreOutboxStorage.cs - EF inbox storage
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/EfCoreInboxStorage.cs - EF model mapping
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/ModelBuilderExtensions.cs - EF registration
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/TinyOutboxEfCoreExtensions.cs - PostgreSQL outbox
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlOutboxStorage.cs - PostgreSQL inbox
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlInboxStorage.cs - PostgreSQL options
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlOutboxOptions.cs - PostgreSQL registration
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlExtensions.cs
Broker transport
- RabbitMQ publisher
TinyOutbox/TinyOutbox.Transport.RabbitMQ/RabbitMqMessagePublisher.cs - RabbitMQ options
TinyOutbox/TinyOutbox.Transport.RabbitMQ/RabbitMqOutboxOptions.cs - RabbitMQ registration
TinyOutbox/TinyOutbox.Transport.RabbitMQ/RabbitMqExtensions.cs
Other components
- Application
- Relational database
- RabbitMQ broker
- Message consumer
Connections 36
- Application → Outbox API: enqueues atomically
README.md - Outbox service → Outbox API: implements
TinyOutbox/TinyOutbox.Core/Services/Concrate/TinyOutboxService.cs - Outbox service → Outbox storage contract: writes through
TinyOutbox/TinyOutbox.Core/Services/Concrate/TinyOutboxService.cs - Outbox service → Outbox message: creates
TinyOutbox/TinyOutbox.Core/Services/Concrate/TinyOutboxService.cs - Outbox worker → Outbox storage contract: fetches and updates
TinyOutbox/TinyOutbox.Hosting/OutboxBackgroundWorker.cs - Outbox worker → Publisher contract: publishes through
TinyOutbox/TinyOutbox.Hosting/OutboxBackgroundWorker.cs - Outbox worker → Worker options: reads settings
TinyOutbox/TinyOutbox.Hosting/OutboxBackgroundWorker.cs - Outbox worker → RabbitMQ publisher: publishes via
- RabbitMQ publisher → Publisher contract: implements
TinyOutbox/TinyOutbox.Transport.RabbitMQ/RabbitMqMessagePublisher.cs - RabbitMQ publisher → RabbitMQ options: reads settings
TinyOutbox/TinyOutbox.Transport.RabbitMQ/RabbitMqMessagePublisher.cs - RabbitMQ publisher → RabbitMQ broker: publishes messages
TinyOutbox/TinyOutbox.Transport.RabbitMQ/RabbitMqMessagePublisher.cs - RabbitMQ broker → Message consumer: delivers messages
README.md - Message consumer → Inbox service: requests deduplication
README.md - Inbox service → Inbox storage contract: checks and records
TinyOutbox/TinyOutbox.Core/Services/Concrate/TinyInboxService.cs - Cleanup worker → Outbox storage contract: purges expired records
TinyOutbox/TinyOutbox.Hosting/OutboxCleanupWorker.cs - Cleanup worker → Inbox storage contract: purges expired records
TinyOutbox/TinyOutbox.Hosting/OutboxCleanupWorker.cs - Cleanup worker → Worker options: reads settings
TinyOutbox/TinyOutbox.Hosting/OutboxCleanupWorker.cs - Hosting setup → Outbox worker: registers
TinyOutbox/TinyOutbox.Hosting/TinyOutboxExtensions.cs - Hosting setup → Cleanup worker: registers
TinyOutbox/TinyOutbox.Hosting/TinyOutboxExtensions.cs - EF outbox storage → Outbox storage contract: implements
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/EfCoreOutboxStorage.cs - EF inbox storage → Inbox storage contract: implements
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/TinyOutboxEfCoreExtensions.cs - EF registration → EF outbox storage: registers
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/TinyOutboxEfCoreExtensions.cs - EF registration → EF inbox storage: registers
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/TinyOutboxEfCoreExtensions.cs - EF model mapping → Outbox message: maps model
TinyOutbox/TinyOutbox.Storage.EntityFrameworkCore/ModelBuilderExtensions.cs - EF outbox storage → Relational database: reads and writes
- EF inbox storage → Relational database: reads and writes
- PostgreSQL outbox → Outbox storage contract: implements
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlOutboxStorage.cs - PostgreSQL inbox → Inbox storage contract: implements
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlInboxStorage.cs - PostgreSQL outbox → PostgreSQL options: uses settings
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlOutboxStorage.cs - PostgreSQL inbox → PostgreSQL options: uses settings
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlInboxStorage.cs - PostgreSQL registration → PostgreSQL outbox: registers
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlExtensions.cs - PostgreSQL registration → PostgreSQL inbox: registers
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlExtensions.cs - PostgreSQL outbox → Relational database: queries and updates
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlOutboxStorage.cs - PostgreSQL inbox → Relational database: queries and updates
TinyOutbox/TinyOutbox.Storage.PostgreSql/PostgreSqlInboxStorage.cs - RabbitMQ registration → RabbitMQ publisher: registers
TinyOutbox/TinyOutbox.Transport.RabbitMQ/RabbitMqExtensions.cs - RabbitMQ registration → RabbitMQ options: configures
TinyOutbox/TinyOutbox.Transport.RabbitMQ/RabbitMqExtensions.cs