Struct StreamKey 

pub struct StreamKey(/* private fields */);

The identifier of an event stream, as the store keys it: raw bytes.

The store is byte-level — at append/read it needs only a stream’s key bytes and a label for diagnostics, never a domain aggregate identity. So the byte-level operations (RawEventStore::read_stream / append, export_stream, list_streams, and the import target) speak StreamKey, not the kernel’s Id — honestly separating “a stream key” from “a domain identity” (issue #245). A consumer’s typed domain id lives at the repository layer; the repository translates it to a StreamKey (its job).

Like the wire-field newtypes in value (EventType, Payload, Metadata), StreamKey is a Bytes-backed newtype — so a stream key can never be confused with a payload or metadata buffer, and it carries a Display the raw bytes cannot. A non-UTF-8 id round-trips losslessly (unlike the former from_utf8_lossy reconstruction).

Implementations

impl StreamKey

pub fn from_bytes(bytes: impl Into<Bytes>) -> Self

Build a StreamKey from any owned byte source (zero-copy for Bytes / Vec<u8> / String / &'static slices and strs).

pub fn from_slice(bytes: &[u8]) -> Self

Build a StreamKey by copying a borrowed byte slice — the convenient shape for an import route (Fn(&[u8]) -> StreamKey), for translating a domain id.as_ref() at the repository boundary, or for any &[u8] key.

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

The raw id bytes.

pub fn into_bytes(self) -> Bytes

Consume into the backing Bytes (zero-copy).

Trait Implementations

impl AsRef<[u8]> for StreamKey

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for StreamKey

fn clone(&self) -> StreamKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StreamKey

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

Formats the value using the given formatter.

impl Display for StreamKey

The string when the bytes are valid UTF-8, else 0x… lowercase hex — faithful for binary ids, readable for the common string id, always unambiguous.

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

Formats the value using the given formatter.

impl Eq for StreamKey

impl From<Bytes> for StreamKey

fn from(bytes: Bytes) -> Self

Converts to this type from the input type.

impl Hash for StreamKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for StreamKey

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StreamKey