exoware-sdk 2026.4.1

//! Range query traversal direction from `RangeRequest.mode`.

use buffa::EnumValue;

use crate::query::TraversalMode;

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum RangeTraversalDirection {
    Forward,
    Reverse,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum RangeTraversalModeError {
    /// Unknown `i32` on the wire (not FORWARD=0 or REVERSE=1).
    UnknownWireValue(i32),
}

/// Maps `RangeRequest.mode` (default **forward** when unset on the wire).
pub fn parse_range_traversal_direction(
    mode: EnumValue<TraversalMode>,
) -> Result<RangeTraversalDirection, RangeTraversalModeError> {
    if mode.is_unknown() {
        return Err(RangeTraversalModeError::UnknownWireValue(mode.to_i32()));
    }
    match mode
        .as_known()
        .expect("known enum variant after is_unknown check")
    {
        TraversalMode::TRAVERSAL_MODE_FORWARD => Ok(RangeTraversalDirection::Forward),
        TraversalMode::TRAVERSAL_MODE_REVERSE => Ok(RangeTraversalDirection::Reverse),
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn forward_and_reverse_are_zero_and_one() {
        assert_eq!(
            EnumValue::from(TraversalMode::TRAVERSAL_MODE_FORWARD).to_i32(),
            0
        );
        assert_eq!(
            EnumValue::from(TraversalMode::TRAVERSAL_MODE_REVERSE).to_i32(),
            1
        );
    }

    #[test]
    fn rejects_unknown_wire_value() {
        let ev = EnumValue::<TraversalMode>::from(99);
        assert!(ev.is_unknown());
        assert_eq!(
            parse_range_traversal_direction(ev),
            Err(RangeTraversalModeError::UnknownWireValue(99))
        );
    }

    #[test]
    fn accepts_forward_and_reverse() {
        assert_eq!(
            parse_range_traversal_direction(EnumValue::from(TraversalMode::TRAVERSAL_MODE_FORWARD)),
            Ok(RangeTraversalDirection::Forward)
        );
        assert_eq!(
            parse_range_traversal_direction(EnumValue::from(TraversalMode::TRAVERSAL_MODE_REVERSE)),
            Ok(RangeTraversalDirection::Reverse)
        );
    }
}