vecdb 0.12.2

use crate::{Format, ReadOnlyRawVec, impl_vec_wrapper};

use super::ReadWriteRawVec;

mod reader;
mod strategy;
mod value;

pub use reader::*;
pub use strategy::*;
pub use value::*;

/// Raw storage vector using explicit byte serialization in little-endian format.
///
/// Uses the `Bytes` trait to serialize values with `to_bytes()/from_bytes()` in
/// **LITTLE-ENDIAN** format, ensuring **portability across different endianness systems**.
///
/// Like `ZeroCopyVec`, this is an append-only raw vector with push, truncate,
/// and rollback support. Wrap it in [`MutableVec`](crate::MutableVec) when
/// existing values must be updated or deleted.
///
/// The only difference from `ZeroCopyVec` is the serialization strategy:
/// - `BytesVec`: Explicit little-endian, portable across architectures
/// - `ZeroCopyVec`: Native byte order, faster but not portable
///
/// Use `BytesVec` when:
/// - Sharing data between systems with different endianness
/// - Cross-platform compatibility is required
/// - Custom serialization logic is needed
///
/// Use `ZeroCopyVec` when:
/// - Maximum performance is critical
/// - Data stays on the same architecture
#[derive(Debug)]
#[must_use = "Vector should be stored to keep data accessible"]
pub struct BytesVec<I, T>(pub(crate) ReadWriteRawVec<I, T, BytesStrategy<T>>);

impl<I, T> BytesVec<I, T>
where
    I: crate::VecIndex,
    T: BytesVecValue,
{
    pub fn reader(&self) -> BytesVecReader<I, T> {
        BytesVecReader::new(self.0.reader())
    }
}

impl_vec_wrapper!(
    BytesVec,
    ReadWriteRawVec<I, T, BytesStrategy<T>>,
    BytesVecValue,
    Format::Bytes,
    ReadOnlyRawVec<I, T, BytesStrategy<T>>,
    no_deref_mut
);