Enum RouteMode 

pub enum RouteMode {
    Static {
        component: String,
    },
    StaticBucket {
        bucket: String,
    },
    Backend {
        component: String,
        origin: String,
        origin_path: Option<String>,
    },
    Redirect {
        target: String,
        status: u16,
    },
}

Body of a DomainRoute. Three modes on the wire, four shapes here:

• Static (mode = "static", component = …) — the door serves a published component’s bytes from its CDN prefix. Component ref points at a kind = "mesofact-static" (or similar) service component.
• StaticBucket (mode = "static", bucket = …, R560-F13) — the door serves an R2 bucket’s ROOT, keyed by the request path minus its leading slash with nothing stripped or prepended. For a CDN whose route prefixes ARE its buckets’ top-level key prefixes (cdn.noisetable.com), where xlb derives a blob’s key from the very URL path it serves at, so path == key is an invariant rather than a convention.
• Backend — Worker proxies to an HTTP origin owned by a backend component (yubaba workload, gateway, etc.).
• Redirect — Worker emits a 30x to the target URL. Used to keep old paths alive during domain refactors.

The two static shapes are separate variants rather than one variant with two optional fields, so “both” and “neither” have no spelling in Rust. The TOML keeps one mode = "static" and the choice between component and bucket is refused at parse time unless exactly one is present — see [RouteModeWire].

Variants

Static

Fields

component: String

Component reference "<service>/<component-id>". Validated at CloudConfig::load time.

StaticBucket

Fields

bucket: String

R2 bucket name. Validated against R2’s naming rule at parse time, which is also what makes crate::route_table::r2_binding_name injective.

Backend

Fields

component: String

Component reference "<service>/<component-id>". Validated at CloudConfig::load time.

origin: String

Origin URL the Worker fetch()es. Schema-permissive — could be https://..., wss://..., or a yah-internal mesh URL resolved by yubaba.

origin_path: Option<String>

The path prefix this route’s path becomes at the origin, when the two differ (R898-F3). /api/issues* with origin_path = "/issues" proxies /api/issues/42 to <origin>/issues/42.

Absent means an identity proxy — the public path reaches the origin unchanged. It is declared here rather than derived because it is a fact about the upstream’s path layout, which this repo does not own: the issue tracker serves /issues and the almanac serves /releases, and both are live contracts that predate the domain manifest. Compiled into RouteRewrite by DomainConfig::route_table.

Redirect

Fields

target: String

Absolute URL or path the Worker emits a 30x to.

status: u16

HTTP status code. Defaults to 308 (permanent + method-preserving) so deprecations don’t silently turn POSTs into GETs.

Implementations

impl RouteMode

pub fn component(&self) -> Option<&str>

Component reference for static/backend modes; None for redirects and bucket-root static routes, which reference no component.

Trait Implementations

impl Clone for RouteMode

fn clone(&self) -> RouteMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RouteMode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RouteMode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RouteMode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.