Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -1,14 +1,49 @@
|
||||
import { ServerResponse, createServer, type IncomingMessage } from "node:http";
|
||||
import { createReadStream } from "node:fs";
|
||||
import { stat } from "node:fs/promises";
|
||||
import os from "node:os";
|
||||
import path from "node:path";
|
||||
import { fileURLToPath, pathToFileURL } from "node:url";
|
||||
import type { ServerBuild } from "react-router";
|
||||
import { loadRequiredWebConfig } from "@hivegrid/config";
|
||||
import { assertRlsRuntimeReady } from "@hivegrid/db/rls-runtime-readiness.server";
|
||||
import { assertPortalRlsRuntimeReady } from "@hivegrid/db/portal-rls-runtime-readiness.server";
|
||||
import {
|
||||
resolvePortalRuntimeCustomHost,
|
||||
resolvePortalRuntimeCustomHostHealth,
|
||||
resolvePortalRuntimeTenant,
|
||||
} from "@hivegrid/db/portal-runtime-tenant.server";
|
||||
import { createChildLogger, defaultLogger } from "@hivegrid/logger";
|
||||
import { app as apiApp } from "../apps/api/src/app";
|
||||
import { getHostRoutingRuntimeDecision } from "./host-routing-runtime";
|
||||
import {
|
||||
finalizePortalHostRoutingDecision,
|
||||
finalizePortalTenantRoutingDecision,
|
||||
getHostRoutingRuntimeDecision,
|
||||
} from "./host-routing-runtime";
|
||||
import {
|
||||
createStaticEtag,
|
||||
getStaticAssetMetadata,
|
||||
getStaticCacheControl,
|
||||
hasCompressedRepresentation,
|
||||
isStaticAssetNotModified,
|
||||
selectStaticRepresentation,
|
||||
type StaticAssetMetadata,
|
||||
type StaticAssetRepresentation,
|
||||
} from "./static-assets";
|
||||
import { createLimitedRequestBody, isRequestBodyTooLargeError, parseRequestContentLength, resolveWebRequestBodyLimit } from "./request-body";
|
||||
import { validateMutationOrigin } from "./request-origin";
|
||||
import { overwriteRequestCspNonce } from "./csp";
|
||||
import { prepareReactRouterManifestRequest } from "./react-router-manifest-dispatch";
|
||||
import { getPortalCapabilityResponseSecurityHeaders } from "../apps/web/app/services/customer-portal/portal-response-security";
|
||||
import { getWebBuildDirectory, getWebServiceName, requireWebBuildSurface } from "../apps/web/build-surface";
|
||||
import {
|
||||
CSP_NONCE_REQUEST_HEADER,
|
||||
SERVICE_WORKER_CONTENT_SECURITY_POLICY,
|
||||
STATIC_ASSET_CONTENT_SECURITY_POLICY,
|
||||
buildDocumentContentSecurityPolicy,
|
||||
contentSecurityPolicyAllowsExternalFraming,
|
||||
getRequestCspNonce,
|
||||
type DocumentContentSecurityPolicyOptions,
|
||||
} from "../apps/web/app/utils/security/contentSecurityPolicy";
|
||||
import { getRequestDocumentContentSecurityPolicyOptions } from "../apps/web/app/utils/security/requestContentSecurityPolicy.server";
|
||||
|
||||
process.env.NODE_ENV = process.env.NODE_ENV ?? "production";
|
||||
|
||||
@@ -16,9 +51,12 @@ const RUNTIME_DIRECTORY = path.dirname(fileURLToPath(import.meta.url));
|
||||
const REPO_ROOT_DIRECTORY = RUNTIME_DIRECTORY.endsWith(path.join("build", "server-runtime"))
|
||||
? path.resolve(RUNTIME_DIRECTORY, "..", "..")
|
||||
: path.resolve(RUNTIME_DIRECTORY, "..");
|
||||
const WEB_BUILD_DIRECTORY = process.env.WEB_BUILD_DIRECTORY
|
||||
? path.resolve(process.env.WEB_BUILD_DIRECTORY)
|
||||
: path.join(REPO_ROOT_DIRECTORY, "apps", "web", "build");
|
||||
const webConfig = loadRequiredWebConfig();
|
||||
const runtimeBuildSurface = requireWebBuildSurface();
|
||||
if (runtimeBuildSurface !== webConfig.runtimeSurface) {
|
||||
throw new Error("HIVEGRID_RUNTIME_SURFACE must match WEB_RUNTIME_SURFACE");
|
||||
}
|
||||
const WEB_BUILD_DIRECTORY = path.join(REPO_ROOT_DIRECTORY, "apps", "web", getWebBuildDirectory(runtimeBuildSurface));
|
||||
const BUILD_PATH = path.join(WEB_BUILD_DIRECTORY, "server", "index.js");
|
||||
const CLIENT_BUILD_DIRECTORY = path.join(WEB_BUILD_DIRECTORY, "client");
|
||||
const ALLOWED_STATIC_ASSET_EXTENSIONS = new Set([
|
||||
@@ -42,51 +80,136 @@ const ALLOWED_STATIC_ASSET_EXTENSIONS = new Set([
|
||||
".woff2",
|
||||
".xml",
|
||||
]);
|
||||
const webConfig = loadRequiredWebConfig();
|
||||
const PORT = webConfig.listen.port;
|
||||
const HOST = webConfig.listen.host;
|
||||
const serverLogger = createChildLogger(defaultLogger, { component: "server" });
|
||||
const serverLogger = createChildLogger(defaultLogger, {
|
||||
component: "server",
|
||||
service: getWebServiceName(webConfig.runtimeSurface),
|
||||
surface: webConfig.runtimeSurface,
|
||||
});
|
||||
const browserBuildEnv = {
|
||||
VITE_SENTRY_DSN_WEB: process.env.VITE_SENTRY_DSN_WEB,
|
||||
VITE_OTEL_EXPORTER_OTLP_ENDPOINT: process.env.VITE_OTEL_EXPORTER_OTLP_ENDPOINT,
|
||||
VITE_HOCUSPOCUS_URL: process.env.VITE_HOCUSPOCUS_URL,
|
||||
};
|
||||
|
||||
const rlsReadiness = webConfig.runtimeSurface === "portal" ? await assertPortalRlsRuntimeReady() : await assertRlsRuntimeReady();
|
||||
if (!rlsReadiness.ready) {
|
||||
serverLogger.warn({ diagnostics: rlsReadiness.diagnostics, surface: webConfig.runtimeSurface }, "RLS runtime is running in audit mode with failed checks");
|
||||
}
|
||||
|
||||
const [{ createRequestHandler }, { createReadableStreamFromReadable, writeReadableStreamToWritable }] = await Promise.all([
|
||||
import("react-router"),
|
||||
import("@react-router/node"),
|
||||
]);
|
||||
const build = (await import(pathToFileURL(BUILD_PATH).href)) as ServerBuild;
|
||||
const handleReactRouterRequest = createRequestHandler(build, process.env.NODE_ENV);
|
||||
const reactRouterRequestHandler = createRequestHandler(build, process.env.NODE_ENV);
|
||||
|
||||
type RequestI18nScopeRunner = (request: Request, callback: () => Promise<Response>) => Promise<Response>;
|
||||
|
||||
const runWithRequestI18nScope = (
|
||||
build.entry.module as ServerBuild["entry"]["module"] & {
|
||||
runWithRequestI18nScope?: RequestI18nScopeRunner;
|
||||
}
|
||||
).runWithRequestI18nScope;
|
||||
|
||||
if (typeof runWithRequestI18nScope !== "function") {
|
||||
throw new Error("Web server build is missing the request-scoped i18n entry wrapper");
|
||||
}
|
||||
|
||||
const handleReactRouterRequest = (request: Request) => runWithRequestI18nScope(request, () => reactRouterRequestHandler(request));
|
||||
|
||||
type NodeRequestInit = RequestInit & { duplex?: "half" };
|
||||
|
||||
const server = createServer(async (req, res) => {
|
||||
try {
|
||||
if (await serveStaticAsset(req, res)) {
|
||||
const requestBodyLimit = resolveWebRequestBodyLimit(req.url, webConfig.runtimeSurface);
|
||||
const declaredBodyLength = getDeclaredBodyLength(req);
|
||||
if (declaredBodyLength !== null && declaredBodyLength > requestBodyLimit) {
|
||||
sendPayloadTooLarge(res);
|
||||
return;
|
||||
}
|
||||
|
||||
const request = createWebRequest(req, res);
|
||||
const routingDecision = getHostRoutingRuntimeDecision(request);
|
||||
const request = createWebRequest(req, res, requestBodyLimit);
|
||||
let routingDecision = getHostRoutingRuntimeDecision(request, {
|
||||
runtimeSurface: webConfig.runtimeSurface,
|
||||
routing: webConfig.routing,
|
||||
});
|
||||
if (routingDecision.type === "resolve-portal-tenant") {
|
||||
const tenant = await resolvePortalRuntimeTenant(routingDecision.tenantSlug);
|
||||
routingDecision = finalizePortalTenantRoutingDecision(routingDecision, tenant?.tenantSlug ?? null);
|
||||
}
|
||||
if (routingDecision.type === "resolve-portal-host") {
|
||||
const host =
|
||||
new URL(routingDecision.request.url).pathname === "/healthz"
|
||||
? await resolvePortalRuntimeCustomHostHealth(routingDecision.hostname)
|
||||
: await resolvePortalRuntimeCustomHost(routingDecision.hostname);
|
||||
routingDecision = finalizePortalHostRoutingDecision(routingDecision, host);
|
||||
}
|
||||
if (routingDecision.type === "redirect") {
|
||||
await sendWebResponse(
|
||||
res,
|
||||
new Response(null, {
|
||||
status: routingDecision.status,
|
||||
headers: { Location: routingDecision.location },
|
||||
})
|
||||
}),
|
||||
request
|
||||
);
|
||||
return;
|
||||
}
|
||||
if (routingDecision.type === "reject") {
|
||||
await sendWebResponse(res, new Response("Not Found", { status: routingDecision.status }));
|
||||
await sendWebResponse(res, new Response("Not Found", { status: routingDecision.status }), request);
|
||||
return;
|
||||
}
|
||||
|
||||
if (routingDecision.target === "web" && isWebOperationalRoute(request)) {
|
||||
await sendWebResponse(res, await handleReactRouterRequest(request));
|
||||
if (routingDecision.serveStaticAssets) {
|
||||
if (await serveStaticAsset(req, res)) {
|
||||
return;
|
||||
}
|
||||
if (!routingDecision.reactRouterFallback) {
|
||||
await sendWebResponse(res, new Response("Not Found", { status: 404 }), routingDecision.request);
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
const manifestDispatchDecision = prepareReactRouterManifestRequest(routingDecision.request, runtimeBuildSurface);
|
||||
if (manifestDispatchDecision.type === "reject") {
|
||||
await sendWebResponse(res, new Response("Not Found", { status: manifestDispatchDecision.status }), routingDecision.request);
|
||||
return;
|
||||
}
|
||||
const manifestRequest = manifestDispatchDecision.request;
|
||||
|
||||
const mutationOriginDecision = validateMutationOrigin(manifestRequest);
|
||||
if (!mutationOriginDecision.allowed) {
|
||||
serverLogger.warn({ reason: mutationOriginDecision.reason, method: manifestRequest.method }, "cross-origin web mutation rejected");
|
||||
await sendWebResponse(
|
||||
res,
|
||||
new Response("Forbidden", {
|
||||
status: 403,
|
||||
headers: { "Cache-Control": "no-store" },
|
||||
}),
|
||||
manifestRequest
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
const response = routingDecision.target === "api" ? await apiApp.fetch(routingDecision.request) : await handleReactRouterRequest(routingDecision.request);
|
||||
await sendWebResponse(res, response);
|
||||
if (routingDecision.target === "web" && isWebOperationalRoute(manifestRequest)) {
|
||||
await sendWebResponse(res, await handleReactRouterRequest(manifestRequest), manifestRequest);
|
||||
return;
|
||||
}
|
||||
|
||||
if (routingDecision.target === "api") {
|
||||
serverLogger.warn({ host: request.headers.get("host") }, "API host request rejected by web runtime");
|
||||
await sendWebResponse(res, new Response("Not Found", { status: 404 }), request);
|
||||
return;
|
||||
}
|
||||
|
||||
await sendWebResponse(res, await handleReactRouterRequest(manifestRequest), manifestRequest);
|
||||
} catch (error) {
|
||||
if (isRequestBodyTooLargeError(error)) {
|
||||
sendPayloadTooLarge(res);
|
||||
return;
|
||||
}
|
||||
serverLogger.error({ error }, "server request failed");
|
||||
if (!res.headersSent) {
|
||||
res.statusCode = 500;
|
||||
@@ -96,20 +219,20 @@ const server = createServer(async (req, res) => {
|
||||
}
|
||||
});
|
||||
|
||||
server.requestTimeout = 120_000;
|
||||
server.headersTimeout = 15_000;
|
||||
server.keepAliveTimeout = 5_000;
|
||||
server.maxHeadersCount = 100;
|
||||
server.maxRequestsPerSocket = 1_000;
|
||||
|
||||
server.listen(PORT, HOST, () => {
|
||||
const address = HOST ?? getLocalAddress() ?? "localhost";
|
||||
serverLogger.info({ host: address, port: PORT }, "server listening");
|
||||
});
|
||||
|
||||
let shuttingDown = false;
|
||||
for (const signal of ["SIGTERM", "SIGINT"] as const) {
|
||||
process.once(signal, () => {
|
||||
server.close((error) => {
|
||||
if (error) {
|
||||
serverLogger.error({ error }, "server shutdown failed");
|
||||
process.exitCode = 1;
|
||||
}
|
||||
});
|
||||
});
|
||||
process.once(signal, () => beginGracefulShutdown(signal));
|
||||
}
|
||||
|
||||
async function serveStaticAsset(req: IncomingMessage, res: ServerResponse) {
|
||||
@@ -123,12 +246,29 @@ async function serveStaticAsset(req: IncomingMessage, res: ServerResponse) {
|
||||
return false;
|
||||
}
|
||||
|
||||
const fileStat = await stat(filePath).catch(() => null);
|
||||
if (!fileStat?.isFile()) {
|
||||
const metadata = await getStaticAssetMetadata(filePath);
|
||||
if (!metadata) {
|
||||
return false;
|
||||
}
|
||||
|
||||
const headers = getStaticHeaders(filePath, requestUrl.pathname);
|
||||
const representation = selectStaticRepresentation(metadata, getSingleHeader(req.headers["accept-encoding"]));
|
||||
const headers = getStaticHeaders(filePath, requestUrl, metadata, representation);
|
||||
const etag = headers.ETag;
|
||||
if (
|
||||
etag &&
|
||||
isStaticAssetNotModified({
|
||||
etag,
|
||||
ifNoneMatch: getSingleHeader(req.headers["if-none-match"]),
|
||||
ifModifiedSince: getSingleHeader(req.headers["if-modified-since"]),
|
||||
mtimeMs: metadata.identity.stat.mtimeMs,
|
||||
})
|
||||
) {
|
||||
delete headers["Content-Length"];
|
||||
res.writeHead(304, headers);
|
||||
res.end();
|
||||
return true;
|
||||
}
|
||||
|
||||
res.writeHead(200, headers);
|
||||
|
||||
if (req.method === "HEAD") {
|
||||
@@ -136,7 +276,7 @@ async function serveStaticAsset(req: IncomingMessage, res: ServerResponse) {
|
||||
return true;
|
||||
}
|
||||
|
||||
createReadStream(filePath)
|
||||
createReadStream(representation.filePath)
|
||||
.on("error", (error) => {
|
||||
serverLogger.error({ error }, "static asset stream failed");
|
||||
if (!res.headersSent) {
|
||||
@@ -173,39 +313,53 @@ function getClientFilePath(pathname: string) {
|
||||
return filePath;
|
||||
}
|
||||
|
||||
function createWebRequest(req: IncomingMessage, res: ServerResponse) {
|
||||
const protocol = req.headers["x-forwarded-proto"]?.toString().split(",")[0]?.trim() || "http";
|
||||
function createWebRequest(req: IncomingMessage, res: ServerResponse, bodyLimitBytes: number) {
|
||||
const host = req.headers.host || "localhost";
|
||||
const url = new URL(req.url ?? "/", `${protocol}://${host}`);
|
||||
const url = createWebRequestUrl(req.url, host);
|
||||
const controller = new AbortController();
|
||||
|
||||
res.on("close", () => {
|
||||
controller.abort();
|
||||
});
|
||||
|
||||
const headers = createWebHeaders(req.headers);
|
||||
overwriteRequestCspNonce(headers);
|
||||
const init: NodeRequestInit = {
|
||||
method: req.method,
|
||||
headers: createWebHeaders(req.headers),
|
||||
headers,
|
||||
signal: controller.signal,
|
||||
};
|
||||
|
||||
if (req.method !== "GET" && req.method !== "HEAD") {
|
||||
init.body = createReadableStreamFromReadable(req);
|
||||
init.body = createReadableStreamFromReadable(createLimitedRequestBody(req, bodyLimitBytes));
|
||||
init.duplex = "half";
|
||||
}
|
||||
|
||||
return new Request(url, init);
|
||||
}
|
||||
|
||||
function createWebRequestUrl(requestUrl: string | undefined, host: string) {
|
||||
try {
|
||||
return new URL(requestUrl ?? "/", `${webConfig.routing.protocol}://${host}`);
|
||||
} catch {
|
||||
// Preserve the original Host header for the routing gate; this inert URL
|
||||
// only prevents malformed client input from escaping the fail-closed 404.
|
||||
return new URL(requestUrl ?? "/", `${webConfig.routing.protocol}://invalid.localhost`);
|
||||
}
|
||||
}
|
||||
|
||||
function isWebOperationalRoute(request: Request) {
|
||||
const { pathname } = new URL(request.url);
|
||||
return pathname === "/healthz" || pathname === "/readyz" || pathname === "/healthcheck";
|
||||
return pathname === "/healthz" || pathname === "/readyz" || pathname === "/healthcheck" || pathname === "/api/metrics";
|
||||
}
|
||||
|
||||
function createWebHeaders(headers: IncomingMessage["headers"]) {
|
||||
const webHeaders = new Headers();
|
||||
|
||||
for (const [key, value] of Object.entries(headers)) {
|
||||
if (key.toLowerCase().startsWith("x-hivegrid-portal-")) {
|
||||
continue;
|
||||
}
|
||||
if (Array.isArray(value)) {
|
||||
for (const item of value) {
|
||||
webHeaders.append(key, item);
|
||||
@@ -218,35 +372,65 @@ function createWebHeaders(headers: IncomingMessage["headers"]) {
|
||||
return webHeaders;
|
||||
}
|
||||
|
||||
async function sendWebResponse(res: ServerResponse, response: Response) {
|
||||
async function sendWebResponse(res: ServerResponse, response: Response, request: Request) {
|
||||
res.statusCode = response.status;
|
||||
res.statusMessage = response.statusText;
|
||||
|
||||
for (const [key, value] of response.headers) {
|
||||
if (key.toLowerCase() === CSP_NONCE_REQUEST_HEADER) continue;
|
||||
res.appendHeader(key, value);
|
||||
}
|
||||
appendWebSecurityHeaders(res);
|
||||
const portalCapabilityHeaders = getPortalCapabilityResponseSecurityHeaders(request, runtimeBuildSurface);
|
||||
if (portalCapabilityHeaders) {
|
||||
for (const [key, value] of Object.entries(portalCapabilityHeaders)) {
|
||||
res.setHeader(key, value);
|
||||
}
|
||||
}
|
||||
appendWebSecurityHeaders(res, {
|
||||
documentNonce: getRequestCspNonce(request),
|
||||
documentPolicy: getRequestDocumentContentSecurityPolicyOptions(request, webConfig, process.env, browserBuildEnv),
|
||||
});
|
||||
|
||||
if (!response.body) {
|
||||
res.end();
|
||||
return;
|
||||
}
|
||||
|
||||
await writeReadableStreamToWritable(response.body, res);
|
||||
try {
|
||||
await writeReadableStreamToWritable(response.body, res);
|
||||
} catch (error) {
|
||||
// A browser can abandon an SSR or SSE response while it is still streaming.
|
||||
// This is expected transport cancellation, not a server failure.
|
||||
if (request.signal.aborted) {
|
||||
serverLogger.debug({ event: "web.response.client_disconnected" }, "web response stream ended after client disconnect");
|
||||
return;
|
||||
}
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
function appendWebSecurityHeaders(headers: Headers): Headers;
|
||||
function appendWebSecurityHeaders(headers: Record<string, string>): Record<string, string>;
|
||||
function appendWebSecurityHeaders(headers: ServerResponse): ServerResponse;
|
||||
function appendWebSecurityHeaders(headers: Headers | Record<string, string> | ServerResponse) {
|
||||
type WebSecurityHeaderOptions = {
|
||||
documentNonce?: string;
|
||||
documentPolicy?: DocumentContentSecurityPolicyOptions;
|
||||
};
|
||||
|
||||
function appendWebSecurityHeaders(headers: Headers, options?: WebSecurityHeaderOptions): Headers;
|
||||
function appendWebSecurityHeaders(headers: Record<string, string>, options?: WebSecurityHeaderOptions): Record<string, string>;
|
||||
function appendWebSecurityHeaders(headers: ServerResponse, options?: WebSecurityHeaderOptions): ServerResponse;
|
||||
function appendWebSecurityHeaders(headers: Headers | Record<string, string> | ServerResponse, options: WebSecurityHeaderOptions = {}) {
|
||||
const routePolicy = getHeaderValue(headers, "Content-Security-Policy");
|
||||
const routeReferrerPolicy = getHeaderValue(headers, "Referrer-Policy");
|
||||
const contentSecurityPolicy = options.documentNonce
|
||||
? buildDocumentContentSecurityPolicy(options.documentNonce, routePolicy, options.documentPolicy)
|
||||
: (routePolicy ?? STATIC_ASSET_CONTENT_SECURITY_POLICY);
|
||||
const allowsExternalFraming = contentSecurityPolicyAllowsExternalFraming(contentSecurityPolicy);
|
||||
const securityHeaders: Record<string, string> = {
|
||||
"Content-Security-Policy": "base-uri 'self'; object-src 'none'; frame-ancestors 'self'",
|
||||
"Content-Security-Policy": contentSecurityPolicy,
|
||||
"X-Content-Type-Options": "nosniff",
|
||||
"Referrer-Policy": "strict-origin-when-cross-origin",
|
||||
"X-Frame-Options": "SAMEORIGIN",
|
||||
"Referrer-Policy": routeReferrerPolicy ?? "strict-origin-when-cross-origin",
|
||||
"Permissions-Policy": "camera=(), microphone=(), geolocation=(), payment=()",
|
||||
"Cross-Origin-Opener-Policy": "same-origin",
|
||||
"Cross-Origin-Resource-Policy": "same-origin",
|
||||
"Cross-Origin-Opener-Policy": allowsExternalFraming ? "unsafe-none" : "same-origin",
|
||||
"Cross-Origin-Resource-Policy": allowsExternalFraming ? "cross-origin" : "same-origin",
|
||||
"Cross-Origin-Embedder-Policy": "unsafe-none",
|
||||
};
|
||||
|
||||
@@ -254,10 +438,13 @@ function appendWebSecurityHeaders(headers: Headers | Record<string, string> | Se
|
||||
securityHeaders["Strict-Transport-Security"] = "max-age=31536000; includeSubDomains";
|
||||
}
|
||||
|
||||
if (allowsExternalFraming) {
|
||||
removeHeader(headers, "X-Frame-Options");
|
||||
} else {
|
||||
securityHeaders["X-Frame-Options"] = "SAMEORIGIN";
|
||||
}
|
||||
|
||||
for (const [key, value] of Object.entries(securityHeaders)) {
|
||||
if (key === "Content-Security-Policy" && hasHeader(headers, key)) {
|
||||
continue;
|
||||
}
|
||||
if (headers instanceof Headers) {
|
||||
headers.set(key, value);
|
||||
} else if (headers instanceof ServerResponse) {
|
||||
@@ -270,37 +457,103 @@ function appendWebSecurityHeaders(headers: Headers | Record<string, string> | Se
|
||||
return headers;
|
||||
}
|
||||
|
||||
function hasHeader(headers: Headers | Record<string, string> | ServerResponse, key: string) {
|
||||
function getHeaderValue(headers: Headers | Record<string, string> | ServerResponse, key: string): string | undefined {
|
||||
if (headers instanceof Headers) {
|
||||
return headers.has(key);
|
||||
return headers.get(key) ?? undefined;
|
||||
}
|
||||
if (headers instanceof ServerResponse) {
|
||||
return headers.hasHeader(key);
|
||||
const value = headers.getHeader(key);
|
||||
if (Array.isArray(value)) return value.join("; ");
|
||||
return value === undefined ? undefined : String(value);
|
||||
}
|
||||
const normalizedKey = key.toLowerCase();
|
||||
return Object.keys(headers).some((candidate) => candidate.toLowerCase() === normalizedKey);
|
||||
const candidate = Object.keys(headers).find((headerName) => headerName.toLowerCase() === normalizedKey);
|
||||
return candidate ? headers[candidate] : undefined;
|
||||
}
|
||||
|
||||
function getStaticHeaders(filePath: string, pathname: string) {
|
||||
function removeHeader(headers: Headers | Record<string, string> | ServerResponse, key: string): void {
|
||||
if (headers instanceof Headers) {
|
||||
headers.delete(key);
|
||||
return;
|
||||
}
|
||||
if (headers instanceof ServerResponse) {
|
||||
headers.removeHeader(key);
|
||||
return;
|
||||
}
|
||||
const normalizedKey = key.toLowerCase();
|
||||
for (const candidate of Object.keys(headers)) {
|
||||
if (candidate.toLowerCase() === normalizedKey) delete headers[candidate];
|
||||
}
|
||||
}
|
||||
|
||||
function getStaticHeaders(filePath: string, requestUrl: URL, metadata: StaticAssetMetadata, representation: StaticAssetRepresentation) {
|
||||
const headers: Record<string, string> = {
|
||||
"Content-Type": getContentType(filePath),
|
||||
"Content-Length": String(representation.stat.size),
|
||||
"Last-Modified": metadata.identity.stat.mtime.toUTCString(),
|
||||
ETag: createStaticEtag(representation),
|
||||
"Cache-Control": getStaticCacheControl(requestUrl.pathname, Boolean(requestUrl.searchParams.get("v"))),
|
||||
};
|
||||
|
||||
// Cache-Control strategy aligned with docs/ops/asset-cdn.md:
|
||||
// * /assets/* → Vite-hashed, safe to cache forever (1 year, immutable)
|
||||
// * /fonts/* → static brand assets, 1 day
|
||||
// * /images/* → static brand assets, 1 day
|
||||
// Anything else (HTML / loader responses / favicons) keeps the default
|
||||
// (no Cache-Control here — the loader / entry.server is in charge).
|
||||
if (pathname === "/assets" || pathname.startsWith("/assets/")) {
|
||||
headers["Cache-Control"] = "public, max-age=31536000, immutable";
|
||||
} else if (pathname === "/fonts" || pathname.startsWith("/fonts/") || pathname === "/images" || pathname.startsWith("/images/")) {
|
||||
headers["Cache-Control"] = "public, max-age=86400";
|
||||
if (requestUrl.pathname === "/sw.js") {
|
||||
headers["Content-Security-Policy"] = SERVICE_WORKER_CONTENT_SECURITY_POLICY;
|
||||
}
|
||||
|
||||
if (representation.encoding !== "identity") {
|
||||
headers["Content-Encoding"] = representation.encoding;
|
||||
}
|
||||
if (hasCompressedRepresentation(metadata)) {
|
||||
headers.Vary = "Accept-Encoding";
|
||||
}
|
||||
|
||||
return appendWebSecurityHeaders(headers);
|
||||
}
|
||||
|
||||
function getSingleHeader(value: string | string[] | undefined): string | undefined {
|
||||
return Array.isArray(value) ? value.at(-1) : value;
|
||||
}
|
||||
|
||||
function getDeclaredBodyLength(req: IncomingMessage): number | null {
|
||||
if (req.method === "GET" || req.method === "HEAD") {
|
||||
return null;
|
||||
}
|
||||
return parseRequestContentLength(getSingleHeader(req.headers["content-length"]));
|
||||
}
|
||||
|
||||
function sendPayloadTooLarge(res: ServerResponse): void {
|
||||
if (res.headersSent) {
|
||||
res.destroy();
|
||||
return;
|
||||
}
|
||||
res.statusCode = 413;
|
||||
res.shouldKeepAlive = false;
|
||||
res.setHeader("Connection", "close");
|
||||
res.setHeader("Content-Type", "text/plain; charset=utf-8");
|
||||
res.setHeader("Cache-Control", "no-store");
|
||||
appendWebSecurityHeaders(res);
|
||||
res.end("Request body too large");
|
||||
}
|
||||
|
||||
function beginGracefulShutdown(signal: "SIGINT" | "SIGTERM"): void {
|
||||
if (shuttingDown) return;
|
||||
shuttingDown = true;
|
||||
serverLogger.info({ signal }, "server shutdown started");
|
||||
server.closeIdleConnections();
|
||||
const forceCloseTimer = setTimeout(() => {
|
||||
serverLogger.error({ signal }, "server shutdown deadline exceeded");
|
||||
server.closeAllConnections();
|
||||
process.exitCode = 1;
|
||||
}, 10_000);
|
||||
forceCloseTimer.unref();
|
||||
server.close((error) => {
|
||||
clearTimeout(forceCloseTimer);
|
||||
if (error) {
|
||||
serverLogger.error({ error }, "server shutdown failed");
|
||||
process.exitCode = 1;
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
function getContentType(filePath: string) {
|
||||
switch (path.extname(filePath).toLowerCase()) {
|
||||
case ".css":
|
||||
|
||||
Reference in new issue
Block a user