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

/**
 * Run `npx playwright install` to download the browsers.
 * See https://playwright.dev/docs/test-configuration.
 */
/** Specs that mock the API in the browser; see the "synthetic" project. */
const SYNTHETIC_SPECS = [
    /assistant-streaming\.spec\.ts/,
    /tabular-chat-lifecycle\.spec\.ts/,
    /settings-search-latency\.spec\.ts/,
];

export default defineConfig({
    testDir: "./e2e",
    /* Every parallel worker signs in as its OWN user (worker 0 is the
       historical e2e@mike.local; see workerAccount() in e2e/users.ts and the
       worker fixture in e2e/fixtures.ts), so workers never share project,
       chat or workflow lists or a session. Files still run one test at a time
       within a worker: several specs build on state created earlier in the
       same file. Locally the default stays at one worker because `next dev`
       compiles routes on demand; CI passes --workers against a production
       build (.github/workflows/e2e.yml). E2E_WORKERS overrides both. */
    fullyParallel: false,
    workers: process.env.E2E_WORKERS ? Number(process.env.E2E_WORKERS) : 1,
    timeout: process.env.REACT_STRESS === "1" ? 90_000 : 30_000,
    /* Fail the build on CI if you accidentally left test.only in the source */
    forbidOnly: !!process.env.CI,
    /* Playwright's assertion default is 5s, which is tight for this app's first
       paint after a cold Next.js dev compile — so nearly every expect() in the
       suite hand-rolled its own `{ timeout: 10_000 }`. Make that the project
       default: new assertions inherit it, and only genuinely slower waits need
       to spell out an override. */
    expect: { timeout: 10_000 },
    /* Stress failures must remain failures even if their timing is intermittent. */
    retries: process.env.REACT_STRESS === "1" ? 0 : process.env.CI ? 2 : 0,
    /* Reporter. On CI, "github" alone would REPLACE Playwright's default html
       reporter, so playwright-report/ would never be written and the workflow's
       artifact upload (docs/e2e-ci.md, "Failure artifacts") would have nothing
       to ship. Include annotations, per-test progress and the HTML report;
       `open: "never"` stops the reporter from trying to launch a
       browser on the CI box after the run. */
    reporter: process.env.CI
        ? [["github"], ["list"], ["html", { open: "never" }]]
        : "list",
    /* Shared settings for all the projects below */
    use: {
        baseURL: process.env.PLAYWRIGHT_BASE_URL ?? "http://localhost:3000",
        video: process.env.PW_VIDEO === "1"
            ? { mode: "on", size: { width: 1280, height: 720 } }
            : "off",
        trace: process.env.REACT_STRESS === "1" ? "retain-on-failure" : "on-first-retry",
        screenshot: "only-on-failure",
    },

    projects: [
        /* Run the auth setup before all other tests */
        {
            name: "setup",
            testMatch: /auth\.setup\.ts/,
        },

        {
            name: "chromium",
            use: { ...devices["Desktop Chrome"] },
            testIgnore: SYNTHETIC_SPECS,
            dependencies: ["setup"],
        },

        /* Specs that mock every /api call inside the browser and need no
           backend, database or account. Kept in their own project so CI can
           run them on runners that skip the Supabase/API stack, and fully
           parallel because nothing is shared between their tests. */
        {
            name: "synthetic",
            use: { ...devices["Desktop Chrome"] },
            testMatch: SYNTHETIC_SPECS,
            fullyParallel: true,
        },
    ],

    /* Start the backend and the Next.js dev server when running locally.
       The backend command first runs the local-stack setup (Docker check,
       supabase start, schema + migrations + grants, env wiring) so a plain
       `npm run test:e2e` works against a ready local Supabase — see
       scripts/e2e-local-stack.sh. Idempotent: a few seconds when already up. */
    webServer: process.env.CI
        ? undefined
        : [
              {
                  command:
                      "bash ../scripts/e2e-local-stack.sh --setup-only && npm run dev",
                  cwd: "backend",
                  // Failures a browser test provokes are not community bug
                  // reports; CI sets the same (see .github/workflows/e2e.yml).
                  env: { ...process.env, SENTRY_DISABLED: "true" },
                  url: "http://localhost:3001/health",
                  reuseExistingServer: true,
                  timeout: 120_000,
              },
              {
                  command: "npm run dev",
                  cwd: "frontend",
                  env: {
                      ...process.env,
                      SENTRY_DISABLED: "true",
                      NEXT_PUBLIC_SENTRY_DISABLED: "true",
                  },
                  url: "http://localhost:3000",
                  reuseExistingServer: true,
                  timeout: 120_000,
              },
          ],
});