# NominalLogStream

## pub struct NominalLogStream

A bounded log stream. Enqueue acknowledges memory acceptance, not remote durability.

Call `flush` or `close` to observe delivery failures. Ambiguous network failures may
result in duplicates after retry or journal recovery. No ordering across batches is promised.

## Implementations

### impl NominalLogStream

#### pub fn builder() -> NominalLogStreamBuilder

#### pub fn enqueue(&self, channel: &str, record: LogRecord) -> Result<(), LogStreamError>

#### pub fn enqueue_batch(&self, channel: &str, records: Vec<LogRecord>) -> Result<(), LogStreamError>

Accept a complete batch, or reject it before accepting any records. The input batch
must fit the memory budget; it is split into request-sized batches internally.

#### pub fn log_writer(&self, channel: impl Into<String>, args: HashMap<String, String>) -> NominalLogWriter<'_>

Cache a channel name and common arguments for convenient repeated writes.

#### pub fn stats(&self) -> LogStreamStats

#### pub fn flush(&self) -> Result<LogStreamStats, LogStreamError>

Block new enqueue calls while all accepted records finish delivery or backup.

#### pub fn stop_accepting_writes(&self)

#### pub fn close(&self) -> Result<LogStreamStats, LogStreamError>

Stop admission, drain accepted records, and join every worker. Repeated calls are safe
and return the same error if a batch was dropped after the last successful flush.

## Trait implementations

### impl Drop for NominalLogStream

#### fn drop(&mut self)

**Auto traits**: [`Send`](https://doc.rust-lang.org/1.98.1/core/marker/trait.Send.html), [`Sync`](https://doc.rust-lang.org/1.98.1/core/marker/trait.Sync.html), [`Unpin`](https://doc.rust-lang.org/1.98.1/core/marker/trait.Unpin.html), [`!UnwindSafe`](https://doc.rust-lang.org/1.98.1/core/panic/unwind_safe/trait.UnwindSafe.html), [`!RefUnwindSafe`](https://doc.rust-lang.org/1.98.1/core/panic/unwind_safe/trait.RefUnwindSafe.html)
