Struct Publication 

pub struct Publication { /* private fields */ }

A declared publisher with its QoS profile applied — the only publish path.

Implementations

impl Publication

pub async fn send( &self, payload: Vec<u8>, attachment: Option<Vec<u8>>, ) -> Result<()>

Publish one payload, with an optional attachment riding beside it (#117 — attachments are outside the registry’s vocabulary and are never schema-encoded). Sets the wire Encoding when one was declared (RFC 04 v1.5’s recommendation: publishers say what they carry).

pub async fn send_stamped( &self, payload: Vec<u8>, attachment: Option<Vec<u8>>, timestamp: Option<Timestamp>, ) -> Result<()>

send, with an explicit HLC timestamp when the caller mints one (session.new_timestamp()). None leaves stamping to the deployment’s config — the default put behaviour. The generator uses this to stamp state samples for LWW (RFC 04 §4) and, for its unstamped fault (#163), to deliberately omit the stamp.

pub async fn retire(&self) -> Result<()>

Publish a tombstone — an authoritative retirement (RFC 04 §1.2), never a payload marker. The only delete path: it rides the declared publisher, and Session::delete stays unexposed for the same reason there is no bare-put helper. Gate dynamic keys through check_retire first — the class semantics live there.

pub async fn undeclare(self) -> Result<()>

Undeclare, acknowledged.

pub async fn matching_status(&self) -> Result<bool>

Whether any subscriber currently matches this publication — a routing fact about the publisher this process declared (RFC 12 §9’s allowed half). It says nothing about other publishers on the key, and false is not a fleet verdict (“no subscriber matched our publication”, never “nobody listens here” — RFC 05 §3.1 applied to a badge).

pub async fn matching_events(&self) -> Result<MatchingEvents>

Event-driven matching changes for this publication — the badge feed. Same honesty bounds as matching_status.

Trait Implementations

impl Debug for Publication

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

Formats the value using the given formatter.