commit 1d81aa548c60294b62e447da1623dd3ac92a13eb
parent fb6a2e255e84c05915e57433c5451737a8798159
Author: triesap <tyson@radroots.org>
Date: Sun, 4 Oct 2026 04:22:17 +0000
test: create the browser and loopback test entry points (HCP-008)
- Pin real Chromium and loopback test dependencies within the web graph.
- Exercise static output, isolated public providers and owned relay sockets.
- Await resource teardown and keep controlled harnesses out of production.
- Preserve generated test artifacts while excluding them from source lint.
Diffstat:
11 files changed, 421 insertions(+), 3 deletions(-)
diff --git a/web/.prettierignore b/web/.prettierignore
@@ -1,4 +1,6 @@
node_modules/
.svelte-kit/
build/
+test-results/
+playwright-report/
AGENTS.md
diff --git a/web/eslint.config.js b/web/eslint.config.js
@@ -8,7 +8,15 @@ const svelteConfig = (await loadConfig('./', { traverse: false }))?.config;
if (!svelteConfig) throw new Error('Missing Svelte configuration');
export default defineConfig(
- { ignores: ['node_modules/**', '.svelte-kit/**', 'build/**'] },
+ {
+ ignores: [
+ 'node_modules/**',
+ '.svelte-kit/**',
+ 'build/**',
+ 'test-results/**',
+ 'playwright-report/**'
+ ]
+ },
js.configs.recommended,
ts.configs.recommended,
{
diff --git a/web/package.json b/web/package.json
@@ -13,16 +13,21 @@
"build": "node tools/check-source.mjs && vite build",
"check": "node tools/check-source.mjs && svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --fail-on-warnings",
"lint": "node tools/check-source.mjs && svelte-kit sync && eslint . --max-warnings 0 && prettier --check .",
- "test:unit": "node tools/check-source.mjs && svelte-kit sync && vitest run --config vitest.config.ts"
+ "test:unit": "node tools/check-source.mjs && svelte-kit sync && vitest run --config vitest.config.ts",
+ "test:conformance": "pnpm build && node --test tests/conformance/*.test.ts",
+ "test:integration": "pnpm build && node --test --test-timeout=10000 tests/integration/*.test.ts",
+ "test:e2e": "pnpm build && playwright test"
},
"devDependencies": {
"@eslint/js": "10.0.1",
"@opentelemetry/api": "1.9.1",
+ "@playwright/test": "1.63.0",
"@sveltejs/adapter-static": "4.0.0",
"@sveltejs/kit": "3.0.0",
"@sveltejs/load-config": "0.2.3",
"@sveltejs/vite-plugin-svelte": "7.3.1",
"@types/node": "24.19.1",
+ "@types/ws": "8.18.2",
"eslint": "10.12.0",
"eslint-plugin-svelte": "3.23.0",
"prettier": "3.9.9",
@@ -32,6 +37,7 @@
"typescript": "6.0.3",
"typescript-eslint": "8.71.0",
"vite": "8.3.2",
- "vitest": "5.0.3"
+ "vitest": "5.0.3",
+ "ws": "8.22.0"
}
}
diff --git a/web/playwright.config.ts b/web/playwright.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+ testDir: './tests/e2e',
+ testMatch: '**/*.spec.ts',
+ fullyParallel: false,
+ workers: 1,
+ retries: 0,
+ timeout: 15_000,
+ use: { browserName: 'chromium', headless: true, serviceWorkers: 'block' },
+ reporter: 'list'
+});
diff --git a/web/pnpm-lock.yaml b/web/pnpm-lock.yaml
@@ -213,6 +213,9 @@ importers:
'@opentelemetry/api':
specifier: 1.9.1
version: 1.9.1
+ '@playwright/test':
+ specifier: 1.63.0
+ version: 1.63.0
'@sveltejs/adapter-static':
specifier: 4.0.0
version: 4.0.0(@sveltejs/kit@3.0.0(@opentelemetry/api@1.9.1)(@sveltejs/vite-plugin-svelte@7.3.1(svelte@5.57.1(@typescript-eslint/types@8.71.0))(vite@8.3.2(@types/node@24.19.1)))(svelte@5.57.1(@typescript-eslint/types@8.71.0))(typescript@6.0.3)(vite@8.3.2(@types/node@24.19.1)))
@@ -228,6 +231,9 @@ importers:
'@types/node':
specifier: 24.19.1
version: 24.19.1
+ '@types/ws':
+ specifier: 8.18.2
+ version: 8.18.2
eslint:
specifier: 10.12.0
version: 10.12.0
@@ -258,6 +264,9 @@ importers:
vitest:
specifier: 5.0.3
version: 5.0.3(@opentelemetry/api@1.9.1)(@types/node@24.19.1)(vite@8.3.2(@types/node@24.19.1))
+ ws:
+ specifier: 8.22.0
+ version: 8.22.0
packages:
'@cacheable/memory@2.2.0':
@@ -429,6 +438,14 @@ packages:
integrity: sha512-oM/5rLBm2tPkg0iBgkH/FOeR3PCDpY19GTgAZjMFM8h9WI9VW7cLgzp6nwtarYKmovavIQZ+Fe/RKX/8C8O/Rw==
}
+ '@playwright/test@1.63.0':
+ resolution:
+ {
+ integrity: sha512-oxMK4vllB9RK5NQ2l1pq1IfOf2AvnEuj/vYGDj0H2nMtmtZpKtCwt/l00GEO6xjGfpBNAvjovvYdCm50dRQkpQ==
+ }
+ engines: { node: '>=20' }
+ hasBin: true
+
'@polka/url@1.0.0-next.29':
resolution:
{
@@ -676,6 +693,12 @@ packages:
integrity: sha512-aS3/DG0oM05K0RIXXP+hKjinGG5IgSSVGzswZxW3O0sS3pH4/fycXundUC9XsszgKCk4gHXylTEK6hyFxVxnoQ==
}
+ '@types/ws@8.18.2':
+ resolution:
+ {
+ integrity: sha512-67MQl+fpWKVTT1NYdnmo3U4sc/xPo/zQBncVnI74qmQa0z/b+1g6iYqNmGCPbxO+zz2aklb08a0oHfegiVd0/w==
+ }
+
'@typescript-eslint/eslint-plugin@8.71.0':
resolution:
{
@@ -1487,6 +1510,22 @@ packages:
}
engines: { node: '>=12' }
+ playwright-core@1.63.0:
+ resolution:
+ {
+ integrity: sha512-rYCsBF/M5HjUch52bbtVONEFjv6Xu8sm8h72dNlR5bzIE1fvC/bxgspzkjSfU+MweEMmPM8KJebG6nnyxo5mCg==
+ }
+ engines: { node: '>=20' }
+ hasBin: true
+
+ playwright@1.63.0:
+ resolution:
+ {
+ integrity: sha512-+7ziBLidS4NaNCdt57SUDT+wYmmd5fmiQejUic/kb+YsYSCPyOOE9sebzMjNmQrsnNpDJqd4WHvV/8lfKfUDUg==
+ }
+ engines: { node: '>=20' }
+ hasBin: true
+
postcss-load-config@3.1.4:
resolution:
{
@@ -1871,6 +1910,21 @@ packages:
}
engines: { node: '>=0.10.0' }
+ ws@8.22.0:
+ resolution:
+ {
+ integrity: sha512-Ydggc987+RO0AnWtZ/7Wq9FtNvcrL1b/RO0ud9mWjUPgDrsAAwQSF51sm2hm1XofbU/4jkpGEsLFsZZxU+1DOg==
+ }
+ engines: { node: '>=10.0.0' }
+ peerDependencies:
+ bufferutil: ^4.0.1
+ utf-8-validate: '>=5.0.2'
+ peerDependenciesMeta:
+ bufferutil:
+ optional: true
+ utf-8-validate:
+ optional: true
+
yaml@1.10.3:
resolution:
{
@@ -1985,6 +2039,10 @@ snapshots:
'@oxc-project/types@0.152.0': {}
+ '@playwright/test@1.63.0':
+ dependencies:
+ playwright: 1.63.0
+
'@polka/url@1.0.0-next.29': {}
'@rolldown/binding-android-arm-eabi@1.2.12':
@@ -2089,6 +2147,10 @@ snapshots:
dependencies:
undici-types: 7.24.6
+ '@types/ws@8.18.2':
+ dependencies:
+ '@types/node': 24.19.1
+
'@typescript-eslint/eslint-plugin@8.71.0(@typescript-eslint/parser@8.71.0(eslint@10.12.0)(typescript@6.0.3))(eslint@10.12.0)(typescript@6.0.3)':
dependencies:
'@eslint-community/regexpp': 4.12.2
@@ -2550,6 +2612,12 @@ snapshots:
picomatch@4.0.7: {}
+ playwright-core@1.63.0: {}
+
+ playwright@1.63.0:
+ dependencies:
+ playwright-core: 1.63.0
+
postcss-load-config@3.1.4(postcss@8.5.28):
dependencies:
lilconfig: 2.1.0
@@ -2766,6 +2834,8 @@ snapshots:
word-wrap@1.2.5: {}
+ ws@8.22.0: {}
+
yaml@1.10.3: {}
yocto-queue@0.1.0: {}
diff --git a/web/tests/conformance/static.test.ts b/web/tests/conformance/static.test.ts
@@ -0,0 +1,23 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { readdir, readFile } from 'node:fs/promises';
+
+// Bootstrap output conformance only; Food/Message oracle parity is not qualified.
+await test('actual static shell is prerendered and excludes controlled harness code', async () => {
+ const root = new URL('../../build/', import.meta.url);
+ const files = await readdir(root, { recursive: true, withFileTypes: true });
+ assert.ok(
+ files.some((entry) => entry.isFile() && entry.name === 'index.html')
+ );
+ const html = await readFile(new URL('index.html', root), 'utf8');
+ assert.match(html, /<h1>HarvestCircle<\/h1>/);
+ assert.match(html, /<title>HarvestCircle<\/title>/);
+ for (const entry of files) {
+ if (!entry.isFile()) continue;
+ const content = await readFile(`${entry.parentPath}/${entry.name}`, 'utf8');
+ assert.doesNotMatch(
+ content,
+ /HC_TEST_ONLY_|createRelayHarness|createStaticHarness|installControlledProvider/
+ );
+ }
+});
diff --git a/web/tests/e2e/bootstrap.spec.ts b/web/tests/e2e/bootstrap.spec.ts
@@ -0,0 +1,101 @@
+import { test, expect } from '@playwright/test';
+import { createRelayHarness } from '../integration/harness/relay.ts';
+import { createStaticHarness } from '../integration/harness/static.ts';
+import { installControlledProvider } from './harness/provider.ts';
+
+test('actual browser loads guest shell without an extension', async ({
+ browser
+}) => {
+ const server = await createStaticHarness();
+ const context = await browser.newContext();
+ try {
+ await context.route('**/*', (route) =>
+ new URL(route.request().url()).origin === server.url
+ ? route.continue()
+ : route.abort()
+ );
+ const page = await context.newPage();
+ await page.goto(server.url);
+ await expect(
+ page.getByRole('heading', { name: 'HarvestCircle' })
+ ).toBeVisible();
+ await expect(page).toHaveTitle('HarvestCircle');
+ expect(await page.evaluate(() => 'nostr' in window)).toBe(false);
+ console.log(`Controlled browser version: ${browser.version()}`);
+ } finally {
+ await context.close();
+ await server.close();
+ }
+ expect(context.pages()).toHaveLength(0);
+ expect(server.state()).toEqual({ listening: false, childProcesses: 0 });
+});
+
+test('controlled provider and actual loopback socket are isolated and torn down', async ({
+ browser
+}) => {
+ const server = await createStaticHarness();
+ const relay = await createRelayHarness();
+ const context = await browser.newContext();
+ try {
+ await installControlledProvider(context);
+ await context.route('**/*', (route) =>
+ new URL(route.request().url()).origin === server.url
+ ? route.continue()
+ : route.abort()
+ );
+ const page = await context.newPage();
+ await page.goto(server.url);
+ await expect(
+ page.getByRole('heading', { name: 'HarvestCircle' })
+ ).toBeVisible();
+ const result = await page.evaluate(async (url) => {
+ const provider = (
+ window as unknown as {
+ nostr: {
+ fixture: string;
+ getPublicKey(): Promise<string>;
+ signEvent(): Promise<never>;
+ };
+ }
+ ).nostr;
+ let signingRejected = false;
+ try {
+ await provider.signEvent();
+ } catch {
+ signingRejected = true;
+ }
+ const reply = await new Promise<string>((resolve, reject) => {
+ const socket = new WebSocket(url);
+ socket.onopen = () =>
+ socket.send(JSON.stringify(['REQ', 'browser', {}]));
+ socket.onmessage = (event: MessageEvent<string>) => resolve(event.data);
+ socket.onerror = () => reject(new Error('Loopback socket failed'));
+ });
+ return {
+ fixture: provider.fixture,
+ publicKey: await provider.getPublicKey(),
+ signingRejected,
+ reply
+ };
+ }, relay.url);
+ expect(result).toEqual({
+ fixture: 'HC_TEST_ONLY_PROVIDER',
+ publicKey: '11'.repeat(32),
+ signingRejected: true,
+ reply: '["EOSE","browser"]'
+ });
+ expect(relay.state().subscriptions).toBe(1);
+ } finally {
+ await context.close();
+ await relay.close();
+ await server.close();
+ }
+ expect(context.pages()).toHaveLength(0);
+ expect(relay.state()).toEqual({
+ listening: false,
+ connections: 0,
+ subscriptions: 0,
+ childProcesses: 0
+ });
+ expect(server.state()).toEqual({ listening: false, childProcesses: 0 });
+});
diff --git a/web/tests/e2e/harness/provider.ts b/web/tests/e2e/harness/provider.ts
@@ -0,0 +1,16 @@
+import type { BrowserContext } from '@playwright/test';
+
+// HC_TEST_ONLY_PROVIDER: public-only injection; never signs or holds secret keys.
+export async function installControlledProvider(context: BrowserContext) {
+ await context.addInitScript(() => {
+ Object.defineProperty(window, 'nostr', {
+ configurable: true,
+ value: Object.freeze({
+ fixture: 'HC_TEST_ONLY_PROVIDER',
+ getPublicKey: () => Promise.resolve('11'.repeat(32)),
+ signEvent: () =>
+ Promise.reject(new Error('Controlled fixture cannot sign'))
+ })
+ });
+ });
+}
diff --git a/web/tests/integration/harness/relay.ts b/web/tests/integration/harness/relay.ts
@@ -0,0 +1,75 @@
+import { once } from 'node:events';
+import { WebSocketServer, type WebSocket } from 'ws';
+
+// HC_TEST_ONLY_RELAY: minimal framing fixture, not a Nostr implementation.
+export async function createRelayHarness() {
+ const server = new WebSocketServer({
+ host: '127.0.0.1',
+ port: 0,
+ maxPayload: 4096
+ });
+ const subscriptions = new Map<WebSocket, Set<string>>();
+ server.on('connection', (socket) => {
+ const owned = new Set<string>();
+ subscriptions.set(socket, owned);
+ socket.on('close', () => subscriptions.delete(socket));
+ socket.on('message', (bytes) => {
+ try {
+ const buffer = Array.isArray(bytes)
+ ? Buffer.concat(bytes)
+ : Buffer.isBuffer(bytes)
+ ? bytes
+ : Buffer.from(bytes);
+ const frame: unknown = JSON.parse(buffer.toString('utf8'));
+ if (
+ !Array.isArray(frame) ||
+ typeof frame[1] !== 'string' ||
+ frame[1].length > 64
+ )
+ return socket.close(1008, 'invalid fixture frame');
+ if (
+ frame[0] === 'REQ' &&
+ frame.length === 3 &&
+ typeof frame[2] === 'object' &&
+ frame[2] !== null &&
+ !Array.isArray(frame[2])
+ ) {
+ if (owned.size >= 4)
+ return socket.close(1008, 'fixture subscription limit');
+ owned.add(frame[1]);
+ socket.send(JSON.stringify(['EOSE', frame[1]]));
+ } else if (frame[0] === 'CLOSE' && frame.length === 2)
+ owned.delete(frame[1]);
+ else socket.close(1008, 'unsupported fixture frame');
+ } catch {
+ socket.close(1008, 'invalid fixture JSON');
+ }
+ });
+ });
+ await once(server, 'listening');
+ const address = server.address();
+ if (!address || typeof address === 'string')
+ throw new Error('Missing loopback port');
+ return {
+ url: `ws://127.0.0.1:${address.port}`,
+ state: () => ({
+ listening: server.address() !== null,
+ connections: server.clients.size,
+ subscriptions: [...subscriptions.values()].reduce(
+ (total, ids) => total + ids.size,
+ 0
+ ),
+ childProcesses: 0
+ }),
+ async close() {
+ const sockets = [...server.clients];
+ const closed = sockets.map((socket) => once(socket, 'close'));
+ for (const socket of sockets) socket.terminate();
+ await new Promise<void>((resolve, reject) =>
+ server.close((error) => (error ? reject(error) : resolve()))
+ );
+ await Promise.all(closed);
+ subscriptions.clear();
+ }
+ };
+}
diff --git a/web/tests/integration/harness/static.ts b/web/tests/integration/harness/static.ts
@@ -0,0 +1,57 @@
+import { createServer } from 'node:http';
+import { once } from 'node:events';
+import { readFile, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// HC_TEST_ONLY_STATIC_SERVER: exact static files only; no dynamic fallback.
+export async function createStaticHarness() {
+ const root = await realpath(
+ fileURLToPath(new URL('../../../build/', import.meta.url))
+ );
+ const server = createServer((request, response) => {
+ void (async () => {
+ if (request.method !== 'GET') {
+ response.writeHead(405).end();
+ return;
+ }
+ const url = new URL(request.url ?? '/', 'http://127.0.0.1');
+ const requested = decodeURIComponent(url.pathname);
+ const file = await realpath(
+ path.resolve(
+ root,
+ '.' + (requested === '/' ? '/index.html' : requested)
+ )
+ );
+ if (!file.startsWith(root + path.sep)) {
+ response.writeHead(404).end();
+ return;
+ }
+ const types: Record<string, string> = {
+ '.html': 'text/html',
+ '.js': 'text/javascript',
+ '.css': 'text/css',
+ '.json': 'application/json'
+ };
+ response.writeHead(200, {
+ 'content-type': types[path.extname(file)] ?? 'application/octet-stream'
+ });
+ response.end(await readFile(file));
+ })().catch(() => response.writeHead(404).end());
+ });
+ server.listen(0, '127.0.0.1');
+ await once(server, 'listening');
+ const address = server.address();
+ if (!address || typeof address === 'string')
+ throw new Error('Missing loopback port');
+ return {
+ url: `http://127.0.0.1:${address.port}`,
+ state: () => ({ listening: server.listening, childProcesses: 0 }),
+ async close() {
+ server.closeAllConnections();
+ await new Promise<void>((resolve, reject) =>
+ server.close((error) => (error ? reject(error) : resolve()))
+ );
+ }
+ };
+}
diff --git a/web/tests/integration/loopback.test.ts b/web/tests/integration/loopback.test.ts
@@ -0,0 +1,48 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { once } from 'node:events';
+import WebSocket from 'ws';
+import { createRelayHarness } from './harness/relay.ts';
+import { createStaticHarness } from './harness/static.ts';
+
+await test('real loopback REQ/CLOSE and active teardown release owned resources', async () => {
+ const relay = await createRelayHarness();
+ const socket = new WebSocket(relay.url);
+ try {
+ await once(socket, 'open');
+ let reply = once(socket, 'message');
+ socket.send(JSON.stringify(['REQ', 'first', {}]));
+ assert.deepEqual(JSON.parse(String((await reply)[0])), ['EOSE', 'first']);
+ assert.equal(relay.state().subscriptions, 1);
+ socket.send(JSON.stringify(['CLOSE', 'first']));
+ reply = once(socket, 'message');
+ socket.send(JSON.stringify(['REQ', 'second', {}]));
+ await reply; // Ordered frames prove CLOSE removed first before REQ second.
+ assert.equal(relay.state().subscriptions, 1);
+ } finally {
+ const closed = once(socket, 'close');
+ await relay.close();
+ await closed;
+ }
+ assert.deepEqual(relay.state(), {
+ listening: false,
+ connections: 0,
+ subscriptions: 0,
+ childProcesses: 0
+ });
+ assert.equal(socket.readyState, WebSocket.CLOSED);
+});
+
+await test('loopback static fixture serves actual output and closes its listener', async () => {
+ const server = await createStaticHarness();
+ try {
+ const result = await fetch(server.url);
+ assert.equal(result.status, 200);
+ assert.match(await result.text(), /<h1>HarvestCircle<\/h1>/);
+ assert.equal((await fetch(`${server.url}/missing.js`)).status, 404);
+ } finally {
+ await server.close();
+ }
+ assert.deepEqual(server.state(), { listening: false, childProcesses: 0 });
+ await assert.rejects(fetch(server.url));
+});