lumen-server 0.2.1

Embeddable render service primitives and local HTTP server for Lumen.
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

use axum::extract::ws::{Message, WebSocket};
use futures_util::SinkExt;

use crate::server::RenderNotification;

use super::state::AppState;

pub(super) async fn render_socket_session(mut socket: WebSocket, state: AppState, id: String) {
    let snapshot = state
        .renders
        .read()
        .ok()
        .and_then(|renders| renders.get(&id).and_then(|stored| stored.progress.clone()));
    let _ = send_notification(
        &mut socket,
        &RenderNotification {
            state: snapshot,
            kind: "snapshot",
        },
    )
    .await;

    let mut rx = state.progress_tx.subscribe();
    loop {
        tokio::select! {
            message = socket.recv() => {
                match message {
                    Some(Ok(Message::Close(_))) => {
                        let _ = socket.close().await;
                        break;
                    }
                    None => break,
                    Some(Ok(_)) => {}
                    Some(Err(_)) => break,
                }
            }
            notification = rx.recv() => {
                match notification {
                    Ok(notification)
                        if notification
                            .state
                            .as_ref()
                            .is_some_and(|progress| progress.render_id == id) =>
                    {
                        if send_notification(&mut socket, &notification).await.is_err() {
                            break;
                        }
                    }
                    Ok(_) => {}
                    Err(tokio::sync::broadcast::error::RecvError::Lagged(_)) => {}
                    Err(tokio::sync::broadcast::error::RecvError::Closed) => break,
                }
            }
        }
    }
}

async fn send_notification(
    socket: &mut WebSocket,
    notification: &RenderNotification,
) -> Result<(), axum::Error> {
    let Some(event) = render_event(notification) else {
        return Ok(());
    };
    let Ok(text) = serde_json::to_string(&event) else {
        return Ok(());
    };
    socket.send(Message::Text(text.into())).await
}

fn render_event(notification: &RenderNotification) -> Option<serde_json::Value> {
    let Some(state) = notification.state.as_ref() else {
        return None;
    };

    Some(match state.state {
        "queued" => serde_json::json!({
            "type": "render.queued",
            "renderId": state.render_id,
        }),
        "succeeded" => serde_json::json!({
            "type": "render.completed",
            "renderId": state.render_id,
            "url": state.artifact_url,
        }),
        "failed" => serde_json::json!({
            "type": "render.failed",
            "renderId": state.render_id,
            "error": {
                "code": "render_failed",
                "message": state.error.as_deref().unwrap_or("Render failed."),
            },
        }),
        "processing" if notification.kind == "started" => serde_json::json!({
            "type": "render.started",
            "renderId": state.render_id,
        }),
        _ => serde_json::json!({
            "type": "render.progress",
            "renderId": state.render_id,
            "progress": state.progress,
        }),
    })
}