DumiFlex
72d75a043c
Serve index.html with Cache-Control: no-cache and hashed assets/ as immutable; a missing assets/ file is a 404, not the shell. A boot watchdog in the shell waits for the server and reloads on a load error (3 tries a minute), then shows a Reload button. After mount, a failed route chunk reloads to that route. Troubleshooting doc entry.
69 lines
2.6 KiB
Python
69 lines
2.6 KiB
Python
"""/wp + /wp/{path:.*} — static asset server with SPA fallback.
|
|
|
|
Looks up the requested path inside ``WEB_DIR``. If a file exists, serves it.
|
|
Otherwise serves ``index.html`` so the SPA router can take over (any
|
|
``/wp/<route>`` path resolves to the SPA shell).
|
|
|
|
Exception: paths under ``/wp/api/`` that fell through every registered
|
|
API route are returned as JSON 404, not the SPA shell. Without this
|
|
guard a client typo like ``/wp/api/moduels`` returned 200 ``text/html``
|
|
(the SPA index), making API debugging hostile — the JSON.parse failure
|
|
on the client masked the real "no such endpoint" error.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
|
|
from aiohttp import web
|
|
|
|
WEB_DIR = Path(__file__).parent.parent / "web"
|
|
|
|
|
|
_SHELL_HEADERS = {"Cache-Control": "no-cache"}
|
|
_HASHED_HEADERS = {"Cache-Control": "public, max-age=31536000, immutable"}
|
|
|
|
|
|
def _is_hashed_asset(path: str) -> bool:
|
|
"""Vite's content-hashed build output lives under ``assets/``."""
|
|
return path.startswith("assets/")
|
|
|
|
|
|
async def _serve(path: str) -> web.StreamResponse:
|
|
if path:
|
|
candidate = (WEB_DIR / path).resolve()
|
|
try:
|
|
candidate.relative_to(WEB_DIR.resolve())
|
|
except ValueError:
|
|
return web.Response(status=403)
|
|
if candidate.is_file():
|
|
if candidate.name == "index.html":
|
|
return web.FileResponse(candidate, headers=_SHELL_HEADERS)
|
|
if _is_hashed_asset(path):
|
|
return web.FileResponse(candidate, headers=_HASHED_HEADERS)
|
|
return web.FileResponse(candidate)
|
|
if _is_hashed_asset(path):
|
|
# A stale shell asking for a chunk from an older build: answer
|
|
# 404 (never the shell, which would fail as a MIME mismatch).
|
|
return web.Response(status=404, headers={"Cache-Control": "no-store"})
|
|
return web.FileResponse(WEB_DIR / "index.html", headers=_SHELL_HEADERS)
|
|
|
|
|
|
async def serve_root(request: web.Request) -> web.StreamResponse:
|
|
return await _serve("")
|
|
|
|
|
|
async def serve_path(request: web.Request) -> web.StreamResponse:
|
|
path = request.match_info["path"]
|
|
# `/wp/api/...` is reserved for the JSON API. Any request reaching
|
|
# this handler under that prefix means no specific API route
|
|
# matched — return a real 404 instead of the SPA shell so the
|
|
# client gets a useful error.
|
|
if path.startswith("api/") or path == "api":
|
|
return web.json_response({"error": f"no such API route: /wp/{path}"}, status=404)
|
|
return await _serve(path)
|
|
|
|
|
|
def register(router) -> None:
|
|
router.add_get("/wp", serve_root)
|
|
router.add_get("/wp/{path:.*}", serve_path)
|