74 add embedded graph database (#75)

- feat: refacto graph_persistance - Created GraphPersistenceService with hexagonal architecture, removed HMAC layer
- feat: refacto platform graph - Integrated Graph adapter into Platform as a proper dependency
- feat: refacto platform - Enhanced Platform with additional adapter accessors for better dependency injection
- fix: load data - Fixed graph persistence issue by using static Lazy globals (NODES and EDGES) to share state across all Platform instances
- feat: change extension name - Migrated file extensions from .ns/.json/.age to .hoddor with backward compatibility
- feat: remove without encryption - Made encryption mandatory everywhere
- feat: fmt - Fixed WASM compilation issues

Author: oScape

README.md

@@ -49,6 +49,16 @@ This solution provides encrypted storage capabilities with robust support for mu
 ### Built for Privacy-First Applications
 This solution is ideal for building **zero-knowledge systems** where user privacy is paramount. The backend serves solely as a storage and synchronization medium, with all sensitive encryption and decryption logic confined to the client side. This ensures that sensitive information never leaves the user's control, empowering developers to build **compliant, privacy-focused, and performant web applications.**
 
+## ⚠️ Experimental Features
+
+> **Warning**: The following features are currently under active development and should **NOT** be used in production environments.
+
+- 🔬 **Graph Database Integration**: Embedded CozoDB graph database with encrypted persistence for knowledge graph and RAG (Retrieval-Augmented Generation) applications.
+  - **Status**: Work in Progress (WIP)
+  - **Known Limitations**: API may change, potential data migration issues between versions
+  - **Use Case**: Experimental RAG workspaces and memory management features
+
+These experimental features are being developed to explore advanced use cases. They are subject to breaking changes and may not provide the same stability guarantees as the core vault functionality. Use at your own risk and avoid storing critical data.
 
 ## Prerequisites
 

hoddor/Cargo.toml

@@ -9,7 +9,15 @@ edition = "2021"
 crate-type = ["cdylib", "rlib"]
 
 [features]
-default = ["console_error_panic_hook"]
+default = ["vault", "graph"]
+
+# Vault: Core functionality - encrypted vaults with namespaces, WebAuthn, etc.
+# This is the base feature of Hoddor
+vault = ["console_error_panic_hook"]
+
+# Graph: Adds graph database with vector search
+# Requires vault for persistence and encryption
+graph = ["vault", "uuid"]
 
 [dependencies]
 once_cell = "1.20.2"
@@ -52,6 +60,8 @@ hkdf = "0.12.4"
 x25519-dalek = { version = "2.0.1", features = ["static_secrets"] }
 async-trait = "0.1.89"
 
+uuid = { version = "1.11", features = ["v4", "serde", "js"], optional = true }
+
 [dependencies.web-sys]
 version = "0.3.77"
 features = [

hoddor/src/adapters/mod.rs

@@ -14,3 +14,10 @@ pub use native::{
 
 pub mod shared;
 pub use shared::{AgeEncryption, AgeIdentity, Argon2Kdf};
+
+#[cfg(feature = "graph")]
+#[path = "wasm/simple_graph.rs"]
+mod simple_graph;
+
+#[cfg(feature = "graph")]
+pub use simple_graph::SimpleGraphAdapter as Graph;

hoddor/src/adapters/wasm/mod.rs

@@ -8,10 +8,16 @@ pub mod opfs_storage;
 pub mod persistence;
 pub mod webauthn_prf;
 
+#[cfg(feature = "graph")]
+pub mod simple_graph;
+
 pub use clock::Clock;
 pub use console_logger::ConsoleLogger;
 pub use locks::Locks;
 pub use notifier::Notifier;
 pub use opfs_storage::OpfsStorage;
 pub use persistence::Persistence;
 pub use webauthn_prf::WebAuthnPrf;
+
+#[cfg(feature = "graph")]
+pub use simple_graph::SimpleGraphAdapter;