feat!: Support custom mapper.

[driessamyn]

Enhance the query API to support specifying a custom mapper function.

[driessamyn]

@CodiumAI-Agent /review

[CodiumAI-Agent]

PR Reviewer Guide 🔍

(Review updated until commit bfca24a)

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 4 🔵🔵🔵🔵⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Code Duplication The newly added query methods in the Kapper interface and KapperImpl class seem to duplicate existing functionality with minor variations. Consider refactoring to minimize code duplication and improve maintainability. TODO Comments There are multiple TODO comments related to caching and refactoring that should be addressed or tracked in a project management tool to ensure they are not overlooked. Exception Handling The createInstance method throws a KapperMappingException if the number of columns does not match the expected number. This could be handled more gracefully or documented clearly in the method's comments to inform users of the API.

[github-actions]

Test Results

 6 files  ±0   6 suites  ±0   2s ⏱️ ±0s
23 tests ±0  21 ✅ ±0  2 💤 ±0  0 ❌ ±0 
35 runs  +2  33 ✅ +2  2 💤 ±0  0 ❌ ±0 

Results for commit bfca24a. ± Comparison against base commit 72dfb06.

[github-actions]

Code Coverage

File	Coverage [90.64%]
lib/src/integrationTest/kotlin/net/samyn/kapper/QueryTests.kt	97.75%
lib/src/main/kotlin/net/samyn/kapper/Kapper.kt	63.64%
lib/src/main/kotlin/net/samyn/kapper/internal/KapperImpl.kt	78.13%
lib/src/main/kotlin/net/samyn/kapper/internal/Mapper.kt	92.31%

Total Project Coverage	89.77%

[CodiumAI-Agent]

Persistent review updated to latest commit bfca24a