Refactor UploadedFile and introduce UploadError enum

[Vyacheslav86RUS]

Summary

Refactors the UploadedFile implementation to improve error handling, stream safety, and internal structure.

Introduces a new UploadError enum to represent PHP upload error codes in a type-safe way.

Changes

• Added UploadError enum (Philharmony\Http\Message\Enum\UploadError)
• Refactored UploadedFile to internally use the enum
• Improved stream copy logic in UploadedFile::moveTo()
• Added cleanup logic when stream copy fails
• Added tests covering error handling and failure scenarios
• Minor internal refactoring and improvements

Tests

• Added tests for UploadError
• Added test covering stream read failure and file cleanup
• Achieved full test coverage for UploadedFile

BC Breaks

None. Public PSR-7 API remains unchanged.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!