AngelGalindo7 · AdrianOlm1 · Jun 26, 2026 · Jun 24, 2026 · Jun 24, 2026 · Jun 24, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -25,3 +25,9 @@ jobs:
 
       - name: Run unit tests
         run: npm test
+
+      - name: Install Playwright browsers
+        run: npx playwright install chromium --with-deps
+
+      - name: Integration smoke
+        run: PUPPETEER_SKIP_DOWNLOAD=true npx vitest run --config vitest.smoke.config.mjs tests/smoke/integration.test.mjs
diff --git a/package-lock.json b/package-lock.json
diff --git a/tests/fixture/about.html b/tests/fixture/about.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>About</title>
+</head>
+<body>
+  <h1>About</h1>
+  <p>This is the about page for the integration fixture.</p>
+  <a href="/index.html">Back to home</a>
+</body>
+</html>
diff --git a/tests/fixture/error.html b/tests/fixture/error.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>Error Fixture</title>
+</head>
+<body>
+  <h1>Error page</h1>
+  <script>window.addEventListener('load', function() { throw new Error('test-pageerror'); });</script>
+</body>
+</html>
diff --git a/tests/fixture/index.html b/tests/fixture/index.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>Fixture Index</title>
+</head>
+<body>
+  <nav>
+    <a href="/about.html">About</a>
+    <a href="/error.html">Error page</a>
+  </nav>
+
+  <button aria-label="Primary action">Do something</button>
+  <button aria-label="Secondary action">Do something else</button>
+
+  <label for="search-input">Search</label>
+  <input id="search-input" type="text" name="q" />
+
+  <form action="#" method="post">
+    <label for="email-input">Email</label>
+    <input id="email-input" type="email" name="email" />
+    <button type="submit">Submit</button>
+  </form>
+</body>
+</html>
diff --git a/tests/smoke/fixture-server.mjs b/tests/smoke/fixture-server.mjs
@@ -0,0 +1,48 @@
+import http from 'http'
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const FIXTURE_DIR = path.join(__dirname, '..', 'fixture')
+
+export async function startFixtureServer(port = 0) {
+  const server = http.createServer((req, res) => {
+    // Strip query string and normalise to a file path
+    const urlPath = req.url.split('?')[0]
+    const relPath = urlPath === '/' ? 'index.html' : urlPath.replace(/^\//, '')
+    const filePath = path.join(FIXTURE_DIR, relPath)
+
+    // Prevent directory traversal outside FIXTURE_DIR
+    if (!filePath.startsWith(FIXTURE_DIR)) {
+      res.writeHead(403, { 'Content-Type': 'text/plain' })
+      res.end('Forbidden')
+      return
+    }
+
+    fs.readFile(filePath, (err, data) => {
+      if (err) {
+        res.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' })
+        res.end('<html><body><h1>404 Not Found</h1></body></html>')
+        return
+      }
+      const contentType = filePath.endsWith('.html')
+        ? 'text/html; charset=utf-8'
+        : 'application/octet-stream'
+      res.writeHead(200, { 'Content-Type': contentType })
+      res.end(data)
+    })
+  })
+
+  return new Promise((resolve, reject) => {
+    server.listen(port, '127.0.0.1', () => {
+      const { port: assignedPort } = server.address()
+      resolve({ server, url: `http://127.0.0.1:${assignedPort}` })
+    })
+    server.on('error', reject)
+  })
+}
+
+export function stopFixtureServer(server) {
+  return new Promise(resolve => server.close(resolve))
+}
diff --git a/tests/smoke/integration.test.mjs b/tests/smoke/integration.test.mjs
@@ -0,0 +1,83 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest'
+import { chromium } from 'playwright'
+import { startFixtureServer, stopFixtureServer } from './fixture-server.mjs'
+import { pruneLayout } from '../../src/perception/a11yTree.js'
+
+let fixtureServer, fixtureUrl
+
+beforeAll(async () => {
+  const result = await startFixtureServer()
+  fixtureServer = result.server
+  fixtureUrl = result.url
+}, 30000)
+
+afterAll(async () => {
+  if (fixtureServer) await stopFixtureServer(fixtureServer)
+})
+
+// Playwright 1.44+ removed page.accessibility; use CDP to get the AX tree and
+// pipe through pruneLayout from a11yTree.js to exercise the same snapshot path.
+async function snapshotViaPlaywright(browser, page) {
+  const context = page.context()
+  const cdp = await context.newCDPSession(page)
+  const { nodes } = await cdp.send('Accessibility.getFullAXTree')
+  await cdp.detach()
+
+  // Build a minimal role/name tree compatible with pruneLayout's input shape
+  const nodeMap = new Map(nodes.map(n => [n.nodeId, n]))
+  function build(node) {
+    if (!node) return null
+    return {
+      role: node.role?.value ?? 'generic',
+      name: node.name?.value ?? '',
+      children: (node.childIds ?? []).map(id => build(nodeMap.get(id))).filter(Boolean),
+    }
+  }
+  const root = nodes[0]
+  return pruneLayout(build(root))
+}
+
+describe('integration smoke', () => {
+  it('crawls clean fixture without fatal error', async () => {
+    const browser = await chromium.launch({ headless: true })
+    const pageErrors = []
+
+    try {
+      const context = await browser.newContext()
+      const page = await context.newPage()
+      page.on('pageerror', e => pageErrors.push(e.message))
+
+      await page.goto(fixtureUrl, { waitUntil: 'domcontentloaded' })
+
+      const snapshot = await snapshotViaPlaywright(browser, page)
+
+      expect(snapshot).not.toBeNull()
+      expect(typeof snapshot).toBe('object')
+      expect(snapshot).toHaveProperty('role')
+
+      await page.goto(fixtureUrl + '/about.html', { waitUntil: 'domcontentloaded' })
+      expect(pageErrors.filter(m => m.includes('500'))).toHaveLength(0)
+    } finally {
+      await browser.close()
+    }
+  }, 20000)
+
+  it('detects JS error on error.html via PAGEERROR signal', async () => {
+    const browser = await chromium.launch({ headless: true })
+    const pageErrors = []
+
+    try {
+      const context = await browser.newContext()
+      const page = await context.newPage()
+      page.on('pageerror', e => pageErrors.push(e.message))
+
+      await page.goto(fixtureUrl + '/error.html', { waitUntil: 'domcontentloaded' })
+      await page.waitForTimeout(500)
+
+      expect(pageErrors.length).toBeGreaterThan(0)
+      expect(pageErrors[0]).toContain('test-pageerror')
+    } finally {
+      await browser.close()
+    }
+  }, 20000)
+})
diff --git a/vitest.smoke.config.mjs b/vitest.smoke.config.mjs
@@ -0,0 +1,10 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    include: ['tests/smoke/**/*.test.mjs'],
+    environment: 'node',
+    testTimeout: 30000,
+    reporters: ['default'],
+  },
+});