mod collection;

mod names;

mod schematic;

mod summary;

/// Types for defining map/reduce-powered `View`s.

pub mod view;

pub use bonsaidb_macros::{Collection, Schema, View, ViewSchema};

pub use self::collection::{

    AsyncEntry, AsyncList, Collection, DefaultSerialization, InsertError, List, Nameable,

    NamedCollection, NamedReference, SerializedCollection,

};

pub use self::names::{

    Authority, CollectionName, InvalidNameError, Name, Qualified, QualifiedName, SchemaName,

    ViewName,

};

pub use self::schematic::Schematic;

pub use self::summary::{CollectionSummary, SchemaSummary, ViewSummary};

pub use self::view::map::{Map, MappedValue, ViewMappedValue};

pub use self::view::{

    CollectionMapReduce, DefaultViewSerialization, MapReduce, ReduceResult, SerializedView, View,

    ViewMapResult, ViewSchema,

};

use crate::Error;

/// Defines a group of collections that are stored into a single database.

///

/// ## Deriving this trait

///

/// This trait can be derived rather than manually implemented:

///

/// ```rust

/// use bonsaidb_core::schema::{Collection, Schema};

/// use serde::{Deserialize, Serialize};

///

/// #[derive(Schema)]

/// #[schema(name = "MySchema", collections = [MyCollection])]

/// # #[schema(core = bonsaidb_core)]

/// pub struct MySchema;

///

/// #[derive(Serialize, Deserialize, Default, Collection)]

/// #[collection(name = "MyCollection")]

/// # #[collection(core = bonsaidb_core)]

/// pub struct MyCollection {

///     pub rank: u32,

///     pub score: f32,

/// }

/// ```

///

/// If you're publishing a schema for use in multiple projects, consider giving

/// the schema an `authority`, which gives your schema a namespace:

///

/// ```rust

/// use bonsaidb_core::schema::Schema;

///

/// #[derive(Schema)]

/// #[schema(name = "MySchema", authority = "khonsulabs", collections = [MyCollection])]

/// # #[schema(core = bonsaidb_core)]

/// pub struct MySchema;

///

/// # use serde::{Deserialize, Serialize};

/// # use bonsaidb_core::schema::Collection;

/// # #[derive(Serialize, Deserialize, Default, Collection)]

/// # #[collection(name = "MyCollection")]

/// # #[collection(core = bonsaidb_core)]

/// # pub struct MyCollection {

/// #    pub rank: u32,

/// #    pub score: f32,

/// # }

/// ```

pub trait Schema: Send + Sync + 'static {

    /// Returns the unique [`SchemaName`] for this schema.

    fn schema_name() -> SchemaName;

    /// Defines the `Collection`s into `schema`.

    fn define_collections(schema: &mut Schematic) -> Result<(), Error>;

    /// Retrieves the [`Schematic`] for this schema.

}

/// This implementation is for accessing databases when interacting with

/// collections isn't required. For example, accessing only the key-value store

/// or pubsub.

impl Schema for () {

}

impl<T> Schema for T

where

    T: Collection + 'static,

{

}