@dynatrace-sdk/client-query 1.11.0 → 1.12.1

package/cjs/index.js

@@ -51,6 +51,7 @@ __export(src_exports, {
   _DQLNodeTransformation: () => dql_node_transformation_exports,
   _DQLTerminalNodeTransformation: () => dql_terminal_node_transformation_exports,
   _ErrorEnvelopeTransformation: () => error_envelope_transformation_exports,
+  _ErrorResponseDetailsConstraintViolationsItemTransformation: () => error_response_details_constraint_violations_item_transformation_exports,
   _ErrorResponseDetailsTransformation: () => error_response_details_transformation_exports,
   _ErrorResponseTransformation: () => error_response_transformation_exports,
   _ExecuteRequestTransformation: () => execute_request_transformation_exports,
@@ -1037,30 +1038,97 @@ function toJson7($model, includeChildProps = true) {
 var error_envelope_transformation_exports = {};
 __export(error_envelope_transformation_exports, {
   fromFormData: () => fromFormData2,
-  fromJson: () => fromJson16,
+  fromJson: () => fromJson17,
   isErrorEnvelope: () => isErrorEnvelope,
-  isJson: () => isJson16,
+  isJson: () => isJson17,
   toFormData: () => toFormData2,
-  toJson: () => toJson16
+  toJson: () => toJson17
 });
 
 // packages/client/query/src/lib/models/error-response.transformation.ts
 var error_response_transformation_exports = {};
 __export(error_response_transformation_exports, {
-  fromJson: () => fromJson15,
+  fromJson: () => fromJson16,
   isErrorResponse: () => isErrorResponse,
-  isJson: () => isJson15,
-  toJson: () => toJson15
+  isJson: () => isJson16,
+  toJson: () => toJson16
 });
 
 // packages/client/query/src/lib/models/error-response-details.transformation.ts
 var error_response_details_transformation_exports = {};
 __export(error_response_details_transformation_exports, {
-  fromJson: () => fromJson14,
+  fromJson: () => fromJson15,
   isErrorResponseDetails: () => isErrorResponseDetails,
+  isJson: () => isJson15,
+  toJson: () => toJson15
+});
+
+// packages/client/query/src/lib/models/error-response-details-constraint-violations-item.transformation.ts
+var error_response_details_constraint_violations_item_transformation_exports = {};
+__export(error_response_details_constraint_violations_item_transformation_exports, {
+  fromJson: () => fromJson14,
+  isErrorResponseDetailsConstraintViolationsItem: () => isErrorResponseDetailsConstraintViolationsItem,
   isJson: () => isJson14,
   toJson: () => toJson14
 });
+function isErrorResponseDetailsConstraintViolationsItem(value) {
+  if (value === null) {
+    return false;
+  }
+  if (value === void 0) {
+    return false;
+  }
+  if (Array.isArray(value)) {
+    return false;
+  }
+  const modelKeys = /* @__PURE__ */ new Set(["message", "parameterLocation", "parameterDescriptor"]);
+  const hasAdditionalProperties = false;
+  const requiredKeys = ["message"];
+  const optionalKeys = ["parameterLocation", "parameterDescriptor"];
+  const valKeys = new Set(Object.keys(value));
+  const containsRequiredOrOptionalKeys = requiredKeys.length > 0 ? requiredKeys.every((reqKey) => valKeys.has(reqKey)) : optionalKeys.some((key) => valKeys.has(key)) || hasAdditionalProperties;
+  const doesNotContainExtraKeys = [...valKeys].every((key) => modelKeys.has(key)) || hasAdditionalProperties;
+  const allPropertiesMatchFormat = true;
+  return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
+}
+function isJson14(value) {
+  if (value === null) {
+    return false;
+  }
+  if (value === void 0) {
+    return false;
+  }
+  if (Array.isArray(value)) {
+    return false;
+  }
+  const modelKeys = /* @__PURE__ */ new Set(["message", "parameterLocation", "parameterDescriptor"]);
+  const hasAdditionalProperties = false;
+  const requiredKeys = ["message"];
+  const optionalKeys = ["parameterLocation", "parameterDescriptor"];
+  const valKeys = new Set(Object.keys(value));
+  const containsRequiredOrOptionalKeys = requiredKeys.length > 0 ? requiredKeys.every((reqKey) => valKeys.has(reqKey)) : optionalKeys.some((key) => valKeys.has(key)) || hasAdditionalProperties;
+  const doesNotContainExtraKeys = [...valKeys].every((key) => modelKeys.has(key)) || hasAdditionalProperties;
+  const allPropertiesMatchFormat = true;
+  return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
+}
+function fromJson14($model) {
+  const { message, parameterLocation, parameterDescriptor } = $model;
+  return {
+    message,
+    parameterLocation,
+    parameterDescriptor
+  };
+}
+function toJson14($model) {
+  const { message, parameterLocation, parameterDescriptor } = $model;
+  return {
+    message,
+    parameterLocation,
+    parameterDescriptor
+  };
+}
+
+// packages/client/query/src/lib/models/error-response-details.transformation.ts
 function isErrorResponseDetails(value) {
   if (value === null) {
     return false;
@@ -1080,26 +1148,34 @@ function isErrorResponseDetails(value) {
     "queryString",
     "errorMessageFormatSpecifierTypes",
     "errorMessageFormat",
-    "queryId"
+    "queryId",
+    "constraintViolations",
+    "missingScopes",
+    "missingPermissions"
   ]);
   const hasAdditionalProperties = false;
-  const requiredKeys = [
-    "arguments",
+  const requiredKeys = [];
+  const optionalKeys = [
+    "exceptionType",
+    "syntaxErrorPosition",
+    "errorType",
     "errorMessage",
-    "errorMessageFormat",
+    "arguments",
+    "queryString",
     "errorMessageFormatSpecifierTypes",
-    "errorType",
-    "exceptionType",
-    "queryString"
+    "errorMessageFormat",
+    "queryId",
+    "constraintViolations",
+    "missingScopes",
+    "missingPermissions"
   ];
-  const optionalKeys = ["syntaxErrorPosition", "queryId"];
   const valKeys = new Set(Object.keys(value));
   const containsRequiredOrOptionalKeys = requiredKeys.length > 0 ? requiredKeys.every((reqKey) => valKeys.has(reqKey)) : optionalKeys.some((key) => valKeys.has(key)) || hasAdditionalProperties;
   const doesNotContainExtraKeys = [...valKeys].every((key) => modelKeys.has(key)) || hasAdditionalProperties;
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson14(value) {
+function isJson15(value) {
   if (value === null) {
     return false;
   }
@@ -1118,26 +1194,34 @@ function isJson14(value) {
     "queryString",
     "errorMessageFormatSpecifierTypes",
     "errorMessageFormat",
-    "queryId"
+    "queryId",
+    "constraintViolations",
+    "missingScopes",
+    "missingPermissions"
   ]);
   const hasAdditionalProperties = false;
-  const requiredKeys = [
-    "arguments",
+  const requiredKeys = [];
+  const optionalKeys = [
+    "exceptionType",
+    "syntaxErrorPosition",
+    "errorType",
     "errorMessage",
-    "errorMessageFormat",
+    "arguments",
+    "queryString",
     "errorMessageFormatSpecifierTypes",
-    "errorType",
-    "exceptionType",
-    "queryString"
+    "errorMessageFormat",
+    "queryId",
+    "constraintViolations",
+    "missingScopes",
+    "missingPermissions"
   ];
-  const optionalKeys = ["syntaxErrorPosition", "queryId"];
   const valKeys = new Set(Object.keys(value));
   const containsRequiredOrOptionalKeys = requiredKeys.length > 0 ? requiredKeys.every((reqKey) => valKeys.has(reqKey)) : optionalKeys.some((key) => valKeys.has(key)) || hasAdditionalProperties;
   const doesNotContainExtraKeys = [...valKeys].every((key) => modelKeys.has(key)) || hasAdditionalProperties;
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson14($model) {
+function fromJson15($model) {
   const {
     exceptionType,
     syntaxErrorPosition,
@@ -1147,21 +1231,29 @@ function fromJson14($model) {
     queryString,
     errorMessageFormatSpecifierTypes,
     errorMessageFormat,
-    queryId
+    queryId,
+    constraintViolations,
+    missingScopes,
+    missingPermissions
   } = $model;
   return {
     exceptionType,
     syntaxErrorPosition: syntaxErrorPosition !== void 0 && syntaxErrorPosition !== null ? fromJson13(syntaxErrorPosition) : void 0,
     errorType,
     errorMessage,
-    arguments: _arguments?.slice(0),
+    arguments: _arguments !== void 0 && _arguments !== null ? _arguments?.slice(0) : void 0,
     queryString,
-    errorMessageFormatSpecifierTypes: errorMessageFormatSpecifierTypes?.slice(0),
+    errorMessageFormatSpecifierTypes: errorMessageFormatSpecifierTypes !== void 0 && errorMessageFormatSpecifierTypes !== null ? errorMessageFormatSpecifierTypes?.slice(0) : void 0,
     errorMessageFormat,
-    queryId
+    queryId,
+    constraintViolations: constraintViolations !== void 0 && constraintViolations !== null ? constraintViolations?.map(
+      (innerValue) => fromJson14(innerValue)
+    ) : void 0,
+    missingScopes: missingScopes !== void 0 && missingScopes !== null ? missingScopes?.slice(0) : void 0,
+    missingPermissions: missingPermissions !== void 0 && missingPermissions !== null ? missingPermissions?.slice(0) : void 0
   };
 }
-function toJson14($model) {
+function toJson15($model) {
   const {
     exceptionType,
     syntaxErrorPosition,
@@ -1171,18 +1263,26 @@ function toJson14($model) {
     queryString,
     errorMessageFormatSpecifierTypes,
     errorMessageFormat,
-    queryId
+    queryId,
+    constraintViolations,
+    missingScopes,
+    missingPermissions
   } = $model;
   return {
     exceptionType,
     syntaxErrorPosition: syntaxErrorPosition !== void 0 && syntaxErrorPosition !== null ? toJson13(syntaxErrorPosition) : void 0,
     errorType,
     errorMessage,
-    arguments: _arguments?.slice(0),
+    arguments: _arguments !== void 0 && _arguments !== null ? _arguments?.slice(0) : void 0,
     queryString,
-    errorMessageFormatSpecifierTypes: errorMessageFormatSpecifierTypes?.slice(0),
+    errorMessageFormatSpecifierTypes: errorMessageFormatSpecifierTypes !== void 0 && errorMessageFormatSpecifierTypes !== null ? errorMessageFormatSpecifierTypes?.slice(0) : void 0,
     errorMessageFormat,
-    queryId
+    queryId,
+    constraintViolations: constraintViolations !== void 0 && constraintViolations !== null ? constraintViolations?.map(
+      (innerValue) => toJson14(innerValue)
+    ) : void 0,
+    missingScopes: missingScopes !== void 0 && missingScopes !== null ? missingScopes?.slice(0) : void 0,
+    missingPermissions: missingPermissions !== void 0 && missingPermissions !== null ? missingPermissions?.slice(0) : void 0
   };
 }
 
@@ -1199,15 +1299,15 @@ function isErrorResponse(value) {
   }
   const modelKeys = /* @__PURE__ */ new Set(["message", "details", "code"]);
   const hasAdditionalProperties = false;
-  const requiredKeys = ["code", "details", "message"];
-  const optionalKeys = [];
+  const requiredKeys = ["code", "message"];
+  const optionalKeys = ["details"];
   const valKeys = new Set(Object.keys(value));
   const containsRequiredOrOptionalKeys = requiredKeys.length > 0 ? requiredKeys.every((reqKey) => valKeys.has(reqKey)) : optionalKeys.some((key) => valKeys.has(key)) || hasAdditionalProperties;
   const doesNotContainExtraKeys = [...valKeys].every((key) => modelKeys.has(key)) || hasAdditionalProperties;
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson15(value) {
+function isJson16(value) {
   if (value === null) {
     return false;
   }
@@ -1219,27 +1319,27 @@ function isJson15(value) {
   }
   const modelKeys = /* @__PURE__ */ new Set(["message", "details", "code"]);
   const hasAdditionalProperties = false;
-  const requiredKeys = ["code", "details", "message"];
-  const optionalKeys = [];
+  const requiredKeys = ["code", "message"];
+  const optionalKeys = ["details"];
   const valKeys = new Set(Object.keys(value));
   const containsRequiredOrOptionalKeys = requiredKeys.length > 0 ? requiredKeys.every((reqKey) => valKeys.has(reqKey)) : optionalKeys.some((key) => valKeys.has(key)) || hasAdditionalProperties;
   const doesNotContainExtraKeys = [...valKeys].every((key) => modelKeys.has(key)) || hasAdditionalProperties;
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson15($model) {
+function fromJson16($model) {
   const { message, details, code } = $model;
   return {
     message,
-    details: fromJson14(details),
+    details: details !== void 0 && details !== null ? fromJson15(details) : void 0,
     code
   };
 }
-function toJson15($model) {
+function toJson16($model) {
   const { message, details, code } = $model;
   return {
     message,
-    details: toJson14(details),
+    details: details !== void 0 && details !== null ? toJson15(details) : void 0,
     code
   };
 }
@@ -1265,7 +1365,7 @@ function isErrorEnvelope(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson16(value) {
+function isJson17(value) {
   if (value === null) {
     return false;
   }
@@ -1285,26 +1385,26 @@ function isJson16(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson16($model) {
+function fromJson17($model) {
   const { error } = $model;
   return {
-    error: fromJson15(error)
+    error: fromJson16(error)
   };
 }
-function toJson16($model) {
+function toJson17($model) {
   const { error } = $model;
   return {
-    error: toJson15(error)
+    error: toJson16(error)
   };
 }
 function fromFormData2(formData) {
   const formDataEntries = Object.fromEntries(formData.map((data) => [data.name, data.value]));
   return {
-    error: fromJson15(JSON.parse(formDataEntries["error"]))
+    error: fromJson16(JSON.parse(formDataEntries["error"]))
   };
 }
 function toFormData2($model) {
-  const json = toJson16($model);
+  const json = toJson17($model);
   const body = [{ name: "error", type: "json", value: json["error"] }];
   return body;
 }
@@ -1312,10 +1412,10 @@ function toFormData2($model) {
 // packages/client/query/src/lib/models/parse-request.transformation.ts
 var parse_request_transformation_exports = {};
 __export(parse_request_transformation_exports, {
-  fromJson: () => fromJson17,
-  isJson: () => isJson17,
+  fromJson: () => fromJson18,
+  isJson: () => isJson18,
   isParseRequest: () => isParseRequest,
-  toJson: () => toJson17
+  toJson: () => toJson18
 });
 function isParseRequest(value) {
   if (value === null) {
@@ -1337,7 +1437,7 @@ function isParseRequest(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson17(value) {
+function isJson18(value) {
   if (value === null) {
     return false;
   }
@@ -1357,7 +1457,7 @@ function isJson17(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson17($model) {
+function fromJson18($model) {
   const { query, timezone, locale, queryOptions } = $model;
   return {
     query,
@@ -1366,7 +1466,7 @@ function fromJson17($model) {
     queryOptions: queryOptions !== void 0 && queryOptions !== null ? fromJson(queryOptions) : void 0
   };
 }
-function toJson17($model) {
+function toJson18($model) {
   const { query, timezone, locale, queryOptions } = $model;
   return {
     query,
@@ -1379,10 +1479,10 @@ function toJson17($model) {
 // packages/client/query/src/lib/models/verify-request.transformation.ts
 var verify_request_transformation_exports = {};
 __export(verify_request_transformation_exports, {
-  fromJson: () => fromJson18,
-  isJson: () => isJson18,
+  fromJson: () => fromJson19,
+  isJson: () => isJson19,
   isVerifyRequest: () => isVerifyRequest,
-  toJson: () => toJson18
+  toJson: () => toJson19
 });
 function isVerifyRequest(value) {
   if (value === null) {
@@ -1404,7 +1504,7 @@ function isVerifyRequest(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson18(value) {
+function isJson19(value) {
   if (value === null) {
     return false;
   }
@@ -1424,7 +1524,7 @@ function isJson18(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson18($model) {
+function fromJson19($model) {
   const { query, timezone, locale, queryOptions, generateCanonicalQuery } = $model;
   return {
     query,
@@ -1434,7 +1534,7 @@ function fromJson18($model) {
     generateCanonicalQuery
   };
 }
-function toJson18($model) {
+function toJson19($model) {
   const { query, timezone, locale, queryOptions, generateCanonicalQuery } = $model;
   return {
     query,
@@ -1448,19 +1548,19 @@ function toJson18($model) {
 // packages/client/query/src/lib/models/verify-response.transformation.ts
 var verify_response_transformation_exports = {};
 __export(verify_response_transformation_exports, {
-  fromJson: () => fromJson20,
-  isJson: () => isJson20,
+  fromJson: () => fromJson21,
+  isJson: () => isJson21,
   isVerifyResponse: () => isVerifyResponse,
-  toJson: () => toJson20
+  toJson: () => toJson21
 });
 
 // packages/client/query/src/lib/models/metadata-notification.transformation.ts
 var metadata_notification_transformation_exports = {};
 __export(metadata_notification_transformation_exports, {
-  fromJson: () => fromJson19,
-  isJson: () => isJson19,
+  fromJson: () => fromJson20,
+  isJson: () => isJson20,
   isMetadataNotification: () => isMetadataNotification,
-  toJson: () => toJson19
+  toJson: () => toJson20
 });
 function isMetadataNotification(value) {
   if (value === null) {
@@ -1498,7 +1598,7 @@ function isMetadataNotification(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson19(value) {
+function isJson20(value) {
   if (value === null) {
     return false;
   }
@@ -1534,7 +1634,7 @@ function isJson19(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson19($model) {
+function fromJson20($model) {
   const {
     severity,
     messageFormat,
@@ -1554,7 +1654,7 @@ function fromJson19($model) {
     message
   };
 }
-function toJson19($model) {
+function toJson20($model) {
   const {
     severity,
     messageFormat,
@@ -1596,7 +1696,7 @@ function isVerifyResponse(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson20(value) {
+function isJson21(value) {
   if (value === null) {
     return false;
   }
@@ -1616,35 +1716,62 @@ function isJson20(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson20($model) {
+function fromJson21($model) {
   const { valid, canonicalQuery, notifications } = $model;
   return {
     valid,
     canonicalQuery,
-    notifications: notifications !== void 0 && notifications !== null ? notifications?.map((innerValue) => fromJson19(innerValue)) : void 0
+    notifications: notifications !== void 0 && notifications !== null ? notifications?.map((innerValue) => fromJson20(innerValue)) : void 0
   };
 }
-function toJson20($model) {
+function toJson21($model) {
   const { valid, canonicalQuery, notifications } = $model;
   return {
     valid,
     canonicalQuery,
-    notifications: notifications !== void 0 && notifications !== null ? notifications?.map((innerValue) => toJson19(innerValue)) : void 0
+    notifications: notifications !== void 0 && notifications !== null ? notifications?.map((innerValue) => toJson20(innerValue)) : void 0
   };
 }
 
 // packages/client/query/src/lib/apis/query-assistance-api.ts
 var QueryAssistanceClient = class {
   httpClient;
+  /**
+   * @param {HttpClient} httpClientImplementation - You can provide custom http client as a parameter to constructor of a QueryAssistanceClient. Custom http client should implement {HttpClient} interface.
+   * @example
+   * const queryAssistanceClientNodeJs = new QueryAssistanceClient(yourCustomImplementation);
+   */
   constructor(httpClientImplementation) {
     this.httpClient = httpClientImplementation;
     registerGlobalErrorSerializer(apiClientErrorSerializer);
   }
+  /**
+   * Verifies a query without executing it.
+   *
+   * For information about the required permissions see the [Bucket and table permissions in Grail documentation](https://docs.dynatrace.com/docs/shortlink/assign-bucket-table-permissions).
+   *
+   * ## Overview
+   *
+   * Verifies the supplied query string and other query parameters for lack of any errors, but without actually
+   * submitting the query for execution.
+   *
+   * @returns Supplied query and parameters were verified.
+   *
+   * @example <caption>Code example</caption>
+   * import { queryAssistanceClient } from "@dynatrace-sdk/client-query";
+   *
+   * const data = await queryAssistanceClient.queryVerify({
+   *   body: {
+   *     query:
+   *       'fetch events | filter event.type == "davis" AND davis.status != "CLOSED" | fields timestamp, davis.title, davis.underMaintenance, davis.status | sort timestamp | limit 10',
+   *   },
+   * });
+   */
   async queryVerify(config) {
     if (!config) {
       throw new ApiClientError("API client error", "API client call is missing mandatory config parameter");
     }
-    const encodedBody = toJson18(config.body);
+    const encodedBody = toJson19(config.body);
     try {
       const response = await this.httpClient.send({
         url: `/platform/storage/query/v1/query:verify`,
@@ -1662,7 +1789,7 @@ var QueryAssistanceClient = class {
       });
       const responseValue = await response.body("json");
       try {
-        return fromJson20(responseValue);
+        return fromJson21(responseValue);
       } catch (err) {
         throw new InvalidResponseError(
           `QueryAssistanceClient.query:verify:200`,
@@ -1684,7 +1811,7 @@ var QueryAssistanceClient = class {
         case 400: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `400`,
               response,
@@ -1708,7 +1835,7 @@ var QueryAssistanceClient = class {
         case 500: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `500`,
               response,
@@ -1742,11 +1869,218 @@ var QueryAssistanceClient = class {
       }
     }
   }
+  /**
+   * Get a structured tree of the canonical form of the query.
+   *
+   * For information about the required permissions see the [Bucket and table permissions in Grail documentation](https://docs.dynatrace.com/docs/shortlink/assign-bucket-table-permissions).
+   *
+   * ## Overview
+   *
+   * Returns the parsed query as a tree, containing the structure of the canonical query. Tree-nodes can contain references to
+   * the token position where they originate from. This may help to provide hover effects, show canonical forms, mark
+   * optional items, and more.
+   *
+   * ## Details
+   *
+   * The query tree consists of nodes that contain different additional information (everything optional):
+   *
+   * ### General Fields
+   *
+   * Field | Mandatory |  Description
+   * ----------------------- | --- | ----------------------------------------------------------------------------------------
+   * tokenPosition           | no  | optional. If present, it represents the position within the query string where the node refers to.
+   * isOptional              | no  | whether this node could be left out and the result would still be the same query (semantically).
+   *
+   * #### tokenPosition
+   *
+   * contains `start` (inclusive) and `end` (inclusive), both contain `index` (0 based; fur substrings), `line`
+   * and `column` (both 1-based; for readability).
+   *
+   * * If `tokenPosition` is present, it always contains start and end with all fields
+   * * If `tokenPosition` is not present, there might still be nested nodes that do contain a position
+   * * If `start == end`, the position refers to a single character
+   * * If `start > end`, we know for sure that something was inserted.
+   *
+   * We can always check whether the canonical representation of a node matches the text in the tokenPosition to see whether
+   * something was inserted, removed, or changed.
+   *
+   * #### isOptional
+   *
+   * only present if it is true.
+   *
+   * Optional nodes can e.g. be optional braces that make a query more readable, but are not necessary. This could be used to
+   * enter *ghost braces* and *implicit functions* in the user's input field; maybe with different formatting
+   * (using the tokenPosition of sibling nodes we can also check whether the user wrote these or not).
+   *
+   * ### Advanced Token Types
+   *
+   * each node is of one of following types and may contain more fields:
+   *
+   * * Terminal Node
+   * * ContainerNode
+   * * Alternative Node
+   *
+   * #### Terminal Node
+   *
+   * can be identified by checking whether `canonicalString` is present
+   *
+   * Field | Mandatory |  Description
+   * ------------------------ | --- | ---------------------------------------------------------------------------------------
+   * type                     | yes | the type of the terminal node - do not confuse with the type of container nodes
+   * canonicalString          | yes | the canonical string representation. Concatenating the canonicalString of all nested terminal nodes provides the canonical form of the query.
+   * isMandatoryOnUserOrder   | no  | may only be present if (`type="BRACE_OPEN"` or `type="BRACE_CLOSE"`) and `isOptional=true`. For usage see section [Special node type: PARAMETERS](#special-node-type-parameters)
+   *
+   * ##### Current types of terminal nodes (list might grow):
+   *
+   * * SPACE
+   * * LINEBREAK
+   * * INDENT
+   * * PIPE
+   * * DOT
+   * * COLON
+   * * COMMA
+   * * BRACE_OPEN
+   * * BRACE_CLOSE
+   * * BRACKET_OPEN
+   * * BRACKET_CLOSE
+   * * PARENTHESIS_OPEN
+   * * PARENTHESIS_CLOSE
+   * * QUOTE
+   * * SLASH
+   * * BOOLEAN_TRUE
+   * * BOOLEAN_FALSE
+   * * NULL
+   * * COMMAND_NAME
+   * * PARAMETER_KEY
+   * * PARAMETER_VALUE_SCOPE
+   * * FUNCTION_NAME
+   * * OPERATOR
+   * * TRAVERSAL_OPERATOR
+   * * TRAVERSAL_RELATION_NAME
+   * * TRAVERSAL_HOP_COUNT
+   * * SIMPLE_IDENTIFIER
+   * * NUMBER
+   * * STRING
+   * * TIME_UNIT
+   * * TIMESTAMP_VALUE
+   * * METRIC_KEY
+   * * VARIABLE
+   *
+   * #### ContainerNode
+   *
+   * can be identified by checking whether `children` is present
+   *
+   * Field | Mandatory |  Description
+   * ----------------------- | --- | ----------------------------------------------------------------------------------------
+   * type                    | yes | the type of the container node - do not confuse with the type of terminal nodes
+   * children                | yes | the children for the node. might be of any type
+   *
+   * ##### Current types of container nodes (list might grow):
+   *
+   * * QUERY
+   * * EXECUTION_BLOCK
+   * * COMMAND
+   * * COMMAND_SEPARATOR
+   * * PARAMETER_WITH_KEY
+   * * GROUP
+   * * PARAMETERS - check examples further down
+   * * PARAMETER_NAMING
+   * * PARAMETER_SEPARATOR
+   * * FUNCTION
+   * * FUNCTION_PART - check examples further down
+   * * EXPRESSION
+   * * IDENTIFIER
+   * * SOURCE_ID
+   * * DURATION
+   * * TIMESTAMP
+   * * TIMEFRAME
+   * * TRAVERSAL_PATH
+   * * TRAVERSAL_STEP
+   *
+   * ##### Special node type: PARAMETERS
+   *
+   * can contain children representing the parameters. Every second child is of type PARAMETER_SEPARATOR.
+   *
+   * You may reorder the children based on their tokenPosition to get the user order. However, in this case,
+   * you need to consider `isMandatoryOnUserOrder` to determine whether the grouping braces are mandatory or not.
+   *
+   * ###### Example
+   *
+   * For the query `SORT a, {direction:"descending", b}`, the canonical form is:
+   *
+   * `SORT a, {b, direction:"descending"}`
+   *
+   * This is the order, in which the parameters are returned in the query tree.
+   * Parameters are {a} and {{b} and {direction:"descending"}}. In this case, the braces are optional.
+   *
+   * `SORT a, {b, direction:"descending"}` is equivalent to `SORT a, b, direction:"descending"`
+   *
+   * However, if you reorder the children by tokenPosition, the braces are not optional, because
+   *
+   * `SORT a, direction:"descending", b` is interpreted as `SORT {a, direction:"descending"}, b`
+   *
+   * So, if the children in PARAMETERS are re-ordered by tokenPosition, braces (or in general: TerminalNodes)
+   * are only optional if `isOptional && !isMandatoryOnUserOrder`.
+   *
+   * ##### Special node type: FUNCTION_PART
+   *
+   * A container node of type `FUNCTION` may contain nodes of type `FUNCTION_PART`.
+   *
+   * If those `FUNCTION_PART`s are marked as optional, this means you have to either include *all* or *none* of these
+   * optional function parts.
+   *
+   * *Example*:
+   *
+   * `filter anyMatch(a.b == 1, input:a)`
+   *
+   * The optional function parts are `anyMatch(` and `, input:a)`. If you leave out both, the command will still work:
+   * `filter a.b == 1` and return the same result. Using one of these optional function parts and removing the other will lead
+   * to an invalid query.
+   *
+   * #### Alternative Node
+   *
+   * can be identified by checking whether `alternatives` is present
+   *
+   * Field | Mandatory |  Description
+   * ----------------------- | --- | ----------------------------------------------------------------------------------------
+   * alternatives            | yes | Type: Map&lt;AlternativeType, DQLNode&gt;
+   *
+   * When displaying the query, pick one option. You may use the other options for hovering, replacing, and more.
+   *
+   * ##### Current values of AlternativeType (list might grow):
+   *
+   * * CANONICAL: This node is the one we will use for our canonical form
+   * * USER: An alternative that is also valid, but not canonical; and this version was picked by the user.
+   * * INFO: only if the canonical version is not present
+   *
+   * *Examples*:
+   *
+   * * `CANONICAL` is not present, `USER` is present: user's nodes are optional, but not canonical (usually optional nodes
+   *   are still canonical)
+   * * `CANONICAL` is present, `USER` is not present: same as if the canonical node was optional. If this happens, it is
+   *   likely that there is also an `INFO` node
+   * * `CANONICAL` is present, `USER` is present: there are different alternatives
+   * * `INFO` is present: usually if `CANONICAL` is not present (e.g. the parameter key for `FILTER a == 1`), there is an info node
+   *   for `FILTER condition:a == 1`. This `condition:` was neither written by the user nor is it canonical; but it might be
+   *   used to help the user understand what this parameter means.
+   *
+   * @returns A node containing more nodes,  a node offering different (semantically equivalent) versions of the query parts, or a terminal node that shows the canonical form.
+   *
+   * @example <caption>Code example</caption>
+   * import { queryAssistanceClient } from "@dynatrace-sdk/client-query";
+   *
+   * const data = await queryAssistanceClient.queryParse({
+   *   body: {
+   *     query:
+   *       'fetch events | filter event.type == "davis" AND davis.status != "CLOSED" | fields timestamp, davis.title, davis.underMaintenance, davis.status | sort timestamp | limit 10',
+   *   },
+   * });
+   */
   async queryParse(config) {
     if (!config) {
       throw new ApiClientError("API client error", "API client call is missing mandatory config parameter");
     }
-    const encodedBody = toJson17(config.body);
+    const encodedBody = toJson18(config.body);
     try {
       const response = await this.httpClient.send({
         url: `/platform/storage/query/v1/query:parse`,
@@ -1786,7 +2120,7 @@ var QueryAssistanceClient = class {
         case 400: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `400`,
               response,
@@ -1813,7 +2147,7 @@ var QueryAssistanceClient = class {
         case 500: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `500`,
               response,
@@ -1847,6 +2181,57 @@ var QueryAssistanceClient = class {
       }
     }
   }
+  /**
+   * Get a structured list of suggestions for the query at the given position.
+   *
+   * For information about the required permissions see the [Bucket and table permissions in Grail documentation](https://docs.dynatrace.com/docs/shortlink/assign-bucket-table-permissions).
+   *
+   * ## Overview
+   *
+   * We provide a list of suggestions that may be used after the cursor position. The following queries will all provide the
+   * same results:
+   *
+   * * `query: "f"`
+   * * `query: "f", cursorPosition:1`
+   * * `query: "fetch ", cursorPosition:1`
+   *
+   * Available fields:
+   *
+   * | Field       | Description                                                                                                                                                                             |
+   * |-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+   * | suggestions | a list of suggestions. Each item is a separate possible suggestion, despite they might have the same outputs.                                                                           |
+   * | optional    | whether the suggestion is optional. If `true`, the query until the cursor position might work. If `false`, the query is definitely incomplete or invalid if cut at the cursor position. |
+   *
+   * Fields in the `suggestions`
+   *
+   * | Field                  | Description                                                                                                |
+   * |------------------------|------------------------------------------------------------------------------------------------------------|
+   * | suggestion             | a string representing the whole suggestion. This information could also be derived from the parts.         |
+   * | alreadyTypedCharacters | how many characters of this suggestion have already been typed (and will be overridden by the suggestion). |
+   * | parts                  | a list of semantically enriched information on what are the parts of a suggestion.                         |
+   *
+   * Fields in `parts`
+   *
+   * | Field      | Description                                               |
+   * |------------|-----------------------------------------------------------|
+   * | suggestion | a string representing the current part of the suggestion. |
+   * | type       | current types: SPACE, PIPE, COMMAND (may be extended)     |
+   *
+   * The `type` helps to treat specific parts of the suggestion different to others; either by a different visualization,
+   * a link to docs, etc.
+   *
+   * @returns A list of structured autocomplete suggestions.
+   *
+   * @example <caption>Code example</caption>
+   * import { queryAssistanceClient } from "@dynatrace-sdk/client-query";
+   *
+   * const data = await queryAssistanceClient.queryAutocomplete({
+   *   body: {
+   *     query:
+   *       'fetch events | filter event.type == "davis" AND davis.status != "CLOSED" | fields timestamp, davis.title, davis.underMaintenance, davis.status | sort timestamp | limit 10',
+   *   },
+   * });
+   */
   async queryAutocomplete(config) {
     if (!config) {
       throw new ApiClientError("API client error", "API client call is missing mandatory config parameter");
@@ -1891,7 +2276,7 @@ var QueryAssistanceClient = class {
         case 400: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `400`,
               response,
@@ -1918,7 +2303,7 @@ var QueryAssistanceClient = class {
         case 500: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `500`,
               response,
@@ -1961,10 +2346,10 @@ var import_http_client2 = require("@dynatrace-sdk/http-client");
 // packages/client/query/src/lib/models/execute-request.transformation.ts
 var execute_request_transformation_exports = {};
 __export(execute_request_transformation_exports, {
-  fromJson: () => fromJson21,
+  fromJson: () => fromJson22,
   isExecuteRequest: () => isExecuteRequest,
-  isJson: () => isJson21,
-  toJson: () => toJson21
+  isJson: () => isJson22,
+  toJson: () => toJson22
 });
 function isExecuteRequest(value) {
   if (value === null) {
@@ -2013,7 +2398,7 @@ function isExecuteRequest(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson21(value) {
+function isJson22(value) {
   if (value === null) {
     return false;
   }
@@ -2060,7 +2445,7 @@ function isJson21(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson21($model) {
+function fromJson22($model) {
   const {
     query,
     defaultTimeframeStart,
@@ -2092,7 +2477,7 @@ function fromJson21($model) {
     queryOptions: queryOptions !== void 0 && queryOptions !== null ? fromJson(queryOptions) : void 0
   };
 }
-function toJson21($model) {
+function toJson22($model) {
   const {
     query,
     defaultTimeframeStart,
@@ -2128,46 +2513,46 @@ function toJson21($model) {
 // packages/client/query/src/lib/models/query-poll-response.transformation.ts
 var query_poll_response_transformation_exports = {};
 __export(query_poll_response_transformation_exports, {
-  fromJson: () => fromJson35,
-  isJson: () => isJson35,
+  fromJson: () => fromJson36,
+  isJson: () => isJson36,
   isQueryPollResponse: () => isQueryPollResponse,
-  toJson: () => toJson35
+  toJson: () => toJson36
 });
 
 // packages/client/query/src/lib/models/query-result.transformation.ts
 var query_result_transformation_exports = {};
 __export(query_result_transformation_exports, {
-  fromJson: () => fromJson33,
-  isJson: () => isJson33,
+  fromJson: () => fromJson34,
+  isJson: () => isJson34,
   isQueryResult: () => isQueryResult,
-  toJson: () => toJson33
+  toJson: () => toJson34
 });
 
 // packages/client/query/src/lib/models/metadata.transformation.ts
 var metadata_transformation_exports = {};
 __export(metadata_transformation_exports, {
-  fromJson: () => fromJson25,
-  isJson: () => isJson25,
+  fromJson: () => fromJson26,
+  isJson: () => isJson26,
   isMetadata: () => isMetadata,
-  toJson: () => toJson25
+  toJson: () => toJson26
 });
 
 // packages/client/query/src/lib/models/grail-metadata.transformation.ts
 var grail_metadata_transformation_exports = {};
 __export(grail_metadata_transformation_exports, {
-  fromJson: () => fromJson23,
+  fromJson: () => fromJson24,
   isGrailMetadata: () => isGrailMetadata,
-  isJson: () => isJson23,
-  toJson: () => toJson23
+  isJson: () => isJson24,
+  toJson: () => toJson24
 });
 
 // packages/client/query/src/lib/models/timeframe.transformation.ts
 var timeframe_transformation_exports = {};
 __export(timeframe_transformation_exports, {
-  fromJson: () => fromJson22,
-  isJson: () => isJson22,
+  fromJson: () => fromJson23,
+  isJson: () => isJson23,
   isTimeframe: () => isTimeframe,
-  toJson: () => toJson22
+  toJson: () => toJson23
 });
 function isTimeframe(value) {
   if (value === null) {
@@ -2189,7 +2574,7 @@ function isTimeframe(value) {
   const allPropertiesMatchFormat = value.start instanceof Date && value.end instanceof Date;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson22(value) {
+function isJson23(value) {
   if (value === null) {
     return false;
   }
@@ -2209,14 +2594,14 @@ function isJson22(value) {
   const allPropertiesMatchFormat = /^((?:(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2}(?:\.\d+)?))(Z|[+-]\d{2}:\d{2})?)$/i.test(value.start) && /^((?:(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2}(?:\.\d+)?))(Z|[+-]\d{2}:\d{2})?)$/i.test(value.end);
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson22($model) {
+function fromJson23($model) {
   const { start, end } = $model;
   return {
     start: start !== void 0 && start !== null ? new Date(start) : void 0,
     end: end !== void 0 && end !== null ? new Date(end) : void 0
   };
 }
-function toJson22($model) {
+function toJson23($model) {
   const { start, end } = $model;
   return {
     start: start !== void 0 && start !== null ? start.toISOString() : void 0,
@@ -2273,7 +2658,7 @@ function isGrailMetadata(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson23(value) {
+function isJson24(value) {
   if (value === null) {
     return false;
   }
@@ -2321,7 +2706,7 @@ function isJson23(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson23($model) {
+function fromJson24($model) {
   const {
     canonicalQuery,
     timezone,
@@ -2345,15 +2730,15 @@ function fromJson23($model) {
     dqlVersion,
     scannedBytes,
     scannedDataPoints,
-    analysisTimeframe: analysisTimeframe !== void 0 && analysisTimeframe !== null ? fromJson22(analysisTimeframe) : void 0,
+    analysisTimeframe: analysisTimeframe !== void 0 && analysisTimeframe !== null ? fromJson23(analysisTimeframe) : void 0,
     locale,
     executionTimeMilliseconds,
-    notifications: notifications !== void 0 && notifications !== null ? notifications?.map((innerValue) => fromJson19(innerValue)) : void 0,
+    notifications: notifications !== void 0 && notifications !== null ? notifications?.map((innerValue) => fromJson20(innerValue)) : void 0,
     queryId,
     sampled
   };
 }
-function toJson23($model) {
+function toJson24($model) {
   const {
     canonicalQuery,
     timezone,
@@ -2377,10 +2762,10 @@ function toJson23($model) {
     dqlVersion,
     scannedBytes,
     scannedDataPoints,
-    analysisTimeframe: analysisTimeframe !== void 0 && analysisTimeframe !== null ? toJson22(analysisTimeframe) : void 0,
+    analysisTimeframe: analysisTimeframe !== void 0 && analysisTimeframe !== null ? toJson23(analysisTimeframe) : void 0,
     locale,
     executionTimeMilliseconds,
-    notifications: notifications !== void 0 && notifications !== null ? notifications?.map((innerValue) => toJson19(innerValue)) : void 0,
+    notifications: notifications !== void 0 && notifications !== null ? notifications?.map((innerValue) => toJson20(innerValue)) : void 0,
     queryId,
     sampled
   };
@@ -2389,10 +2774,10 @@ function toJson23($model) {
 // packages/client/query/src/lib/models/metric-metadata.transformation.ts
 var metric_metadata_transformation_exports = {};
 __export(metric_metadata_transformation_exports, {
-  fromJson: () => fromJson24,
-  isJson: () => isJson24,
+  fromJson: () => fromJson25,
+  isJson: () => isJson25,
   isMetricMetadata: () => isMetricMetadata,
-  toJson: () => toJson24
+  toJson: () => toJson25
 });
 function isMetricMetadata(value) {
   if (value === null) {
@@ -2432,7 +2817,7 @@ function isMetricMetadata(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson24(value) {
+function isJson25(value) {
   if (value === null) {
     return false;
   }
@@ -2470,7 +2855,7 @@ function isJson24(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson24($model) {
+function fromJson25($model) {
   const { "metric.key": metricKey, displayName, description, unit, fieldName, rollup, rate, shifted } = $model;
   return {
     "metric.key": metricKey,
@@ -2483,7 +2868,7 @@ function fromJson24($model) {
     shifted
   };
 }
-function toJson24($model) {
+function toJson25($model) {
   const { "metric.key": metricKey, displayName, description, unit, fieldName, rollup, rate, shifted } = $model;
   return {
     "metric.key": metricKey,
@@ -2518,7 +2903,7 @@ function isMetadata(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson25(value) {
+function isJson26(value) {
   if (value === null) {
     return false;
   }
@@ -2538,66 +2923,66 @@ function isJson25(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson25($model) {
+function fromJson26($model) {
   const { grail, metrics } = $model;
   return {
-    grail: grail !== void 0 && grail !== null ? fromJson23(grail) : void 0,
-    metrics: metrics !== void 0 && metrics !== null ? metrics?.map((innerValue) => fromJson24(innerValue)) : void 0
+    grail: grail !== void 0 && grail !== null ? fromJson24(grail) : void 0,
+    metrics: metrics !== void 0 && metrics !== null ? metrics?.map((innerValue) => fromJson25(innerValue)) : void 0
   };
 }
-function toJson25($model) {
+function toJson26($model) {
   const { grail, metrics } = $model;
   return {
-    grail: grail !== void 0 && grail !== null ? toJson23(grail) : void 0,
-    metrics: metrics !== void 0 && metrics !== null ? metrics?.map((innerValue) => toJson24(innerValue)) : void 0
+    grail: grail !== void 0 && grail !== null ? toJson24(grail) : void 0,
+    metrics: metrics !== void 0 && metrics !== null ? metrics?.map((innerValue) => toJson25(innerValue)) : void 0
   };
 }
 
 // packages/client/query/src/lib/models/ranged-field-types.transformation.ts
 var ranged_field_types_transformation_exports = {};
 __export(ranged_field_types_transformation_exports, {
-  fromJson: () => fromJson27,
-  isJson: () => isJson29,
+  fromJson: () => fromJson28,
+  isJson: () => isJson30,
   isRangedFieldTypes: () => isRangedFieldTypes,
-  toJson: () => toJson27
+  toJson: () => toJson28
 });
 
 // packages/client/query/src/lib/models/ranged-field-types-mappings.transformation.ts
 var ranged_field_types_mappings_transformation_exports = {};
 __export(ranged_field_types_mappings_transformation_exports, {
-  fromJson: () => fromJson29,
-  isJson: () => isJson28,
+  fromJson: () => fromJson30,
+  isJson: () => isJson29,
   isRangedFieldTypesMappings: () => isRangedFieldTypesMappings,
-  toJson: () => toJson29
+  toJson: () => toJson30
 });
 
 // packages/client/query/src/lib/models/field-type.transformation.ts
 var field_type_transformation_exports = {};
 __export(field_type_transformation_exports, {
-  fromJson: () => fromJson28,
+  fromJson: () => fromJson29,
   isFieldType: () => isFieldType,
-  isJson: () => isJson27,
-  toJson: () => toJson28
+  isJson: () => isJson28,
+  toJson: () => toJson29
 });
 
 // packages/client/query/src/lib/models/field-type-type.transformation.ts
 var field_type_type_transformation_exports = {};
 __export(field_type_type_transformation_exports, {
-  fromJson: () => fromJson26,
+  fromJson: () => fromJson27,
   isFieldTypeType: () => isFieldTypeType,
-  isJson: () => isJson26,
-  toJson: () => toJson26
+  isJson: () => isJson27,
+  toJson: () => toJson27
 });
 function isFieldTypeType(value) {
   return typeof value === "string";
 }
-function isJson26(value) {
+function isJson27(value) {
   return typeof value === "string";
 }
-function fromJson26($model) {
+function fromJson27($model) {
   return String($model);
 }
-function toJson26($model) {
+function toJson27($model) {
   return String($model);
 }
 
@@ -2622,7 +3007,7 @@ function isFieldType(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson27(value) {
+function isJson28(value) {
   if (value === null) {
     return false;
   }
@@ -2642,18 +3027,18 @@ function isJson27(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson28($model) {
+function fromJson29($model) {
   const { type, types } = $model;
   return {
-    type: fromJson26(type),
-    types: types !== void 0 && types !== null ? types?.map((innerValue) => fromJson27(innerValue)) : void 0
+    type: fromJson27(type),
+    types: types !== void 0 && types !== null ? types?.map((innerValue) => fromJson28(innerValue)) : void 0
   };
 }
-function toJson28($model) {
+function toJson29($model) {
   const { type, types } = $model;
   return {
-    type: toJson26(type),
-    types: types !== void 0 && types !== null ? types?.map((innerValue) => toJson27(innerValue)) : void 0
+    type: toJson27(type),
+    types: types !== void 0 && types !== null ? types?.map((innerValue) => toJson28(innerValue)) : void 0
   };
 }
 
@@ -2678,7 +3063,7 @@ function isRangedFieldTypesMappings(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson28(value) {
+function isJson29(value) {
   if (value === null) {
     return false;
   }
@@ -2698,24 +3083,24 @@ function isJson28(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson29($model) {
+function fromJson30($model) {
   const additionalProps = $model;
   return {
     ...Object.fromEntries(
       Object.entries(additionalProps).map(([propName, value]) => [
         propName,
-        value !== void 0 && value !== null ? fromJson28(value) : void 0
+        value !== void 0 && value !== null ? fromJson29(value) : void 0
       ])
     )
   };
 }
-function toJson29($model) {
+function toJson30($model) {
   const additionalProps = $model;
   return {
     ...Object.fromEntries(
       Object.entries(additionalProps).map(([propName, value]) => [
         propName,
-        value !== void 0 && value !== null ? toJson28(value) : void 0
+        value !== void 0 && value !== null ? toJson29(value) : void 0
       ])
     )
   };
@@ -2742,7 +3127,7 @@ function isRangedFieldTypes(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson29(value) {
+function isJson30(value) {
   if (value === null) {
     return false;
   }
@@ -2762,17 +3147,17 @@ function isJson29(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson27($model) {
+function fromJson28($model) {
   const { mappings, indexRange } = $model;
   return {
-    mappings: fromJson29(mappings),
+    mappings: fromJson30(mappings),
     indexRange: indexRange !== void 0 && indexRange !== null ? indexRange?.slice(0) : void 0
   };
 }
-function toJson27($model) {
+function toJson28($model) {
   const { mappings, indexRange } = $model;
   return {
-    mappings: toJson29(mappings),
+    mappings: toJson30(mappings),
     indexRange: indexRange !== void 0 && indexRange !== null ? indexRange?.slice(0) : void 0
   };
 }
@@ -2780,10 +3165,10 @@ function toJson27($model) {
 // packages/client/query/src/lib/models/result-record.transformation.ts
 var result_record_transformation_exports = {};
 __export(result_record_transformation_exports, {
-  fromJson: () => fromJson31,
-  isJson: () => isJson31,
+  fromJson: () => fromJson32,
+  isJson: () => isJson32,
   isResultRecord: () => isResultRecord,
-  toJson: () => toJson31
+  toJson: () => toJson32
 });
 
 // packages/client/query/src/lib/models/result-record-value.transformation.ts
@@ -2802,19 +3187,19 @@ __export(result_record_value_transformation_exports, {
   checkString: () => checkString,
   checkTimeframe: () => checkTimeframe,
   checkTimeframeAsJson: () => checkTimeframeAsJson,
-  fromJson: () => fromJson32,
-  isJson: () => isJson32,
+  fromJson: () => fromJson33,
+  isJson: () => isJson33,
   isResultRecordValue: () => isResultRecordValue,
-  toJson: () => toJson32
+  toJson: () => toJson33
 });
 
 // packages/client/query/src/lib/models/geo-point.transformation.ts
 var geo_point_transformation_exports = {};
 __export(geo_point_transformation_exports, {
-  fromJson: () => fromJson30,
+  fromJson: () => fromJson31,
   isGeoPoint: () => isGeoPoint,
-  isJson: () => isJson30,
-  toJson: () => toJson30
+  isJson: () => isJson31,
+  toJson: () => toJson31
 });
 function isGeoPoint(value) {
   if (value === null) {
@@ -2836,7 +3221,7 @@ function isGeoPoint(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson30(value) {
+function isJson31(value) {
   if (value === null) {
     return false;
   }
@@ -2856,14 +3241,14 @@ function isJson30(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson30($model) {
+function fromJson31($model) {
   const { latitude, longitude } = $model;
   return {
     latitude,
     longitude
   };
 }
-function toJson30($model) {
+function toJson31($model) {
   const { latitude, longitude } = $model;
   return {
     latitude,
@@ -2901,13 +3286,13 @@ function isResultRecordValue(value) {
   return checkBoolean(value) || checkNumber(value) || checkString(value) || checkTimeframe(value) || checkGeoPoint(value) || checkResultRecord(value) || checkArrayResultRecordValue(value) || value === null;
 }
 function checkTimeframeAsJson(value) {
-  return isJson22(value);
+  return isJson23(value);
 }
 function checkGeoPointAsJson(value) {
-  return isJson30(value);
+  return isJson31(value);
 }
 function checkResultRecordAsJson(value) {
-  return isJson31(value);
+  return isJson32(value);
 }
 function checkArrayResultRecordValueTransformationAsJsonNullItemDatatype(value) {
   return isResultRecordValue(value);
@@ -2916,11 +3301,11 @@ function checkArrayResultRecordValueAsJson(value) {
   const datatypeMatch = (val) => checkArrayResultRecordValueTransformationAsJsonNullItemDatatype(val);
   return Array.isArray(value) && value.every(datatypeMatch);
 }
-function isJson32(value) {
+function isJson33(value) {
   return checkBoolean(value) || checkNumber(value) || checkString(value) || checkTimeframeAsJson(value) || checkGeoPointAsJson(value) || checkResultRecordAsJson(value) || checkArrayResultRecordValueAsJson(value) || value === null;
 }
-function fromJson32($model) {
-  if (!isJson32($model)) {
+function fromJson33($model) {
+  if (!isJson33($model)) {
     throw new TypeError("_ResultRecordValueTransformation.fromJson: value's datatype does not match");
   }
   if ($model === null) {
@@ -2936,20 +3321,20 @@ function fromJson32($model) {
     return String($model);
   }
   if (checkTimeframeAsJson($model)) {
-    return fromJson22($model);
+    return fromJson23($model);
   }
   if (checkGeoPointAsJson($model)) {
-    return fromJson30($model);
+    return fromJson31($model);
   }
   if (checkResultRecordAsJson($model)) {
-    return fromJson31($model);
+    return fromJson32($model);
   }
   if (checkArrayResultRecordValue($model)) {
-    return $model.map((el) => fromJson32(el));
+    return $model.map((el) => fromJson33(el));
   }
   throw new TypeError("Unable to deserialize value");
 }
-function toJson32($model) {
+function toJson33($model) {
   if (!isResultRecordValue($model)) {
     throw new TypeError("_ResultRecordValueTransformation.toJson: value's datatype does not match");
   }
@@ -2966,16 +3351,16 @@ function toJson32($model) {
     return String($model);
   }
   if (checkTimeframe($model)) {
-    return toJson22($model);
+    return toJson23($model);
   }
   if (checkGeoPoint($model)) {
-    return toJson30($model);
+    return toJson31($model);
   }
   if (checkResultRecord($model)) {
-    return toJson31($model);
+    return toJson32($model);
   }
   if (checkArrayResultRecordValue($model)) {
-    return $model.map((el) => toJson32(el));
+    return $model.map((el) => toJson33(el));
   }
   throw new TypeError("Unable to serialize value");
 }
@@ -3001,7 +3386,7 @@ function isResultRecord(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson31(value) {
+function isJson32(value) {
   if (value === null) {
     return true;
   }
@@ -3021,7 +3406,7 @@ function isJson31(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson31($model) {
+function fromJson32($model) {
   if ($model === null) {
     return null;
   }
@@ -3030,12 +3415,12 @@ function fromJson31($model) {
     ...Object.fromEntries(
       Object.entries(additionalProps).map(([propName, value]) => [
         propName,
-        value !== void 0 ? fromJson32(value) : void 0
+        value !== void 0 ? fromJson33(value) : void 0
       ])
     )
   };
 }
-function toJson31($model) {
+function toJson32($model) {
   if ($model === null) {
     return null;
   }
@@ -3044,7 +3429,7 @@ function toJson31($model) {
     ...Object.fromEntries(
       Object.entries(additionalProps).map(([propName, value]) => [
         propName,
-        value !== void 0 && value !== null ? toJson32(value) : void 0
+        value !== void 0 && value !== null ? toJson33(value) : void 0
       ])
     )
   };
@@ -3071,7 +3456,7 @@ function isQueryResult(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson33(value) {
+function isJson34(value) {
   if (value === null) {
     return false;
   }
@@ -3091,41 +3476,41 @@ function isJson33(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson33($model) {
+function fromJson34($model) {
   const { records, metadata, types } = $model;
   return {
-    records: records?.map((innerValue) => fromJson31(innerValue)),
-    metadata: fromJson25(metadata),
-    types: types?.map((innerValue) => fromJson27(innerValue))
+    records: records?.map((innerValue) => fromJson32(innerValue)),
+    metadata: fromJson26(metadata),
+    types: types?.map((innerValue) => fromJson28(innerValue))
   };
 }
-function toJson33($model) {
+function toJson34($model) {
   const { records, metadata, types } = $model;
   return {
-    records: records?.map((innerValue) => toJson31(innerValue)),
-    metadata: toJson25(metadata),
-    types: types?.map((innerValue) => toJson27(innerValue))
+    records: records?.map((innerValue) => toJson32(innerValue)),
+    metadata: toJson26(metadata),
+    types: types?.map((innerValue) => toJson28(innerValue))
   };
 }
 
 // packages/client/query/src/lib/models/query-state.transformation.ts
 var query_state_transformation_exports = {};
 __export(query_state_transformation_exports, {
-  fromJson: () => fromJson34,
-  isJson: () => isJson34,
+  fromJson: () => fromJson35,
+  isJson: () => isJson35,
   isQueryState: () => isQueryState,
-  toJson: () => toJson34
+  toJson: () => toJson35
 });
 function isQueryState(value) {
   return typeof value === "string";
 }
-function isJson34(value) {
+function isJson35(value) {
   return typeof value === "string";
 }
-function fromJson34($model) {
+function fromJson35($model) {
   return String($model);
 }
-function toJson34($model) {
+function toJson35($model) {
   return String($model);
 }
 
@@ -3150,7 +3535,7 @@ function isQueryPollResponse(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson35(value) {
+function isJson36(value) {
   if (value === null) {
     return false;
   }
@@ -3170,32 +3555,32 @@ function isJson35(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson35($model) {
+function fromJson36($model) {
   const { result, ttlSeconds, progress, state } = $model;
   return {
-    result: result !== void 0 && result !== null ? fromJson33(result) : void 0,
+    result: result !== void 0 && result !== null ? fromJson34(result) : void 0,
     ttlSeconds,
     progress,
-    state: fromJson34(state)
+    state: fromJson35(state)
   };
 }
-function toJson35($model) {
+function toJson36($model) {
   const { result, ttlSeconds, progress, state } = $model;
   return {
-    result: result !== void 0 && result !== null ? toJson33(result) : void 0,
+    result: result !== void 0 && result !== null ? toJson34(result) : void 0,
     ttlSeconds,
     progress,
-    state: toJson34(state)
+    state: toJson35(state)
   };
 }
 
 // packages/client/query/src/lib/models/query-start-response.transformation.ts
 var query_start_response_transformation_exports = {};
 __export(query_start_response_transformation_exports, {
-  fromJson: () => fromJson36,
-  isJson: () => isJson36,
+  fromJson: () => fromJson37,
+  isJson: () => isJson37,
   isQueryStartResponse: () => isQueryStartResponse,
-  toJson: () => toJson36
+  toJson: () => toJson37
 });
 function isQueryStartResponse(value) {
   if (value === null) {
@@ -3217,7 +3602,7 @@ function isQueryStartResponse(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson36(value) {
+function isJson37(value) {
   if (value === null) {
     return false;
   }
@@ -3237,24 +3622,24 @@ function isJson36(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson36($model) {
+function fromJson37($model) {
   const { result, ttlSeconds, progress, requestToken, state } = $model;
   return {
-    result: result !== void 0 && result !== null ? fromJson33(result) : void 0,
+    result: result !== void 0 && result !== null ? fromJson34(result) : void 0,
     ttlSeconds,
     progress,
     requestToken,
-    state: fromJson34(state)
+    state: fromJson35(state)
   };
 }
-function toJson36($model) {
+function toJson37($model) {
   const { result, ttlSeconds, progress, requestToken, state } = $model;
   return {
-    result: result !== void 0 && result !== null ? toJson33(result) : void 0,
+    result: result !== void 0 && result !== null ? toJson34(result) : void 0,
     ttlSeconds,
     progress,
     requestToken,
-    state: toJson34(state)
+    state: toJson35(state)
   };
 }
 
@@ -3288,10 +3673,60 @@ var toQueryString = (rawQuery, flags = {}) => {
 // packages/client/query/src/lib/apis/query-execution-api.ts
 var QueryExecutionClient = class {
   httpClient;
+  /**
+   * @param {HttpClient} httpClientImplementation - You can provide custom http client as a parameter to constructor of a QueryExecutionClient. Custom http client should implement {HttpClient} interface.
+   * @example
+   * const queryExecutionClientNodeJs = new QueryExecutionClient(yourCustomImplementation);
+   */
   constructor(httpClientImplementation) {
     this.httpClient = httpClientImplementation;
     registerGlobalErrorSerializer(apiClientErrorSerializer);
   }
+  /**
+   * Retrieves query status and final result from Grail.
+   *
+   * For information about the required permissions see the [Bucket and table permissions in Grail documentation](https://docs.dynatrace.com/docs/shortlink/assign-bucket-table-permissions).
+   *
+   * ### Overview:
+   *
+   * Polls the status of a Grail query. Returns the status of the query, including the result if the query finished.
+   *
+   * ### The response format:
+   * The json response will contain the state of the query. If the query succeeded, the result will be included.
+   *
+   * The result has two main sections:
+   * * The 'records' section contains the individual records, where each record consists of a set of fields and their corresponding values.
+   * * The 'types' section describes the corresponding data types that a record field has.
+   *
+   * Every record has an implicit 'index' according to the position in the 'records' JSON array.
+   * The types section has a list of 1..N possible type 'buckets'. Each such bucket has an 'indexRange' which indicates which
+   * records will find their field types in which bucket. The index range has two values start & end and can be thought of as [startIndex, endIndex).
+   *
+   * A field part of a record with index 'i' will find its corresponding field type by first locating the bucket that satisfies:
+   *
+   * ```text
+   * startIndex <= i <= endIndex
+   * ```
+   *
+   * Once the bucket is found the 'mappings' object has an entry for all the fields that are part of that record with index 'i'.
+   *
+   *
+   * Since enforcement of a particular schema is absent at ingestion time, it is possible to have records that share the same
+   * field name but their values are of a different type. This phenomenon will hence forth be named as a **"collision"**.
+   * When a collision does occur, we will create a new type 'bucket' that will have a different index range where
+   * the new record field types will be placed.
+   * It is guaranteed that every field of every record will have a corresponding type.
+   * **Clients should always take the included types into account when consuming records!**
+   *
+   * @returns The current status and results of the supplied query.
+   *
+   * @example <caption>Code example</caption>
+   * import { queryExecutionClient } from "@dynatrace-sdk/client-query";
+   *
+   * const data = await queryExecutionClient.queryPoll({
+   *   requestToken: "...",
+   * });
+   */
   async queryPoll(config) {
     if (!config) {
       throw new ApiClientError("API client error", "API client call is missing mandatory config parameter");
@@ -3318,7 +3753,7 @@ var QueryExecutionClient = class {
       });
       const responseValue = await response.body("json");
       try {
-        return fromJson35(responseValue);
+        return fromJson36(responseValue);
       } catch (err) {
         throw new InvalidResponseError(`QueryExecutionClient.query:poll:200`, err, responseValue, void 0, void 0);
       }
@@ -3334,7 +3769,7 @@ var QueryExecutionClient = class {
         case 400: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `400`,
               response,
@@ -3359,7 +3794,10 @@ var QueryExecutionClient = class {
           }
         }
         case 410: {
-          const responseValue = await response.body("text");
+          const responseValue = await response.body(
+            "text"
+            /* type from spec unsupported */
+          );
           throw new ClientRequestError(
             `410`,
             response,
@@ -3370,7 +3808,7 @@ var QueryExecutionClient = class {
         case 500: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `500`,
               response,
@@ -3404,11 +3842,62 @@ var QueryExecutionClient = class {
       }
     }
   }
+  /**
+   * Starts a Grail query.
+   *
+   * For information about the required permissions see the [Bucket and table permissions in Grail documentation](https://docs.dynatrace.com/docs/shortlink/assign-bucket-table-permissions).
+   *
+   * ### Overview:
+   *
+   * Executes a query and returns a list of records.
+   *
+   * For details about the query language see the [Dynatrace Query Language documentation](https://dt-url.net/bv03yk8).
+   *
+   * ### The response format:
+   *
+   * The json response will contain the state of the started query. If the query succeeded, the result will be included. Otherwise the response will contain a request token to reference the query in future polling requests.
+   *
+   * The result has two main sections:
+   * * The 'records' section contains the individual records, where each record consists of a set of fields and their corresponding values.
+   * * The 'types' section describes the corresponding data types that a record field has.
+   *
+   * Every record has an implicit 'index' according to the position in the 'records' JSON array.
+   * The types section has a list of 1..N possible type 'buckets'. Each such bucket has an 'indexRange' which indicates which
+   * records will find their field types in which bucket. The index range has two values start & end and can be thought of as [startIndex, endIndex).
+   *
+   * A field part of a record with index 'i' will find its corresponding field type by first locating the bucket that satisfies:
+   *
+   * ```text
+   * startIndex <= i <= endIndex
+   * ```
+   *
+   * Once the bucket is found the 'mappings' object has an entry for all the fields that are part of that record with index 'i'.
+   *
+   *
+   * Since enforcement of a particular schema is absent at ingestion time, it is possible to have records that share the same
+   * field name but their values are of a different type. This phenomenon will hence forth be named as a **"collision"**.
+   * When a collision does occur, we will create a new type 'bucket' that will have a different index range where
+   * the new record field types will be placed.
+   * It is guaranteed that every field of every record will have a corresponding type.
+   * **Clients should always take the included types into account when consuming records!**
+   *
+   * @returns The final status and results of the supplied query if it finished within a supplied requestTimeoutMilliseconds. | The status of the query to start.
+   *
+   * @example <caption>Code example</caption>
+   * import { queryExecutionClient } from "@dynatrace-sdk/client-query";
+   *
+   * const data = await queryExecutionClient.queryExecute({
+   *   body: {
+   *     query:
+   *       'fetch events | filter event.type == "davis" AND davis.status != "CLOSED" | fields timestamp, davis.title, davis.underMaintenance, davis.status | sort timestamp | limit 10',
+   *   },
+   * });
+   */
   async queryExecute(config) {
     if (!config) {
       throw new ApiClientError("API client error", "API client call is missing mandatory config parameter");
     }
-    const encodedBody = toJson21(config.body);
+    const encodedBody = toJson22(config.body);
     const query = toQueryString({ enrich: config.enrich });
     try {
       const response = await this.httpClient.send({
@@ -3429,7 +3918,7 @@ var QueryExecutionClient = class {
         case 200: {
           const responseValue = await response.body("json");
           try {
-            return fromJson36(responseValue);
+            return fromJson37(responseValue);
           } catch (err) {
             throw new InvalidResponseError(
               `QueryExecutionClient.query:execute:${response.status}`,
@@ -3443,7 +3932,7 @@ var QueryExecutionClient = class {
         case 202: {
           const responseValue = await response.body("json");
           try {
-            return fromJson36(responseValue);
+            return fromJson37(responseValue);
           } catch (err) {
             throw new InvalidResponseError(
               `QueryExecutionClient.query:execute:${response.status}`,
@@ -3476,7 +3965,7 @@ var QueryExecutionClient = class {
         case 400: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `400`,
               response,
@@ -3503,7 +3992,7 @@ var QueryExecutionClient = class {
         case 403: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `403`,
               response,
@@ -3527,7 +4016,7 @@ var QueryExecutionClient = class {
         case 429: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `429`,
               response,
@@ -3551,7 +4040,7 @@ var QueryExecutionClient = class {
         case 500: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `500`,
               response,
@@ -3575,7 +4064,7 @@ var QueryExecutionClient = class {
         case 503: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `503`,
               response,
@@ -3600,7 +4089,7 @@ var QueryExecutionClient = class {
           if (response.status >= 400 && response.status <= 499) {
             const responseValue = await response.body("json");
             try {
-              const errorBody = fromJson16(responseValue);
+              const errorBody = fromJson17(responseValue);
               throw new ErrorEnvelopeError(
                 `${response.status}`,
                 response,
@@ -3623,7 +4112,7 @@ var QueryExecutionClient = class {
           } else if (response.status >= 500 && response.status <= 599) {
             const responseValue = await response.body("json");
             try {
-              const errorBody = fromJson16(responseValue);
+              const errorBody = fromJson17(responseValue);
               throw new ErrorEnvelopeError(
                 `${response.status}`,
                 response,
@@ -3659,6 +4148,53 @@ var QueryExecutionClient = class {
       }
     }
   }
+  /**
+   * Cancels the query and returns the result if the query was already finished, otherwise discards it.
+   *
+   * For information about the required permissions see the [Bucket and table permissions in Grail documentation](https://docs.dynatrace.com/docs/shortlink/assign-bucket-table-permissions).
+   *
+   * ### Overview:
+   *
+   * Cancels a running Grail query and returns a list of records if the query already finished.
+   *
+   * ### The response format:
+   *
+   * If the query was already finished, a response body including the result will be returned. Otherwise the response will contain no body.
+   *
+   * The result has three main sections:
+   * * the 'records' section contains the individual records, where each record consists of a set of fields and their corresponding values.
+   * * the 'types' section describes the corresponding data types that a record field has.
+   * * the 'metadata' section contains information about the query like 'analysisTimeframe', 'timezone' or 'locale'.
+   *
+   * Every record has an implicit 'index' according to the position in the 'records' JSON array.
+   * The types section has a list of 1..N possible type 'buckets'. Each such bucket has an 'indexRange' which indicates which
+   * records will find their field types in which bucket. The index range has two values start & end and can be thought of as [startIndex, endIndex).
+   *
+   * A field part of a record with index 'i' will find its corresponding field type by first locating the bucket that satisfies:
+   *
+   * ```text
+   * startIndex <= i <= endIndex
+   * ```
+   *
+   * Once the bucket is found the 'mappings' object has an entry for all the fields that are part of that record with index 'i'.
+   *
+   *
+   * Since enforcement of a particular schema is absent at ingestion time, it is possible to have records that share the same
+   * field name but their values are of a different type. This phenomenon will hence forth be named as a **"collision"**.
+   * When a collision does occur, we will create a new type 'bucket' that will have a different index range where
+   * the new record field types will be placed.
+   * It is guaranteed that every field of every record will have a corresponding type.
+   * **Clients should always take the included types into account when consuming records!**
+   *
+   * @returns The query already finished.
+   *
+   * @example <caption>Code example</caption>
+   * import { queryExecutionClient } from "@dynatrace-sdk/client-query";
+   *
+   * const data = await queryExecutionClient.queryCancel({
+   *   requestToken: "...",
+   * });
+   */
   async queryCancel(config) {
     if (!config) {
       throw new ApiClientError("API client error", "API client call is missing mandatory config parameter");
@@ -3683,7 +4219,7 @@ var QueryExecutionClient = class {
         case 200: {
           const responseValue = await response.body("json");
           try {
-            return fromJson35(responseValue);
+            return fromJson36(responseValue);
           } catch (err) {
             throw new InvalidResponseError(
               `QueryExecutionClient.query:cancel:${response.status}`,
@@ -3719,7 +4255,7 @@ var QueryExecutionClient = class {
         case 400: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `400`,
               response,
@@ -3744,7 +4280,10 @@ var QueryExecutionClient = class {
           }
         }
         case 410: {
-          const responseValue = await response.body("text");
+          const responseValue = await response.body(
+            "text"
+            /* type from spec unsupported */
+          );
           throw new ClientRequestError(
             `410`,
             response,
@@ -3755,7 +4294,7 @@ var QueryExecutionClient = class {
         case 500: {
           const responseValue = await response.body("json");
           try {
-            const errorBody = fromJson16(responseValue);
+            const errorBody = fromJson17(responseValue);
             throw new ErrorEnvelopeError(
               `500`,
               response,