Struct DaemonFrame 

pub struct DaemonFrame { /* private fields */ }

A canonical frozen v1 daemon envelope.

kind and payload_encoding intentionally stay raw discriminants. This preserves unknown additive values rather than normalizing them through a backend enum. W3C trace headers are retained privately so decode followed by encode keeps their original bytes; Self::trace_id and Self::span_id expose their semantic IDs when present.

Implementations

impl DaemonFrame

pub fn request(payload_protocol: u32, payload: Vec<u8>) -> Self

Create a request with the frozen v1 defaults.

pub fn response_to(request: &Self, payload: Vec<u8>) -> Self

Create the frozen response to request.

This uses the shared v1 response constructor, preserving the request correlation ID, product protocol, and W3C trace headers exactly.

pub fn with_request_id(self, request_id: u64) -> Self

Set the opaque request/response correlation identifier.

pub fn with_raw_kind(self, kind: i32) -> Self

Set the raw frozen frame-kind discriminant.

pub fn with_raw_payload_encoding(self, payload_encoding: i32) -> Self

Set the raw frozen payload-encoding discriminant.

pub fn with_deadline_unix_ms(self, deadline_unix_ms: u64) -> Self

Set the absolute Unix-millisecond deadline carried in the envelope.

pub fn with_trace_context( self, trace_id: impl AsRef<str>, span_id: impl AsRef<str>, ) -> Self

Set W3C trace and span identifiers using frozen v1 trace-header form.

The default W3C version and sampled flag preserve the product’s existing v1 constructor behavior. Decoded headers are not regenerated, so an existing header’s version, flags, and formatting remain intact.

pub fn with_trace_state(self, trace_state: impl Into<String>) -> Self

Set the opaque W3C trace-state value.

pub fn envelope_version(&self) -> u32

Frozen envelope version carried inside the protobuf body.

pub fn kind(&self) -> i32

Raw frozen frame-kind discriminant.

pub fn kind_classification(&self) -> DaemonFrameKind

Classify Self::kind without discarding an unknown raw value.

pub fn payload_protocol(&self) -> u32

Application-owned payload protocol identifier.

pub fn payload(&self) -> &[u8]

Opaque application payload bytes.

pub fn request_id(&self) -> u64

Correlation identifier carried by the envelope.

pub fn payload_encoding(&self) -> i32

Raw frozen payload-encoding discriminant.

pub fn payload_encoding_classification(&self) -> DaemonPayloadEncoding

Classify Self::payload_encoding without discarding an unknown raw value.

pub fn deadline_unix_ms(&self) -> u64

Absolute Unix-millisecond deadline carried by the envelope.

pub fn trace_id(&self) -> Option<&str>

W3C trace ID, when the retained trace header carries one.

pub fn span_id(&self) -> Option<&str>

W3C span ID, when the retained trace header carries one.

pub fn trace_state(&self) -> &str

Opaque W3C trace-state retained by the envelope.

Trait Implementations

impl Clone for DaemonFrame

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DaemonFrame

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

Formats the value using the given formatter.

impl Eq for DaemonFrame

impl PartialEq for DaemonFrame

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DaemonFrame