foundation_db 0.0.3

Unified storage backend with Turso sync API, D1, R2, and in-memory fallback
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

//! Foundation DB - Unified Storage Backend
//!
//! # Architecture
//!
//! - **`core/`** — shared between native and wasm (traits, errors, memory backends,
//!   D1/R2 HTTP backends, schema, crypto, cleanup)
//! - **`native/`** — non-wasm only (turso, libsql, `json_file`, `rows_stream`)
//! - **`wasm/`** — wasm32 only (CF D1/R2/KV wasm-bindgen bindings)
//!
//! # Storage Providers
//!
//! - Turso - `SQLite`-compatible embedded/remote database with sync API
//! - libsql - Local/remote `SQLite` with sync API
//! - Cloudflare D1 - Edge `SQLite` for Cloudflare Workers
//! - Cloudflare R2 - Object storage for larger blobs
//! - In-Memory - Ephemeral storage for development/testing
//! - JSON File - Simple JSON-on-disk key-value store (native only)

// Shared — always compiled
pub mod core;

// Central storage provider (wraps all backends)
pub mod storage_provider;

// Native — TCP/DB backends, rows streaming
#[cfg(not(target_family = "wasm"))]
pub mod native;

// Wasm — optional wasm-bindgen bridge for Cloudflare Workers (D1/R2/KV)
#[cfg(all(target_family = "wasm", feature = "wasm-bindgen-bindings"))]
pub mod wasm;

// Public re-exports (shared — always available)
pub use core::errors::*;
pub use core::storage_provider as traits;
pub use core::cleanup::*;
pub use core::backends::*;
pub use core::crypto::*;
pub use core::schema::*;
pub use core::auth_store::*;

// Central StorageProvider + StorageBackend (always available)
pub use storage_provider::{StorageBackend, StorageProvider};

// Re-export trait types at top level for convenience
pub use core::storage_provider::{
    AsyncKeyValueStore, AsyncListStream, AsyncQueryStore, AsyncQueryStream,
    AsyncStorageItemStream, BlobStore, DataValue, FromDataValue, KeyValueStore, QueryStore,
    RateLimiterStore, SqlRow, StorageItemStream,
};

// Native-only re-exports
#[cfg(not(target_family = "wasm"))]
pub use native::*;

// Wasm-bindgen storage re-exports (wasm32 only)
#[cfg(all(target_family = "wasm", feature = "wasm-bindgen-storage"))]
pub use wasm::{CfD1R2DocumentStore, D1WasmStorage, KVWasmStorage, R2WasmStorage, WasmCredentialStore};

// Wasm-bindgen CF types re-exports (wasm32 only)
#[cfg(all(target_family = "wasm", feature = "wasm-bindgen-storage"))]
pub use wasm::bindgen::{D1Database, D1PreparedStatement, KVNamespace, R2Bucket, R2Object, R2Objects};

// State store module
pub use core::state;