adler-server 0.11.2

HTTP API + SSE streaming for the Adler OSINT username-search engine.
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

//! Static SPA assets — `web/dist/` embedded into the binary via
//! `rust-embed`.
//!
//! The `SolidJS` project lives at `adler-server/web/` and Vite builds it
//! to `web/dist/`, which `rust-embed` reads directly. Keeping the
//! frontend inside this crate means a standalone `cargo install
//! adler-server` finds the bundle, and — because it's inside the
//! package directory — changes to the SPA are visible to release-plz,
//! so a frontend-only edit still cuts a release.
//!
//! Routes attached here:
//!   - `GET /` and any SPA route → `web/dist/index.html`
//!   - `GET /assets/*` (and any other embedded file) → matched 1:1
//!   - `GET /favicon.ico` → 204 (favicon ships inline in index.html
//!     as an SVG data URI; this stops browser noise without bundling
//!     a separate icon file).

use axum::Router;
use axum::body::Body;
use axum::extract::Path as AxumPath;
use axum::http::{HeaderValue, StatusCode, header};
use axum::response::{IntoResponse, Response};
use axum::routing::get;
use rust_embed::RustEmbed;

#[derive(RustEmbed)]
#[folder = "web/dist/"]
struct Asset;

pub(crate) fn attach(router: Router) -> Router {
    router
        .route("/", get(index))
        .route("/favicon.ico", get(favicon))
        .route("/*path", get(static_file_or_index))
}

async fn index() -> Response {
    serve_embedded("index.html").unwrap_or_else(spa_missing_response)
}

async fn static_file_or_index(AxumPath(path): AxumPath<String>) -> Response {
    // Don't intercept API requests — they should 404 if no handler matched.
    if path.starts_with("api/") {
        return (StatusCode::NOT_FOUND, "not found").into_response();
    }
    // Try an exact file match first; otherwise fall through to the
    // SPA's index.html so client-side routing handles unknown paths.
    if let Some(resp) = serve_embedded(&path) {
        return resp;
    }
    serve_embedded("index.html").unwrap_or_else(spa_missing_response)
}

async fn favicon() -> (StatusCode, [(header::HeaderName, &'static str); 1]) {
    (
        StatusCode::NO_CONTENT,
        [(header::CACHE_CONTROL, "public, max-age=86400")],
    )
}

fn serve_embedded(path: &str) -> Option<Response> {
    let file = Asset::get(path)?;
    let mime = mime_guess::from_path(path).first_or_octet_stream();
    let mut response = Body::from(file.data.into_owned()).into_response();
    response.headers_mut().insert(
        header::CONTENT_TYPE,
        HeaderValue::from_str(mime.as_ref())
            .unwrap_or_else(|_| HeaderValue::from_static("application/octet-stream")),
    );
    // Cache static assets aggressively; the bundle filenames are
    // content-hashed by Vite so a deploy invalidates them by URL change.
    // index.html is never long-cached — it references the hashed bundles.
    let cache_control = if path == "index.html" {
        "no-cache"
    } else {
        "public, max-age=31536000, immutable"
    };
    response.headers_mut().insert(
        header::CACHE_CONTROL,
        HeaderValue::from_static(cache_control),
    );
    Some(response)
}

fn spa_missing_response() -> Response {
    (
        StatusCode::SERVICE_UNAVAILABLE,
        [(header::CONTENT_TYPE, "text/html; charset=utf-8")],
        SPA_MISSING_HTML,
    )
        .into_response()
}

const SPA_MISSING_HTML: &str = r#"<!doctype html>
<html><head><meta charset="utf-8"><title>Adler — frontend not built</title>
<style>body{font-family:ui-monospace,monospace;background:#000;color:#eee;padding:3rem 2rem;max-width:38rem;margin:auto}h1{color:#ff2d2d}code{background:#1a1a1a;padding:0.1rem 0.4rem}</style></head><body>
<h1>adler-web/dist/ is empty</h1>
<p>The SolidJS bundle wasn't built into the binary at compile time.</p>
<pre>  cd adler-server/web
  npm install
  npm run build
  cargo build -p adler-cli --release</pre>
<p>API endpoints are still live — see <code>GET /api/health</code>.</p>
</body></html>"#;