rari 0.13.2

rari: Runtime Accelerated Rendering Infrastructure - A high-performance React Server Components framework powered by 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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

mod cache;
mod generator;
mod layout;
mod rendering;
mod resources;
mod types;

pub use cache::OgImageCache;
pub use generator::OgImageGenerator;
pub use types::{OgImageParams, OgImageResult};

use crate::error::RariError;
use axum::{
    extract::{Path, State},
    http::{StatusCode, header},
    response::{IntoResponse, Response},
};
use std::sync::Arc;

pub async fn handle_og_image_request(
    State(generator): State<Arc<OgImageGenerator>>,
    Path(route_path): Path<String>,
) -> Result<Response, OgImageError> {
    let normalized_path = if route_path.is_empty() {
        "/".to_string()
    } else {
        format!("/{}", route_path.trim_start_matches('/'))
    };

    let (image_data, cache_hit) = generator.generate(&normalized_path).await?;

    let x_cache = if cache_hit { "HIT" } else { "MISS" };

    let mut response = (
        StatusCode::OK,
        [
            (header::CONTENT_TYPE, "image/webp"),
            (header::CACHE_CONTROL, "public, max-age=31536000, immutable"),
        ],
        image_data,
    )
        .into_response();

    response
        .headers_mut()
        .insert("x-cache", x_cache.parse().expect("x-cache header value should be valid ASCII"));

    Ok(response)
}

#[derive(Debug, thiserror::Error)]
pub enum OgImageError {
    #[error("OG image component not found for route: {0}")]
    ComponentNotFound(String),
    #[error("Failed to execute OG component: {0}")]
    ExecutionError(String),
    #[error("Failed to generate image: {0}")]
    GenerationError(String),
    #[error("Invalid parameters: {0}")]
    InvalidParams(String),
    #[error("Internal error: {0}")]
    InternalError(String),
}

impl From<RariError> for OgImageError {
    fn from(err: RariError) -> Self {
        OgImageError::InternalError(err.to_string())
    }
}

impl IntoResponse for OgImageError {
    fn into_response(self) -> Response {
        let (status, message) = match self {
            OgImageError::ComponentNotFound(_) => (StatusCode::NOT_FOUND, self.to_string()),
            OgImageError::InvalidParams(_) => (StatusCode::BAD_REQUEST, self.to_string()),
            OgImageError::ExecutionError(_) | OgImageError::GenerationError(_) => {
                (StatusCode::INTERNAL_SERVER_ERROR, self.to_string())
            }
            OgImageError::InternalError(_) => {
                (StatusCode::INTERNAL_SERVER_ERROR, "Internal server error".to_string())
            }
        };

        (status, message).into_response()
    }
}