mockaton 8.13.0 → 8.14.0

package/README.md

@@ -75,9 +75,7 @@ They will be saved in your `config.mocksDir` following the filename convention.
 <br/>
 
 
-## Basic Usage
-Mockaton is a Node.js program.
-
+## Basic Usage (See below for Node < 23.6)
 ```sh
 npm install mockaton --save-dev
 ```
@@ -98,6 +96,14 @@ Mockaton({
 node my-mockaton.js
 ```
 
+### Node < 23.6 + TypeScript
+If you want to write mocks in TypeScript in a version older than Node 23.6:
+```shell
+npm install tsx
+node --import=tsx my-mockaton.js
+```
+
+
 <br/>
 
 ## Demo App (Vite)

package/package.json

@@ -2,7 +2,7 @@
 	"name": "mockaton",
 	"description": "HTTP Mock Server",
 	"type": "module",
-	"version": "8.13.0",
+	"version": "8.14.0",
 	"main": "index.js",
 	"types": "index.d.ts",
 	"license": "MIT",

package/src/Api.js

@@ -5,11 +5,11 @@
 
 import { join } from 'node:path'
 import { cookie } from './cookie.js'
-import { uiSyncVersion } from './Watcher.js'
 import { parseJSON } from './utils/http-request.js'
-import { listFilesRecursively } from './utils/fs.js'
+import { uiSyncVersion } from './Watcher.js'
 import * as mockBrokersCollection from './mockBrokersCollection.js'
-import { config, isFileAllowed, ConfigValidator } from './config.js'
+import { config, ConfigValidator } from './config.js'
+import { getStaticFilesCollection, findStaticBrokerByRoute } from './StaticDispatcher.js'
 import { DF, API, LONG_POLL_SERVER_TIMEOUT } from './ApiConstants.js'
 import { sendOK, sendJSON, sendUnprocessableContent, sendFile } from './utils/http-response.js'
 
@@ -47,7 +47,9 @@ export const apiPatchRequests = new Map([
 	[API.fallback, updateProxyFallback],
 	[API.bulkSelect, bulkUpdateBrokersByCommentTag],
 	[API.globalDelay, setGlobalDelay],
-	[API.collectProxied, setCollectProxied]
+	[API.collectProxied, setCollectProxied],
+	[API.delayStatic, setStaticRouteIsDelayed],
+	[API.notFoundStatic, setStaticRouteIsNotFound]
 ])
 
 
@@ -64,18 +66,13 @@ function serveDashboardAsset(f) {
 
 function listCookies(_, response) { sendJSON(response, cookie.list()) }
 function listComments(_, response) { sendJSON(response, mockBrokersCollection.extractAllComments()) }
+function listStaticFiles(req, response) { sendJSON(response, getStaticFilesCollection()) }
 function getGlobalDelay(_, response) { sendJSON(response, config.delay) }
 function listMockBrokers(_, response) { sendJSON(response, mockBrokersCollection.getAll()) }
 function getProxyFallback(_, response) { sendJSON(response, config.proxyFallback) }
 function getIsCorsAllowed(_, response) { sendJSON(response, config.corsAllowed) }
 function getCollectProxied(_, response) { sendJSON(response, config.collectProxied) }
 
-function listStaticFiles(req, response) {
-	sendJSON(response, config.staticDir
-		? listFilesRecursively(config.staticDir).filter(isFileAllowed)
-		: [])
-}
-
 function longPollClientSyncVersion(req, response) {
 	if (uiSyncVersion.version !== Number(req.headers[DF.syncVersion])) {
 		// e.g., tab was hidden while new mocks were added or removed
@@ -134,7 +131,7 @@ async function setRouteIsDelayed(req, response) {
 		body[DF.routeUrlMask])
 
 	if (!broker) // TESTME
-		sendUnprocessableContent(response, `Route does not exist: ${body[DF.routeUrlMask]} ${body[DF.routeUrlMask]}`)
+		sendUnprocessableContent(response, `Route does not exist: ${body[DF.routeMethod]} ${body[DF.routeUrlMask]}`)
 	else if (typeof delayed !== 'boolean')
 		sendUnprocessableContent(response, `Expected a boolean for "delayed"`) // TESTME
 	else {
@@ -151,7 +148,7 @@ async function setRouteIsProxied(req, response) { // TESTME
 		body[DF.routeUrlMask])
 
 	if (!broker)
-		sendUnprocessableContent(response, `Route does not exist: ${body[DF.routeUrlMask]} ${body[DF.routeUrlMask]}`)
+		sendUnprocessableContent(response, `Route does not exist: ${body[DF.routeMethod]} ${body[DF.routeUrlMask]}`)
 	else if (typeof proxied !== 'boolean')
 		sendUnprocessableContent(response, `Expected a boolean for "proxied"`)
 	else if (proxied && !config.proxyFallback)
@@ -198,3 +195,36 @@ async function setGlobalDelay(req, response) { // TESTME
 	config.delay = parseInt(await parseJSON(req), 10)
 	sendOK(response)
 }
+
+
+async function setStaticRouteIsNotFound(req, response) {
+	const body = await parseJSON(req)
+	const shouldBeNotFound = body[DF.shouldBeNotFound]
+	const broker = findStaticBrokerByRoute(body[DF.routeUrlMask])
+
+	if (!broker) // TESTME
+		sendUnprocessableContent(response, `Route does not exist: ${body[DF.routeUrlMask]}`)
+	else if (typeof shouldBeNotFound !== 'boolean')
+		sendUnprocessableContent(response, `Expected a boolean for "not found"`) // TESTME
+	else {
+		broker.updateNotFound(body[DF.shouldBeNotFound])
+		sendOK(response)
+	}
+}
+
+
+async function setStaticRouteIsDelayed(req, response) {
+	const body = await parseJSON(req)
+	const shouldBeNotFound = body[DF.delayed]
+	const broker = findStaticBrokerByRoute(body[DF.routeUrlMask])
+
+	if (!broker) // TESTME
+		sendUnprocessableContent(response, `Route does not exist: ${body[DF.routeUrlMask]}`)
+	else if (typeof shouldBeNotFound !== 'boolean')
+		sendUnprocessableContent(response, `Expected a boolean for "delayed"`) // TESTME
+	else {
+		broker.updateDelayed(body[DF.delayed])
+		sendOK(response)
+	}
+}
+

package/src/ApiConstants.js

@@ -7,9 +7,11 @@ export const API = {
 	cookies: MOUNT + '/cookies',
 	cors: MOUNT + '/cors',
 	delay: MOUNT + '/delay',
+	delayStatic: MOUNT + '/delay-static',
 	fallback: MOUNT + '/fallback',
 	globalDelay: MOUNT + '/global-delay',
 	mocks: MOUNT + '/mocks',
+	notFoundStatic: MOUNT + '/not-found-static',
 	proxied: MOUNT + '/proxied',
 	reset: MOUNT + '/reset',
 	select: MOUNT + '/select',
@@ -22,6 +24,7 @@ export const DF = { // Dashboard Fields (XHR)
 	routeUrlMask: 'route_url_mask',
 	delayed: 'delayed',
 	proxied: 'proxied',
+	shouldBeNotFound: 'should_be_not_found',
 	syncVersion: 'last_received_sync_version'
 }
 

package/src/Commander.js

@@ -37,6 +37,20 @@ export class Commander {
 		})
 	}
 
+	setStaticRouteIsDelayed(routeUrlMask, delayed) {
+		return this.#patch(API.delayStatic, {
+			[DF.routeUrlMask]: routeUrlMask,
+			[DF.delayed]: delayed
+		})
+	}
+
+	setStaticRouteIs404(routeUrlMask, shouldBeNotFound) {
+		return this.#patch(API.notFoundStatic, {
+			[DF.routeUrlMask]: routeUrlMask,
+			[DF.shouldBeNotFound]: shouldBeNotFound
+		})
+	}
+
 	setRouteIsProxied(routeMethod, routeUrlMask, proxied) {
 		return this.#patch(API.proxied, {
 			[DF.routeMethod]: routeMethod,

package/src/Dashboard.css

@@ -1,19 +1,19 @@
 :root {
 	--boxShadow1: 0 2px 1px -1px rgba(0, 0, 0, 0.15), 0 1px 1px 0 rgba(0, 0, 0, 0.15), 0 1px 3px 0 rgba(0, 0, 0, 0.1);
-	--radius: 6px;
+	--radius: 4px;
 	--radiusSmall: 4px;
 }
 
 @media (prefers-color-scheme: light) {
 	:root {
 		--color4xxBackground: #ffedd1;
-		--colorAccent: #0075db;
+		--colorAccent: #0170cc;
 		--colorAccentAlt: #068185;
 		--colorBackground: #fff;
 		--colorComboBoxHeaderBackground: #fff;
-		--colorComboBoxBackground: #f7f7f7;
+		--colorComboBoxBackground: #eee;
 		--colorHeaderBackground: #eee;
-		--colorSecondaryButtonBackground: #f3f3f3;
+		--colorSecondaryButtonBackground: #eee;
 		--colorSecondaryAction: #555;
 		--colorDisabledMockSelector: #444;
 		--colorHover: #dfefff;
@@ -27,11 +27,10 @@
 	:root {
 		--color4xxBackground: #403630;
 		--colorAccent: #2495ff;
-		--colorAccentAlt: #00bf64;
 		--colorBackground: #161616;
 		--colorHeaderBackground: #090909;
-		--colorComboBoxBackground: #252525;
-		--colorSecondaryButtonBackground: #282828;
+		--colorComboBoxBackground: #2a2a2a;
+		--colorSecondaryButtonBackground: #2a2a2a;
 		--colorSecondaryAction: #999;
 		--colorComboBoxHeaderBackground: #222;
 		--colorDisabledMockSelector: #b9b9b9;
@@ -227,24 +226,29 @@ select {
 }
 
 
-.MockList {
+.Main {
 	display: flex;
-	align-items: flex-start;
-	margin-top: 64px;
+}
 
-	> table {
-		border-collapse: collapse;
+table {
+	border-collapse: collapse;
 
-		th {
-			padding-top: 20px;
-			padding-bottom: 2px;
-			text-align: left;
-		}
+	th {
+		padding-top: 20px;
+		padding-bottom: 2px;
+		padding-left: 99px;
+		text-align: left;
+	}
 
-		tr {
-			border-top: 2px solid transparent;
-		}
+	tr {
+		border-top: 2px solid transparent;
 	}
+}
+
+.MockList {
+	display: flex;
+	align-items: flex-start;
+	margin-top: 64px;
 
 	&.empty {
 		margin-top: 80px;
@@ -254,6 +258,7 @@ select {
 
 .PayloadViewer {
 	position: sticky;
+	margin-top: 62px;
 	top: 62px;
 	width: 50%;
 	margin-left: 20px;
@@ -292,7 +297,6 @@ select {
 
 	span {
 		opacity: 0.5;
-		filter: saturate(0.5);
 	}
 
 	&:hover {
@@ -336,7 +340,6 @@ select {
 .DelayToggler,
 .ProxyToggler {
 	display: flex;
-	margin-left: 8px;
 
 	> input {
 		appearance: none;
@@ -357,9 +360,9 @@ select {
 }
 
 .DelayToggler {
+	margin-left: 8px;
 	> input {
 		&:checked ~ svg {
-			border: 1px solid var(--colorBackground);
 			fill: var(--colorAccent);
 			background: var(--colorAccent);
 			stroke: var(--colorBackground);
@@ -373,11 +376,12 @@ select {
 	}
 
 	> svg {
-		width: 18px;
-		height: 18px;
+		width: 19px;
+		height: 19px;
 		stroke-width: 2.5px;
 		border-radius: 50%;
 		background: var(--colorSecondaryButtonBackground);
+		box-shadow: var(--boxShadow1);
 	}
 }
 
@@ -385,10 +389,12 @@ select {
 	padding: 1px 3px;
 	background: var(--colorSecondaryButtonBackground);
 	border-radius: var(--radiusSmall);
+	box-shadow: var(--boxShadow1);
 
 	&:has(input:checked),
 	&:has(input:disabled) {
 		background: transparent;
+		box-shadow: none;
 	}
 
 	> input {
@@ -431,6 +437,7 @@ select {
 .InternalServerErrorToggler {
 	display: flex;
 	margin-left: 8px;
+	margin-right: 12px;
 	cursor: pointer;
 
 	> input {
@@ -456,6 +463,7 @@ select {
 		color: var(--colorSecondaryAction);
 		border-radius: var(--radiusSmall);
 		background: var(--colorSecondaryButtonBackground);
+		box-shadow: var(--boxShadow1);
 
 		&:hover {
 			background: var(--colorLightRed);
@@ -491,26 +499,13 @@ select {
 }
 
 .StaticFilesList {
-	margin-top: 20px;
-
-	h2 {
-		margin-bottom: 8px;
-	}
-
-	ul {
-		position: relative;
-		left: -6px;
-	}
-
-	li {
-		list-style: none;
-	}
+	margin-top: 8px;
 
 	a {
 		display: inline-block;
-		padding: 6px;
+		padding: 6px 0;
 		border-radius: var(--radius);
-		color: var(--colorAccentAlt);
+		color: var(--colorAccent);
 		text-decoration: none;
 
 		&:hover {
@@ -519,7 +514,6 @@ select {
 
 		span {
 			opacity: 0.5;
-			filter: saturate(0.5);
 		}
 	}
 }

package/src/Dashboard.js

@@ -26,6 +26,7 @@ const Strings = {
 	internal_server_error: 'Internal Server Error',
 	mock: 'Mock',
 	no_mocks_found: 'No mocks found',
+	not_found: 'Not Found',
 	pick_comment: 'Pick Comment…',
 	proxied: 'Proxied',
 	proxy_toggler: 'Proxy Toggler',
@@ -51,6 +52,7 @@ const CSS = {
 	GlobalDelayField: 'GlobalDelayField',
 	SaveProxiedCheckbox: 'SaveProxiedCheckbox',
 	StaticFilesList: 'StaticFilesList',
+	Main: 'Main',
 
 	red: 'red',
 	empty: 'empty',
@@ -89,8 +91,11 @@ function App([brokersByMethod, cookies, comments, delay, collectProxied, fallbac
 	return (
 		r('div', null,
 			r(Header, { cookies, comments, delay, fallbackAddress, collectProxied }),
-			r(MockList, { brokersByMethod, canProxy: Boolean(fallbackAddress) }),
-			r(StaticFilesList, { staticFiles })))
+			r('main', { className: CSS.Main },
+				r('div', null,
+					r(MockList, { brokersByMethod, canProxy: Boolean(fallbackAddress) }),
+					r(StaticFilesList, { staticFiles })),
+				r(PayloadViewer))))
 }
 
 
@@ -243,13 +248,12 @@ function MockList({ brokersByMethod, canProxy }) {
 	const hasMocks = Object.keys(brokersByMethod).length
 	if (!hasMocks)
 		return (
-			r('main', { className: cssClass(CSS.MockList, CSS.empty) },
+			r('div', { className: cssClass(CSS.MockList, CSS.empty) },
 				Strings.no_mocks_found))
 	return (
-		r('main', { className: CSS.MockList },
+		r('div', { className: CSS.MockList },
 			r('table', null, Object.entries(brokersByMethod).map(([method, brokers]) =>
-				r(SectionByMethod, { method, brokers, canProxy }))),
-			r(PayloadViewer)))
+				r(SectionByMethod, { method, brokers, canProxy })))))
 }
 
 function SectionByMethod({ method, brokers, canProxy }) {
@@ -258,20 +262,21 @@ function SectionByMethod({ method, brokers, canProxy }) {
 		.sort((a, b) => a[0].localeCompare(b[0]))
 
 	const urlMasks = brokersSorted.map(([urlMask]) => urlMask)
-	const urlMasksHighlighted = highlightCommonPathPrefixes(urlMasks)
+	const urlMasksDittoed = dittoSplitPaths(urlMasks)
 	return (
 		r('tbody', null,
-			r('th', null, method),
+			r('th', { colspan: 4 }, method),
 			brokersSorted.map(([urlMask, broker], i) =>
 				r('tr', { 'data-method': method, 'data-urlMask': urlMask },
-					r('td', null, r(PreviewLink, { method, urlMask, urlMaskHighlighted: urlMasksHighlighted[i] })),
-					r('td', null, r(MockSelector, { broker })),
-					r('td', null, r(InternalServerErrorToggler, { broker })),
+					r('td', null, r(ProxyToggler, { broker, disabled: !canProxy })),
 					r('td', null, r(DelayRouteToggler, { broker })),
-					r('td', null, r(ProxyToggler, { broker, disabled: !canProxy }))))))
+					r('td', null, r(InternalServerErrorToggler, { broker })),
+					r('td', null, r(PreviewLink, { method, urlMask, urlMaskDittoed: urlMasksDittoed[i] })),
+					r('td', null, r(MockSelector, { broker }))
+				))))
 }
 
-function PreviewLink({ method, urlMask, urlMaskHighlighted }) {
+function PreviewLink({ method, urlMask, urlMaskDittoed }) {
 	async function onClick(event) {
 		event.preventDefault()
 		try {
@@ -283,13 +288,15 @@ function PreviewLink({ method, urlMask, urlMaskHighlighted }) {
 			onError(error)
 		}
 	}
+	const [ditto, tail] = urlMaskDittoed
 	return (
 		r('a', {
 			className: CSS.PreviewLink,
 			href: urlMask,
-			onClick,
-			innerHTML: urlMaskHighlighted
-		}))
+			onClick
+		}, ditto
+			? [r('span', null, ditto), tail]
+			: tail))
 }
 
 function MockSelector({ broker }) {
@@ -394,6 +401,84 @@ function ProxyToggler({ broker, disabled }) {
 }
 
 
+
+/** # StaticFilesList */
+
+function StaticFilesList({ staticFiles }) {
+	if (!Object.keys(staticFiles).length)
+		return null
+	const paths = dittoSplitPaths(Object.keys(staticFiles)).map(([ditto, tail]) => ditto
+		? [r('span', null, ditto), tail]
+		: tail)
+	return (
+		r('table', { className: CSS.StaticFilesList },
+			r('tbody', null,
+				r('th', { colspan: 4 }, Strings.static_get),
+				Object.values(staticFiles).map((broker, i) =>
+					r('tr', null,
+						r('td', null, r(ProxyStaticToggler, {})),
+						r('td', null, r(DelayStaticRouteToggler, { broker })),
+						r('td', null, r(NotFoundToggler, { broker })),
+						r('td', null, r('a', { href: broker.file, target: '_blank' }, paths[i]))
+					)))))
+}
+
+
+function DelayStaticRouteToggler({ broker }) {
+	function onChange() {
+		mockaton.setStaticRouteIsDelayed(broker.file, this.checked)
+			.catch(onError)
+	}
+	return (
+		r('label', {
+				className: CSS.DelayToggler,
+				title: Strings.delay
+			},
+			r('input', {
+				type: 'checkbox',
+				checked: broker.delayed,
+				onChange
+			}),
+			TimerIcon()))
+}
+
+function NotFoundToggler({ broker }) {
+	function onChange() {
+		mockaton.setStaticRouteIs404(broker.file, this.checked)
+			.catch(onError)
+	}
+	return (
+		r('label', {
+				className: CSS.InternalServerErrorToggler, // TODO rename
+				title: Strings.not_found
+			},
+			r('input', {
+				type: 'checkbox',
+				checked: broker.should404,
+				onChange
+			}),
+			r('span', null, '404')))
+}
+
+
+// TODO
+function ProxyStaticToggler({}) {
+	function onChange() {
+	}
+	return (
+		r('label', {
+				style: { visibility: 'hidden' },
+				className: CSS.ProxyToggler,
+				title: Strings.proxy_toggler
+			},
+			r('input', {
+				type: 'checkbox',
+				disabled: true,
+				onChange
+			}),
+			r(CloudIcon)))
+}
+
 /** # Payload Preview */
 
 const payloadViewerTitleRef = useRef()
@@ -491,28 +576,6 @@ function mockSelectorFor(method, urlMask) {
 }
 
 
-/** # StaticFilesList */
-
-function StaticFilesList({ staticFiles }) {
-	if (!staticFiles.length)
-		return null
-	const highlighted = highlightCommonPathPrefixes(staticFiles)
-	return (
-		r('section', {
-				open: true,
-				className: CSS.StaticFilesList
-			},
-			r('h2', null, Strings.static_get),
-			r('ul', null, staticFiles.map((f, i) =>
-				r('li', null,
-					r('a', {
-						href: f,
-						target: '_blank',
-						innerHTML: highlighted[i]
-					}))))))
-}
-
-
 /** # Misc */
 
 function onError(error) {
@@ -619,37 +682,56 @@ function useRef() {
 
 
 
-
-/** This is for styling the repeated paths with a faint style  */
-function highlightCommonPathPrefixes(paths) {
-	const seen = []
-	const result = []
-	for (const path of paths) {
-		let longestPrefixSegments = []
-
-		for (const prev of seen) {
-			const currSegs = path.split('/')
-			const prevSegs = prev.split('/')
-
-			let i = 0
-			while (i < currSegs.length && i < prevSegs.length && currSegs[i] === prevSegs[i])
-				i++
-
-			if (i > longestPrefixSegments.length)
-				longestPrefixSegments = currSegs.slice(0, i)
-		}
-
-		if (longestPrefixSegments.length > 0) {
-			let prefix = longestPrefixSegments.join('/')
-			if (!prefix.endsWith('/'))
-				prefix += '/' // always end with slash for dirs
-			const suffix = path.slice(prefix.length)
-			result.push(`<span>${prefix}</span>${suffix}`)
+/**
+ * Think of this as a way of printing a directory tree in which
+ * the repeated folder paths are kept but styled differently.
+ * @param {string[]} paths - sorted
+ */
+function dittoSplitPaths(paths) {
+	const result = [['', paths[0]]]
+	const pathsInParts = paths.map(p => p.split('/').filter(Boolean))
+
+	for (let i = 1; i < paths.length; i++) {
+		const prevParts = pathsInParts[i - 1]
+		const currParts = pathsInParts[i]
+
+		let j = 0
+		while (
+			j < currParts.length &&
+			j < prevParts.length &&
+			currParts[j] === prevParts[j])
+			j++
+
+		if (!j) // no common dirs
+			result.push(['', paths[i]])
+		else {
+			const ditto = '/' + currParts.slice(0, j).join('/') + '/'
+			result.push([ditto, paths[i].slice(ditto.length)])
 		}
-		else
-			result.push(path)
-
-		seen.push(path)
 	}
 	return result
 }
+
+(function testDittoSplitPaths() {
+	const input = [
+		'/api/user',
+		'/api/user/avatar',
+		'/api/user/friends',
+		'/api/vid',
+		'/api/video/id',
+		'/api/video/stats',
+		'/v2/foo',
+		'/v2/foo/bar'
+	]
+	const expected = [
+		['', '/api/user'],
+		['/api/user/', 'avatar'],
+		['/api/user/', 'friends'],
+		['/api/', 'vid'],
+		['/api/', 'video/id'],
+		['/api/video/', 'stats'],
+		['', '/v2/foo'],
+		['/v2/foo/', 'bar']
+	]
+	console.assert(JSON.stringify(dittoSplitPaths(input)) === JSON.stringify(expected))
+}())

package/src/Mockaton.js

@@ -6,9 +6,9 @@ import { dispatchMock } from './MockDispatcher.js'
 import { watchMocksDir } from './Watcher.js'
 import { BodyReaderError } from './utils/http-request.js'
 import * as mockBrokerCollection from './mockBrokersCollection.js'
-import { dispatchStatic, isStatic } from './StaticDispatcher.js'
 import { setCorsHeaders, isPreflight } from './utils/http-cors.js'
 import { apiPatchRequests, apiGetRequests } from './Api.js'
+import { dispatchStatic, isStatic, initStaticCollection } from './StaticDispatcher.js'
 import { sendNoContent, sendInternalServerError, sendUnprocessableContent } from './utils/http-response.js'
 
 
@@ -18,6 +18,7 @@ export function Mockaton(options) {
 	setup(options)
 	mockBrokerCollection.init()
 	watchMocksDir()
+	initStaticCollection()
 
 	return createServer(onRequest).listen(config.port, config.host, function (error) {
 		if (error) {

package/src/StaticDispatcher.js

@@ -1,59 +1,83 @@
 import { join } from 'node:path'
-import fs, { readFileSync } from 'node:fs'
+import { readFileSync } from 'node:fs'
 
 import { mimeFor } from './utils/mime.js'
-import { isDirectory, isFile } from './utils/fs.js'
 import { config, isFileAllowed } from './config.js'
-import { sendInternalServerError } from './utils/http-response.js'
+import { sendPartialContent, sendNotFound } from './utils/http-response.js'
+import { isDirectory, isFile, listFilesRecursively } from './utils/fs.js'
 
 
-export function isStatic(req) {
-	if (!config.staticDir)
-		return false
-	const f = resolvePath(req.url)
-	return f && isFileAllowed(f)
-}
+class StaticBroker {
+	constructor(file) {
+		this.file = file
+		this.delayed = false
+		this.should404 = false
+		this.resolvedPath = this.#staticFilePath()
+	}
 
-export async function dispatchStatic(req, response) {
-	const file = resolvePath(req.url)
-	if (req.headers.range)
-		await sendPartialContent(response, req.headers.range, file)
-	else {
-		response.setHeader('Content-Type', mimeFor(file))
-		response.end(readFileSync(file))
+	#staticFilePath() { // url is absolute e.g. /home/../.. => /
+		let candidate = join(config.staticDir, this.file)
+		if (isDirectory(candidate))
+			candidate = join(candidate, 'index.html')
+		if (isFile(candidate))
+			return candidate
+	}
+
+	updateDelayed(value) {
+		this.delayed = value
+	}
+
+	updateNotFound(value) {
+		this.should404 = value
 	}
 }
 
-function resolvePath(url) { // url is absolute e.g. /home/../.. => /
-	let candidate = join(config.staticDir, url)
-	if (isDirectory(candidate))
-		candidate = join(candidate, 'index.html')
-	if (isFile(candidate))
-		return candidate
+let collection = {}
+
+export function initStaticCollection() {
+	collection = {}
+	listFilesRecursively(config.staticDir)
+		.filter(isFileAllowed)
+		.sort()
+		.forEach(f => registerStatic(f))
 }
 
-async function sendPartialContent(response, range, file) {
-	const { size } = await fs.promises.lstat(file)
-	let [start, end] = range.replace(/bytes=/, '').split('-').map(n => parseInt(n, 10))
-	if (isNaN(end)) end = size - 1
-	if (isNaN(start)) start = size - end
+function registerStatic(file) {
+	file = '/' + file
+	collection[file] = new StaticBroker(file)
+}
 
-	if (start < 0 || start > end || start >= size || end >= size) {
-		response.statusCode = 416 // Range Not Satisfiable
-		response.setHeader('Content-Range', `bytes */${size}`)
-		response.end()
-	}
-	else {
-		response.statusCode = 206 // Partial Content
-		response.setHeader('Accept-Ranges', 'bytes')
-		response.setHeader('Content-Range', `bytes ${start}-${end}/${size}`)
-		response.setHeader('Content-Type', mimeFor(file))
-		const reader = fs.createReadStream(file, { start, end })
-		reader.on('open', function () {
-			this.pipe(response)
-		})
-		reader.on('error', function (error) {
-			sendInternalServerError(response, error)
-		})
+export function findStaticBrokerByRoute(route) {
+	return collection[route] || collection[join(route, 'index.html')]
+}
+
+export function getStaticFilesCollection() {
+	return collection
+}
+
+export function isStatic(req) {
+	return req.url in collection || join(req.url, 'index.html') in collection
+}
+
+// TODO improve
+export async function dispatchStatic(req, response) {
+	let broker = collection[join(req.url, 'index.html')]
+	if (!broker && req.url in collection)
+		broker = collection[req.url]
+
+	if (broker?.should404) { // TESTME
+		sendNotFound(response)
+		return
 	}
+
+	const file = broker.resolvedPath
+	setTimeout(async () => {
+		if (req.headers.range)
+			await sendPartialContent(response, req.headers.range, file)
+		else {
+			response.setHeader('Content-Type', mimeFor(file))
+			response.end(readFileSync(file))
+		}
+	}, broker.delayed * config.delay)
 }
+

package/src/utils/fs.js

@@ -7,10 +7,15 @@ export const isDirectory = path => lstatSync(path, { throwIfNoEntry: false })?.i
 
 /** @returns {Array<string>} paths relative to `dir` */
 export const listFilesRecursively = dir => {
-	const files = readdirSync(dir, { recursive: true }).filter(f => isFile(join(dir, f)))
-	return process.platform === 'win32'
-		? files.map(f => f.replaceAll(sep, posix.sep))
-		: files
+	try {
+		const files = readdirSync(dir, { recursive: true }).filter(f => isFile(join(dir, f)))
+		return process.platform === 'win32'
+			? files.map(f => f.replaceAll(sep, posix.sep))
+			: files
+	}
+	catch (err) { // e.g. ENOENT
+		return []
+	}
 }
 
 export const write = (path, body) => {

package/src/utils/http-response.js

@@ -1,4 +1,4 @@
-import { readFileSync } from 'node:fs'
+import fs, { readFileSync } from 'node:fs'
 import { mimeFor } from './mime.js'
 import { HEADER_FOR_502 } from '../ApiConstants.js'
 
@@ -45,3 +45,30 @@ export function sendBadGateway(response, error) {
 	response.setHeader(HEADER_FOR_502, 1)
 	response.end()
 }
+
+
+export async function sendPartialContent(response, range, file) {
+	const { size } = await fs.promises.lstat(file)
+	let [start, end] = range.replace(/bytes=/, '').split('-').map(n => parseInt(n, 10))
+	if (isNaN(end)) end = size - 1
+	if (isNaN(start)) start = size - end
+
+	if (start < 0 || start > end || start >= size || end >= size) {
+		response.statusCode = 416 // Range Not Satisfiable
+		response.setHeader('Content-Range', `bytes */${size}`)
+		response.end()
+	}
+	else {
+		response.statusCode = 206 // Partial Content
+		response.setHeader('Accept-Ranges', 'bytes')
+		response.setHeader('Content-Range', `bytes ${start}-${end}/${size}`)
+		response.setHeader('Content-Type', mimeFor(file))
+		const reader = fs.createReadStream(file, { start, end })
+		reader.on('open', function () {
+			this.pipe(response)
+		})
+		reader.on('error', function (error) {
+			sendInternalServerError(response, error)
+		})
+	}
+}