feca-mailshots-plugin/tests/e2e/README.md

Browser E2E (Playwright)

This suite runs browser-based smoke/regression coverage against fixture-hosted admin UI (tests/fixture/wp-admin/*).

Run

tests/e2e/run.sh

Or manually:

scripts/run_fixture_server.sh start
npm install
npx playwright install chromium
E2E_BASE_URL=http://127.0.0.1:8092 npx playwright test

Remote admin mode (uses credentials/.env E2E_REMOTE_ADMIN* vars):

E2E_REMOTE_ADMIN=1 tests/e2e/run.sh

Specs

• admin-ui-smoke.spec.mjs
  • page-load smoke for Data Sources, Mailshots, Attachments, PDF Assets.
• data-sources.spec.mjs
  • modal create flow, preview regression guard (contacts and accounts), validation failure path.
• mailshots-editor.spec.mjs
  • datasource-driven token/field population, message/PDF overlay editor flows, create mailshot.
• run-test-pages.spec.mjs
  • Run/Test page load checks and API failure-path assertions (run_mailshot invalid id, send_test blank email).
• download-pdf-renewal.spec.mjs
  • Optional live-data e2e for renewal_accounts_with_contacts + formats/renewals_v4.html, asserts merged and ZIP downloads both succeed.

Renewal Dataset E2E

Run this targeted dataset test with:

E2E_RENEWAL_ENABLE=1 \
E2E_RENEWAL_DATASOURCE=renewal_accounts_with_contacts \
E2E_BASE_URL=http://127.0.0.1:8092 \
npx playwright test tests/e2e/specs/download-pdf-renewal.spec.mjs

Notes

• Tests clean up created Data Source/Mailshot artefacts.
• This suite is intended as a pre-manual gate before release/deploy.