import { defineConfig, devices } from '@playwright/test';

/**
 * Playwright E2E config for Sencho.
 *
 * Before running: ensure both dev servers are up:
 *   cd backend && npm run dev &
 *   cd frontend && npm run dev &
 *
 * Or use the webServer config below (which starts them automatically).
 */
export default defineConfig({
  testDir: './e2e',
  // Don't stop on first failure - show all results
  maxFailures: 0,
  // How long to wait for a single test
  timeout: 30_000,
  // How long to wait for an expect() assertion
  expect: { timeout: 5_000 },
  // Run tests serially - Sencho is a single-user app and tests share DB state
  workers: 1,
  // Retry only in CI: the deploy/health-gate specs drive real Docker container
  // runs, so image-pull and gate-window timing varies on shared runners. A retry
  // absorbs the transient blip; trace: 'on-first-retry' captures the retried run.
  retries: process.env.CI ? 2 : 0,
  reporter: [['list'], ['html', { outputFolder: 'e2e/report', open: 'never' }]],

  use: {
    baseURL: 'http://localhost:5173',
    // Persist auth state between tests in the same file
    storageState: undefined,
    trace: 'on-first-retry',
    screenshot: 'only-on-failure',
  },

  projects: [
    {
      // Default project (what CI runs via --project=chromium). Skips the manual
      // screenshot capture spec and the visual-regression gate: the gate needs
      // committed, platform-matched baselines and runs in its own job, so it
      // must not fail the functional E2E run on a missing snapshot.
      name: 'chromium',
      use: { ...devices['Desktop Chrome'] },
      testIgnore: ['**/screenshots.spec.ts', '**/desktop-visual-regression.spec.ts'],
    },
    {
      // Desktop-unchanged visual gate. Run explicitly (and in the dedicated
      // Visual Regression workflow):
      //   npx playwright test --project=visual
      // Baselines are platform-specific; regenerate with --update-snapshots in
      // the same environment you compare in (locally, or the workflow's
      // Playwright container for the CI baselines).
      name: 'visual',
      use: { ...devices['Desktop Chrome'] },
      testMatch: ['**/desktop-visual-regression.spec.ts'],
    },
    {
      // Manual-only project for capturing docs/images/. Run explicitly:
      //   npx playwright test --project=screenshots
      name: 'screenshots',
      use: { ...devices['Desktop Chrome'] },
      testMatch: ['**/screenshots.spec.ts'],
    },
  ],
});