fidelity-kit 0.1.0

package/dist/server.test.d.ts.map

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

package/dist/server.test.js

@@ -0,0 +1,162 @@
+import { mkdir, mkdtemp, stat, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { expect, test } from 'vitest';
+import { createHandler } from './server.js';
+test('serves only allowlisted suite files and the viewer', async () => {
+    const dir = await mkdtemp(join(tmpdir(), 'fk-srv-'));
+    const [root, assets] = [join(dir, 'root'), join(dir, 'assets')];
+    await mkdir(join(root, 's', 'beauty'), { recursive: true });
+    await mkdir(join(assets, 'assets'), { recursive: true });
+    for (const [f, c] of [
+        ['root/index.json', '{}'],
+        ['root/fidelity.json', '{}'],
+        ['root/README.md', '# x'],
+        ['root/s/scene.json', '{}'],
+        ['root/s/beauty/a.avif', 'img'],
+        ['secret.txt', 'nope'],
+        ['assets/index.html', '<html>'],
+        ['assets/assets/app.js', '1'],
+    ]) {
+        await writeFile(join(dir, f), c);
+    }
+    const get = async (p) => createHandler(root, { assets })(new Request(`http://x${p}`));
+    const status = async (p) => (await get(p)).status;
+    expect(await status('/')).toBe(200);
+    expect((await get('/')).headers.get('content-type')).toContain('text/html');
+    expect((await get('/assets/app.js')).headers.get('cache-control')).toContain('immutable');
+    for (const ok of ['/data/index.json', '/data/README.md', '/data/s/beauty/a.avif'])
+        expect(await status(ok)).toBe(200);
+    for (const bad of [
+        '/data/fidelity.json',
+        '/data/s/scene.json',
+        '/data/../secret.txt',
+        '/data/%2e%2e/secret.txt',
+        '/nope',
+    ])
+        expect(await status(bad)).toBe(404);
+    // CDN-facing headers: images are shared-cacheable with SWR; everything mutable revalidates.
+    const img = await get('/data/s/beauty/a.avif');
+    expect(img.headers.get('cache-control')).toBe('public, max-age=300, stale-while-revalidate=86400, stale-if-error=86400');
+    expect(img.headers.get('content-length')).toBe('3');
+    expect(img.headers.get('content-type')).toBe('image/avif');
+    expect(img.headers.get('etag')).toMatch(/^"/);
+    expect(img.headers.get('last-modified')).toMatch(/GMT$/);
+    expect(img.headers.get('vary')).toBeNull();
+    expect((await get('/data/index.json')).headers.get('cache-control')).toBe('no-cache');
+    expect((await get('/')).headers.get('cache-control')).toBe('no-cache');
+    // validators: If-None-Match, and If-Modified-Since when there is no ETag
+    const revalidate = async (h) => (await createHandler(root, { assets })(new Request('http://x/data/s/beauty/a.avif', { headers: h }))).status;
+    expect(await revalidate({ 'if-none-match': img.headers.get('etag') })).toBe(304);
+    expect(await revalidate({ 'if-none-match': '"other"' })).toBe(200);
+    expect(await revalidate({ 'if-modified-since': img.headers.get('last-modified') })).toBe(304);
+    expect(await revalidate({ 'if-modified-since': new Date(0).toUTCString() })).toBe(200);
+});
+test('dev mode serves everything fresh: no validators, no caching, conditionals ignored', async () => {
+    const dir = await mkdtemp(join(tmpdir(), 'fk-dev-'));
+    const [root, assets] = [join(dir, 'root'), join(dir, 'assets')];
+    await mkdir(join(root, 's', 'beauty'), { recursive: true });
+    await mkdir(assets, { recursive: true });
+    await writeFile(join(assets, 'index.html'), '<html>');
+    await writeFile(join(root, 'index.json'), '{}');
+    const image = join(root, 's', 'beauty', 'a.avif');
+    await writeFile(image, 'one');
+    const dev = createHandler(root, { assets, dev: true });
+    const get = (p, headers = {}) => dev(new Request(`http://x${p}`, { headers }));
+    for (const p of ['/', '/data/index.json', '/data/s/beauty/a.avif']) {
+        const res = await get(p);
+        expect(res.status).toBe(200);
+        expect(res.headers.get('cache-control')).toBe('no-store');
+        expect(res.headers.get('etag')).toBeNull();
+        expect(res.headers.get('last-modified')).toBeNull();
+    }
+    const future = new Date(Date.now() + 60_000).toUTCString();
+    expect((await get('/data/s/beauty/a.avif', { 'if-none-match': '*', 'if-modified-since': future })).status).toBe(200);
+    expect((await get('/data/nope.avif')).status).toBe(404);
+    // a modified image is visible on the very next request, with a new size
+    await writeFile(image, 'changed!');
+    const after = await get('/data/s/beauty/a.avif');
+    expect(await after.text()).toBe('changed!');
+    expect(after.headers.get('content-length')).toBe('8');
+});
+async function hashedSuite(prepare) {
+    const dir = await mkdtemp(join(tmpdir(), 'fk-hsh-'));
+    const [root, assets] = [join(dir, 'root'), join(dir, 'assets')];
+    await mkdir(join(root, 's', 'beauty'), { recursive: true });
+    await mkdir(assets, { recursive: true });
+    await writeFile(join(assets, 'index.html'), '<html>');
+    await writeFile(join(root, 'index.json'), '{}');
+    await writeFile(join(root, 's', 'beauty', 'a.avif'), 'one');
+    await writeFile(join(root, 's', 'beauty', 'b.avif'), 'two2');
+    await prepare?.(root);
+    return { root, assets };
+}
+const SHORT = 'public, max-age=300, stale-while-revalidate=86400, stale-if-error=86400';
+const IMMUTABLE = 'public, max-age=31536000, immutable';
+const A = '/data/s/beauty/a.avif';
+test('?v is immutable only when it matches the current hash; the listing grows as images are hashed', async () => {
+    const { root, assets } = await hashedSuite();
+    const h = createHandler(root, { assets });
+    const get = (p, headers = {}) => h(new Request(`http://x${p}`, { headers }));
+    const empty = await get('/data/image-hashes.json');
+    expect(await empty.json()).toEqual({});
+    expect(empty.headers.get('cache-control')).toBe('no-cache');
+    expect(empty.headers.get('content-type')).toBe('application/json');
+    const first = await get(A);
+    const hash = first.headers.get('etag').slice(1, -1);
+    expect(first.headers.get('cache-control')).toBe(SHORT);
+    expect((await get(`${A}?v=${hash}`)).headers.get('cache-control')).toBe(IMMUTABLE);
+    expect((await get(`${A}?v=bogus`)).headers.get('cache-control')).toBe(SHORT);
+    expect((await get('/data/s/beauty/b.avif?v=' + hash)).headers.get('cache-control')).toBe(SHORT);
+    expect((await get('/data/index.json?v=' + hash)).headers.get('cache-control')).toBe('no-cache');
+    const list = await get('/data/image-hashes.json');
+    expect(await list.json()).toEqual({ 's/beauty/a.avif': hash, 's/beauty/b.avif': expect.any(String) });
+    const etag = list.headers.get('etag');
+    expect(etag).not.toBe(empty.headers.get('etag'));
+    expect((await get('/data/image-hashes.json', { 'if-none-match': etag })).status).toBe(304);
+    // a changed file drops out of the listing and its old version is no longer immutable
+    await writeFile(join(root, 's', 'beauty', 'a.avif'), 'changed');
+    expect(Object.keys((await (await get('/data/image-hashes.json')).json()))).toEqual(['s/beauty/b.avif']);
+    expect((await get(`${A}?v=${hash}`)).headers.get('cache-control')).toBe(SHORT);
+});
+test('image-hashes.json pre-populates the map; entries with a different size or mtime are discarded', async () => {
+    const { root, assets } = await hashedSuite(async (r) => {
+        const [a, b] = ['a', 'b'].map((n) => join(r, 's', 'beauty', `${n}.avif`));
+        const [sa, sb] = await Promise.all([stat(a), stat(b)]);
+        await writeFile(join(r, 'image-hashes.json'), JSON.stringify({
+            version: 1,
+            files: {
+                // deliberately not the real hash: proves the file is trusted instead of re-read
+                's/beauty/a.avif': { hash: 'prepopulated', size: sa.size, mtimeMs: sa.mtimeMs },
+                's/beauty/b.avif': { hash: 'stale', size: sb.size, mtimeMs: sb.mtimeMs + 1 },
+            },
+        }));
+    });
+    const h = createHandler(root, { assets });
+    const get = (p) => h(new Request(`http://x${p}`));
+    expect(await (await get('/data/image-hashes.json')).json()).toEqual({ 's/beauty/a.avif': 'prepopulated' });
+    const a = await get(A);
+    expect(a.headers.get('etag')).toBe('"prepopulated"');
+    expect((await get(`${A}?v=prepopulated`)).headers.get('cache-control')).toBe(IMMUTABLE);
+    const b = await get('/data/s/beauty/b.avif');
+    expect(b.headers.get('etag')).not.toMatch(/stale/);
+    expect((await get('/data/s/beauty/b.avif?v=stale')).headers.get('cache-control')).toBe(SHORT);
+    expect((await get('/data/image-hashes.json')).status).toBe(200);
+});
+test('dev mode never hashes: listing is empty, ?v is ignored, the hash file is not loaded', async () => {
+    const { root, assets } = await hashedSuite(async (r) => {
+        const s = await stat(join(r, 's', 'beauty', 'a.avif'));
+        await writeFile(join(r, 'image-hashes.json'), JSON.stringify({ version: 1, files: { 's/beauty/a.avif': { hash: 'h', size: s.size, mtimeMs: s.mtimeMs } } }));
+    });
+    const h = createHandler(root, { assets, dev: true });
+    const list = await h(new Request('http://x/data/image-hashes.json'));
+    expect(list.status).toBe(200);
+    expect(await list.json()).toEqual({});
+    expect(list.headers.get('cache-control')).toBe('no-store');
+    expect(list.headers.get('etag')).toBeNull();
+    const img = await h(new Request(`http://x${A}?v=h`));
+    expect(img.status).toBe(200);
+    expect(img.headers.get('cache-control')).toBe('no-store');
+    expect(img.headers.get('etag')).toBeNull();
+});
+//# sourceMappingURL=server.test.js.map

package/dist/server.test.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "fidelity-kit",
+  "version": "0.1.0",
+  "description": "Toolkit for renderer fidelity suites: metrics + delta CLI and a viewer served from any results folder.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bhouston/fidelity-kit.git"
+  },
+  "bin": {
+    "fidelity-kit": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "viewer"
+  ],
+  "type": "module",
+  "main": "./dist/core/index.js",
+  "types": "./dist/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./paths": {
+      "types": "./dist/core/paths.d.ts",
+      "import": "./dist/core/paths.js"
+    },
+    "./scan": {
+      "types": "./dist/core/scan.d.ts",
+      "import": "./dist/core/scan.js"
+    }
+  },
+  "dependencies": {
+    "@clidoc/core": "^1.0.0",
+    "@clidoc/yargs": "^1.1.0",
+    "p-limit": "^7.3.3",
+    "sharp": "^0.35.4",
+    "yargs": "^18.0.0",
+    "yargs-file-commands": "^2.1.0",
+    "zod": "^4.0.0"
+  },
+  "scripts": {}
+}