Struct OutboxService 

pub struct OutboxService<W, S> { /* private fields */ }

Implementations

impl<W> OutboxService<W, NoIdempotency>

where W: OutboxWriter + Send + Sync + 'static,

pub fn new(writer: Arc<W>, config: Arc<OutboxConfig>) -> Self

impl<W, S> OutboxService<W, S>

where W: OutboxWriter + Send + Sync + 'static, S: IdempotencyStorageProvider + Send + Sync + 'static,

pub fn with_idempotency( writer: Arc<W>, config: Arc<OutboxConfig>, idempotency_storage: Arc<S>, ) -> Self

pub async fn add_event<F>( &self, event_type: &str, payload: Value, provided_token: Option<String>, get_event: F, ) -> Result<(), OutboxError>

where F: FnOnce() -> Option<Event>,

Adds a new event to the outbox storage with idempotency checks.

If an idempotency provider is configured and a token is generated, it will first attempt to reserve the token to prevent duplicate processing.

Errors

Returns OutboxError::DuplicateEvent if the event token has already been used. Returns OutboxError if the idempotency storage fails or the database insert operation fails.

Panics

Panics if the idempotency strategy is set to Custom, but get_event returns None.