stripe_misc/
forwarded_request_details.rs

1/// Details about the request forwarded to the destination endpoint.
2#[derive(Clone, Debug)]
3#[cfg_attr(feature = "serialize", derive(serde::Serialize))]
4#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
5pub struct ForwardedRequestDetails {
6    /// The body payload to send to the destination endpoint.
7    pub body: String,
8    /// The headers to include in the forwarded request.
9    /// Can be omitted if no additional headers (excluding Stripe-generated ones such as the Content-Type header) should be included.
10    pub headers: Vec<stripe_misc::ForwardedRequestHeader>,
11    /// The HTTP method used to call the destination endpoint.
12    pub http_method: ForwardedRequestDetailsHttpMethod,
13}
14#[doc(hidden)]
15pub struct ForwardedRequestDetailsBuilder {
16    body: Option<String>,
17    headers: Option<Vec<stripe_misc::ForwardedRequestHeader>>,
18    http_method: Option<ForwardedRequestDetailsHttpMethod>,
19}
20
21#[allow(
22    unused_variables,
23    irrefutable_let_patterns,
24    clippy::let_unit_value,
25    clippy::match_single_binding,
26    clippy::single_match
27)]
28const _: () = {
29    use miniserde::de::{Map, Visitor};
30    use miniserde::json::Value;
31    use miniserde::{Deserialize, Result, make_place};
32    use stripe_types::miniserde_helpers::FromValueOpt;
33    use stripe_types::{MapBuilder, ObjectDeser};
34
35    make_place!(Place);
36
37    impl Deserialize for ForwardedRequestDetails {
38        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
39            Place::new(out)
40        }
41    }
42
43    struct Builder<'a> {
44        out: &'a mut Option<ForwardedRequestDetails>,
45        builder: ForwardedRequestDetailsBuilder,
46    }
47
48    impl Visitor for Place<ForwardedRequestDetails> {
49        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
50            Ok(Box::new(Builder {
51                out: &mut self.out,
52                builder: ForwardedRequestDetailsBuilder::deser_default(),
53            }))
54        }
55    }
56
57    impl MapBuilder for ForwardedRequestDetailsBuilder {
58        type Out = ForwardedRequestDetails;
59        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
60            Ok(match k {
61                "body" => Deserialize::begin(&mut self.body),
62                "headers" => Deserialize::begin(&mut self.headers),
63                "http_method" => Deserialize::begin(&mut self.http_method),
64                _ => <dyn Visitor>::ignore(),
65            })
66        }
67
68        fn deser_default() -> Self {
69            Self {
70                body: Deserialize::default(),
71                headers: Deserialize::default(),
72                http_method: Deserialize::default(),
73            }
74        }
75
76        fn take_out(&mut self) -> Option<Self::Out> {
77            let (Some(body), Some(headers), Some(http_method)) =
78                (self.body.take(), self.headers.take(), self.http_method.take())
79            else {
80                return None;
81            };
82            Some(Self::Out { body, headers, http_method })
83        }
84    }
85
86    impl Map for Builder<'_> {
87        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
88            self.builder.key(k)
89        }
90
91        fn finish(&mut self) -> Result<()> {
92            *self.out = self.builder.take_out();
93            Ok(())
94        }
95    }
96
97    impl ObjectDeser for ForwardedRequestDetails {
98        type Builder = ForwardedRequestDetailsBuilder;
99    }
100
101    impl FromValueOpt for ForwardedRequestDetails {
102        fn from_value(v: Value) -> Option<Self> {
103            let Value::Object(obj) = v else {
104                return None;
105            };
106            let mut b = ForwardedRequestDetailsBuilder::deser_default();
107            for (k, v) in obj {
108                match k.as_str() {
109                    "body" => b.body = FromValueOpt::from_value(v),
110                    "headers" => b.headers = FromValueOpt::from_value(v),
111                    "http_method" => b.http_method = FromValueOpt::from_value(v),
112                    _ => {}
113                }
114            }
115            b.take_out()
116        }
117    }
118};
119/// The HTTP method used to call the destination endpoint.
120#[derive(Clone, Eq, PartialEq)]
121#[non_exhaustive]
122pub enum ForwardedRequestDetailsHttpMethod {
123    Post,
124    /// An unrecognized value from Stripe. Should not be used as a request parameter.
125    Unknown(String),
126}
127impl ForwardedRequestDetailsHttpMethod {
128    pub fn as_str(&self) -> &str {
129        use ForwardedRequestDetailsHttpMethod::*;
130        match self {
131            Post => "POST",
132            Unknown(v) => v,
133        }
134    }
135}
136
137impl std::str::FromStr for ForwardedRequestDetailsHttpMethod {
138    type Err = std::convert::Infallible;
139    fn from_str(s: &str) -> Result<Self, Self::Err> {
140        use ForwardedRequestDetailsHttpMethod::*;
141        match s {
142            "POST" => Ok(Post),
143            v => {
144                tracing::warn!(
145                    "Unknown value '{}' for enum '{}'",
146                    v,
147                    "ForwardedRequestDetailsHttpMethod"
148                );
149                Ok(Unknown(v.to_owned()))
150            }
151        }
152    }
153}
154impl std::fmt::Display for ForwardedRequestDetailsHttpMethod {
155    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
156        f.write_str(self.as_str())
157    }
158}
159
160impl std::fmt::Debug for ForwardedRequestDetailsHttpMethod {
161    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
162        f.write_str(self.as_str())
163    }
164}
165#[cfg(feature = "serialize")]
166impl serde::Serialize for ForwardedRequestDetailsHttpMethod {
167    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
168    where
169        S: serde::Serializer,
170    {
171        serializer.serialize_str(self.as_str())
172    }
173}
174impl miniserde::Deserialize for ForwardedRequestDetailsHttpMethod {
175    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
176        crate::Place::new(out)
177    }
178}
179
180impl miniserde::de::Visitor for crate::Place<ForwardedRequestDetailsHttpMethod> {
181    fn string(&mut self, s: &str) -> miniserde::Result<()> {
182        use std::str::FromStr;
183        self.out = Some(ForwardedRequestDetailsHttpMethod::from_str(s).expect("infallible"));
184        Ok(())
185    }
186}
187
188stripe_types::impl_from_val_with_from_str!(ForwardedRequestDetailsHttpMethod);
189#[cfg(feature = "deserialize")]
190impl<'de> serde::Deserialize<'de> for ForwardedRequestDetailsHttpMethod {
191    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
192        use std::str::FromStr;
193        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
194        Ok(Self::from_str(&s).expect("infallible"))
195    }
196}