feat: [#770] Add a SelectRaw function for the ORM

[hwbrzzl]

📑 Description

Closes goravel/goravel#770

This pull request adds support for raw SQL selection in the ORM query interface, allowing more flexible and complex queries. The main changes include introducing a new SelectRaw method to the query interface and its implementation, updating the internal conditions structure to support raw selects, and adding corresponding tests and mocks.

Raw SQL selection support:

• Added SelectRaw method to the Query interface in orm.go, enabling users to specify raw SQL queries for field selection.
• Implemented the SelectRaw method in query.go, updated the Conditions struct to include the new selectRaw field, and added the Select struct to hold the query and its arguments. [1] [2] [3]
• Modified the buildSelectColumns function to handle both regular column selection and raw SQL selection, ensuring only one selection mode is active per query.

Testing and mocking:

• Added a new test case TestSelectRaw in query_test.go to verify the functionality of raw SQL selection with various inputs.
• Updated the ORM query mocks in Query.go to support the new SelectRaw method, including helper and expectation methods for testing.

Dependency update:

• Updated the github.com/go-viper/mapstructure/v2 dependency from v2.3.0 to v2.4.0 in tests/go.mod.

✅ Checks

• Added test cases for my code

[Copilot]

Pull Request Overview

This PR adds raw SQL selection support to the ORM by introducing a new SelectRaw method that allows users to specify raw SQL queries for field selection, providing more flexibility for complex queries.

• Added SelectRaw method to the Query interface and its implementation in the GORM query builder
• Updated the conditions structure to support raw SQL selection alongside regular column selection
• Added comprehensive test coverage for the new functionality

Reviewed Changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
contracts/database/orm/orm.go	Added SelectRaw method to the Query interface
database/gorm/conditions.go	Added Select struct and selectRaw field to support raw SQL selection
database/gorm/query.go	Implemented SelectRaw method and updated buildSelectColumns to handle raw SQL
mocks/database/orm/Query.go	Added mock implementation for SelectRaw method
tests/query_test.go	Added comprehensive test case for TestSelectRaw functionality
tests/go.mod	Updated mapstructure dependency to v2.4.0

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (v1.16.x@b12a15a). Learn more about missing BASE report.

Additional details and impacted files

@@            Coverage Diff             @@
##             v1.16.x    #1186   +/-   ##
==========================================
  Coverage           ?   66.90%           
==========================================
  Files              ?      215           
  Lines              ?    14083           
  Branches           ?        0           
==========================================
  Hits               ?     9422           
  Misses             ?     4284           
  Partials           ?      377           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.