resuma 0.2.0

Resuma — SSR + Resumability + Islands + Server Actions + JS Bridge for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! Resuma HTTP server.
//!
//! Built on top of `axum`. Apps interact with this crate by:
//!
//!   1. Building a [`ResumaApp`] with [`ResumaApp::new`].
//!   2. Mounting page routes via [`ResumaApp::page`] / [`ResumaApp::route`].
//!   3. Spawning the HTTP listener with [`ResumaApp::serve`].
//!
//! The server provides the following built-in routes:
//!
//!   * `GET  /_resuma/loader.js`                — tiny event bootstrap (~1–2 KB).
//!   * `GET  /_resuma/core.js`                  — lazy-loaded resumability core.
//!   * `GET  /_resuma/runtime.js`               — legacy monolithic runtime.
//!   * `POST /_resuma/action/:name`             — invokes a `#[server]` action.
//!   * `GET  /_resuma/handler/:chunk.js`        — handler chunk lazy-loaded by the runtime.
//!   * `GET  /_resuma/island/:chunk.js`         — island chunk loader.
//!   * `GET  /_resuma/island/:instance`         — re-rendered island HTML (HMR).

pub mod actions;
pub mod app;
pub mod compressed_asset;
pub mod deferred_stream;
pub mod handlers;
pub mod page_cache;
pub mod request_path;
pub mod runtime_asset;
pub mod security;

pub use actions::{register_server_action, set_action_middleware, ActionFn};
pub use app::{apply_security_headers, security_headers_middleware, ResumaApp, ServeOptions};
pub use deferred_stream::{set_deferred_stream_hook, try_deferred_stream};
pub use page_cache::{
    page_csrf, stage_page_csrf, stage_response_cache_control, take_response_cache_control,
};
pub use request_path::{stage_response_path, take_response_path};
pub use security::{
    client_ip, client_ip_from_parts, configure as configure_security, csrf_token, guard_mutation,
    http_status, random_token, request_is_https, CspNonce, SecurityConfig, SecurityHeaderOptions,
    CSRF_COOKIE, CSRF_FIELD, CSRF_HEADER,
};