redefined-designs/frontend/tests/e2e/fixtures.ts

import { test as base, APIRequestContext, expect } from '@playwright/test';
import { mkdirSync, writeFileSync } from 'fs';
import { randomUUID } from 'crypto';
import path from 'path';
import { Header } from './pages/Header';
import { AuthModal } from './pages/AuthModal';
import { AccountModal } from './pages/AccountModal';
import { StorefrontPage } from './pages/StorefrontPage';
import { AdminPage } from './pages/AdminPage';
import { PasswordResetPages } from './pages/PasswordResetPages';
import { uniqueEmail } from './support/api';

// Re-exported so specs can import everything from here — expect, Page,
// APIRequestContext — and get the coverage-collecting `test` at the same time.
// The explicit `test` below wins over the star export.
export * from '@playwright/test';
export * from './support/api';

const NYC_OUTPUT = path.resolve(__dirname, '..', '..', '.nyc_output');
const collectingCoverage = process.env.COVERAGE === 'true';

// Set once any page reports instrumentation. Checked by the collection script so
// an empty run fails loudly instead of publishing 0% — see the note below.
const MARKER = path.join(NYC_OUTPUT, '.collected');

/** The password every seeded customer gets. Long enough to pass the 8-char rule. */
export const PASSWORD = 'supersecret123';

export interface RegisteredCustomer {
  email: string;
  password: string;
  firstName: string;
  lastName: string;
}

interface Pages {
  header: Header;
  authModal: AuthModal;
  accountModal: AccountModal;
  storefront: StorefrontPage;
  admin: AdminPage;
  passwordReset: PasswordResetPages;
}

interface Data {
  /**
   * A request context for the admin API, on the configured baseURL.
   *
   * Specs used to build their own with `playwright.request.newContext(...)`, one
   * of them against a hardcoded `http://localhost:5173`, which meant changing
   * the port in the config moved every test except that one.
   */
  adminApi: APIRequestContext;
  /**
   * A freshly registered customer, already signed in on `page`.
   *
   * Registering through the API rather than the form, deliberately. Nine specs
   * drove the registration form purely to arrive at a signed-in session, so a
   * broken form failed a hundred tests that were not about it — and each paid
   * for a bcrypt round-trip through the UI. The specs that are about
   * registration use `authModal` and drive it properly.
   *
   * `page.request` shares the browser context's cookie jar, so the session
   * cookie the endpoint sets belongs to `page`. The caller still has to
   * navigate: the session exists, but a page loaded before it does not know.
   */
  customer: RegisteredCustomer;
}

/**
 * Flushes istanbul's per-page counters after each test.
 *
 * Coverage lives in `window.__coverage__` on the page and dies with it, so it
 * has to be read before the page closes — one file per test, because the suite
 * runs fullyParallel and workers would otherwise overwrite each other.
 */
export const test = base.extend<Pages & Data & { collectCoverage: void }>({
  header: async ({ page }, use) => {
    await use(new Header(page));
  },
  authModal: async ({ page }, use) => {
    await use(new AuthModal(page));
  },
  accountModal: async ({ page }, use) => {
    await use(new AccountModal(page));
  },
  storefront: async ({ page }, use) => {
    await use(new StorefrontPage(page));
  },
  admin: async ({ page }, use) => {
    await use(new AdminPage(page));
  },
  passwordReset: async ({ page }, use) => {
    await use(new PasswordResetPages(page));
  },

  adminApi: async ({ playwright, baseURL }, use) => {
    const context = await playwright.request.newContext({ baseURL });
    await use(context);
    await context.dispose();
  },

  customer: async ({ page }, use) => {
    const details: RegisteredCustomer = {
      email: uniqueEmail(),
      password: PASSWORD,
      firstName: 'Test',
      lastName: 'Customer'
    };

    const res = await page.request.post('/api/customers/register', {
      data: {
        email: details.email,
        password: details.password,
        firstName: details.firstName,
        lastName: details.lastName,
        marketingConsent: false
      }
    });
    // Loudly, and naming the address: a failure here is a fixture failing to
    // build, and every assertion after it would fail for a reason that has
    // nothing to do with what the test is about.
    expect(res.ok(), `registering ${details.email}`).toBeTruthy();

    await use(details);
  },

  collectCoverage: [
    async ({ page }, use) => {
      await use();

      if (!collectingCoverage) return;

      // The page may already be closed by a test that navigated away or crashed;
      // a missing sample is not worth failing a passing test over. The run-level
      // check catches the case that actually matters — no samples at all.
      const coverage = await page
        .evaluate(() => (window as unknown as { __coverage__?: unknown }).__coverage__)
        .catch(() => undefined);

      if (!coverage) return;

      mkdirSync(NYC_OUTPUT, { recursive: true });
      writeFileSync(path.join(NYC_OUTPUT, `${randomUUID()}.json`), JSON.stringify(coverage));
      writeFileSync(MARKER, 'ok');
    },
    { auto: true }
  ]
});