qubit_codec/value/
json_bytes_value_codec.rs

1// =============================================================================
2//    Copyright (c) 2026 Haixing Hu.
3//
4//    SPDX-License-Identifier: Apache-2.0
5//
6//    Licensed under the Apache License, Version 2.0.
7// =============================================================================
8//! Bidirectional Serde JSON bytes codec for one owned value.
9
10use core::marker::PhantomData;
11
12use serde::Serialize;
13use serde::de::DeserializeOwned;
14use serde_json::Error as JsonError;
15
16use super::JsonBytesValueDecoder;
17use super::JsonBytesValueEncoder;
18use super::ValueDecoder;
19use super::ValueEncoder;
20
21/// Encodes and decodes one serializable value through UTF-8 JSON bytes.
22///
23/// This type combines [`JsonBytesValueEncoder`] and [`JsonBytesValueDecoder`]
24/// for registry-backed or bidirectional call sites. It holds no state between
25/// calls, so it is `Copy` and `Default`, and encoding and decoding can share
26/// one value through [`ValueEncoder`] and [`ValueDecoder`].
27///
28/// # Type Parameters
29///
30/// - `T`: Value type serialized to JSON bytes and recovered from them.
31///
32/// # Examples
33///
34/// ```
35/// use qubit_codec::JsonBytesValueCodec;
36/// use qubit_codec::ValueDecoder;
37/// use qubit_codec::ValueEncoder;
38///
39/// let mut codec = JsonBytesValueCodec::<String>::new();
40/// assert_eq!(codec.encode(&"hello".to_string()).unwrap(), br#""hello""#.to_vec());
41/// assert_eq!(codec.decode(br#""hello""#).unwrap(), "hello");
42/// ```
43#[must_use]
44#[derive(Debug, Clone, Copy, Default)]
45pub struct JsonBytesValueCodec<T> {
46    /// Associates the codec with `T` without retaining a value.
47    _marker: PhantomData<T>,
48}
49
50impl<T> JsonBytesValueCodec<T> {
51    /// Creates a bidirectional JSON bytes codec for values of type `T`.
52    ///
53    /// # Returns
54    ///
55    /// Returns a stateless codec bound to values of type `T`.
56    #[inline]
57    pub const fn new() -> Self {
58        Self { _marker: PhantomData }
59    }
60}
61
62impl<T> ValueEncoder<T> for JsonBytesValueCodec<T>
63where
64    T: Serialize,
65{
66    /// Serialization failure reported by Serde JSON.
67    type Error = JsonError;
68    /// Newly allocated UTF-8 JSON bytes owned by the caller.
69    type Output = Vec<u8>;
70
71    /// Serializes `input` into UTF-8 JSON bytes.
72    #[inline]
73    fn encode(&mut self, input: &T) -> Result<Self::Output, Self::Error> {
74        JsonBytesValueEncoder::<T>::new().encode(input)
75    }
76}
77
78impl<T> ValueDecoder<[u8]> for JsonBytesValueCodec<T>
79where
80    T: DeserializeOwned,
81{
82    /// JSON syntax, UTF-8, or target-value deserialization failure.
83    type Error = JsonError;
84    /// Owned value deserialized independently of the input byte slice.
85    type Output = T;
86
87    /// Deserializes `input` from UTF-8 JSON bytes.
88    #[inline]
89    fn decode(&mut self, input: &[u8]) -> Result<Self::Output, Self::Error> {
90        JsonBytesValueDecoder::<T>::new().decode(input)
91    }
92}
qubit_codec/value/json_bytes_value_codec.rs

qubit_codec/value/
json_bytes_value_codec.rs
