Adds the URL rules to the preview server, IIS config and deploy
The preview server and web.config now follow the same URLs as nginx, without the SPA fallback. Lighthouse exceptions need a recorded reason and the 404 page is audited through an opt-in route. The deploy checks the build first and the served result afterwards. The IIS rules stay unverified until a host exists. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
+116
-45
@@ -4,7 +4,10 @@
|
||||
// afbeelding van /over-mij naar over-mij.html, en productie draait geen
|
||||
// Node-server. Hier krijgt een onbekend pad 404.html met status 404, en een
|
||||
// pad zonder punt het bijbehorende paginabestand, zoals de host dat straks
|
||||
// ook moet doen (BR-SRV-01 tot 08).
|
||||
// ook moet doen (BR-SRV-01 tot 08). Varianten van een bekende pagina en een
|
||||
// slash aan het eind krijgen één 301 (BR-HST-03, 04). /404.html is een echte
|
||||
// 404; Lighthouse auditeert de 404-pagina via de opt-in route /__audit/404
|
||||
// (--audit-route, BR-HST-22).
|
||||
import { createReadStream, statSync } from 'node:fs';
|
||||
import {
|
||||
createServer,
|
||||
@@ -15,28 +18,59 @@ import {
|
||||
import { extname, join, resolve, sep, win32 } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { createGzip } from 'node:zlib';
|
||||
import { canonicalRedirect, stripTrailingSlashes } from './canonicalUrls.ts';
|
||||
import {
|
||||
compressibleExtensions,
|
||||
compressibleTypes,
|
||||
plainTypes,
|
||||
} from './compressibleTypes.ts';
|
||||
import { NOT_FOUND_FILE, pageFile } from './pageFiles.ts';
|
||||
import { securityHeaders } from './securityHeaders.ts';
|
||||
|
||||
export interface ResolvedRequest {
|
||||
export interface FileResult {
|
||||
// Relatief aan clientDir, met voorwaartse slashes en zonder voorste slash
|
||||
file: string;
|
||||
status: 200 | 404;
|
||||
}
|
||||
|
||||
const NOT_FOUND: ResolvedRequest = { file: NOT_FOUND_FILE, status: 404 };
|
||||
export interface RedirectResult {
|
||||
// Pad zonder query; de server plakt de query van het verzoek erachter
|
||||
redirect: string;
|
||||
status: 301;
|
||||
}
|
||||
|
||||
export type ResolvedRequest = FileResult | RedirectResult;
|
||||
|
||||
export interface ResolveOptions {
|
||||
// Opt-in route /__audit/404: de 404-pagina met status 200, alleen voor
|
||||
// Lighthouse (BR-HST-22)
|
||||
auditRoute?: boolean;
|
||||
}
|
||||
|
||||
const AUDIT_ROUTE = '/__audit/404';
|
||||
|
||||
const NOT_FOUND: FileResult = { file: NOT_FOUND_FILE, status: 404 };
|
||||
|
||||
// Een segment van alleen punten en spaties ('.', '..', '...', '.. ') wordt door
|
||||
// Windows tot een puntsegment teruggebracht, dus het mag nooit door
|
||||
const DOT_SEGMENT = /^[. ]+$/;
|
||||
|
||||
// Het verzoekpad (zonder query of hash) naar het bestand dat erbij hoort.
|
||||
// Eerst één keer decoderen en dán pas op segmenten controleren, zodat
|
||||
// '%2e%2e' en '..%2f' niet langs de controle komen (BR-SRV-06). Een
|
||||
// dubbel gecodeerd pad blijft na één keer decoderen een gewone bestandsnaam.
|
||||
// Het doel van een slash-redirect: de segmenten opnieuw gecodeerd, want het
|
||||
// pad is al gedecodeerd en kan spaties, '?' of niet-ASCII bevatten. Een
|
||||
// '%2F' in het origineel is dan al een segmentscheiding; dat is hier geen
|
||||
// probleem omdat het doel alleen een ander verzoek oplevert.
|
||||
const encodePath = (path: string) =>
|
||||
path.split('/').map(encodeURIComponent).join('/');
|
||||
|
||||
// Het verzoekpad (zonder query of hash) naar het bestand dat erbij hoort, of
|
||||
// naar het pad waar één 301 heen gaat. Eerst één keer decoderen en dán pas
|
||||
// op segmenten controleren, zodat '%2e%2e' en '..%2f' niet langs de controle
|
||||
// komen (BR-SRV-06). Een dubbel gecodeerd pad blijft na één keer decoderen
|
||||
// een gewone bestandsnaam.
|
||||
export function resolveRequest(
|
||||
path: string,
|
||||
fileExists: (file: string) => boolean,
|
||||
options: ResolveOptions = {},
|
||||
): ResolvedRequest {
|
||||
let decoded: string;
|
||||
try {
|
||||
@@ -51,42 +85,54 @@ export function resolveRequest(
|
||||
) {
|
||||
return NOT_FOUND;
|
||||
}
|
||||
if (decoded === '/') return { file: pageFile('/'), status: 200 };
|
||||
|
||||
// Lege segmenten (dubbele slash, slash aan het eind) en puntsegmenten:
|
||||
// geen redirect, maar een 404 (BR-SRV-07)
|
||||
// Puntsegmenten ('.', '..', '...') en een stationsletter horen nergens bij
|
||||
const segments = decoded.slice(1).split('/');
|
||||
if (
|
||||
segments.some((segment) => segment === '' || DOT_SEGMENT.test(segment))
|
||||
) {
|
||||
if (segments.some((segment) => DOT_SEGMENT.test(segment))) {
|
||||
return NOT_FOUND;
|
||||
}
|
||||
|
||||
// Eén 301 voor een afwijkende vorm van een bekende pagina (BR-HST-04) en
|
||||
// voor een slash aan het eind van elk ander pad (BR-HST-03)
|
||||
const canonical = canonicalRedirect(decoded);
|
||||
if (canonical !== undefined) return { redirect: canonical, status: 301 };
|
||||
if (decoded.length > 1 && decoded.endsWith('/')) {
|
||||
const stripped = stripTrailingSlashes(decoded);
|
||||
// Een doel dat niet veilig is (BR-HST-06) of een leeg segment heeft
|
||||
// (//x, BR-SRV-07, buiten de pariteit) is een onbekend pad
|
||||
if (stripped === undefined || stripped.includes('//')) {
|
||||
return NOT_FOUND;
|
||||
}
|
||||
try {
|
||||
return { redirect: encodePath(stripped), status: 301 };
|
||||
} catch {
|
||||
return NOT_FOUND;
|
||||
}
|
||||
}
|
||||
|
||||
// /404 en /404.html zijn echte 404's (BR-HST-05)
|
||||
if (decoded === '/404' || decoded === '/404.html') return NOT_FOUND;
|
||||
if (options.auditRoute && decoded === AUDIT_ROUTE) {
|
||||
return { file: NOT_FOUND_FILE, status: 200 };
|
||||
}
|
||||
if (decoded === '/') return { file: pageFile('/'), status: 200 };
|
||||
|
||||
// Lege segmenten (dubbele slash) blijven een 404 (BR-SRV-07)
|
||||
if (segments.some((segment) => segment === '')) return NOT_FOUND;
|
||||
|
||||
const isFileRequest = segments[segments.length - 1].includes('.');
|
||||
const file = isFileRequest ? segments.join('/') : pageFile(decoded);
|
||||
// Een stationsletter ('c:/x') is op Windows een absoluut pad
|
||||
if (win32.isAbsolute(file)) return NOT_FOUND;
|
||||
// Het pagina-pad /404 antwoordt met 404, niet met 200. Het bestandsverzoek /404.html is
|
||||
// gewoon een bestand (BR-SRV-04) en geeft 200: Lighthouse weigert een
|
||||
// pagina met een 404-status te auditen en gebruikt dit pad als terugval.
|
||||
if (!isFileRequest && file === NOT_FOUND_FILE) return NOT_FOUND;
|
||||
return fileExists(file) ? { file, status: 200 } : NOT_FOUND;
|
||||
}
|
||||
|
||||
const CONTENT_TYPES: Record<string, string> = {
|
||||
'.html': 'text/html; charset=utf-8',
|
||||
'.js': 'text/javascript; charset=utf-8',
|
||||
'.css': 'text/css; charset=utf-8',
|
||||
'.svg': 'image/svg+xml',
|
||||
'.png': 'image/png',
|
||||
'.jpg': 'image/jpeg',
|
||||
'.webp': 'image/webp',
|
||||
'.woff2': 'font/woff2',
|
||||
'.ico': 'image/x-icon',
|
||||
'.xml': 'application/xml; charset=utf-8',
|
||||
'.txt': 'text/plain; charset=utf-8',
|
||||
'.json': 'application/json; charset=utf-8',
|
||||
};
|
||||
const CONTENT_TYPES: Record<string, string> = Object.fromEntries(
|
||||
[...compressibleTypes, ...plainTypes].map((type) => [
|
||||
type.extension,
|
||||
type.previewContentType,
|
||||
]),
|
||||
);
|
||||
|
||||
export const contentTypeOf = (file: string): string =>
|
||||
CONTENT_TYPES[extname(file).toLowerCase()] ?? 'application/octet-stream';
|
||||
@@ -95,18 +141,9 @@ export const contentTypeOf = (file: string): string =>
|
||||
// Waarom: de nulmeting draaide op `vite preview`, dat comprimeert; zonder dit
|
||||
// zijn de Lighthouse-metingen niet te vergelijken (scripts: 667 kB tegen
|
||||
// 202 kB). Productie comprimeert op de host (BR-SRV-08).
|
||||
const COMPRESSIBLE = new Set([
|
||||
'.html',
|
||||
'.js',
|
||||
'.css',
|
||||
'.svg',
|
||||
'.json',
|
||||
'.xml',
|
||||
'.txt',
|
||||
]);
|
||||
|
||||
export const isCompressible = (file: string): boolean =>
|
||||
COMPRESSIBLE.has(extname(file).toLowerCase());
|
||||
compressibleExtensions.has(extname(file).toLowerCase());
|
||||
|
||||
// Staat gzip in Accept-Encoding? 'gzip;q=0' weigert het, '*' staat het toe,
|
||||
// tenzij gzip zelf genoemd is
|
||||
@@ -145,9 +182,20 @@ function send(
|
||||
else body.pipe(response);
|
||||
}
|
||||
|
||||
// De query van het verzoek, byte voor byte vanaf het eerste '?' (zonder hash)
|
||||
const searchOf = (target: string) => {
|
||||
const start = target.indexOf('?');
|
||||
return start === -1 ? '' : target.slice(start).split('#', 1)[0];
|
||||
};
|
||||
|
||||
export interface PreviewOptions {
|
||||
auditRoute?: boolean;
|
||||
}
|
||||
|
||||
export function startPreviewServer(
|
||||
clientDir: string,
|
||||
port: number,
|
||||
options: PreviewOptions = {},
|
||||
): Promise<Server> {
|
||||
const root = resolve(clientDir);
|
||||
const isFile = (file: string) => {
|
||||
@@ -168,10 +216,25 @@ export function startPreviewServer(
|
||||
);
|
||||
return;
|
||||
}
|
||||
const { file, status } = resolveRequest(
|
||||
const resolved = resolveRequest(
|
||||
pathOf(request.url ?? '/'),
|
||||
isFile,
|
||||
options,
|
||||
);
|
||||
if ('redirect' in resolved) {
|
||||
// Geen Cache-Control (BR-HST-12); de query blijft zoals ze kwam
|
||||
send(
|
||||
response,
|
||||
resolved.status,
|
||||
{
|
||||
Location: resolved.redirect + searchOf(request.url ?? ''),
|
||||
'Content-Length': 0,
|
||||
},
|
||||
null,
|
||||
);
|
||||
return;
|
||||
}
|
||||
const { file, status } = resolved;
|
||||
const target = join(root, file);
|
||||
// Tweede slot naast resolveRequest: nooit buiten clientDir lezen
|
||||
if (!target.startsWith(root + sep) || !isFile(file)) {
|
||||
@@ -216,13 +279,19 @@ export function startPreviewServer(
|
||||
// `--port 4173` en `--port=4173`; onbekende argumenten (die `vite preview`
|
||||
// wel kent) worden genegeerd
|
||||
function parseArguments(args: string[]) {
|
||||
const options = { port: 4173, strictPort: false, dir: 'dist/client' };
|
||||
const options = {
|
||||
port: 4173,
|
||||
strictPort: false,
|
||||
dir: 'dist/client',
|
||||
auditRoute: false,
|
||||
};
|
||||
for (let i = 0; i < args.length; i++) {
|
||||
const [name, inline] = args[i].split('=', 2);
|
||||
const value = () => inline ?? args[++i];
|
||||
if (name === '--port') options.port = Number(value());
|
||||
else if (name === '--dir') options.dir = value();
|
||||
else if (name === '--strictPort') options.strictPort = true;
|
||||
else if (name === '--audit-route') options.auditRoute = true;
|
||||
}
|
||||
return options;
|
||||
}
|
||||
@@ -230,7 +299,7 @@ function parseArguments(args: string[]) {
|
||||
const MAX_PORT_TRIES = 10;
|
||||
|
||||
async function main(args: string[]) {
|
||||
const { port, strictPort, dir } = parseArguments(args);
|
||||
const { port, strictPort, dir, auditRoute } = parseArguments(args);
|
||||
if (!Number.isInteger(port) || port < 0 || port > 65535) {
|
||||
console.error(`Ongeldige poort: ${port}`);
|
||||
process.exitCode = 1;
|
||||
@@ -241,7 +310,9 @@ async function main(args: string[]) {
|
||||
const tries = strictPort || port === 0 ? 1 : MAX_PORT_TRIES;
|
||||
for (let attempt = 0; attempt < tries; attempt++) {
|
||||
try {
|
||||
const server = await startPreviewServer(dir, port + attempt);
|
||||
const server = await startPreviewServer(dir, port + attempt, {
|
||||
auditRoute,
|
||||
});
|
||||
const address = server.address();
|
||||
const actual =
|
||||
typeof address === 'object' && address ? address.port : port;
|
||||
|
||||
Reference in New Issue
Block a user