Struct ValueWireV1 

pub struct ValueWireV1 { /* private fields */ }

Stable version-one wire DTO for a scalar or homogeneous collection.

For a given serializer and value, output is byte-stable with canonical field and object-key order, including recursively nested JSON objects. V1 is closed: existing tags, shapes, and payload representations cannot change, and future runtime data types require a new wire version instead of extending V1.

Resource limits

The generic Deserialize implementation is intended for already-bounded embedded documents and does not enforce message-size or structural limits. Use ValueWireV1::decode_json_slice or ValueWireV1::decode_json_slice_with_limits for untrusted complete JSON input.

Implementations

impl ValueWireV1

pub const VERSION: u8 = VALUE_WIRE_V1_VERSION

Numeric version emitted and accepted by this DTO.

pub const fn new(value: ValueWirePayloadV1) -> Self

Creates a V1 DTO from an explicit scalar-or-collection container.

Parameters

• value - Runtime container whose exact type and shape are preserved.

Returns

A V1 DTO containing value.

pub fn decode_json_slice(input: &[u8]) -> Result<Self, ValueWireDecodeError>

Decodes a V1 JSON wire value using the default structural limits.

The complete input length and decoded structure are checked before the value is returned. Embedded protocols should share one crate::WireBudget across their complete document.

Parameters

• input - Complete UTF-8 JSON document to decode.

Returns

The decoded V1 wire DTO.

Errors

Returns a limit error when the input or decoded structure is too large, or ValueWireDecodeError::InvalidJson for malformed input.

pub fn decode_json_slice_with_limits( input: &[u8], limits: WireLimits, ) -> Result<Self, ValueWireDecodeError>

Decodes a V1 JSON wire value using explicit structural limits.

The complete input length and decoded structure are checked before the value is returned. Embedded values should be checked through the outer protocol’s shared crate::WireBudget.

Parameters

• input - Complete UTF-8 JSON document to decode.
• limits - Shared encoded-input and structural limits.

Returns

The decoded V1 wire DTO.

Errors

Returns a limit error when input or its decoded structure exceeds limits, or ValueWireDecodeError::InvalidJson for malformed input.

pub const fn container(&self) -> &ValueContainer

Returns the runtime container represented by this DTO.

Returns

A shared reference to the preserved runtime container.

pub fn into_container(self) -> ValueContainer

Consumes the DTO and returns its runtime container.

Returns

The preserved runtime container.

Trait Implementations

impl Clone for ValueWireV1

fn clone(&self) -> ValueWireV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ValueWireV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ValueWireV1

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserializes a validated V1 runtime container into the DTO.

impl Eq for ValueWireV1

impl From<ValueWireV1> for ValueContainer

fn from(value: ValueWireV1) -> Self

Unwraps the runtime container from a V1 DTO.

impl Hash for ValueWireV1

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ValueWireV1

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ValueWireV1

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serializes the contained runtime shape through the V1 contract.

impl StructuralPartialEq for ValueWireV1

impl TryFrom<MultiValues> for ValueWireV1

fn try_from(values: MultiValues) -> Result<Self, Self::Error>

Wraps a runtime collection in a V1 DTO.

type Error = ValueWireEncodeError

The type returned in the event of a conversion error.

impl TryFrom<Value> for ValueWireV1

fn try_from(value: Value) -> Result<Self, Self::Error>

Wraps a runtime scalar in a V1 DTO.

type Error = ValueWireEncodeError

The type returned in the event of a conversion error.

impl TryFrom<ValueContainer> for ValueWireV1

fn try_from(value: ValueContainer) -> Result<Self, Self::Error>

Wraps an explicit runtime shape in a V1 DTO.

type Error = ValueWireEncodeError

The type returned in the event of a conversion error.