Struct MessageWithPayloadEvent 

pub struct MessageWithPayloadEvent {
    pub msg_id: i64,
    pub queue_name: String,
    pub namespace: String,
    pub message: Value,
    pub ready_at: DateTime<Utc>,
    pub delay_seconds: i32,
}

Event emitted when a message is ready with full payload included (TAS-133)

This event is triggered for messages smaller than 7KB, where the full payload can fit within pg_notify’s ~8KB limit. This enables RabbitMQ-style direct processing without a separate database fetch operation.

For larger messages, MessageReadyEvent is used instead (signal-only).

Benefits

• Reduced latency: No separate fetch required
• Unified consumer code: Same processing pattern as RabbitMQ
• Direct ack: Can delete message by msg_id after processing

Examples

use tasker_pgmq::MessageWithPayloadEvent;
use chrono::Utc;

let event = MessageWithPayloadEvent {
    msg_id: 42,
    queue_name: "tasks_queue".to_string(),
    namespace: "tasks".to_string(),
    message: serde_json::json!({"task": "process", "data": [1, 2, 3]}),
    ready_at: Utc::now(),
    delay_seconds: 0,
};

// Process message directly without fetching
let task_data = &event.message["task"];
assert_eq!(task_data, "process");

Fields

msg_id: i64

ID of the message (for ack/delete after processing)

queue_name: String

Queue where the message is stored

namespace: String

Extracted namespace from the queue name

message: Value

The full message payload (included because size < 7KB)

ready_at: DateTime<Utc>

When the message became ready

delay_seconds: i32

Delay in seconds before message became visible (if any)

Implementations

impl MessageWithPayloadEvent

pub fn new<S: Into<String>>( msg_id: i64, queue_name: S, namespace: S, message: Value, ) -> Self

Create a new message with payload event

pub fn with_timestamp<S: Into<String>>( msg_id: i64, queue_name: S, namespace: S, message: Value, ready_at: DateTime<Utc>, ) -> Self

Create with custom timestamp

pub fn with_delay_seconds(self, delay_seconds: i32) -> Self

Set delay seconds

Trait Implementations

impl Clone for MessageWithPayloadEvent

fn clone(&self) -> MessageWithPayloadEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageWithPayloadEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MessageWithPayloadEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MessageWithPayloadEvent

fn eq(&self, other: &MessageWithPayloadEvent) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MessageWithPayloadEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MessageWithPayloadEvent