cipherstash-client 0.42.0

//! Mode-specific construction of orderable [`EncryptedSteVecTerm`] values.
//!
//! [`PrefixMac`] picks a [`TermBuilder`] via its associated type, so the term
//! shape (`Compat` vs. `Standard`) is selected at type-level by the MAC choice
//! rather than threaded through a runtime mode flag.
//!
//! The orderable term is the ONLY term an entry can carry: exact matching for
//! every node kind is the value-inclusive selector's job (see
//! [`super::value_selector`]), so the historic per-kind MAC terms (`hm`) no
//! longer exist and the trait has no MAC constructor.

use super::ste_plaintext_term::OrderableTerm;
use crate::encryption::{
    json_indexer::{
        prefix_mac::{PrefixMac, UpdatePrefixMac},
        ste_vec::encrypted_term::EncryptedSteVecTerm,
    },
    EncryptionError,
};
use zerokms_protocol::cipherstash_config::column::SteVecMode;

pub(crate) trait TermBuilder {
    fn orderable_term<M>(
        term: OrderableTerm,
        macca: &mut M,
    ) -> Result<EncryptedSteVecTerm, EncryptionError>
    where
        M: PrefixMac + UpdatePrefixMac<&'static str>;
}

/// Continuation invoked with the [`TermBuilder`] selected for a [`SteVecMode`].
///
/// [`dispatch_mode`] is the single place a runtime [`SteVecMode`] is turned into
/// a compile-time [`TermBuilder`]. Every mode-dependent construction path routes
/// through it, so the mode->builder mapping lives in exactly one place; the
/// builder->variant mapping is fixed by each builder's own impl (a
/// [`CompatTermBuilder`] can only produce `EncryptedSteVecTerm::Compat` values,
/// a [`StandardTermBuilder`] only `::Standard`). A column therefore cannot emit
/// the wrong wire key for its mode.
pub(crate) trait WithTermBuilder {
    type Output;
    fn call<TB: TermBuilder>(self) -> Self::Output;
}

pub(crate) fn dispatch_mode<W: WithTermBuilder>(mode: SteVecMode, with: W) -> W::Output {
    match mode {
        SteVecMode::Compat => with.call::<CompatTermBuilder>(),
        SteVecMode::Standard => with.call::<StandardTermBuilder>(),
    }
}

pub(crate) struct CompatTermBuilder;

impl TermBuilder for CompatTermBuilder {
    fn orderable_term<M>(
        term: OrderableTerm,
        macca: &mut M,
    ) -> Result<EncryptedSteVecTerm, EncryptionError>
    where
        M: PrefixMac + UpdatePrefixMac<&'static str>,
    {
        term.build_compat(macca)
    }
}

pub(crate) struct StandardTermBuilder;

impl TermBuilder for StandardTermBuilder {
    fn orderable_term<M>(
        term: OrderableTerm,
        macca: &mut M,
    ) -> Result<EncryptedSteVecTerm, EncryptionError>
    where
        M: PrefixMac + UpdatePrefixMac<&'static str>,
    {
        term.build_standard(macca)
    }
}