Enum InteropValue 

pub enum InteropValue {
    Null,
    Bool(bool),
    Int(i128),
    Float(f64),
    Str(String),
    Bytes(Vec<u8>),
    Array(Vec<InteropValue>),
    Map(BTreeMap<String, InteropValue>),
    Set(Vec<InteropValue>),
    DateTime {
        unix_micros: i64,
    },
    Uuid(Uuid),
}

A value in the closed interop/v1 argument data model.

Anything outside this model is unrepresentable by construction; values that are representable but out of spec range (non-finite floats, integers outside [-2^63, 2^64-1]) are rejected with an error at encode time — never silently coerced.

Variants

Null

msgpack nil.

Bool(bool)

msgpack bool.

Int(i128)

Integer. Must be within [-2^63, 2^64-1] (checked at encode time); i128 storage lets a single variant span the full signed+unsigned range.

Float(f64)

Float. Must be finite (NaN / ±Inf rejected at encode time). In the argument profile, integral floats within [-2^63, 2^64) collapse to the integer encoding, so 2.0 and 2 hash identically (spec: number canonicalization).

Str(String)

UTF-8 string, encoded as the msgpack str family. No Unicode normalization is applied. Rust strings are well-formed Unicode scalar sequences by construction, which the spec requires.

Bytes(Vec<u8>)

Byte string, encoded as the msgpack bin family (never str).

Array(Vec<InteropValue>)

Ordered sequence; elements normalized recursively.

Map(BTreeMap<String, InteropValue>)

String-keyed map. BTreeMap’s byte-wise key order is the spec’s Unicode-code-point order (UTF-8 byte order ≡ code point order), applied at every nesting level.

Set(Vec<InteropValue>)

Set: elements are normalized, encoded, sorted by their encoded bytes (unsigned lexicographic), and deduplicated post-normalization.

DateTime

Timezone-aware instant as microseconds since the Unix epoch.

Sub-microsecond precision must be floored toward negative infinity before construction. Encoding performs the spec’s single IEEE 754 float64 division by 10^6, so hashes are bit-deterministic across SDKs. Naive (offset-less) datetimes are unrepresentable in this API.

Fields

unix_micros: i64

Microseconds since 1970-01-01T00:00:00Z (negative = pre-epoch).

Uuid(Uuid)

UUID, encoded as its lowercase hyphenated string form.

Implementations

impl InteropValue

pub fn bytes(bytes: impl Into<Vec<u8>>) -> Self

Build a byte string (msgpack bin).

pub fn datetime_from_unix_micros(unix_micros: i64) -> Self

Build a timezone-aware datetime from microseconds since the Unix epoch.

Trait Implementations

impl Clone for InteropValue

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InteropValue

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&str> for InteropValue

fn from(v: &str) -> Self

Converts to this type from the input type.

impl From<BTreeMap<String, InteropValue>> for InteropValue

fn from(v: BTreeMap<String, InteropValue>) -> Self

Converts to this type from the input type.

impl From<String> for InteropValue

fn from(v: String) -> Self

Converts to this type from the input type.

impl From<Uuid> for InteropValue

fn from(v: Uuid) -> Self

Converts to this type from the input type.

impl From<Vec<InteropValue>> for InteropValue

fn from(v: Vec<InteropValue>) -> Self

Converts to this type from the input type.

impl From<bool> for InteropValue

fn from(v: bool) -> Self

Converts to this type from the input type.

impl From<f64> for InteropValue

fn from(v: f64) -> Self

Finiteness is checked at encode time, not construction time.

impl From<i32> for InteropValue

fn from(v: i32) -> Self

Converts to this type from the input type.

impl From<i64> for InteropValue

fn from(v: i64) -> Self

Converts to this type from the input type.

impl From<i128> for InteropValue

fn from(v: i128) -> Self

Range is checked at encode time, not construction time.

impl From<u32> for InteropValue

fn from(v: u32) -> Self

Converts to this type from the input type.

impl From<u64> for InteropValue

fn from(v: u64) -> Self

Converts to this type from the input type.

impl PartialEq for InteropValue

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for InteropValue

impl TryFrom<SystemTime> for InteropValue

fn try_from(t: SystemTime) -> Result<Self, CachekitError>

Convert an instant to interop datetime micros, flooring sub-microsecond precision toward negative infinity (spec rule — truncation toward zero would differ for pre-epoch instants).

type Error = CachekitError

The type returned in the event of a conversion error.