airnest 0.1.0

//! The `Persistent` trait — implemented automatically by `#[persistent]`.

use serde::{Serialize, de::DeserializeOwned};

use crate::AirId;

/// Marks a struct as persistable via `Store`.
///
/// Do not implement this manually — use `#[persistent]`.
///
/// # What the macro generates
///
/// ```ignore
/// #[persistent]
/// pub struct User {
///     pub name: String,
/// }
/// // expands to:
/// pub struct User {
///     pub id: AirId<User>,
///     pub name: String,
/// }
/// impl User {
///     pub fn new(name: String) -> Self { ... }
///     pub fn id(&self) -> AirId<Self> { self.id }
/// }
/// impl Persistent for User { ... }
/// ```
///
/// # Architecture patterns
///
/// In large codebases, `#[persistent]` should be used sparingly — only on
/// aggregates and domain entities that represent state worth saving. Child
/// structs nested inside a persistent root should be plain `Serialize +
/// Deserialize` values.
///
/// See the `airnest` crate README for a full guide on persistence boundaries,
/// aggregate-root modelling, repository layers, and domain-module conventions.
pub trait Persistent: Serialize + DeserializeOwned + Send + Sync + 'static {
    /// The auto-generated UUIDv7 id embedded in every persisted value.
    fn id(&self) -> AirId<Self>;

    /// SQLite table name — defaults to the struct name.
    const TABLE: &'static str;

    /// Names of extra columns stored alongside the blob for indexed queries.
    /// Populated by `#[persistent(index(field_a, field_b))]`.
    fn index_columns() -> &'static [&'static str];

    /// Current values for each index column, in the same order as `index_columns()`.
    fn index_values(&self) -> Vec<String>;
}