feat: add types for cds.ql.SELECT.hints() (#408)

* Add types and tests for `ql.SELECT.hints()`

* Remove unused generic type

* Add changelog entry

CHANGELOG.md

@@ -6,6 +6,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
 ## [Unreleased]
 ### Added
+- Added types for `SELECT.hints()` of `cds.ql` API
+
 ### Changed
 - `CHANGELOG.md` and `LICENSE` files are no longer part of the npm package.
 

apis/internal/query.d.ts

@@ -145,6 +145,11 @@ export interface Limit {
   & ((rows: number, offset?: number) => this)
 }
 
+export interface Hints {
+  hints: ((...hints: string[]) => this)
+  & ((hints: string[]) => this)
+}
+
 export interface And {
   and: TaggedTemplateQueryPart<this>
   & ((predicate: object) => this)

apis/ql.d.ts

@@ -15,6 +15,7 @@ import {
   Columns,
   EntityDescription,
   Having,
+  Hints,
   GroupBy,
   Limit,
   OrderBy,
@@ -74,7 +75,7 @@ export declare class QL<T> {
 
 }
 
-export interface SELECT<T> extends Where<T>, And, Having<T>, GroupBy, OrderBy<T>, Limit {
+export interface SELECT<T> extends Where<T>, And, Having<T>, GroupBy, OrderBy<T>, Limit, Hints {
   // overload specific to SELECT
   columns: Columns<T, this>['columns'] & ((projection: Projection<T>) => this)
 }

test/typescript/apis/project/cds-ql.ts

@@ -60,6 +60,10 @@ SELECT.from(Foos, f => f.ref(r => r.x))  // ref should be callable without optio
 SELECT.from(Foos).orderBy('x')  // x auto completed
 SELECT.from(Foos).orderBy('y')  // non-columns also still possible
 
+SELECT.from(Foos).hints('x')
+SELECT.from(Foos).hints('x', 'y')
+SELECT.from(Foos).hints(['x', 'y'])
+
 SELECT.from(Foos, f => { 
     f.x,
     // @ts-expect-error - foobar is not a valid column