Enum RoutePolicy 

pub enum RoutePolicy {
    Requires,
    CachePolicy,
    Concurrency,
    Resilience,
}

A route field that changes serving behaviour, and can therefore fail open when the serving tier does not implement it.

Deliberately not “every field on crate::manifest::Route” — build-time and publish-time fields (prerender, data_inputs, placement, source_reads, hydration) are consumed before a request exists, so a server that ignores them cannot serve a route that quietly lacks a policy it declared. See STRUCTURAL_FIELDS for that half of the partition; every key on Route belongs to exactly one of the two, pinned by every_route_field_is_classified.

Variants

Requires

requires: ["user" | "project" | "region"] — the auth gate. The one whose fail-open is a confidentiality breach rather than a performance regression, which is why R556-B13 was filed at severity high.

CachePolicy

cache_policy: { ttl, swr, negative_ttl, vary }.

Concurrency

concurrency — per-route in-flight cap.

Resilience

resilience: { retry, timeout_ms } (W181).

Implementations

impl RoutePolicy

pub const ALL: [RoutePolicy; 4]

Every policy, in declaration order. Nothing at compile time checks this list is complete — parse() searches it at runtime — so a variant left out here is caught only by every_route_field_is_classified below.

pub const fn field(self) -> &'static str

The manifest / defineRoutes field name. This is what an author reads in their own routes file, so it is what a refusal message must name.

pub const fn effect(self) -> &'static str

What an author expects the field to do, one clause. Rendered into the refusal so the message says what is being lost, not just which key.

pub fn parse(field: &str) -> Option<Self>

Parse a field name, for --policy-delegated / MESOFACT_POLICY_DELEGATED.

pub const fn subfields(self) -> &'static [&'static str]

For a policy carried as a JSON object, the sub-keys this build actually implements. Empty = the policy is a scalar/array with no inner shape.

Checked as strictly as the top level, because a policy’s sub-field is the same defect one level down and hides better: serde on crate::manifest::CachePolicy silently drops an unknown key, so a cache_policy.private added by a newer build would deserialize into a policy that looks complete and quietly is not.

resilience.queue is deliberately absent — W181 reserves the slot for v2 and defineRoutes rejects it today, so the type exists only so v1 binaries keep deserializing v2 manifests. Deserializing one is not the same as honouring it; a manifest that carries a queue policy must not be served as though the queueing happens.

pub const fn reserved_subfields(self) -> &'static [&'static str]

Sub-keys that exist on the manifest type and are deliberately not implemented. Listing them is what turns “we left it out” into a decision the completeness gate can check, and it keeps subfields’s omissions from reading as oversights.

Trait Implementations

impl Clone for RoutePolicy

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RoutePolicy

impl Debug for RoutePolicy

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

Formats the value using the given formatter.

impl Display for RoutePolicy

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

Formats the value using the given formatter.

impl Eq for RoutePolicy

impl Ord for RoutePolicy

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for RoutePolicy

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for RoutePolicy

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for RoutePolicy