kitedb 0.2.15

High-performance embedded graph database
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

//! KiteDB - High-performance embedded graph database
//!
//! A Rust implementation of KiteDB with NAPI bindings for Node.js/Bun.
//!
//! # Architecture
//!
//! KiteDB uses a **Snapshot + Delta + WAL** architecture:
//!
//! - **Snapshot**: Memory-mapped CSR format for fast reads
//! - **Delta**: In-memory overlay for pending changes
//! - **WAL**: Write-ahead log for durability and crash recovery
//!
//! # Features
//!
//! - Zero-copy reads via mmap
//! - ACID transactions with optional MVCC
//! - Vector embeddings with IVF index
//! - Single-file format
//! - Compression support (zstd, gzip, deflate)

#![deny(clippy::all)]
#![allow(dead_code)] // Allow during development

// Core modules
pub mod constants;
pub mod error;
pub mod types;
pub mod util;

// Storage layer modules (Phase 2)
pub mod core;

// Snapshot integrity checks
pub mod check;

// MVCC modules (Phase 4)
pub mod mvcc;

// Vector embeddings modules (Phase 5)
pub mod vector;

// Backup and metrics modules
pub mod backup;
pub mod metrics;

// Cache modules
pub mod cache;

// Export/import
pub mod export;

// Streaming/pagination
pub mod streaming;

// High-level API modules (Phase 6)
pub mod api;

// Concurrent access tests (test-only)
#[cfg(test)]
mod concurrent_tests;

// NAPI bindings module
#[cfg(feature = "napi")]
pub mod napi_bindings;

// PyO3 Python bindings module
#[cfg(feature = "python")]
pub mod pyo3_bindings;

// Re-export commonly used items
pub use check::{check_snapshot, quick_check};
pub use error::{KiteError, Result};

// Re-export schema builders for convenience
pub use api::schema::{
  edge, node, prop, DatabaseSchema, EdgeSchema, NodeSchema, PropDef, SchemaType, ValidationError,
};

// Deprecated aliases for backwards compatibility
#[allow(deprecated)]
pub use api::schema::{define_edge, define_node};

// Convenience entrypoint (Rust)
pub use api::kite::kite;

// ============================================================================
// NAPI Exports
// ============================================================================

#[cfg(feature = "napi")]
use napi_derive::napi;

/// Test function to verify NAPI bindings work
#[cfg(feature = "napi")]
#[napi]
pub fn plus_100(input: u32) -> u32 {
  input + 100
}

/// Get KiteDB version
#[cfg(feature = "napi")]
#[napi]
pub fn version() -> String {
  env!("CARGO_PKG_VERSION").to_string()
}

// Re-export the PropValueTag enum for NAPI
pub use types::PropValueTag;

// Re-export NAPI database types
#[cfg(feature = "napi")]
pub use napi_bindings::{
  open_database, Database, DbStats, EdgePage, EdgeWithProps, JsEdge, JsFullEdge, JsNodeProp,
  JsPropValue, Kite, NodePage, NodeWithProps, OpenOptions, PaginationOptions, PropType,
  StreamOptions,
};

// ============================================================================
// PyO3 Exports
// ============================================================================

#[cfg(feature = "python")]
pub use pyo3_bindings::kitedb;

// Note: Full NAPI exports will be added as we implement each module