explorer-monorepo/scripts/e2e-full-stack.spec.ts

import { expect, test, type Page } from '@playwright/test'
import { mkdirSync } from 'node:fs'
import path from 'node:path'

// e2e-full-stack.spec.ts
//
// Playwright spec that exercises the golden-path behaviours of the
// explorer against a *locally booted* backend + frontend, rather than
// against the production deploy that `e2e-explorer-frontend.spec.ts`
// targets. `make e2e-full` stands up the stack, points this spec at
// it via EXPLORER_URL / EXPLORER_API_URL, and tears it down afterwards.
//
// The spec intentionally sticks to Track-1 (public, no auth) routes so
// it can run without provisioning wallet credentials in CI. Track 2-4
// behaviours are covered by the Go and unit-test layers.

const EXPLORER_URL = process.env.EXPLORER_URL || 'http://localhost:3000'
const EXPLORER_API_URL = process.env.EXPLORER_API_URL || 'http://localhost:8080'
const SCREENSHOT_DIR = process.env.E2E_SCREENSHOT_DIR || 'test-results/screenshots'

mkdirSync(SCREENSHOT_DIR, { recursive: true })

async function snapshot(page: Page, name: string) {
  const file = path.join(SCREENSHOT_DIR, `${name}.png`)
  await page.screenshot({ path: file, fullPage: true })
}

async function expectHeading(page: Page, name: RegExp) {
  await expect(page.getByRole('heading', { name })).toBeVisible({ timeout: 15000 })
}

test.describe('Explorer full-stack smoke', () => {
  test('backend /healthz responds 200', async ({ request }) => {
    const response = await request.get(`${EXPLORER_API_URL}/healthz`)
    expect(response.status()).toBeLessThan(500)
  })

  for (const route of [
    { path: '/', heading: /SolaceScan/i, name: 'home' },
    { path: '/blocks', heading: /^Blocks$/i, name: 'blocks' },
    { path: '/transactions', heading: /^Transactions$/i, name: 'transactions' },
    { path: '/addresses', heading: /^Addresses$/i, name: 'addresses' },
    { path: '/tokens', heading: /^Tokens$/i, name: 'tokens' },
    { path: '/pools', heading: /^Pools$/i, name: 'pools' },
    { path: '/search', heading: /^Search$/i, name: 'search' },
    { path: '/wallet', heading: /Wallet & MetaMask/i, name: 'wallet' },
    { path: '/routes', heading: /Route/i, name: 'routes' },
  ]) {
    test(`frontend route ${route.path} renders`, async ({ page }) => {
      await page.goto(`${EXPLORER_URL}${route.path}`, {
        waitUntil: 'domcontentloaded',
        timeout: 30000,
      })
      await expectHeading(page, route.heading)
      await snapshot(page, route.name)
    })
  }

  test('access products endpoint is reachable', async ({ request }) => {
    // Covers the YAML-backed catalogue wired up in PR #7. The endpoint
    // is public (lists available RPC products) so no auth is needed.
    const response = await request.get(`${EXPLORER_API_URL}/api/v1/access/products`)
    expect(response.status()).toBe(200)
    const body = await response.json()
    expect(Array.isArray(body.products)).toBe(true)
    expect(body.products.length).toBeGreaterThanOrEqual(3)
  })

  test('auth nonce endpoint issues a nonce', async ({ request }) => {
    // Covers wallet auth kickoff: /api/v1/auth/nonce must issue a
    // fresh nonce even without credentials. This is Track-1-safe.
    const response = await request.post(`${EXPLORER_API_URL}/api/v1/auth/nonce`, {
      data: { address: '0x4A666F96fC8764181194447A7dFdb7d471b301C8' },
    })
    expect(response.status()).toBe(200)
    const body = await response.json()
    expect(typeof body.nonce === 'string' && body.nonce.length > 0).toBe(true)
  })
})