post-cortex-storage 0.3.1

Storage backends for post-cortex — lock-free RocksDB (default) and optional SurrealDB. Implements the Storage trait against the post-cortex domain types.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# post-cortex-storage

[![Crates.io](https://img.shields.io/crates/v/post-cortex-storage.svg)](https://crates.io/crates/post-cortex-storage)
[![Docs.rs](https://docs.rs/post-cortex-storage/badge.svg)](https://docs.rs/post-cortex-storage)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE)

Storage backends for [post-cortex](https://docs.rs/post-cortex). Provides the [`Storage`] trait plus the lock-free RocksDB backend ([`RealRocksDBStorage`]) and an optional SurrealDB backend behind the `surrealdb-storage` feature.

## Install

```toml
[dependencies]
post-cortex-storage = "0.2"                                          # RocksDB only
post-cortex-storage = { version = "0.2", features = ["surrealdb-storage"] }  # + SurrealDB
```

## Features

| Feature | Default | What it enables |
|---------|---------|-----------------|
| `surrealdb-storage` | no | SurrealDB backend (kv-mem + protocol-ws) |
| `surrealdb-tikv` | no | SurrealDB with TiKV distributed KV |
| `otel` | no | OpenTelemetry instrumentation hooks |

The RocksDB backend is always compiled — it's the post-cortex default and what the daemon ships with.

## Example

```rust,no_run
use post_cortex_storage::{RealRocksDBStorage, Storage};
use std::sync::Arc;

# async fn run() -> Result<(), Box<dyn std::error::Error>> {
let storage = Arc::new(RealRocksDBStorage::new("./pcx-data")?);
// `Storage` is `dyn`-compatible — pass `Arc<dyn Storage>` to any consumer.
let session_count = storage.list_sessions().await?.len();
println!("{session_count} sessions persisted");
# Ok(()) }
```

## License

MIT — see [LICENSE](../../LICENSE).