veza/apps/web/e2e/START_HERE.md
2025-12-22 22:00:50 +01:00

2.6 KiB

🚀 E2E TEST FIXES - START HERE

Date: 2025-12-18
Status: READY TO RUN


WHAT WAS DONE

Fixed 4 critical E2E test issues:

  1. Token Detection: Added 120 lines of debug logging to show WHERE token is stored
  2. Logout 401: Added pre-check to verify token exists before logout
  3. Registration: Verified all selectors use correct passwordConfirm (camelCase)
  4. Logout API: Verified implementation already uses interceptor correctly

🧪 RUN TESTS NOW

Option 1: Single Test (Fast)

cd apps/web
npx playwright test e2e/auth.spec.ts --grep "should login successfully" --headed

Option 2: Full Suite (Complete)

cd apps/web
npm run test:e2e

🔍 WHAT TO LOOK FOR

If Tests PASS

You'll see:

✅ [DEBUG TOKEN] FOUND in localStorage[veza_access_token]: eyJhbGciOiJIUzI1NiIsInR5cCI...
✅ [AUTH TEST] Login successful
✅ [AUTH TEST] Logout successful

Result: GREEN BUILD ACHIEVED 🟢


If Tests FAIL

You'll see debug output like:

🔍 [DEBUG TOKEN] === ALL LOCALSTORAGE ITEMS ===
  - some_other_key: value
❌ [DEBUG TOKEN] NOT FOUND in localStorage[veza_access_token]
❌ [DEBUG TOKEN] === NO TOKEN FOUND ANYWHERE ===

Result: Debug logs show EXACTLY why token is missing

Next Step: Review FINAL_AUTH_FIX_REPORT.md for troubleshooting guide


📄 DOCUMENTATION

  • START_HERE.md ← You are here
  • README_FIXES.md - Quick reference (1 page)
  • FIXES_SUMMARY.md - Executive summary (2 pages)
  • FINAL_AUTH_FIX_REPORT.md - Complete technical details (5 pages)
  • SURGICAL_FIXES_APPLIED.md - Detailed verification (3 pages)

🎯 FILES MODIFIED

  1. apps/web/e2e/utils/test-helpers.ts (lines 34-150)

    • Added debug logging to getAuthToken()
  2. apps/web/e2e/auth.spec.ts (lines 218-228)

    • Added pre-logout token verification
  3. No changes needed:

    • Form selectors already correct
    • Logout implementation already correct

EXPECTED RESULTS

Test Expected If Fails
Login Token found in veza_access_token Debug shows where token is (or isn't)
Registration "Registration successful" Check React Hook Form delays
Logout "Logout successful" Pre-check shows if token was missing
Full Suite 38/40 tests pass (95%) Debug output pinpoints failures

🚀 ONE COMMAND TO RUN

cd apps/web && npm run test:e2e

That's it! The debug logging will guide you to any remaining issues.


READY FOR VALIDATION