feat(error-type-mapping): adds support to map the error types in the result property of ApiResponse

[asadali214]

What

This PR adds a new functionality to mapErrorTypes while returning ApiResponse, along with unit tests.

Why

This implementation enabled better error handling by mapping error response bodies to their respective types.

Type of change

Select multiple if applicable.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause a breaking change)
• Tests (adds or updates tests)
• Documentation (adds or updates documentation)
• Refactor (style improvements, performance improvements, code refactoring)
• Revert (reverts a commit)
• CI/Build (adds or updates a script, change in external dependencies)

Dependency Change

N/A

Breaking change

N/A

Testing

Unit tests are added in the PR to test out the new functionality

Checklist

• My code follows the coding conventions
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have added new unit tests

[Copilot]

Pull request overview

This PR introduces functionality to map error response bodies to their respective types when returning ApiResponse objects, enabling better error handling through type-safe error responses.

Changes:

• Added mapErrorTypesInApiResponse() method to enable error type mapping in API responses
• Introduced getClassName() method in ErrorType to expose the error class name
• Refactored ResponseError::getResult() to extract API response handling into a separate method

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/Mocking/Other/MockException4.php	Adds new mock exception class for testing error type mapping
tests/ApiCallTest.php	Adds comprehensive test coverage for the new error type mapping functionality
src/Response/Types/ErrorType.php	Exposes error class name through new getter method and updates documentation
src/Response/ResponseHandler.php	Provides public API method to enable error type mapping in responses
src/Response/ResponseError.php	Implements core logic for mapping error types and refactors response handling
src/Response/Context.php	Adds method to create API responses with mapped error types

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

This PR was automatically closed because some checks failed.
Status Summary: 1 null, 12 success, 1 failure, 2 skipped

[github-actions]

This PR was automatically closed because some checks failed.
Status Summary: 1 null, 2 failure, 17 success, 2 skipped

[github-actions]

This PR was automatically closed because some checks failed.
Status Summary: 1 null, 19 success, 2 failure, 2 skipped