#api-design

  1. Read your writes: opt-in replica routing via Sentinel

    Routing read-only queries to replicas is a correctness decision, not just a throughput knob. Here's why we made it opt-in, per-client and per-query.

  2. Typed mapping with serde, and temporal values that do real math

    Deserialize rows straight into your own structs with serde, and decode FalkorDB date/time/duration values into types with a checked, type-safe algebra.

  3. Rows that don't lie: header-aware, fallible result iteration

    A result API where every row is a FalkorResult<Row>, columns are read by name, and a value that fails to parse is an Err you can handle โ€” not a panic.

  4. Stop hand-quoting Cypher: type-safe, injection-proof parameters

    Bound query parameters that take real Rust values, encode them correctly, and make Cypher injection a compile-time non-event.