Struct TaskMessage 

pub struct TaskMessage {

    pub id: TaskId,
    pub task_name: String,
    pub queue: String,
    pub payload: Value,
    pub state: TaskState,
    pub retries: u32,
    pub max_retries: u32,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub eta: Option<DateTime<Utc>>,
    pub headers: HashMap<String, String>,
    pub parent_id: Option<TaskId>,
    pub correlation_id: Option<String>,
    pub group_id: Option<String>,
    pub group_total: Option<u32>,
    pub chord_callback: Option<Box<TaskMessage>>,
    pub priority: Option<u8>,
    pub dedup_key: Option<String>,
}

A task message that flows through the broker.

Fields

id: TaskId

Unique task identifier.

task_name: String

Registered task name (e.g., “send_email”).

queue: String

Target queue name.

payload: Value

Serialized task payload.

state: TaskState

Current task state.

retries: u32

Current retry count.

max_retries: u32

Maximum allowed retries.

created_at: DateTime<Utc>

When the message was created.

updated_at: DateTime<Utc>

When the message was last updated.

eta: Option<DateTime<Utc>>

Optional ETA — earliest time the task should execute.

headers: HashMap<String, String>

Arbitrary headers for middleware / tracing propagation.

parent_id: Option<TaskId>

Parent task ID for workflow tracking.

correlation_id: Option<String>

Correlation ID for tracing an entire workflow.

group_id: Option<String>

Group ID this task belongs to.

group_total: Option<u32>

Total number of tasks in the group.

chord_callback: Option<Box<TaskMessage>>

Chord callback to enqueue when all group members complete.

priority: Option<u8>

Task priority (0–9, higher = more urgent). Broker-specific support.

dedup_key: Option<String>

Deduplication key. If set, brokers may skip enqueue when a duplicate exists.

Implementations

impl TaskMessage

pub fn new( task_name: impl Into<String>, queue: impl Into<String>, payload: Value, ) -> Self

Create a new task message with defaults.

pub fn with_max_retries(self, max_retries: u32) -> Self

Set max retries.

pub fn with_eta(self, eta: DateTime<Utc>) -> Self

Set ETA.

pub fn with_header( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add a header.

pub fn with_parent_id(self, parent_id: TaskId) -> Self

Set parent task ID for workflow tracking.

pub fn with_correlation_id(self, correlation_id: impl Into<String>) -> Self

Set correlation ID for tracing an entire workflow.

pub fn with_group(self, group_id: impl Into<String>, group_total: u32) -> Self

Set group metadata.

pub fn with_chord_callback(self, callback: TaskMessage) -> Self

Set chord callback.

pub fn with_priority(self, priority: u8) -> Self

Set task priority (clamped to 0–9, higher = more urgent).

pub fn with_dedup_key(self, key: impl Into<String>) -> Self

Set an explicit deduplication key.

pub fn with_content_dedup(self) -> Self

Auto-generate a dedup key by hashing task_name + payload.

Uses FNV-1a (64-bit) which is deterministic across Rust versions and platforms, unlike DefaultHasher which may change between releases.

Trait Implementations

impl Clone for TaskMessage

fn clone(&self) -> TaskMessage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TaskMessage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskMessage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TaskMessage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.