Replace GeneratedAqlQuery with AqlQuery

CHANGELOG.md

@@ -40,6 +40,12 @@ for upgrading your code to arangojs v9.
   the behavior of other ArangoDB drivers and help detect normalization issues
   in user code.
 
+- Changed return type of `aql` and the AQL `join` helper function to `AqlQuery`
+
+  Previously the internal `GeneratedAqlQuery` type was exposed as the return
+  type of these functions, leading to complexity when handling generic type
+  arguments.
+
 ## [8.6.0] - 2023-10-24
 
 ### Added

src/aql.ts

@@ -206,7 +206,7 @@ export function isAqlLiteral(literal: any): literal is AqlLiteral {
 export function aql<T = any>(
   templateStrings: TemplateStringsArray,
   ...args: AqlValue[]
-): GeneratedAqlQuery<T> {
+): AqlQuery<T> {
   const strings = [...templateStrings];
   const bindVars: Record<string, any> = {};
   const bindValues = [];
@@ -264,7 +264,7 @@ export function aql<T = any>(
     query,
     bindVars,
     _source: () => ({ strings, args }),
-  };
+  } as AqlQuery<T>;
 }
 
 /**
@@ -399,7 +399,7 @@ export function literal(
  * //   @value1 -> "users"
  * ```
  */
-export function join(values: AqlValue[], sep: string = " "): GeneratedAqlQuery {
+export function join(values: AqlValue[], sep: string = " "): AqlQuery {
   if (!values.length) {
     return aql``;
   }