Crate issundb 

IssunDB is an embedded graph database in Rust.

Visit the project repository for documentation and examples

This is the main crate of IssunDB, and exposes the Graph type, Cypher query execution, vector search, full-text search, and hybrid retrieval APIs. Application code, bindings, and tools depend on this crate only; the internal crates (issundb-core, issundb-vector, issundb-text, issundb-retrieval, and issundb-cypher) are not part of the stable API.

Entry Points

• Graph is the central handle. Open it with Graph::open, then use its methods for node and edge CRUD, adjacency, and graph algorithms.
• GraphQueryExt adds Cypher execution (query, query_with_params, and explain) to Graph.
• VectorGraphExt adds vector indexing and search to Graph.
• TextGraphExt and TextIndexExt add full-text indexing and search.
• retrieve, retrieve_with, and retrieve_hybrid run hybrid retrieval over vector hits, text hits, and graph expansion.

Working with Query Results

Query parameters and Record values use serde_json::Value. The serde_json crate is re-exported as issundb::serde_json so callers do not need to track a separate, version-compatible dependency.

Re-exports

pub use serde_json;

Structs

Bm25Scorer

BM25 (Okapi BM25) relevance scorer with default parameters k1 = 1.2, b = 0.75.

DirectedNeighborEntry

A neighbor entry with a direction flag, returned by crate::Graph::all_neighbors.

EdgeRecord

Stored in the edges LMDB sub-database as msgpack bytes.

Graph

The graph database handle. Cheap to clone: all state is behind Arc.

Hit

A single result from vector search.

HybridRetrieveOptions

Options for retrieve_hybrid.

NeighborEntry

The result of a single adjacency lookup entry returned by crate::Graph::out_neighbors and crate::Graph::in_neighbors.

NodeRecord

Stored in the nodes LMDB sub-database as msgpack bytes.

Procedure

A table-backed procedure. rows each contain inputs.len() + outputs.len() cells: the first segment matches the declared inputs, the second the outputs.

ProcedureRegistry

A runtime registry of procedures available to CALL.

QueryResult

The tabular result of a Cypher query execution.

ReadTxn

A read-only transaction on the graph.

Record

An individual row in the query result table.

RetrieveOptions

Options for retrieve_with.

Subgraph

A subgraph extracted by a retrieval call.

TextHit

A single ranked full-text search result.

TextSearchOptions

Options for full-text search.

TfIdfScorer

TF-IDF relevance scorer. Lighter than BM25; no length normalization.

TriangleCountSpec

Pattern description for Graph::count_triangle_cycles: the directed cycle (a)-[t1]->(b)-[t2]->(c)-[t3]->(a) with an optional relationship type per hop and an optional label per node variable. None means unconstrained.

VectorIndexOptions

Construction options for VectorIndex.

VectorSearchOptions

Options for vector_search_with.

WeightedPath

A path with an associated total weight, returned by weighted path algorithms.

WriteTxn

A read-write transaction on the graph.

Enums

BooleanMode

Boolean candidate-set filtering for multi-term queries.

CypherError

Structured query engine errors representing all parsing, optimization, planning, and runtime execution faults.

CypherType

The declared Cypher type of a procedure argument or output field.

DegreeDirection

The direction of edges to count for degree centrality.

Error

FusionStrategy

Strategy for fusing vector and text relevance scores.

Language

Supported languages for Full-Text Search indexing and stemming.

PropValue

A typed property value used in index lookups and range queries.

RetrievalError

Structured errors representing all hybrid retrieval faults.

TextError

VectorError

Structured errors representing all vector search and indexing faults.

VectorMetric

Distance metric for the HNSW index.

VectorQuantization

Quantization format for in-memory vector storage.

Traits

GraphQueryExt

Extension trait to execute Cypher queries on the Graph handle.

Scorer

Relevance scoring strategy for full-text search.

TextGraphExt

Full-text search operations for Graph.

TextIndexExt

Text index lifecycle operations for Graph.

VectorGraphExt

Vector search operations for Graph.

Functions

retrieve

Convenience wrapper: vector search to k seeds, then hops-hop BFS expansion to subgraph materialization.

retrieve_hybrid

Hybrid retrieval: merges vector search seeds with full-text search seeds, fuses their scores using opts.fusion, then expands via BFS.

retrieve_with

Full retrieve with configurable options.

Type Aliases

EdgeId

LabelId

NodeId

TypeId