test: Add comprehensive test suites for issues #896-899

[maugauwi-hash]

Test Implementation for SwiftRemit Issues 896-899

Summary

This PR adds comprehensive test suites for four high-priority issues across the frontend. Each issue gets its own dedicated test file with full coverage of acceptance criteria.

Issues Addressed

Issue 896: ProofOfPayout File Upload with SHA-256 Hashing

• File upload support for images (PNG, JPEG, GIF) and PDFs
• Client-side SHA-256 hashing of uploaded files
• Hash submission to contract via confirm_payout
• File type validation
• File preview and drag-and-drop support
• Error handling for upload failures

Test File: ProofOfPayoutFileUpload.test.tsx (345 lines)
Tests: 8 scenarios covering all acceptance criteria

Issue 899: Real-time Toast Notifications for WebSocket Events

• Socket.io integration for remittance status events
• Toast display for completed, failed, and disputed remittances
• Auto-dismiss after 10 seconds with configurable duration
• Manual dismissal with close button
• Pause/resume on hover
• Multiple concurrent toasts
• Connection error handling

Test File: WebSocketToastNotifications.test.tsx (431 lines)
Tests: 10 scenarios covering real-time updates without page refresh

Issue 898: Dispute Resolution UI for Admins

• Resolve modal with outcome dropdown (Favour Sender/Agent/Split)
• Resolution notes field for administrative notes
• Evidence hash display with link to stored proof
• API submission for on-chain and audit log recording
• Confirmation dialog before resolution
• Audit log of resolved disputes
• Form validation and error handling
• Loading state during submission

Test File: DisputeResolutionUI.test.tsx (517 lines)
Tests: 11 scenarios covering complete dispute resolution workflow

Issue 897: 2FA Settings Page for Admin Users

• TOTP enrollment with QR code generation
• 6-digit TOTP code entry and verification
• Backup code generation and storage
• Encrypted TOTP secret storage in database
• 2FA verification step on admin login
• 2FA status display on user profile
• Enable/disable toggle with password confirmation
• Backup code authentication fallback
• Error handling for invalid codes
• Enforcement of 2FA for admin operations

Test File: AdminTwoFactorAuth.test.tsx (613 lines)
Tests: 13 scenarios covering complete 2FA lifecycle

Test Statistics

• Total Test Files: 4
• Total Test Cases: 42
• Total Lines of Test Code: 1,906

Commits

1. 95244b7 - test: Issue 896 - Add file upload tests for ProofOfPayout with SHA-256 hashing
2. d3916b7 - test: Issue 899 - Add WebSocket-driven toast notification tests
3. 4fe68fa - test: Issue 898 - Add dispute resolution UI tests for admins
4. dfd8f18 - test: Issue 897 - Add 2FA settings page tests for admin users

Test Execution

All tests are ready to run with:

npm test

Coverage

• User interactions (clicks, typing, uploads)
• Async operations (API calls, Socket.io events)
• Error scenarios and edge cases
• State management and UI updates
• Form validation and submission
• Loading and completion states

Notes

• Tests use Vitest and React Testing Library
• All mocks are properly isolated and cleaned up
• Tests follow best practices for accessibility (ARIA roles, labels)
• No implementation changes; test-only deliverable as requested

Closes #896
Closes #897
Closes #898
Closes #899

[vercel]

@maugauwi-hash is attempting to deploy a commit to the Harold's projects Team on Vercel.

A member of the Team first needs to authorize it.

[drips-wave]

@maugauwi-hash Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits