Enum PgmqNotifyEvent 

pub enum PgmqNotifyEvent {
    QueueCreated(QueueCreatedEvent),
    MessageReady(MessageReadyEvent),
    MessageWithPayload(MessageWithPayloadEvent),
    BatchReady(BatchReadyEvent),
}

Union of all possible PGMQ notification events

This enum represents all event types that can be emitted by PGMQ operations. Events are tagged for JSON serialization and can be pattern-matched for handling.

Examples

use tasker_pgmq::{PgmqNotifyEvent, QueueCreatedEvent};
use chrono::Utc;

let event = PgmqNotifyEvent::QueueCreated(QueueCreatedEvent {
    queue_name: "new_queue".to_string(),
    namespace: "default".to_string(),
    created_at: Utc::now(),
    metadata: Default::default(),
});

match event {
    PgmqNotifyEvent::QueueCreated(e) => {
        println!("Queue created: {}", e.queue_name);
    }
    PgmqNotifyEvent::MessageReady(e) => {
        println!("Message ready: {}", e.msg_id);
    }
    PgmqNotifyEvent::MessageWithPayload(e) => {
        println!("Message with payload: {}", e.msg_id);
    }
    PgmqNotifyEvent::BatchReady(e) => {
        println!("Batch ready: {} messages", e.message_count);
    }
}

Variants

QueueCreated(QueueCreatedEvent)

Queue was created

MessageReady(MessageReadyEvent)

Message is ready for processing in a queue (signal only, requires fetch) Used for large messages (>= 7KB) that don’t fit in pg_notify payload

MessageWithPayload(MessageWithPayloadEvent)

Message with full payload included (TAS-133) Used for small messages (< 7KB) - enables direct processing without fetch

BatchReady(BatchReadyEvent)

Batch of messages are ready for processing in a queue

Implementations

impl PgmqNotifyEvent

pub fn namespace(&self) -> &str

Get the namespace for any event type

pub fn queue_name(&self) -> &str

Get the queue name for any event type

pub fn timestamp(&self) -> DateTime<Utc>

Get the timestamp for any event type

pub fn metadata(&self) -> &HashMap<String, String>

Get metadata for any event type

Note: MessageWithPayload events don’t have metadata, returns empty HashMap

pub fn matches_namespace(&self, namespace: &str) -> bool

Check if event matches a specific namespace

pub fn event_type(&self) -> &'static str

Get the event type as a string

pub fn msg_id(&self) -> Option<i64>

Get the message ID if this event is message-related

Returns Some(msg_id) for MessageReady and MessageWithPayload events, None for queue creation and batch events.

pub fn has_payload(&self) -> bool

Check if this event includes the full message payload (TAS-133)

Returns true for MessageWithPayload events where the message can be processed directly without a separate fetch.

pub fn payload(&self) -> Option<&Value>

Get the message payload if available (TAS-133)

Returns Some(&Value) for MessageWithPayload events, None for all other event types.

Trait Implementations

impl Clone for PgmqNotifyEvent

fn clone(&self) -> PgmqNotifyEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PgmqNotifyEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PgmqNotifyEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PgmqNotifyEvent

fn eq(&self, other: &PgmqNotifyEvent) -> 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 PgmqNotifyEvent

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 PgmqNotifyEvent