@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
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +73 -53
  3. package/cjs/index.js +782 -243
  4. package/dynatrace-metadata.json +2 -2
  5. package/esm/index.js +782 -243
  6. package/package.json +2 -2
  7. package/types/packages/client/query/src/lib/models/dql-node-node-type.transformation.d.ts +1 -1
  8. package/types/packages/client/query/src/lib/models/error-response-details-constraint-violations-item.d.ts +14 -0
  9. package/types/packages/client/query/src/lib/models/error-response-details-constraint-violations-item.transformation.d.ts +10 -0
  10. package/types/packages/client/query/src/lib/models/error-response-details.d.ts +20 -7
  11. package/types/packages/client/query/src/lib/models/error-response-details.transformation.d.ts +11 -7
  12. package/types/packages/client/query/src/lib/models/error-response.d.ts +1 -1
  13. package/types/packages/client/query/src/lib/models/error-response.transformation.d.ts +1 -1
  14. package/types/packages/client/query/src/lib/models/field-type-type.transformation.d.ts +1 -1
  15. package/types/packages/client/query/src/lib/models/index.d.ts +2 -0
  16. package/types/packages/client/query/src/lib/models/query-state.transformation.d.ts +1 -1
  17. package/types/packages/client/query/src/lib/models/result-record-value.d.ts +1 -1
  18. package/types/packages/client/query/src/lib/models/result-record-value.transformation.d.ts +1 -1
  19. package/types/packages/client/query/src/lib/models/token-type.transformation.d.ts +1 -1
  20. package/types/packages/client/query/src/lib/utils/url-helpers.d.ts +1 -1
  21. package/types/packages/http-client/src/lib/platform/abort-controller.d.ts +1 -1
  22. package/types/packages/http-client/src/lib/platform/abort-signal.d.ts +1 -1
  23. package/types/packages/http-client/src/lib/platform/decode-form-data.d.ts +48 -0
  24. package/types/packages/http-client/src/lib/platform/http-client.d.ts +8 -0
  25. package/types/packages/http-client/src/lib/types/abort-signal.d.ts +4 -1
  26. package/types/packages/http-client/src/lib/types/data-types.d.ts +1 -1
  27. package/types/packages/http-client/src/lib/types/form-data-request-body.d.ts +2 -2
  28. package/types/packages/http-client/src/lib/types/form-data-response-body.d.ts +2 -2
  29. package/types/packages/http-client/src/lib/types/request-body-types.d.ts +1 -1
  30. package/types/packages/http-client/src/lib/types/response-body-types.d.ts +1 -1
  31. package/types/packages/platform/error-handlers/src/lib/types/global-dt-runtime-with-error-handlers.d.ts +1 -1
  32. package/types/packages/platform/error-handlers/src/lib/types/global-error-serializer.d.ts +1 -1
  33. package/types/packages/platform/error-handlers/src/lib/types/serialized-error.d.ts +1 -1
  34. package/docs/DOCS.md +0 -1207
package/CHANGELOG.md CHANGED
@@ -2,6 +2,30 @@
2
2
 
3
3
  @dynatrace-sdk/client-query
4
4
 
5
+ ## 1.12.1
6
+
7
+ ### Patch Changes
8
+
9
+ - Updated boolean serialization handling. APPDEV-9047
10
+
11
+ ## 1.12.0
12
+
13
+ ### Minor Changes
14
+
15
+ - Client updated to support latest API changes. NOISSUE
16
+ - Updated dependencies
17
+ - @dynatrace-sdk/http-client@1.3.0
18
+
19
+ ### Patch Changes
20
+
21
+ - Documentation removed from the package. APPDEV-8356
22
+
23
+ ## 1.11.1
24
+
25
+ ### Patch Changes
26
+
27
+ - Fix broken links in the readme file.
28
+
5
29
  ## 1.11.0
6
30
 
7
31
  ### Minor Changes
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @dynatrace-sdk/client-query
2
2
 
3
- [![npm](https://img.shields.io/badge/npm-v1.11.0-blue)](https://www.npmjs.com/package/@dynatrace-sdk/client-query/v/1.11.0)
3
+ [![npm](https://img.shields.io/badge/npm-v1.12.1-blue)](https://www.npmjs.com/package/@dynatrace-sdk/client-query/v/1.12.1)
4
4
  [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
5
5
 
6
6
  Exposes an API to fetch records stored in Grail
@@ -35,10 +35,11 @@ import { queryAssistanceClient } from '@dynatrace-sdk/client-query';
35
35
  ```
36
36
 
37
37
 
38
+ <a name="queryautocomplete"></a>
38
39
  ### queryAutocomplete
39
40
 
40
41
  <div class="padding-bottom--md">
41
- <strong>queryAssistanceClient.queryAutocomplete(config): Promise&lt;[AutocompleteResponse](#autocompleteresponse)&gt;</strong>
42
+ <strong>queryAssistanceClient.queryAutocomplete(config): Promise&lt;<a href="#autocompleteresponse">AutocompleteResponse</a>&gt;</strong>
42
43
 
43
44
  <div class="padding-left--md">
44
45
 
@@ -89,7 +90,7 @@ a link to docs, etc.
89
90
 
90
91
  | Name | Type |
91
92
  | --- | --- |
92
- |config.body<sup>*required</sup>|[AutocompleteRequest](#autocompleterequest)|
93
+ |config.body<sup>*required</sup>|<a href="#autocompleterequest" target="_blank" rel="noopener noreferrer">AutocompleteRequest</a>|
93
94
 
94
95
 
95
96
 
@@ -102,7 +103,6 @@ A list of structured autocomplete suggestions.
102
103
  <details>
103
104
  <summary>
104
105
  Code example
105
-
106
106
  </summary>
107
107
 
108
108
  ```ts
@@ -123,10 +123,11 @@ const data = await queryAssistanceClient.queryAutocomplete({
123
123
  </div>
124
124
 
125
125
 
126
+ <a name="queryparse"></a>
126
127
  ### queryParse
127
128
 
128
129
  <div class="padding-bottom--md">
129
- <strong>queryAssistanceClient.queryParse(config): Promise&lt;[DQLNode](#dqlnode)&gt;</strong>
130
+ <strong>queryAssistanceClient.queryParse(config): Promise&lt;<a href="#dqlnode">DQLNode</a>&gt;</strong>
130
131
 
131
132
  <div class="padding-left--md">
132
133
 
@@ -333,7 +334,7 @@ When displaying the query, pick one option. You may use the other options for ho
333
334
 
334
335
  | Name | Type |
335
336
  | --- | --- |
336
- |config.body<sup>*required</sup>|[ParseRequest](#parserequest)|
337
+ |config.body<sup>*required</sup>|<a href="#parserequest" target="_blank" rel="noopener noreferrer">ParseRequest</a>|
337
338
 
338
339
 
339
340
 
@@ -346,7 +347,6 @@ A node containing more nodes, a node offering different (semantically equivalen
346
347
  <details>
347
348
  <summary>
348
349
  Code example
349
-
350
350
  </summary>
351
351
 
352
352
  ```ts
@@ -367,10 +367,11 @@ const data = await queryAssistanceClient.queryParse({
367
367
  </div>
368
368
 
369
369
 
370
+ <a name="queryverify"></a>
370
371
  ### queryVerify
371
372
 
372
373
  <div class="padding-bottom--md">
373
- <strong>queryAssistanceClient.queryVerify(config): Promise&lt;[VerifyResponse](#verifyresponse)&gt;</strong>
374
+ <strong>queryAssistanceClient.queryVerify(config): Promise&lt;<a href="#verifyresponse">VerifyResponse</a>&gt;</strong>
374
375
 
375
376
  <div class="padding-left--md">
376
377
 
@@ -392,7 +393,7 @@ submitting the query for execution.
392
393
 
393
394
  | Name | Type |
394
395
  | --- | --- |
395
- |config.body<sup>*required</sup>|[VerifyRequest](#verifyrequest)|
396
+ |config.body<sup>*required</sup>|<a href="#verifyrequest" target="_blank" rel="noopener noreferrer">VerifyRequest</a>|
396
397
 
397
398
 
398
399
 
@@ -405,7 +406,6 @@ Supplied query and parameters were verified.
405
406
  <details>
406
407
  <summary>
407
408
  Code example
408
-
409
409
  </summary>
410
410
 
411
411
  ```ts
@@ -432,10 +432,11 @@ import { queryExecutionClient } from '@dynatrace-sdk/client-query';
432
432
  ```
433
433
 
434
434
 
435
+ <a name="querycancel"></a>
435
436
  ### queryCancel
436
437
 
437
438
  <div class="padding-bottom--md">
438
- <strong>queryExecutionClient.queryCancel(config): Promise&lt;void &#124; [QueryPollResponse](#querypollresponse)&gt;</strong>
439
+ <strong>queryExecutionClient.queryCancel(config): Promise&lt;void &#124; <a href="#querypollresponse">QueryPollResponse</a>&gt;</strong>
439
440
 
440
441
  <div class="padding-left--md">
441
442
 
@@ -499,7 +500,6 @@ The query already finished.
499
500
  <details>
500
501
  <summary>
501
502
  Code example
502
-
503
503
  </summary>
504
504
 
505
505
  ```ts
@@ -517,10 +517,11 @@ const data = await queryExecutionClient.queryCancel({
517
517
  </div>
518
518
 
519
519
 
520
+ <a name="queryexecute"></a>
520
521
  ### queryExecute
521
522
 
522
523
  <div class="padding-bottom--md">
523
- <strong>queryExecutionClient.queryExecute(config): Promise&lt;[QueryStartResponse](#querystartresponse)&gt;</strong>
524
+ <strong>queryExecutionClient.queryExecute(config): Promise&lt;<a href="#querystartresponse" target="_blank" rel="noopener noreferrer">QueryStartResponse</a>&gt;</strong>
524
525
 
525
526
  <div class="padding-left--md">
526
527
 
@@ -571,7 +572,7 @@ It is guaranteed that every field of every record will have a corresponding type
571
572
 
572
573
  | Name | Type | Description |
573
574
  | --- | --- | --- |
574
- |config.body<sup>*required</sup>|[ExecuteRequest](#executerequest)| |
575
+ |config.body<sup>*required</sup>|<a href="#executerequest">ExecuteRequest</a>| |
575
576
  |config.enrich|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|If set additional data will be available in the metadata section. |
576
577
 
577
578
 
@@ -585,7 +586,6 @@ The final status and results of the supplied query if it finished within a suppl
585
586
  <details>
586
587
  <summary>
587
588
  Code example
588
-
589
589
  </summary>
590
590
 
591
591
  ```ts
@@ -606,10 +606,11 @@ const data = await queryExecutionClient.queryExecute({
606
606
  </div>
607
607
 
608
608
 
609
+ <a name="querypoll"></a>
609
610
  ### queryPoll
610
611
 
611
612
  <div class="padding-bottom--md">
612
- <strong>queryExecutionClient.queryPoll(config): Promise&lt;[QueryPollResponse](#querypollresponse)&gt;</strong>
613
+ <strong>queryExecutionClient.queryPoll(config): Promise&lt;<a href="#querypollresponse" target="_blank" rel="noopener noreferrer">QueryPollResponse</a>&gt;</strong>
613
614
 
614
615
  <div class="padding-left--md">
615
616
 
@@ -672,7 +673,6 @@ The current status and results of the supplied query.
672
673
  <details>
673
674
  <summary>
674
675
  Code example
675
-
676
676
  </summary>
677
677
 
678
678
  ```ts
@@ -704,7 +704,7 @@ const data = await queryExecutionClient.queryPoll({
704
704
  |locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query locale. If none specified, then a language/country neutral locale is chosen. The input values take the ISO-639 Language code with an optional ISO-3166 country code appended to it with an underscore. For instance, both values are valid 'en' or 'en_US'. |
705
705
  |maxDataSuggestions|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)| |
706
706
  |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
707
- |queryOptions|[QueryOptions](#queryoptions)| |
707
+ |queryOptions|<a href="#queryoptions">QueryOptions</a>| |
708
708
  |timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
709
709
 
710
710
  ### AutocompleteResponse
@@ -718,7 +718,7 @@ The response of the autocomplete call.
718
718
  | --- | --- | --- |
719
719
  |optional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the suggestions are optional. |
720
720
  |suggestedTtlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Suggested duration in seconds, for how long the response may be cached and reused by the client. It is derived from the volatility of the suggestions on the server (if the suggestions are static, how long the server will cache the volatile suggestions, ...). If not provided, then the result may be cached for long time. Value below 1 means that the result should not be cached. |
721
- |suggestions<sup>*required</sup>|Array&lt;[AutocompleteSuggestion](#autocompletesuggestion)&gt;|The list of suggestions. |
721
+ |suggestions<sup>*required</sup>|Array&lt;<a href="#autocompletesuggestion" target="_blank" rel="noopener noreferrer">AutocompleteSuggestion</a>&gt;|The list of suggestions. |
722
722
 
723
723
  ### AutocompleteSuggestion
724
724
 
@@ -730,7 +730,7 @@ Single suggestion for completion of the query.
730
730
  | Name | Type | Description |
731
731
  | --- | --- | --- |
732
732
  |alreadyTypedCharacters<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Number of characters that the user user already typed for this suggestion. |
733
- |parts<sup>*required</sup>|Array&lt;[AutocompleteSuggestionPart](#autocompletesuggestionpart)&gt;|List of suggestion parts. |
733
+ |parts<sup>*required</sup>|Array&lt;<a href="#autocompletesuggestionpart">AutocompleteSuggestionPart</a>&gt;|List of suggestion parts. |
734
734
  |suggestion<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The suggested continuation of the query. |
735
735
 
736
736
  ### AutocompleteSuggestionPart
@@ -759,7 +759,7 @@ The DQL node that has alternatives.
759
759
  |alternatives|object|The different alternatives. |
760
760
  |isOptional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the node is optional. |
761
761
  |nodeType<sup>*required</sup>|DQLNodeNodeType| |
762
- |tokenPosition|[TokenPosition](#tokenposition)| |
762
+ |tokenPosition|<a href="#tokenposition" target="_blank" rel="noopener noreferrer">TokenPosition</a>| |
763
763
 
764
764
  ### DQLContainerNode
765
765
 
@@ -770,10 +770,10 @@ The DQL node that contains other nodes.
770
770
 
771
771
  | Name | Type | Description |
772
772
  | --- | --- | --- |
773
- |children|Array&lt;[DQLNode](#dqlnode)&gt;|The list of children nodes. |
773
+ |children|Array&lt;<a href="#dqlnode">DQLNode</a>&gt;|The list of children nodes. |
774
774
  |isOptional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the node is optional. |
775
775
  |nodeType<sup>*required</sup>|DQLNodeNodeType| |
776
- |tokenPosition|[TokenPosition](#tokenposition)| |
776
+ |tokenPosition|<a href="#tokenposition" target="_blank" rel="noopener noreferrer">TokenPosition</a>| |
777
777
  |type|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The type of the node. |
778
778
 
779
779
  ### DQLNode
@@ -787,7 +787,7 @@ General Node in the DQL query.
787
787
  | --- | --- | --- |
788
788
  |isOptional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the node is optional. |
789
789
  |nodeType<sup>*required</sup>|DQLNodeNodeType| |
790
- |tokenPosition|[TokenPosition](#tokenposition)| |
790
+ |tokenPosition|<a href="#tokenposition">TokenPosition</a>| |
791
791
 
792
792
  ### DQLTerminalNode
793
793
 
@@ -802,7 +802,7 @@ Node that represents single token.
802
802
  |isMandatoryOnUserOrder|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|For optional items only: whether this node becomes mandatory when user order is used. True only for some optional 'ghost braces' |
803
803
  |isOptional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the node is optional. |
804
804
  |nodeType<sup>*required</sup>|DQLNodeNodeType| |
805
- |tokenPosition|[TokenPosition](#tokenposition)| |
805
+ |tokenPosition|<a href="#tokenposition" target="_blank" rel="noopener noreferrer">TokenPosition</a>| |
806
806
  |type|TokenType| |
807
807
 
808
808
  ### ErrorEnvelope
@@ -814,7 +814,7 @@ An &apos;envelope&apos; error object that has the mandatory error object.
814
814
 
815
815
  | Name | Type |
816
816
  | --- | --- |
817
- |error<sup>*required</sup>|[ErrorResponse](#errorresponse)|
817
+ |error<sup>*required</sup>|<a href="#errorresponse">ErrorResponse</a>|
818
818
 
819
819
  ### ErrorResponse
820
820
 
@@ -826,7 +826,7 @@ The response for error state
826
826
  | Name | Type | Description |
827
827
  | --- | --- | --- |
828
828
  |code<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Error code, which normally matches the HTTP error code. |
829
- |details<sup>*required</sup>|[ErrorResponseDetails](#errorresponsedetails)| |
829
+ |details|<a href="#errorresponsedetails" target="_blank" rel="noopener noreferrer">ErrorResponseDetails</a>| |
830
830
  |message<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|A short, clear error message without details |
831
831
 
832
832
  ### ErrorResponseDetails
@@ -838,15 +838,31 @@ Detailed information about the error.
838
838
 
839
839
  | Name | Type | Description |
840
840
  | --- | --- | --- |
841
- |arguments<sup>*required</sup>|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The arguments for the message format. |
842
- |errorMessage<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Complete error message. |
843
- |errorMessageFormat<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The message format of the error message, string.format based. |
844
- |errorMessageFormatSpecifierTypes<sup>*required</sup>|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The corresponding DQL format specifier types for each format specifier used in the error message format. |
845
- |errorType<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The error type, e.g. COMMAND_NAME_MISSING |
846
- |exceptionType<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The exception type. |
841
+ |arguments|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The arguments for the message format. |
842
+ |constraintViolations|Array&lt;<a href="#errorresponsedetailsconstraintviolationsitem">ErrorResponseDetailsConstraintViolationsItem</a>&gt;|Information about an input parameter that violated some validation rule of the service API. |
843
+ |errorMessage|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Complete error message. |
844
+ |errorMessageFormat|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The message format of the error message, string.format based. |
845
+ |errorMessageFormatSpecifierTypes|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The corresponding DQL format specifier types for each format specifier used in the error message format. |
846
+ |errorType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The error type, e.g. COMMAND_NAME_MISSING |
847
+ |exceptionType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The exception type. |
848
+ |missingPermissions|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|List of missing IAM permissions necessary to successfully execute the request. |
849
+ |missingScopes|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|List of missing IAM scopes necessary to successfully execute the request. |
847
850
  |queryId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |
848
- |queryString<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Submitted query string. |
849
- |syntaxErrorPosition|[TokenPosition](#tokenposition)| |
851
+ |queryString|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Submitted query string. |
852
+ |syntaxErrorPosition|<a href="#tokenposition" target="_blank" rel="noopener noreferrer">TokenPosition</a>| |
853
+
854
+ ### ErrorResponseDetailsConstraintViolationsItem
855
+
856
+
857
+
858
+
859
+
860
+
861
+ | Name | Type | Description |
862
+ | --- | --- | --- |
863
+ |message<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Message describing the error. |
864
+ |parameterDescriptor|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Describes the violating parameter. |
865
+ |parameterLocation|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Describes the general location of the violating parameter. |
850
866
 
851
867
  ### ExecuteRequest
852
868
 
@@ -867,7 +883,7 @@ Detailed information about the error.
867
883
  |maxResultBytes|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The maximum number of result bytes that this query will return. |
868
884
  |maxResultRecords|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The maximum number of result records that this query will return. |
869
885
  |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
870
- |queryOptions|[QueryOptions](#queryoptions)| |
886
+ |queryOptions|<a href="#queryoptions">QueryOptions</a>| |
871
887
  |requestTimeoutMilliseconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The time a client is willing to wait for the query result. In case the query finishes within the specified timeout, the query result is returned. Otherwise, the requestToken is returned, allowing polling for the result. |
872
888
  |timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
873
889
 
@@ -881,7 +897,7 @@ The possible type of a field in DQL.
881
897
  | Name | Type |
882
898
  | --- | --- |
883
899
  |type<sup>*required</sup>|FieldTypeType|
884
- |types|Array&lt;[RangedFieldTypes](#rangedfieldtypes)&gt;|
900
+ |types|Array&lt;<a href="#rangedfieldtypes" target="_blank" rel="noopener noreferrer">RangedFieldTypes</a>&gt;|
885
901
 
886
902
  ### GeoPoint
887
903
 
@@ -904,12 +920,12 @@ Collects various bits of metadata information.
904
920
 
905
921
  | Name | Type | Description |
906
922
  | --- | --- | --- |
907
- |analysisTimeframe|[Timeframe](#timeframe)| |
923
+ |analysisTimeframe|<a href="#timeframe">Timeframe</a>| |
908
924
  |canonicalQuery|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The canonical form of the query. It has normalized spaces and canonical constructs. |
909
925
  |dqlVersion|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The version of DQL that was used to process the query request. |
910
926
  |executionTimeMilliseconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The time it took to execute the query. |
911
927
  |locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Effective locale for the query. |
912
- |notifications|Array&lt;[MetadataNotification](#metadatanotification)&gt;|Collected messages during the execution of the query. |
928
+ |notifications|Array&lt;<a href="#metadatanotification" target="_blank" rel="noopener noreferrer">MetadataNotification</a>&gt;|Collected messages during the execution of the query. |
913
929
  |query|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The submitted query. |
914
930
  |queryId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The id of the query |
915
931
  |sampled|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if sampling was used for at least one segment. |
@@ -927,8 +943,8 @@ Collects various bits of metadata information.
927
943
 
928
944
  | Name | Type |
929
945
  | --- | --- |
930
- |grail|[GrailMetadata](#grailmetadata)|
931
- |metrics|Array&lt;[MetricMetadata](#metricmetadata)&gt;|
946
+ |grail|<a href="#grailmetadata">GrailMetadata</a>|
947
+ |metrics|Array&lt;<a href="#metricmetadata" target="_blank" rel="noopener noreferrer">MetricMetadata</a>&gt;|
932
948
 
933
949
  ### MetadataNotification
934
950
 
@@ -945,7 +961,7 @@ The message that provides additional information about the execution of the quer
945
961
  |messageFormatSpecifierTypes|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The corresponding DQL format specifier types for each format specifier used in the error message format. |
946
962
  |notificationType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The notification type, e.g. LIMIT_ADDED. |
947
963
  |severity|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The severity of the notification, currently: INFO, WARN, ERROR. |
948
- |syntaxPosition|[TokenPosition](#tokenposition)| |
964
+ |syntaxPosition|<a href="#tokenposition">TokenPosition</a>| |
949
965
 
950
966
  ### MetricMetadata
951
967
 
@@ -976,7 +992,7 @@ An object that defines additional metric metadata.
976
992
  | --- | --- | --- |
977
993
  |locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query locale. If none specified, then a language/country neutral locale is chosen. The input values take the ISO-639 Language code with an optional ISO-3166 country code appended to it with an underscore. For instance, both values are valid 'en' or 'en_US'. |
978
994
  |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
979
- |queryOptions|[QueryOptions](#queryoptions)| |
995
+ |queryOptions|<a href="#queryoptions" target="_blank" rel="noopener noreferrer">QueryOptions</a>| |
980
996
  |timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
981
997
 
982
998
  ### PositionInfo
@@ -1009,7 +1025,7 @@ The response of GET query:execute call.
1009
1025
  | Name | Type | Description |
1010
1026
  | --- | --- | --- |
1011
1027
  |progress|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The progress of the query from 0 to 100. |
1012
- |result|[QueryResult](#queryresult)| |
1028
+ |result|<a href="#queryresult">QueryResult</a>| |
1013
1029
  |state<sup>*required</sup>|QueryState| |
1014
1030
  |ttlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Time to live in seconds. |
1015
1031
 
@@ -1022,9 +1038,9 @@ The result of the DQL query.
1022
1038
 
1023
1039
  | Name | Type | Description |
1024
1040
  | --- | --- | --- |
1025
- |metadata<sup>*required</sup>|[Metadata](#metadata)| |
1026
- |records<sup>*required</sup>|Array&lt;null &#124; [ResultRecord](#resultrecord)&gt;|List of records containing the result fields data. |
1027
- |types<sup>*required</sup>|Array&lt;[RangedFieldTypes](#rangedfieldtypes)&gt;|The data types for the result records. |
1041
+ |metadata<sup>*required</sup>|<a href="#metadata" target="_blank" rel="noopener noreferrer">Metadata</a>| |
1042
+ |records<sup>*required</sup>|Array&lt;null &#124; <a href="#resultrecord">ResultRecord</a>&gt;|List of records containing the result fields data. |
1043
+ |types<sup>*required</sup>|Array&lt;<a href="#rangedfieldtypes" target="_blank" rel="noopener noreferrer">RangedFieldTypes</a>&gt;|The data types for the result records. |
1028
1044
 
1029
1045
  ### QueryStartResponse
1030
1046
 
@@ -1037,7 +1053,7 @@ The response when starting a query.
1037
1053
  | --- | --- | --- |
1038
1054
  |progress|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The progress of the query from 0 to 100. |
1039
1055
  |requestToken|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The token returned by the POST query:execute call. |
1040
- |result|[QueryResult](#queryresult)| |
1056
+ |result|<a href="#queryresult">QueryResult</a>| |
1041
1057
  |state<sup>*required</sup>|QueryState| |
1042
1058
  |ttlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Time to live in seconds. |
1043
1059
 
@@ -1051,7 +1067,7 @@ The field type in range.
1051
1067
  | Name | Type | Description |
1052
1068
  | --- | --- | --- |
1053
1069
  |indexRange|Array&lt;[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)&gt;|The range of elements at use this type in arrays (null for records). |
1054
- |mappings<sup>*required</sup>|[RangedFieldTypesMappings](#rangedfieldtypesmappings)| |
1070
+ |mappings<sup>*required</sup>|<a href="#rangedfieldtypesmappings" target="_blank" rel="noopener noreferrer">RangedFieldTypesMappings</a>| |
1055
1071
 
1056
1072
  ### RangedFieldTypesMappings
1057
1073
  **type**: Record&lt;string, FieldType | undefined&gt;
@@ -1088,8 +1104,8 @@ The position of a token in a query string used for errors and notification to ma
1088
1104
 
1089
1105
  | Name | Type |
1090
1106
  | --- | --- |
1091
- |end<sup>*required</sup>|[PositionInfo](#positioninfo)|
1092
- |start<sup>*required</sup>|[PositionInfo](#positioninfo)|
1107
+ |end<sup>*required</sup>|<a href="#positioninfo">PositionInfo</a>|
1108
+ |start<sup>*required</sup>|<a href="#positioninfo" target="_blank" rel="noopener noreferrer">PositionInfo</a>|
1093
1109
 
1094
1110
  ### VerifyRequest
1095
1111
 
@@ -1103,7 +1119,7 @@ The position of a token in a query string used for errors and notification to ma
1103
1119
  |generateCanonicalQuery|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)| <i>default:</i> <code>false</code>|
1104
1120
  |locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query locale. If none specified, then a language/country neutral locale is chosen. The input values take the ISO-639 Language code with an optional ISO-3166 country code appended to it with an underscore. For instance, both values are valid 'en' or 'en_US'. |
1105
1121
  |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
1106
- |queryOptions|[QueryOptions](#queryoptions)| |
1122
+ |queryOptions|<a href="#queryoptions">QueryOptions</a>| |
1107
1123
  |timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
1108
1124
 
1109
1125
  ### VerifyResponse
@@ -1116,11 +1132,12 @@ Verify response.
1116
1132
  | Name | Type | Description |
1117
1133
  | --- | --- | --- |
1118
1134
  |canonicalQuery|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |
1119
- |notifications|Array&lt;[MetadataNotification](#metadatanotification)&gt;|The notifications related to the supplied DQL query string. |
1135
+ |notifications|Array&lt;<a href="#metadatanotification" target="_blank" rel="noopener noreferrer">MetadataNotification</a>&gt;|The notifications related to the supplied DQL query string. |
1120
1136
  |valid<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the supplied DQL query string is valid. |
1121
1137
 
1122
1138
  ## Enums
1123
1139
 
1140
+ <a name="dqlnodenodetype"></a>
1124
1141
  ### DQLNodeNodeType
1125
1142
 
1126
1143
  <div class="padding-left--md">
@@ -1138,6 +1155,7 @@ The type of the node.
1138
1155
 
1139
1156
  </div>
1140
1157
 
1158
+ <a name="fieldtypetype"></a>
1141
1159
  ### FieldTypeType
1142
1160
 
1143
1161
  <div class="padding-left--md">
@@ -1155,6 +1173,7 @@ The type of the node.
1155
1173
 
1156
1174
  </div>
1157
1175
 
1176
+ <a name="querystate"></a>
1158
1177
  ### QueryState
1159
1178
 
1160
1179
  <div class="padding-left--md">
@@ -1172,6 +1191,7 @@ Possible state of the query.
1172
1191
 
1173
1192
  </div>
1174
1193
 
1194
+ <a name="tokentype"></a>
1175
1195
  ### TokenType
1176
1196
 
1177
1197
  <div class="padding-left--md">