fidelity-kit 0.1.0

package/dist/commands/hash.js

@@ -0,0 +1,23 @@
+import { availableParallelism } from 'node:os';
+import { defineCommand } from 'yargs-file-commands';
+import { hashSuite } from '../core/index.js';
+export const command = defineCommand({
+    command: 'hash <root>',
+    describe: 'Write image-hashes.json so `serve` can use immutable, content-hashed image URLs from the first request',
+    builder: (yargs) => yargs
+        .positional('root', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Suite results directory (contains fidelity.json)',
+    })
+        .option('concurrency', {
+        type: 'number',
+        default: availableParallelism(),
+        describe: 'Files hashed in parallel (default: os.availableParallelism())',
+    }),
+    handler: async (argv) => {
+        const r = await hashSuite(argv.root, { concurrency: argv.concurrency });
+        console.log(`${r.hashed} hashed, ${r.reused} reused, ${r.total} total`);
+    },
+});
+//# sourceMappingURL=hash.js.map

package/dist/commands/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/commands/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC;IACnC,OAAO,EAAE,aAAa;IACtB,QAAQ,EAAE,wGAAwG;IAClH,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,UAAU,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,kDAAkD;KAC7D,CAAC;SACD,MAAM,CAAC,aAAa,EAAE;QACrB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,oBAAoB,EAAE;QAC/B,QAAQ,EAAE,+DAA+D;KAC1E,CAAC;IACN,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC1E,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/process.d.ts

@@ -0,0 +1,6 @@
+export declare const command: import("yargs-file-commands").DefineCommandResult<{}, {
+    root: string;
+} & {
+    force: boolean;
+}>;
+//# sourceMappingURL=process.d.ts.map

package/dist/commands/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/commands/process.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO;;;;EAiBlB,CAAC"}

package/dist/commands/process.js

@@ -0,0 +1,22 @@
+import { processSuite } from '../core/index.js';
+import { defineCommand } from 'yargs-file-commands';
+export const command = defineCommand({
+    command: 'process <root>',
+    describe: 'Compute metrics + delta images for stale pairs and write index.json',
+    builder: (yargs) => yargs
+        .positional('root', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Suite results directory (contains fidelity.json)',
+    })
+        .option('force', { type: 'boolean', default: false, describe: 'Recompute even when up to date' }),
+    handler: async (argv) => {
+        const r = await processSuite(argv.root, { force: argv.force, onCompute: (f) => console.log('wrote', f) });
+        console.log(`${r.computed} computed, ${r.skipped} up to date, ${r.failed.length} failed`);
+        for (const f of r.failed)
+            console.error(`FAILED ${f.file}: ${f.error}`);
+        if (r.failed.length)
+            process.exitCode = 1;
+    },
+});
+//# sourceMappingURL=process.js.map

package/dist/commands/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/commands/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC;IACnC,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,qEAAqE;IAC/E,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,UAAU,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,kDAAkD;KAC7D,CAAC;SACD,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,gCAAgC,EAAE,CAAC;IACrG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1G,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,cAAc,CAAC,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;QAC1F,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,14 @@
+export declare const command: import("yargs-file-commands").DefineCommandResult<{}, {
+    root: string;
+} & {
+    port: number;
+} & {
+    host: string;
+} & {
+    "max-age": number;
+} & {
+    "stale-while-revalidate": number;
+} & {
+    process: boolean;
+}>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO;;;;;;;;;;;;EAwBlB,CAAC"}

package/dist/commands/serve.js

@@ -0,0 +1,28 @@
+import { defineCommand } from 'yargs-file-commands';
+import { run } from '../run.js';
+import { defaultCachePolicy } from '../server.js';
+export const command = defineCommand({
+    command: 'serve <root>',
+    describe: 'Serve the viewer for a results directory (lazy ETags and shared-cache headers)',
+    builder: (yargs) => yargs
+        .positional('root', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Suite results directory (contains fidelity.json)',
+    })
+        .option('port', { type: 'number', default: 3000, describe: 'Port to listen on' })
+        .option('host', { type: 'string', default: 'localhost', describe: 'Interface to bind (0.0.0.0 for all)' })
+        .option('max-age', {
+        type: 'number',
+        default: defaultCachePolicy.maxAge,
+        describe: 'Seconds images are cached (browsers and CDNs) without revalidation',
+    })
+        .option('stale-while-revalidate', {
+        type: 'number',
+        default: defaultCachePolicy.staleWhileRevalidate,
+        describe: 'Seconds a stale image may be served while it refreshes in the background',
+    })
+        .option('process', { type: 'boolean', default: true, describe: 'Refresh stale metrics/deltas before serving' }),
+    handler: (argv) => run(argv, false),
+});
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC;IACnC,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,gFAAgF;IAC1F,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,UAAU,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,kDAAkD;KAC7D,CAAC;SACD,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;SAChF,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,qCAAqC,EAAE,CAAC;SACzG,MAAM,CAAC,SAAS,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,kBAAkB,CAAC,MAAM;QAClC,QAAQ,EAAE,oEAAoE;KAC/E,CAAC;SACD,MAAM,CAAC,wBAAwB,EAAE;QAChC,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,kBAAkB,CAAC,oBAAoB;QAChD,QAAQ,EAAE,0EAA0E;KACrF,CAAC;SACD,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,6CAA6C,EAAE,CAAC;IACnH,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC;CACpC,CAAC,CAAC"}

package/dist/core/compare.d.ts

@@ -0,0 +1,32 @@
+export interface RawImage {
+    data: Buffer;
+    width: number;
+    height: number;
+}
+/** All errors are normalized to 0–1. `psnr` is in dB over RGB 0–255, and `null` when the images are identical (infinite PSNR). */
+export interface ImageMetrics {
+    psnr: number | null;
+    rmse: number;
+    mae: number;
+    maxError: number;
+}
+/** Encoding for committed result images: near-lossless (worst render ~40 dB PSNR vs PNG), full-res chroma so noise and false colour survive. */
+export declare const RESULT_AVIF: {
+    readonly quality: 90;
+    readonly chromaSubsampling: '4:4:4';
+};
+/** Decodes an image (path or encoded buffer) to 8-bit RGB, dropping alpha. */
+export declare function readRgb(input: string | Buffer): Promise<RawImage>;
+/** Computes metrics and an RGB heat-map delta image (black = identical) from two equal-size RGB images. */
+export declare function compareRgb(reference: RawImage, test: RawImage): {
+    metrics: ImageMetrics;
+    delta: RawImage;
+};
+/** Compares two encoded images (paths or buffers); returns metrics and the delta encoded like the renders. */
+export declare function compareImages(reference: string | Buffer, test: string | Buffer): Promise<{
+    metrics: ImageMetrics;
+    width: number;
+    height: number;
+    deltaImage: Buffer;
+}>;
+//# sourceMappingURL=compare.d.ts.map

package/dist/core/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/core/compare.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kIAAkI;AAClI,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gJAAgJ;AAChJ,eAAO,MAAM,WAAW;aAAK,OAAO,EAAE,EAAE;aAAE,iBAAiB,EAAE,OAAO;CAAW,CAAC;AAEhF,8EAA8E;AAC9E,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOvE;AA0BD,2GAA2G;AAC3G,wBAAgB,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAmC1G;AAED,8GAA8G;AAC9G,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAOvF"}

package/dist/core/compare.js

@@ -0,0 +1,81 @@
+import sharp from 'sharp';
+/** Encoding for committed result images: near-lossless (worst render ~40 dB PSNR vs PNG), full-res chroma so noise and false colour survive. */
+export const RESULT_AVIF = { quality: 90, chromaSubsampling: '4:4:4' };
+/** Decodes an image (path or encoded buffer) to 8-bit RGB, dropping alpha. */
+export async function readRgb(input) {
+    const { data, info } = await sharp(input)
+        .removeAlpha()
+        .toColourspace('srgb')
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    return { data, width: info.width, height: info.height };
+}
+// Inferno colormap, polynomial fit by Matt Zucker (CC0). inferno(0) clamps to black.
+const INFERNO = [
+    [0.0002189403691192265, 0.001651004631001012, -0.01948089843709184],
+    [0.1065134194856116, 0.5639564367884091, 3.932712388889277],
+    [11.60249308247187, -3.972853965665698, -15.9423941062914],
+    [-41.70399613139459, 17.43639888205313, 44.35414519872813],
+    [77.162935699427, -33.40235894210092, -81.80730925738993],
+    [-71.31942824499214, 32.62606426397723, 73.20951985803202],
+    [25.13112622477341, -12.24266895238567, -23.07032500287172],
+];
+function inferno(t) {
+    const rgb = [0, 0, 0];
+    for (let c = 0; c < 3; c += 1) {
+        let v = 0;
+        for (let i = INFERNO.length - 1; i >= 0; i -= 1)
+            v = v * t + INFERNO[i][c];
+        rgb[c] = Math.round(Math.min(1, Math.max(0, v)) * 255);
+    }
+    return rgb;
+}
+// Max-channel error e (0–255) → t = min(1, 2·sqrt(e/255)): 1/255 error is already visible, ≥25% error saturates.
+const DELTA_LUT = Array.from({ length: 256 }, (_, e) => inferno(Math.min(1, 2 * Math.sqrt(e / 255))));
+/** Computes metrics and an RGB heat-map delta image (black = identical) from two equal-size RGB images. */
+export function compareRgb(reference, test) {
+    if (reference.width !== test.width || reference.height !== test.height) {
+        throw new Error(`Image size mismatch: reference ${reference.width}x${reference.height} vs test ${test.width}x${test.height}`);
+    }
+    const n = reference.data.length;
+    const delta = Buffer.alloc(n);
+    let sumSq = 0;
+    let sumAbs = 0;
+    let max = 0;
+    for (let p = 0; p < n; p += 3) {
+        let pixelMax = 0;
+        for (let c = 0; c < 3; c += 1) {
+            const d = Math.abs(reference.data[p + c] - test.data[p + c]);
+            sumSq += d * d;
+            sumAbs += d;
+            if (d > pixelMax)
+                pixelMax = d;
+        }
+        if (pixelMax > max)
+            max = pixelMax;
+        const [r, g, b] = DELTA_LUT[pixelMax];
+        delta[p] = r;
+        delta[p + 1] = g;
+        delta[p + 2] = b;
+    }
+    const mse = sumSq / n;
+    return {
+        metrics: {
+            psnr: mse === 0 ? null : 10 * Math.log10((255 * 255) / mse),
+            rmse: Math.sqrt(mse) / 255,
+            mae: sumAbs / n / 255,
+            maxError: max / 255,
+        },
+        delta: { data: delta, width: reference.width, height: reference.height },
+    };
+}
+/** Compares two encoded images (paths or buffers); returns metrics and the delta encoded like the renders. */
+export async function compareImages(reference, test) {
+    const [ref, tst] = await Promise.all([readRgb(reference), readRgb(test)]);
+    const { metrics, delta } = compareRgb(ref, tst);
+    const deltaImage = await sharp(delta.data, { raw: { width: delta.width, height: delta.height, channels: 3 } })
+        .avif(RESULT_AVIF)
+        .toBuffer();
+    return { metrics, width: ref.width, height: ref.height, deltaImage };
+}
+//# sourceMappingURL=compare.js.map

package/dist/core/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/core/compare.ts"],"names":[],"mappings":"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"}

package/dist/core/etag.d.ts

@@ -0,0 +1,39 @@
+import { type HashEntry } from './hash.js';
+/**
+ * Lazy content-hash map keyed by absolute path: a file is hashed (streamed, CRC32) only when its mtime or size differs
+ * from the entry. Only the hash is kept, never the bytes, so memory stays flat however many images a suite has. Entries
+ * can be pre-populated from `image-hashes.json`; they are trusted only while the file's stat still matches.
+ */
+export declare class HashStore {
+    private entries;
+    /** Concurrent first requests for the same file (a visitor scrolling a page of images) share one hash pass. */
+    private hashing;
+    /** Bumped whenever the set of known hashes changes; drives the ETag of the hash listing. */
+    version: number;
+    preload(path: string, entry: HashEntry): void;
+    entryFor(path: string, mtimeMs: number, size: number): Promise<HashEntry>;
+    /** Every hash that is valid right now: entries whose file changed or vanished are dropped. */
+    known(): Promise<Map<string, string>>;
+}
+/** Refuses paths that escape `root`. */
+export declare function resolveInside(root: string, rel: string): string | null;
+export declare const IMMUTABLE = "public, max-age=31536000, immutable";
+/** True when the request's validators say the client's copy is current (If-None-Match wins over If-Modified-Since). */
+export declare function notModified(req: Request, etag: string, mtimeMs: number): boolean;
+/**
+ * Serves a file with CDN-friendly validators: strong ETag (`"<size>-<crc32>"`, the content hash), Last-Modified, Content-Length, nosniff, and
+ * 304 on If-None-Match / If-Modified-Since. The body is streamed from disk. `cacheControl` defaults to `no-cache`
+ * (always revalidate); `immutableIf` is a `?v=` version that becomes `immutableCacheControl` only if it equals the file's
+ * current hash (an unverified version keeps `cacheControl`). There is no Vary: the response never depends on request headers.
+ */
+export declare function fileResponse(req: Request, path: string, opts?: {
+    cacheControl?: string;
+    immutableIf?: string | null;
+    store?: HashStore;
+}): Promise<Response>;
+/**
+ * Dev-mode variant: the file exactly as it is on disk right now, every time. No ETag, no Last-Modified, no hash cache,
+ * conditional headers are ignored (always 200) and `Cache-Control: no-store` keeps browsers and proxies from reusing it.
+ */
+export declare function freshFileResponse(path: string): Promise<Response>;
+//# sourceMappingURL=etag.d.ts.map

package/dist/core/etag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../src/core/etag.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAErD;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAgC;IAC/C,8GAA8G;IAC9G,OAAO,CAAC,OAAO,CAAyC;IACxD,4FAA4F;IAC5F,OAAO,SAAK;IAEZ,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAGrC;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAe9E;IAED,8FAA8F;IACxF,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAW1C;CACF;AAKD,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAItE;AAED,eAAO,MAAM,SAAS,wCAAwC,CAAC;AAgB/D,uHAAuH;AACvH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKhF;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAO,GACnF,OAAO,CAAC,QAAQ,CAAC,CAgBnB;AAOD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAMvE"}

package/dist/core/etag.js

@@ -0,0 +1,121 @@
+import { createReadStream } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { resolve, sep } from 'node:path';
+import { Readable } from 'node:stream';
+import { hashFile } from './hash.js';
+/**
+ * Lazy content-hash map keyed by absolute path: a file is hashed (streamed, CRC32) only when its mtime or size differs
+ * from the entry. Only the hash is kept, never the bytes, so memory stays flat however many images a suite has. Entries
+ * can be pre-populated from `image-hashes.json`; they are trusted only while the file's stat still matches.
+ */
+export class HashStore {
+    entries = new Map();
+    /** Concurrent first requests for the same file (a visitor scrolling a page of images) share one hash pass. */
+    hashing = new Map();
+    /** Bumped whenever the set of known hashes changes; drives the ETag of the hash listing. */
+    version = 0;
+    preload(path, entry) {
+        this.entries.set(path, entry);
+        this.version++;
+    }
+    async entryFor(path, mtimeMs, size) {
+        const hit = this.entries.get(path);
+        if (hit && hit.mtimeMs === mtimeMs && hit.size === size)
+            return hit;
+        const key = `${path}\0${mtimeMs}\0${size}`;
+        let pending = this.hashing.get(key);
+        if (!pending) {
+            pending = (async () => {
+                const entry = { mtimeMs, size, hash: await hashFile(path) };
+                this.entries.set(path, entry);
+                this.version++;
+                return entry;
+            })().finally(() => this.hashing.delete(key));
+            this.hashing.set(key, pending);
+        }
+        return pending;
+    }
+    /** Every hash that is valid right now: entries whose file changed or vanished are dropped. */
+    async known() {
+        await Promise.all([...this.entries].map(async ([path, e]) => {
+            const s = await stat(path).catch(() => null);
+            if (!s?.isFile() || s.mtimeMs !== e.mtimeMs || s.size !== e.size) {
+                this.entries.delete(path);
+                this.version++;
+            }
+        }));
+        return new Map([...this.entries].map(([path, e]) => [path, e.hash]));
+    }
+}
+/** Used by `fileResponse` callers that don't bring their own store (the server has one per handler). */
+const sharedStore = new HashStore();
+/** Refuses paths that escape `root`. */
+export function resolveInside(root, rel) {
+    const base = resolve(root);
+    const full = resolve(base, rel);
+    return full === base || full.startsWith(base + sep) ? full : null;
+}
+export const IMMUTABLE = 'public, max-age=31536000, immutable';
+const TYPES = {
+    avif: 'image/avif',
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    webp: 'image/webp',
+    json: 'application/json',
+    md: 'text/markdown; charset=utf-8',
+    html: 'text/html; charset=utf-8',
+    js: 'text/javascript; charset=utf-8',
+    css: 'text/css; charset=utf-8',
+    svg: 'image/svg+xml',
+    ico: 'image/x-icon',
+};
+/** True when the request's validators say the client's copy is current (If-None-Match wins over If-Modified-Since). */
+export function notModified(req, etag, mtimeMs) {
+    const inm = req.headers.get('if-none-match');
+    if (inm)
+        return inm.trim() === '*' || inm.split(',').some((t) => t.trim().replace(/^W\//, '') === etag);
+    const ims = Date.parse(req.headers.get('if-modified-since') ?? '');
+    return Math.floor(mtimeMs / 1000) <= Math.floor(ims / 1000); // NaN (absent/invalid) compares false
+}
+/**
+ * Serves a file with CDN-friendly validators: strong ETag (`"<size>-<crc32>"`, the content hash), Last-Modified, Content-Length, nosniff, and
+ * 304 on If-None-Match / If-Modified-Since. The body is streamed from disk. `cacheControl` defaults to `no-cache`
+ * (always revalidate); `immutableIf` is a `?v=` version that becomes `immutableCacheControl` only if it equals the file's
+ * current hash (an unverified version keeps `cacheControl`). There is no Vary: the response never depends on request headers.
+ */
+export async function fileResponse(req, path, opts = {}) {
+    const s = await stat(path).catch(() => null);
+    if (!s?.isFile())
+        return new Response('Not found', { status: 404, headers: { 'Cache-Control': 'no-cache' } });
+    const { hash } = await (opts.store ?? sharedStore).entryFor(path, s.mtimeMs, s.size);
+    const etag = `"${hash}"`;
+    const verified = opts.immutableIf === hash;
+    const headers = {
+        ETag: etag,
+        'Last-Modified': new Date(s.mtimeMs).toUTCString(),
+        'Cache-Control': verified ? IMMUTABLE : (opts.cacheControl ?? 'no-cache'),
+        'X-Content-Type-Options': 'nosniff',
+    };
+    if (notModified(req, etag, s.mtimeMs))
+        return new Response(null, { status: 304, headers });
+    return new Response(Readable.toWeb(createReadStream(path)), {
+        headers: { ...headers, ...bodyHeaders(path, s.size) },
+    });
+}
+function bodyHeaders(path, size) {
+    const ext = path.slice(path.lastIndexOf('.') + 1).toLowerCase();
+    return { 'Content-Type': TYPES[ext] ?? 'application/octet-stream', 'Content-Length': String(size) };
+}
+/**
+ * Dev-mode variant: the file exactly as it is on disk right now, every time. No ETag, no Last-Modified, no hash cache,
+ * conditional headers are ignored (always 200) and `Cache-Control: no-store` keeps browsers and proxies from reusing it.
+ */
+export async function freshFileResponse(path) {
+    const s = await stat(path).catch(() => null);
+    if (!s?.isFile())
+        return new Response('Not found', { status: 404, headers: { 'Cache-Control': 'no-store' } });
+    return new Response(Readable.toWeb(createReadStream(path)), {
+        headers: { ...bodyHeaders(path, s.size), 'Cache-Control': 'no-store' },
+    });
+}
+//# sourceMappingURL=etag.js.map

package/dist/core/etag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.js","sourceRoot":"","sources":["../../src/core/etag.ts"],"names":[],"mappings":"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"}

package/dist/core/hash.d.ts

@@ -0,0 +1,30 @@
+export declare const HASHES_FILE = "image-hashes.json";
+export interface HashEntry {
+    hash: string;
+    size: number;
+    mtimeMs: number;
+}
+/**
+ * Content hash shared by the ETag and the `?v=` URL version: `<size>-<crc32>` in base36. Streamed, so memory stays flat
+ * however large the file is. Fast and non-cryptographic: it detects change, it is not a security boundary.
+ */
+export declare function hashFile(path: string): Promise<string>;
+/** The entries of `<root>/image-hashes.json`; empty when it is missing or malformed (they are only a cache). */
+export declare function readHashFile(root: string): Promise<Record<string, HashEntry>>;
+export interface HashSuiteOptions {
+    /** Parallel file reads; defaults to `os.availableParallelism()`. */
+    concurrency?: number;
+    /** Injectable for tests. */
+    hash?: (path: string) => Promise<string>;
+}
+export interface HashSuiteResult {
+    hashed: number;
+    reused: number;
+    total: number;
+}
+/**
+ * Writes `<root>/image-hashes.json` for every served `.avif`. Incremental: an entry whose size and mtimeMs are unchanged
+ * is reused without reading the file. Output is sorted and timestamp-free, so unchanged files give identical bytes.
+ */
+export declare function hashSuite(root: string, opts?: HashSuiteOptions): Promise<HashSuiteResult>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/core/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/core/hash.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ5D;AAED,gHAAgH;AAChH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAMnF;AAED,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AACD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4BnG"}

package/dist/core/hash.js

@@ -0,0 +1,65 @@
+import { createReadStream } from 'node:fs';
+import { readFile, readdir, rename, stat, writeFile } from 'node:fs/promises';
+import { availableParallelism } from 'node:os';
+import { join, resolve } from 'node:path';
+import { crc32 } from 'node:zlib';
+import pLimit from 'p-limit';
+import { z } from 'zod';
+import { isDataFile } from './paths.js';
+export const HASHES_FILE = 'image-hashes.json';
+const fileSchema = z.object({
+    version: z.literal(1),
+    files: z.record(z.string(), z.object({ hash: z.string(), size: z.number(), mtimeMs: z.number() })),
+});
+/**
+ * Content hash shared by the ETag and the `?v=` URL version: `<size>-<crc32>` in base36. Streamed, so memory stays flat
+ * however large the file is. Fast and non-cryptographic: it detects change, it is not a security boundary.
+ */
+export async function hashFile(path) {
+    let crc = 0;
+    let size = 0;
+    for await (const chunk of createReadStream(path)) {
+        crc = crc32(chunk, crc);
+        size += chunk.length;
+    }
+    return `${size.toString(36)}-${crc.toString(36)}`;
+}
+/** The entries of `<root>/image-hashes.json`; empty when it is missing or malformed (they are only a cache). */
+export async function readHashFile(root) {
+    try {
+        return fileSchema.parse(JSON.parse(await readFile(join(root, HASHES_FILE), 'utf8'))).files;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Writes `<root>/image-hashes.json` for every served `.avif`. Incremental: an entry whose size and mtimeMs are unchanged
+ * is reused without reading the file. Output is sorted and timestamp-free, so unchanged files give identical bytes.
+ */
+export async function hashSuite(root, opts = {}) {
+    root = resolve(root);
+    const { concurrency = availableParallelism(), hash = hashFile } = opts;
+    const limit = pLimit(Math.max(1, Math.floor(concurrency)));
+    const previous = await readHashFile(root);
+    const rels = (await readdir(root, { recursive: true }))
+        .map((p) => p.split('\\').join('/'))
+        .filter((rel) => rel.endsWith('.avif') && isDataFile(rel))
+        .toSorted();
+    let reused = 0;
+    const entries = await Promise.all(rels.map((rel) => limit(async () => {
+        const s = await stat(join(root, rel));
+        const old = previous[rel];
+        if (old && old.size === s.size && old.mtimeMs === s.mtimeMs) {
+            reused++;
+            return [rel, old];
+        }
+        return [rel, { hash: await hash(join(root, rel)), size: s.size, mtimeMs: s.mtimeMs }];
+    })));
+    const out = join(root, HASHES_FILE);
+    const tmp = `${out}.${process.pid}.tmp`;
+    await writeFile(tmp, `${JSON.stringify({ version: 1, files: Object.fromEntries(entries) }, null, 2)}\n`);
+    await rename(tmp, out);
+    return { hashed: entries.length - reused, reused, total: entries.length };
+}
+//# sourceMappingURL=hash.js.map

package/dist/core/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/core/hash.ts"],"names":[],"mappings":"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"}

package/dist/core/hash.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hash.test.d.ts.map

package/dist/core/hash.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.test.d.ts","sourceRoot":"","sources":["../../src/core/hash.test.ts"],"names":[],"mappings":""}

package/dist/core/hash.test.js

@@ -0,0 +1,71 @@
+import { mkdir, mkdtemp, readFile, utimes, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { expect, test } from 'vitest';
+import { HASHES_FILE, hashFile, hashSuite } from './index.js';
+async function suite() {
+    const root = await mkdtemp(join(tmpdir(), 'fk-hash-'));
+    await mkdir(join(root, 'b', 'beauty'), { recursive: true });
+    await mkdir(join(root, 'a', 'beauty'), { recursive: true });
+    await mkdir(join(root, '.hidden'), { recursive: true });
+    for (const [f, c] of [
+        ['b/beauty/x.avif', 'bbb'],
+        ['a/beauty/x.avif', 'a'],
+        ['a/beauty/y.avif', 'aaaa'],
+        ['a/notes.txt', 'ignored'],
+        ['.hidden/z.avif', 'ignored'],
+    ]) {
+        await writeFile(join(root, f), c);
+    }
+    return root;
+}
+const read = async (root) => JSON.parse(await readFile(join(root, HASHES_FILE), 'utf8'));
+test('hash is deterministic, sorted, covers only served images, and is incremental', async () => {
+    const root = await suite();
+    expect(await hashSuite(root)).toEqual({ hashed: 3, reused: 0, total: 3 });
+    const first = await readFile(join(root, HASHES_FILE), 'utf8');
+    const json = JSON.parse(first);
+    expect(json.version).toBe(1);
+    expect(Object.keys(json.files)).toEqual(['a/beauty/x.avif', 'a/beauty/y.avif', 'b/beauty/x.avif']);
+    expect(json.files['b/beauty/x.avif']).toMatchObject({ hash: await hashFile(join(root, 'b/beauty/x.avif')), size: 3 });
+    expect(await hashSuite(root)).toEqual({ hashed: 0, reused: 3, total: 3 });
+    expect(await readFile(join(root, HASHES_FILE), 'utf8')).toBe(first);
+    // changed content (new size) is rehashed, the rest is reused without reading
+    const hashed = [];
+    await writeFile(join(root, 'a/beauty/y.avif'), 'changed!');
+    const r = await hashSuite(root, {
+        hash: (p) => {
+            hashed.push(p);
+            return hashFile(p);
+        },
+    });
+    expect(r).toEqual({ hashed: 1, reused: 2, total: 3 });
+    expect(hashed).toEqual([join(root, 'a/beauty/y.avif')]);
+    expect((await read(root)).files['a/beauty/y.avif'].hash).not.toBe(json.files['a/beauty/y.avif'].hash);
+    // a touched file (same bytes, new mtime) is rehashed to the same hash
+    const later = new Date(Date.now() + 10_000);
+    await utimes(join(root, 'a/beauty/x.avif'), later, later);
+    expect(await hashSuite(root)).toMatchObject({ hashed: 1, reused: 2 });
+    expect((await read(root)).files['a/beauty/x.avif'].hash).toBe(json.files['a/beauty/x.avif'].hash);
+});
+test('hash concurrency never exceeds the limit', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'fk-hash-'));
+    await mkdir(join(root, 's', 'o'), { recursive: true });
+    for (let i = 0; i < 12; i++)
+        await writeFile(join(root, 's', 'o', `${i}.avif`), String(i));
+    let active = 0;
+    let peak = 0;
+    const hash = async () => {
+        peak = Math.max(peak, ++active);
+        await new Promise((r) => setTimeout(r, 5));
+        active--;
+        return 'h';
+    };
+    await hashSuite(root, { concurrency: 3, hash });
+    expect(peak).toBe(3);
+    peak = 0;
+    await writeFile(join(root, HASHES_FILE), '{}'); // malformed cache is ignored
+    await hashSuite(root, { concurrency: 1, hash });
+    expect(peak).toBe(1);
+});
+//# sourceMappingURL=hash.test.js.map

package/dist/core/hash.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.test.js","sourceRoot":"","sources":["../../src/core/hash.test.ts"],"names":[],"mappings":"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"}