@aletheia-ios/tools 0.2.1 → 0.2.2

package/dist/cli.js

@@ -1061,7 +1061,10 @@ const TRAVERSAL = /^(\.\.[/\\])+/;
 /** How long after the last change to wait before rebuilding, so an editor's save burst is one build. */
 const DEBOUNCE_MS = 300;
 const OK = 200;
+const NOT_MODIFIED = 304;
 const NOT_FOUND = 404;
+/** Base 16, so the validator stays short. */
+const HEX = 16;
 /**
 * Packs and indexes the whole repository, reporting failures instead of throwing.
 *
@@ -1103,7 +1106,27 @@ async function resolveFile(dist, url) {
 	if (!(existsSync(file) && (await stat(file)).isFile())) return null;
 	return file;
 }
-/** A static server over `dist/` that sends `cache-control: no-store` so the app never caches a dev build. */
+/**
+* A validator for the file as it is right now, from its size and modification time.
+*
+* Every rebuild rewrites the file, so the value changes and a conditional request gets the new
+* bytes. Between rebuilds it is stable, which is the only case that answers 304.
+*/
+function etagOf(size, mtimeMs) {
+	return `"${size.toString(HEX)}-${Math.trunc(mtimeMs).toString(HEX)}"`;
+}
+/** Whether the request already holds this version. A client may offer several. */
+function offers(header, etag) {
+	if (header === void 0) return false;
+	return header.split(",").some((candidate) => candidate.trim() === etag);
+}
+/**
+* A static server over `dist/`.
+*
+* Sends `cache-control: no-store` so nothing holds on to a dev build, alongside an `ETag` so a
+* client that asks can still be told nothing changed. The two are not in tension: `no-store`
+* governs whether a copy may be kept, the validator governs whether a fetch has to transfer.
+*/
 function fileServer(dist) {
 	return createServer(async (request, response) => {
 		const file = await resolveFile(dist, request.url ?? "/");
@@ -1111,9 +1134,20 @@ function fileServer(dist) {
 			response.writeHead(NOT_FOUND).end();
 			return;
 		}
+		const { size, mtimeMs } = await stat(file);
+		const etag = etagOf(size, mtimeMs);
+		if (offers(request.headers["if-none-match"], etag)) {
+			response.writeHead(NOT_MODIFIED, {
+				etag,
+				"cache-control": "no-store"
+			}).end();
+			return;
+		}
 		response.writeHead(OK, {
 			"content-type": TYPES[extname(file)] ?? "application/octet-stream",
-			"cache-control": "no-store"
+			"cache-control": "no-store",
+			"content-length": size,
+			etag
 		});
 		createReadStream(file).pipe(response);
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aletheia-ios/tools",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "The aletheia CLI: build, check, pack, index and serve source packages",
   "license": "MIT",
   "repository": {