Architecture
A storage engine you can reason about.
LioranDB V2 is documented as a Rust-powered document database with a persistent storage path, WAL and checkpoint lifecycle, indexing paths, and multiple client transports. This page keeps implementation status visible.
Request flow
From client request to persistent state.
The public architecture direction describes this path. Exact behavior is version-sensitive and belongs in the maintained docs.
Client request
JavaScript / TypeScript SDK, REST, or gRPC
Document API
Collections, filters, updates, and query execution
Storage paths
Primary storage plus configured secondary/text indexes
Durability
WAL and checkpoint lifecycle
Persistent state
Local or managed deployment storage
Engine properties
Keep implemented, tested, and planned distinct.
Rust engine
The V2 engine is documented as Rust-powered.
Nodes and partitions
Benchmark artifacts show node and partition settings; do not infer general clustering availability.
WAL and checkpoints
WAL and checkpoint paths are present in the documented test surface.
Indexing
Secondary and text indexes are documented; specialized raw-write tests may disable them.
Recovery
Public artifacts include WAL replay and crash-recovery test paths.
Replication / failover
Do not treat multi-node configuration as automatic replication or failover without authoritative proof.
Operational boundaries
What to verify before production adoption.
| Area | Website can establish | Verify in docs / deployment |
|---|---|---|
| Durability | WAL and checkpointing are configured in the supplied workload. | Acknowledgement semantics, fsync behavior, and reopen guarantees. |
| Transport | JavaScript, TypeScript, gRPC, and REST paths are described publicly. | Endpoint details, auth, TLS, and compatibility for your version. |
| Scaling | Nodes and partitions appear in test configurations. | Replication, placement, automatic failover, and supported topologies. |
| Observability | Benchmark and recovery artifacts are linked. | Metrics, alerting, backups, restore drills, and incident procedures. |