npm - @dynatrace-sdk/client-query - Versions diffs - 1.11.0 → 1.12.1 - Mend

@dynatrace-sdk/client-query 1.11.0 → 1.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (34) hide show

package/esm/index.js CHANGED Viewed

@@ -978,30 +978,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;
@@ -1021,26 +1088,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;
   }
@@ -1059,26 +1134,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,
@@ -1088,21 +1171,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,
@@ -1112,18 +1203,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
   };
 }
@@ -1140,15 +1239,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;
   }
@@ -1160,27 +1259,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
   };
 }
@@ -1206,7 +1305,7 @@ function isErrorEnvelope(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson16(value) {
+function isJson17(value) {
   if (value === null) {
     return false;
   }
@@ -1226,26 +1325,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;
 }
@@ -1253,10 +1352,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) {
@@ -1278,7 +1377,7 @@ function isParseRequest(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson17(value) {
+function isJson18(value) {
   if (value === null) {
     return false;
   }
@@ -1298,7 +1397,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,
@@ -1307,7 +1406,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,
@@ -1320,10 +1419,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) {
@@ -1345,7 +1444,7 @@ function isVerifyRequest(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson18(value) {
+function isJson19(value) {
   if (value === null) {
     return false;
   }
@@ -1365,7 +1464,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,
@@ -1375,7 +1474,7 @@ function fromJson18($model) {
     generateCanonicalQuery
   };
 }
-function toJson18($model) {
+function toJson19($model) {
   const { query, timezone, locale, queryOptions, generateCanonicalQuery } = $model;
   return {
     query,
@@ -1389,19 +1488,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) {
@@ -1439,7 +1538,7 @@ function isMetadataNotification(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson19(value) {
+function isJson20(value) {
   if (value === null) {
     return false;
   }
@@ -1475,7 +1574,7 @@ function isJson19(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson19($model) {
+function fromJson20($model) {
   const {
     severity,
     messageFormat,
@@ -1495,7 +1594,7 @@ function fromJson19($model) {
     message
   };
 }
-function toJson19($model) {
+function toJson20($model) {
   const {
     severity,
     messageFormat,
@@ -1537,7 +1636,7 @@ function isVerifyResponse(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson20(value) {
+function isJson21(value) {
   if (value === null) {
     return false;
   }
@@ -1557,35 +1656,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`,
@@ -1603,7 +1729,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`,
@@ -1625,7 +1751,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,
@@ -1649,7 +1775,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,
@@ -1683,11 +1809,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`,
@@ -1727,7 +2060,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,
@@ -1754,7 +2087,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,
@@ -1788,6 +2121,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");
@@ -1832,7 +2216,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,
@@ -1859,7 +2243,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,
@@ -1906,10 +2290,10 @@ import {
 // 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) {
@@ -1958,7 +2342,7 @@ function isExecuteRequest(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson21(value) {
+function isJson22(value) {
   if (value === null) {
     return false;
   }
@@ -2005,7 +2389,7 @@ function isJson21(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson21($model) {
+function fromJson22($model) {
   const {
     query,
     defaultTimeframeStart,
@@ -2037,7 +2421,7 @@ function fromJson21($model) {
     queryOptions: queryOptions !== void 0 && queryOptions !== null ? fromJson(queryOptions) : void 0
   };
 }
-function toJson21($model) {
+function toJson22($model) {
   const {
     query,
     defaultTimeframeStart,
@@ -2073,46 +2457,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) {
@@ -2134,7 +2518,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;
   }
@@ -2154,14 +2538,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,
@@ -2218,7 +2602,7 @@ function isGrailMetadata(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson23(value) {
+function isJson24(value) {
   if (value === null) {
     return false;
   }
@@ -2266,7 +2650,7 @@ function isJson23(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson23($model) {
+function fromJson24($model) {
   const {
     canonicalQuery,
     timezone,
@@ -2290,15 +2674,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,
@@ -2322,10 +2706,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
   };
@@ -2334,10 +2718,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) {
@@ -2377,7 +2761,7 @@ function isMetricMetadata(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson24(value) {
+function isJson25(value) {
   if (value === null) {
     return false;
   }
@@ -2415,7 +2799,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,
@@ -2428,7 +2812,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,
@@ -2463,7 +2847,7 @@ function isMetadata(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson25(value) {
+function isJson26(value) {
   if (value === null) {
     return false;
   }
@@ -2483,66 +2867,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);
 }
@@ -2567,7 +2951,7 @@ function isFieldType(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson27(value) {
+function isJson28(value) {
   if (value === null) {
     return false;
   }
@@ -2587,18 +2971,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
   };
 }
@@ -2623,7 +3007,7 @@ function isRangedFieldTypesMappings(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson28(value) {
+function isJson29(value) {
   if (value === null) {
     return false;
   }
@@ -2643,24 +3027,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
       ])
     )
   };
@@ -2687,7 +3071,7 @@ function isRangedFieldTypes(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson29(value) {
+function isJson30(value) {
   if (value === null) {
     return false;
   }
@@ -2707,17 +3091,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
   };
 }
@@ -2725,10 +3109,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
@@ -2747,19 +3131,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) {
@@ -2781,7 +3165,7 @@ function isGeoPoint(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson30(value) {
+function isJson31(value) {
   if (value === null) {
     return false;
   }
@@ -2801,14 +3185,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,
@@ -2846,13 +3230,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);
@@ -2861,11 +3245,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) {
@@ -2881,20 +3265,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");
   }
@@ -2911,16 +3295,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");
 }
@@ -2946,7 +3330,7 @@ function isResultRecord(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson31(value) {
+function isJson32(value) {
   if (value === null) {
     return true;
   }
@@ -2966,7 +3350,7 @@ function isJson31(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function fromJson31($model) {
+function fromJson32($model) {
   if ($model === null) {
     return null;
   }
@@ -2975,12 +3359,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;
   }
@@ -2989,7 +3373,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
       ])
     )
   };
@@ -3016,7 +3400,7 @@ function isQueryResult(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson33(value) {
+function isJson34(value) {
   if (value === null) {
     return false;
   }
@@ -3036,41 +3420,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);
 }
@@ -3095,7 +3479,7 @@ function isQueryPollResponse(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson35(value) {
+function isJson36(value) {
   if (value === null) {
     return false;
   }
@@ -3115,32 +3499,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) {
@@ -3162,7 +3546,7 @@ function isQueryStartResponse(value) {
   const allPropertiesMatchFormat = true;
   return containsRequiredOrOptionalKeys && doesNotContainExtraKeys && allPropertiesMatchFormat;
 }
-function isJson36(value) {
+function isJson37(value) {
   if (value === null) {
     return false;
   }
@@ -3182,24 +3566,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)
   };
 }
@@ -3233,10 +3617,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");
@@ -3263,7 +3697,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);
       }
@@ -3279,7 +3713,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,
@@ -3304,7 +3738,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,
@@ -3315,7 +3752,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,
@@ -3349,11 +3786,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({
@@ -3374,7 +3862,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}`,
@@ -3388,7 +3876,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}`,
@@ -3421,7 +3909,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,
@@ -3448,7 +3936,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,
@@ -3472,7 +3960,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,
@@ -3496,7 +3984,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,
@@ -3520,7 +4008,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,
@@ -3545,7 +4033,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,
@@ -3568,7 +4056,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,
@@ -3604,6 +4092,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");
@@ -3628,7 +4163,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}`,
@@ -3664,7 +4199,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,
@@ -3689,7 +4224,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,
@@ -3700,7 +4238,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,
@@ -3842,6 +4380,7 @@ export {
   dql_node_transformation_exports as _DQLNodeTransformation,
   dql_terminal_node_transformation_exports as _DQLTerminalNodeTransformation,
   error_envelope_transformation_exports as _ErrorEnvelopeTransformation,
+  error_response_details_constraint_violations_item_transformation_exports as _ErrorResponseDetailsConstraintViolationsItemTransformation,
   error_response_details_transformation_exports as _ErrorResponseDetailsTransformation,
   error_response_transformation_exports as _ErrorResponseTransformation,
   execute_request_transformation_exports as _ExecuteRequestTransformation,