ui/e2e/tests/wire_contract.e2e.ts

import { test, expect } from '@playwright/test'

// AZ-459 / FT-P-06 e2e — detection wire payload uses spec enum values for
// affiliation and combatReadiness against the real annotations/ + detect/
// services. Profile: e2e (gated by docker compose stack).
//
// The fast counterpart (tests/wire_contract.test.ts) asserts the typed enum
// SHAPES; the e2e half asserts the actual outbound POST body when the SPA
// triggers an annotation save (the wire-format contract per AC-04).
//
// Enum value sets pinned in _docs/00_problem/input_data/enum_spec_snapshot.json.

const ALICE_EMAIL = 'op_alice@test.local'
const ALICE_PASSWORD = 'TestPassword!23'

// Pinned per snapshot (not currently met by the UI — see ui_drift_summary).
// The e2e test asserts the payload uses values FROM these spec sets. When
// the UI is fixed (Step 4), the test stays green; today the test fails with
// the documented drift, so we tag the wire-format scenarios `@drift` so the
// runner can downgrade them to documentary while QUARANTINEd.
const SPEC_AFFILIATION_VALUES = new Set([0, 10, 20, 30])
const SPEC_ANNOTATION_STATUS_VALUES = new Set([0, 10, 20, 30, 40])

test.describe('AZ-459 e2e — wire-contract enum values @drift', () => {
  test.skip(
    process.env.AZAION_RUN_DRIFT_E2E !== '1',
    'QUARANTINE: enum drift documented (ui_drift_summary in enum_spec_snapshot.json); ' +
      'set AZAION_RUN_DRIFT_E2E=1 to exercise the assertion against today\'s drifted UI ' +
      '(expect failure until Step 4 lifts the drift on src/types/index.ts).',
  )

  test('FT-P-06 (rows 18, 19): annotation save body uses spec affiliation + status values', async ({ page }) => {
    // Arrange — log in.
    await page.goto('/login')
    await page.getByLabel(/email/i).fill(ALICE_EMAIL)
    await page.getByLabel(/password/i).fill(ALICE_PASSWORD)
    await page.getByRole('button', { name: /sign in/i }).click()
    await page.waitForLoadState('networkidle')

    // Capture the next /api/annotations/annotations POST body.
    const savePromise = page.waitForRequest(
      (req) =>
        req.url().includes('/api/annotations/annotations') &&
        req.method() === 'POST',
    )

    // Trigger an annotation save through the UI. The actual flow depends on
    // the seeded fixtures; this test relies on the AnnotationsPage save
    // button being reachable from a logged-in op_alice session.
    await page.goto('/annotations')
    await page.getByRole('button', { name: /save/i }).first().click()

    const saveReq = await savePromise
    const body = saveReq.postDataJSON() as { status?: number; detections?: Array<{ affiliation?: number }> }

    // Assert
    if (typeof body.status === 'number') {
      expect(SPEC_ANNOTATION_STATUS_VALUES.has(body.status)).toBe(true)
    }
    for (const det of body.detections ?? []) {
      if (typeof det.affiliation === 'number') {
        expect(SPEC_AFFILIATION_VALUES.has(det.affiliation)).toBe(true)
      }
    }
  })
})