78 lines
4.2 KiB
JavaScript
78 lines
4.2 KiB
JavaScript
// server/http/routes.js — the node:http request listener. Every response gets the security headers (common.js), then:
|
|
// (i18n-ignore-file: the error pages are bilingual by design, 中文 · English — docs/I18N.md)
|
|
//
|
|
// * a URL longer than 4096 characters → 414; one that does not parse → 400;
|
|
// * any method but GET / HEAD → 405 with `Allow: GET, HEAD`;
|
|
// * GET /healthz → JSON status (protocol `version`, release `app`, uptime, the served `build`, sockets, sessions,
|
|
// rooms, matches), never cached; `?traffic=1` adds the traffic counters (traffic.js: bytes by category since the
|
|
// start, WebSocket wire and payload bytes);
|
|
// * everything else → the static files (static.js).
|
|
// Every response's body bytes count in the traffic counters (traffic.js meter). A route that throws is logged and
|
|
// answers 500.
|
|
|
|
import { PROTOCOL_VERSION, APP_VERSION } from '../../shared/constants.js';
|
|
import { buildTag } from './buildTag.js';
|
|
import { setSecurityHeaders, sendError, sendJson, splitUrl } from './common.js';
|
|
|
|
const MAX_URL_LENGTH = 4096;
|
|
|
|
/**
|
|
* The GET /healthz body (`withTraffic`: plus the traffic counters and the asset index's state, `?traffic=1`).
|
|
* @param {{ startedAt: number, network: import('../net.js').Network, registry: import('../net.js').SessionRegistry,
|
|
* lobby: import('../lobby.js').Lobby, traffic?: ReturnType<typeof import('./traffic.js').createTrafficCounter>,
|
|
* assetIndex?: ReturnType<typeof import('./assetIndex.js').createAssetIndex> | null,
|
|
* views?: ReturnType<typeof import('./assetViews.js').createManifestViews> | null }} health
|
|
* @param {boolean} [withTraffic]
|
|
*/
|
|
export function healthReport({ startedAt, network, registry, lobby, traffic, assetIndex, views }, withTraffic = false) {
|
|
const report = {
|
|
ok: true, version: PROTOCOL_VERSION, app: APP_VERSION, uptimeSec: Math.round((Date.now() - startedAt) / 1000),
|
|
// the runtime the server is serving right now (public/js/ui/buildGuard.js): a page whose own build is
|
|
// older than this reloads itself, so a deploy reaches clients that never reload
|
|
build: buildTag(),
|
|
sockets: network.connectionCount, sessions: registry.size, ...lobby.stats(),
|
|
};
|
|
if (withTraffic && traffic) report.traffic = traffic.snapshot();
|
|
// content-hashed asset URLs (assetIndex.js / assetViews.js): off, building, or ready with how many files and URLs
|
|
if (withTraffic) report.assetHashes = assetIndex ? { ...assetIndex.stats(), views: views ? views.stats() : null } : null;
|
|
return report;
|
|
}
|
|
|
|
/** Does the query ask for the traffic counters (`traffic`, `traffic=1`, `traffic=true`)? */
|
|
const wantsTraffic = (query) => /(?:^|&)traffic(?:=(?:1|true|yes))?(?:&|$)/i.test(query || '');
|
|
|
|
/**
|
|
* The request listener for `http.createServer`.
|
|
* @param {{ serveStatic: (req: import('node:http').IncomingMessage, res: import('node:http').ServerResponse,
|
|
* rawPath: string, query: string) => Promise<void>,
|
|
* health: Parameters<typeof healthReport>[0], log: object }} deps
|
|
* @returns {(req: import('node:http').IncomingMessage, res: import('node:http').ServerResponse) => void}
|
|
*/
|
|
export function createRequestHandler({ serveStatic, health, log }) {
|
|
async function handleRequest(req, res) {
|
|
const url = req.url || '/';
|
|
if (url.length > MAX_URL_LENGTH) { sendError(req, res, 414, '请求地址过长 · URI too long'); return; }
|
|
const parts = splitUrl(url);
|
|
if (!parts) { sendError(req, res, 400, '请求地址无效 · Bad request'); return; }
|
|
if (req.method !== 'GET' && req.method !== 'HEAD') {
|
|
res.setHeader('Allow', 'GET, HEAD');
|
|
sendError(req, res, 405, '不支持的请求方法 · Method not allowed');
|
|
return;
|
|
}
|
|
if (parts.rawPath === '/healthz') {
|
|
sendJson(req, res, 200, healthReport(health, wantsTraffic(parts.query)));
|
|
return;
|
|
}
|
|
await serveStatic(req, res, parts.rawPath, parts.query);
|
|
}
|
|
|
|
return (req, res) => {
|
|
setSecurityHeaders(res);
|
|
if (health.traffic) health.traffic.meter(res, splitUrl(req.url || '/')?.rawPath || '/');
|
|
handleRequest(req, res).catch((e) => {
|
|
log.error('[http] request failed', e);
|
|
sendError(req, res, 500, '服务器内部错误 · Internal error');
|
|
});
|
|
};
|
|
}
|