Concepts

How Logbun is split between a runtime-neutral core, destination adapters, and reliability backends.

Logbun is an audit-event pipeline. Callers emit typed actions; the library redacts, caps, assigns a UUIDv7 id, optionally seals a hash chain, admits the event through a reliability journal, batches it in RAM, and inserts it into a destination adapter.

The package root is ES2022 / Web APIs only. Runtime-specific storage is reached through explicit exports:

logbun (root) ── MemoryReliabilityAdapter (volatile)
              ├─ logbun/durability/filesystem ── Node/Bun/Deno WAL + files
              └─ logbun/durability/cloudflare ── Workers DO SQLite

Destination adapters (IAdapter) store queryable records. Reliability adapters own the journal and DLQ. Durable mode requires a persistent reliability adapter; missing or persistent: false throws in the constructor.

Pipeline

Durability

Reliability

Tenancy

Integrity