aimdb_core/
lib.rs

1//! AimDB Core Database Engine
2//!
3//! # aimdb-core
4//!
5//! Type-safe, async in-memory database for data synchronization
6//! across MCU → edge → cloud environments.
7//!
8//! # Architecture
9//!
10//! - **RecordKey/RecordId**: Stable identifiers for multi-instance records
11//! - **Unified API**: Single `Database<A>` type for all operations
12//! - **Runtime Agnostic**: Works with Tokio (std) or Embassy (embedded)
13//! - **Producer-Consumer**: Built-in typed message passing
14//!
15//! See examples in the repository for usage patterns.
16
17#![cfg_attr(not(feature = "std"), no_std)]
18
19pub mod buffer;
20pub mod builder;
21pub mod connector;
22pub mod context;
23pub mod database;
24mod error;
25pub mod ext_macros;
26pub mod record_id;
27#[cfg(feature = "std")]
28pub mod remote;
29pub mod router;
30pub mod time;
31pub mod transport;
32pub mod typed_api;
33pub mod typed_record;
34
35// Public API exports
36pub use context::RuntimeContext;
37pub use error::{DbError, DbResult};
38
39// Runtime trait re-exports from aimdb-executor
40// These traits define the platform-specific execution, timing, and logging capabilities
41pub use aimdb_executor::{
42    ExecutorError, ExecutorResult, Logger, Runtime, RuntimeAdapter, RuntimeInfo, Spawn, TimeOps,
43};
44
45// Database implementation exports
46pub use database::Database;
47
48// Producer-Consumer Pattern exports
49pub use builder::{AimDb, AimDbBuilder};
50pub use connector::ConnectorBuilder;
51pub use transport::{Connector, ConnectorConfig, PublishError};
52pub use typed_api::{Consumer, Producer, RecordRegistrar, RecordT};
53pub use typed_record::{AnyRecord, AnyRecordExt, TypedRecord};
54
55// Connector Infrastructure exports
56pub use connector::{ConnectorClient, ConnectorLink, ConnectorUrl, SerializeError};
57
58// Router exports for connector implementations
59pub use router::{Route, Router, RouterBuilder};
60
61// Record identification exports
62pub use record_id::{RecordId, RecordKey, StringKey};