vex-queue 1.7.0

Async background worker queue for VEX Protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

//! Queue Backend Trait

use crate::job::{JobEntry, JobStatus};
use async_trait::async_trait;
use uuid::Uuid;

#[derive(Debug, thiserror::Error)]
pub enum QueueError {
    #[error("Backend error: {0}")]
    Backend(String),
    #[error("Job not found")]
    NotFound,
    #[error("Serialization error: {0}")]
    Serialization(#[from] serde_json::Error),
}

#[async_trait]
pub trait QueueBackend: Send + Sync {
    /// Enqueue a job payload for a specific tenant
    async fn enqueue(
        &self,
        tenant_id: &str,
        job_type: &str,
        payload: serde_json::Value,
        delay_secs: Option<u64>,
    ) -> Result<Uuid, QueueError>;

    /// Pull next available job
    async fn dequeue(&self) -> Result<Option<JobEntry>, QueueError>;

    /// Update job status (ack/nack)
    /// `delay_secs` is used for retries - how long to wait before the job is available again
    async fn update_status(
        &self,
        id: Uuid,
        status: JobStatus,
        error: Option<String>,
        delay_secs: Option<u64>,
    ) -> Result<(), QueueError>;

    /// Get job status
    async fn get_status(&self, tenant_id: &str, id: Uuid) -> Result<JobStatus, QueueError>;

    /// Get full job entry (for polling endpoint)
    async fn get_job(&self, tenant_id: &str, id: Uuid) -> Result<JobEntry, QueueError>;

    /// Store the result of a completed job
    async fn set_result(&self, id: Uuid, result: serde_json::Value) -> Result<(), QueueError>;
}