Struct SpaMiddleware 

pub struct SpaMiddleware { /* private fields */ }

SPA static file middleware.

• Matches /{filename} against the disk root, then against embedded files
• Serves files with MIME types inferred by the host
• Falls back to index.html for unknown paths (SPA routing)
• Handles GET and HEAD; other methods pass through silently

Implementations

impl SpaMiddleware

pub fn new(source: impl Into<SpaSource>) -> SpaMiddleware

Create a new SPA middleware with default index “index.html”.

The disk root is resolved relative to the current working directory. If the directory doesn’t exist at that path, the middleware searches upward through ancestor directories and their immediate subdirectories, matching the strategy used by config::load_appsettings.

pub fn with_index( source: impl Into<SpaSource>, index: impl Into<String>, ) -> SpaMiddleware

Create a new SPA middleware with a custom index file name.

pub fn from_source(source: SpaSource) -> SpaMiddleware

Create a SPA middleware from an already-built source.

pub fn resolved_root(&self) -> &Path

The disk directory actually consulted, after resolution.

pub fn embedded(&self) -> Option<&EmbeddedAssets>

The embedded files this middleware may serve, if any.

Present even when EMBED_ENV disabled them at runtime.

impl SpaMiddleware

pub async fn try_index_fallback( &self, ctx: &mut dyn IHttpContext, ) -> Result<bool, Error>

Serve index.html for a client-side route that did not match the router.

Called by the host after routing misses, so:

• an API path (/api/*) is never answered with the app shell;
• a request that asks for data (Accept: application/json, */*, or no Accept) gets a proper 404 instead of 200 text/html;
• the fallback cannot leak its cache policy into a handler response, because no handler ran.

Returns true when the fallback was written into ctx.

Trait Implementations

impl IMiddleware for SpaMiddleware

fn invoke<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 mut dyn IHttpContext, ) -> Pin<Box<dyn Future<Output = Result<ControlFlow<()>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, SpaMiddleware: 'async_trait,

Process an HTTP request (before hook).

fn after<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut dyn IHttpContext, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Called after the final handler has executed.