Struct StreamCursor 

pub struct StreamCursor(pub Bytes);

Opaque, backend-versioned cursor. Consumers persist the bytes, hand them back on resume. The first byte MUST encode a backend-family + version prefix so cursors stay stable across backend upgrades (Valkey: 0x01, Postgres: 0x02, …). The remainder is backend- specific.

StreamCursor::empty is the “start from tail / now” sentinel every backend accepts. Cursor byte order is owner-adjudicated opaque — consumers MUST NOT parse the bytes.

Tuple Fields

0: Bytes

Implementations

impl StreamCursor

pub fn new(raw: impl Into<Bytes>) -> Self

Wrap arbitrary cursor bytes — typically only called by backend impls that just encoded a fresh cursor from a backend-native position (Valkey stream id, Postgres event_id).

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

Borrow the raw cursor bytes for persistence. Consumers treat the slice as opaque.

pub fn empty() -> Self

Sentinel “start from tail” cursor. Backends interpret an empty cursor as “subscribe from now” (Valkey: XREAD $; Postgres: LISTEN from the current max(event_id)).

Trait Implementations

impl Clone for StreamCursor

fn clone(&self) -> StreamCursor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StreamCursor

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

Formats the value using the given formatter.

impl PartialEq for StreamCursor

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

impl StructuralPartialEq for StreamCursor