app

Local-first trade for farms and co-ops
git clone https://radroots.dev/git/app.git
Log | Files | Refs | README | LICENSE

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:
Mweb/.prettierignore | 2++
Mweb/eslint.config.js | 10+++++++++-
Mweb/package.json | 10++++++++--
Aweb/playwright.config.ts | 12++++++++++++
Mweb/pnpm-lock.yaml | 70++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Aweb/tests/conformance/static.test.ts | 23+++++++++++++++++++++++
Aweb/tests/e2e/bootstrap.spec.ts | 101+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Aweb/tests/e2e/harness/provider.ts | 16++++++++++++++++
Aweb/tests/integration/harness/relay.ts | 75+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Aweb/tests/integration/harness/static.ts | 57+++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Aweb/tests/integration/loopback.test.ts | 48++++++++++++++++++++++++++++++++++++++++++++++++
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)); +});