veer 0.1.1

Inertia.js v3 server-side protocol superset 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

//! Server-side rendering integration.

#[cfg(feature = "ssr")]
pub mod http;

use async_trait::async_trait;
use serde_json::Value;
use thiserror::Error;

/// SSR-rendered HTML chunks returned by the SSR service.
#[derive(Debug, Clone, Default)]
pub struct SsrPayload {
    /// HTML strings to inject into `<head>`.
    pub head: Vec<String>,
    /// HTML to put inside the mount element.
    pub body: String,
}

/// Errors from the SSR client.
#[derive(Debug, Error)]
pub enum SsrError {
    /// Transport-level failure (network, timeout, status).
    #[error("ssr transport: {0}")]
    Transport(String),
    /// Response body could not be parsed as expected.
    #[error("ssr decode: {0}")]
    Decode(String),
}

/// A pluggable SSR renderer.
#[async_trait]
pub trait SsrClient: Send + Sync {
    /// Render `page` to head + body HTML chunks.
    async fn render(&self, page: &Value) -> Result<SsrPayload, SsrError>;
}