Struct HandlerConfig 

pub struct HandlerConfig {
    pub route: String,
    pub methods: Vec<String>,
    pub component: String,
    pub imports: Vec<String>,
    pub streaming: bool,
    pub limits: Option<HandlerLimits>,
    pub env: BTreeMap<String, String>,
    pub invoke_targets: Vec<String>,
    pub tenancy: Option<Tenancy>,
    pub token_claims: Option<HandlerGraphqlTokenClaims>,
}

A WebAssembly request handler bound to a route (deploy-scoped).

Fields

route: String

Route pattern (matcher syntax).

methods: Vec<String>

HTTP methods this handler answers (empty = all).

component: String

Path to the component .wasm within the deployment.

imports: Vec<String>

Requested capabilities (interface names; see KNOWN_IMPORTS).

streaming: bool

A streaming handler: the guest writes its response body incrementally (SSE, chunked, agent token streaming) via a #[handler(stream)] body. The host serves it on the isolated streaming lane (its own concurrency budget + a much larger wall-clock) so a long-lived stream never holds a fast-request slot. Should match the guest’s declared shape — the activation pre-check warns when a #[handler(stream)] guest is deployed without it (it would otherwise run on the sync lane and be cut at the sync timeout). Default false (a buffered handler).

limits: Option<HandlerLimits>

Optional resource limits (capped by site config at activation).

env: BTreeMap<String, String>

Static environment variables (never secrets).

invoke_targets: Vec<String>

Function-to-function invoke allowlist (FI): the target names this handler may call through the invoke capability (same contract as FunctionConfig::invoke_targets). Each entry may use * wildcards (* = any function, img-* = a family, resize = one literal). Deny by default: empty ⇒ the handler cannot invoke anything, even if it imports invoke. Only consulted when imports contains invoke and the site’s allow_imports permits it.

tenancy: Option<Tenancy>

Per-handler in-site tenancy decision (Dimension 0), overriding the site-level HandlersSiteConfig::tenancy for this route. Absent ⇒ inherit the site decision. When present it must narrow within the site ceiling (crate::tenancy::Tenancy::narrows_within) — a widening is refused fail-closed at bind. Lets one site host handlers at different modes (e.g. an own page handler beside an all admin handler under a site ceiling of all).

token_claims: Option<HandlerGraphqlTokenClaims>

Per-handler JWKS/issuer config verifying the app bearer for a crate::tenancy::TenantSource::Token tenant source, overriding the site’s [handlers.graphql.data].claims_from_token. Absent ⇒ inherit the site’s. Only consulted when this handler’s tenancy (or the inherited site tenancy) names a token source.

Trait Implementations

impl Clone for HandlerConfig

fn clone(&self) -> HandlerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandlerConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HandlerConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<HandlerConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for HandlerConfig

impl PartialEq for HandlerConfig

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for HandlerConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for HandlerConfig