sutures 1.0.1

Protocol-agnostic API abstraction gateway
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

use crate::error::Error;
use crate::seam::Seam;

/// Value-layer operations on a compiled [`Suture`](crate::v1::Suture).
///
/// `stitch` builds a `serde_json::Value` tree from a struct.
/// `unstitch` extracts a struct from a `serde_json::Value` tree.
///
/// Both walk the compiled path tree and index into Value directly
/// serde Serialize/DeserializeOwned bounds are required to bridge
/// between typed structs and `serde_json::Value`.
pub trait Stitch {
    /// Request direction: struct → Value.
    /// Walks the compiled tree, reads struct fields via Seam, places values at JSON paths.
    fn stitch<T: Seam + serde::Serialize>(&self, input: &T) -> Result<serde_json::Value, Error>;

    /// Response direction: Value → struct.
    /// Walks the compiled tree, extracts values from JSON paths, constructs struct via Seam.
    fn unstitch<T: Seam + serde::de::DeserializeOwned>(
        &self,
        input: &serde_json::Value,
    ) -> Result<T, Error>;
}