playwright.config.ts

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

/**
 * Playwright configuration for E2E web tests
 *
 * See https://playwright.dev/docs/test-configuration
 */
export default defineConfig({
  testDir: "./test-e2e",

  // Maximum time one test can run (longer for CI to handle slower environments)
  timeout: process.env.CI ? 60 * 1000 : 30 * 1000,

  // Maximum time to wait for expect() assertions
  expect: {
    timeout: process.env.CI ? 15 * 1000 : 10 * 1000,
  },

  // Test execution settings
  fullyParallel: false, // Run serially to avoid resource contention
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 2 : 0,
  workers: 1, // Single worker for stability

  // Reporter configuration - use multiple reporters in CI
  reporter: process.env.CI
    ? [["github"], ["html", { open: "never" }]]
    : [["list"], ["html", { open: "on-failure" }]],

  // Shared settings for all projects
  use: {
    // Base URL for the app — override with BASE_URL env var to target a
    // deployed preview (e.g. Cloudflare Pages) instead of the local server.
    baseURL: process.env.BASE_URL ?? "http://127.0.0.1:8080",

    // Collect trace on failure for debugging
    trace: "on-first-retry",

    // Take screenshots on failure
    screenshot: "only-on-failure",

    // Record video on first retry (helps debug flaky tests)
    video: "retain-on-failure",

    // Navigation timeout (longer for CI to handle API calls and Flutter initialization)
    navigationTimeout: process.env.CI ? 45 * 1000 : 15 * 1000,

    // Action timeout (clicks, fills, etc.)
    actionTimeout: process.env.CI ? 15 * 1000 : 10 * 1000,
  },

  // Test projects for different browsers
  projects: [
    {
      name: "chromium",
      use: { ...devices["Desktop Chrome"] },
    },
    // Uncomment to test on additional browsers
    // {
    //   name: 'firefox',
    //   use: { ...devices['Desktop Firefox'] },
    // },
    // {
    //   name: 'webkit',
    //   use: { ...devices['Desktop Safari'] },
    // },
  ],

  // Note: webServer is NOT used here because CI needs more control
  // over the http-server lifecycle. Instead:
  // 1. CI starts http-server in the background
  // 2. Tests run
  // 3. CI stops http-server
  //
  // For local development, start the server manually:
  // npm run serve:web
});