1use std::{fmt::Debug, hash::Hash};
2
3use crate::error::Result;
4
5mod known;
6mod policy;
7mod rewrite;
8#[cfg(test)]
9mod tests;
10mod util;
11
12pub use policy::OriginPolicy;
13pub(crate) use util::{require_http_scheme, with_directory_path};
14
15pub trait Origin: Copy + Debug + Eq + Hash + Send + Sync + 'static {
16 fn canonical(self) -> &'static str;
17 fn all() -> &'static [Self];
18}
19
20#[derive(Debug, Clone)]
21pub struct OriginEndpoints<O: Origin> {
22 origin_policy: OriginPolicy<O>,
23}
24
25impl<O: Origin> Default for OriginEndpoints<O> {
26 fn default() -> Self {
27 Self::official()
28 }
29}
30
31impl<O: Origin> OriginEndpoints<O> {
32 pub fn new(origin_policy: OriginPolicy<O>) -> Self {
33 Self { origin_policy }
34 }
35
36 pub fn official() -> Self {
37 Self::new(OriginPolicy::default())
38 }
39
40 pub fn with_overrides<const N: usize>(overrides: [(O, String); N]) -> Result<Self> {
41 let mut policy = OriginPolicy::default();
42 for (origin, raw_url) in overrides {
43 policy = policy.with_override(origin, raw_url)?;
44 }
45 Ok(Self::new(policy))
46 }
47
48 pub fn origin_policy(&self) -> &OriginPolicy<O> {
49 &self.origin_policy
50 }
51
52 pub fn resolve(&self, origin: O, path: &str) -> Result<String> {
53 self.origin_policy.resolve(origin, path)
54 }
55
56 pub fn resolve_segments<const N: usize>(
57 &self,
58 origin: O,
59 segments: [&str; N],
60 ) -> Result<String> {
61 self.origin_policy.resolve_segments(origin, segments)
62 }
63
64 pub fn rewrite_upstream(&self, raw_url: &str) -> Result<String> {
65 self.origin_policy.rewrite_origin_url(raw_url)
66 }
67
68 pub fn rewrite_known_or_keep(&self, raw_url: &str) -> Result<String> {
69 self.origin_policy.rewrite_known_origin_url_or_keep(raw_url)
70 }
71}