1. 1//! Embedded admin SPA (crates/vak-admin-ui/dist). The frontend is a static
2. 2//! SolidJS bundle; every data call goes through the authenticated
3. 3//! /admin/api/* routes in `crate::admin`. Serving is read-only and
4. 4//! stateless — no session state lives here, auth rides the cookie.
5. 5//!
6. 6//! The serving mechanics are shared with the workspace client at `/app`;
7. 7//! see `crate::embedded_ui` for why they live in one place.
8. 8
9. 9use axum::routing::get;
10. 10use include_dir::{Dir, include_dir};
11. 11
12. 12use crate::embedded_ui::{register_files, serve_file};
13. 13
14. 14static ADMIN_UI: Dir<'_> = include_dir!("$CARGO_MANIFEST_DIR/../vak-admin-ui/dist");
15. 15
16. 16async fn index() -> axum::response::Response {
17. 17 serve_file(&ADMIN_UI, "index.html")
18. 18}
19. 19
20. 20pub(crate) fn routes() -> axum::Router<crate::AppState> {
21. 21 let router = axum::Router::new()
22. 22 .route("/admin", get(index))
23. 23 .route("/admin/", get(index))
24. 24 // dist/favicon.svg is served by register_files below at
25. 25 // /admin/favicon.svg; the bare /favicon.svg alias is registered
26. 26 // here since it lives outside that prefix.
27. 27 .route(
28. 28 "/favicon.svg",
29. 29 get(|| async { serve_file(&ADMIN_UI, "favicon.svg") }),
30. 30 );
31. 31 register_files(router, &ADMIN_UI, &ADMIN_UI, "/admin")
32. 32}
33. 33
34. 34#[cfg(test)]
35. 35#[allow(clippy::unwrap_used, clippy::expect_used)]
36. 36mod tests {
37. 37 use super::*;
38. 38 use crate::embedded_ui::referenced_assets;
39. 39
40. 40 /// Every asset `index.html` references by URL must actually be
41. 41 /// embedded, or the admin console loads a blank shell with nothing
42. 42 /// in the console to say why: no JS runs, so nothing errors.
43. 43 ///
44. 44 /// This is the same failure `crates/vak-server/build.rs` exists to
45. 45 /// prevent — `include_dir!` has no way to know dist/ is a build
46. 46 /// input unless a build script says so, and without one a `cargo
47. 47 /// build` after `npm run build` could reuse an incremental build of
48. 48 /// this crate from before the rebuild, silently embedding an
49. 49 /// `index.html` that references hashed filenames the embedded
50. 50 /// directory no longer contains. That shipped as part of v0.8.1.
51. 51 #[test]
52. 52 fn every_asset_index_html_references_is_actually_embedded() {
53. 53 let referenced = referenced_assets(&ADMIN_UI, "/admin");
54. 54 assert!(
55. 55 !referenced.is_empty(),
56. 56 "index.html references no /admin/assets/ paths — the extraction above is not \
57. 57 matching this build's markup, not evidence there is nothing to check"
58. 58 );
59. 59 for url_path in referenced {
60. 60 let embedded_path = url_path.trim_start_matches("/admin/");
61. 61 assert!(
62. 62 ADMIN_UI.get_file(embedded_path).is_some(),
63. 63 "index.html references {url_path}, but no such file is embedded — \
64. 64 this is the exact defect that shipped in v0.8.1"
65. 65 );
66. 66 }
67. 67 }
68. 68
69. 69 /// The test above checks embedding; this checks routing — a
70. 70 /// different layer, and the one that was actually broken.
71. 71 /// `Dir::files()` is not recursive, so the previous route
72. 72 /// registration loop never reached anything under `assets/`.
73. 73 #[tokio::test]
74. 74 async fn every_referenced_asset_is_actually_routable() {
75. 75 use http_body_util::BodyExt as _;
76. 76 use tower::ServiceExt as _;
77. 77
78. 78 let referenced = referenced_assets(&ADMIN_UI, "/admin");
79. 79 assert!(
80. 80 !referenced.is_empty(),
81. 81 "nothing to check — extraction is not matching this markup"
82. 82 );
83. 83
84. 84 for url_path in referenced {
85. 85 let router = routes().with_state(crate::test_support::state());
86. 86 let response = router
87. 87 .oneshot(
88. 88 axum::http::Request::builder()
89. 89 .uri(&url_path)
90. 90 .body(axum::body::Body::empty())
91. 91 .unwrap(),
92. 92 )
93. 93 .await
94. 94 .unwrap();
95. 95 assert_eq!(
96. 96 response.status(),
97. 97 axum::http::StatusCode::OK,
98. 98 "GET {url_path} did not route to 200 — this is the exact defect \
99. 99 that shipped in v0.8.1, v0.8.2, and v0.8.3's first attempt at fixing it"
100. 100 );
101. 101 let bytes = response.into_body().collect().await.unwrap().to_bytes();
102. 102 assert!(
103. 103 !bytes.is_empty(),
104. 104 "GET {url_path} routed but returned an empty body"
105. 105 );
106. 106 }
107. 107 }
108. 108}
109. 109