cloudflare 5.2.0 → 6.0.0-beta.1

package/src/resources/radar/dns/dns.ts

@@ -61,6 +61,76 @@ export class DNS extends APIResource {
     this._client,
   );
 
+  /**
+   * Retrieves the distribution of DNS queries by the specified dimension.
+   *
+   * @example
+   * ```ts
+   * const response = await client.radar.dns.summaryV2(
+   *   'IP_VERSION',
+   * );
+   * ```
+   */
+  summaryV2(
+    dimension:
+      | 'IP_VERSION'
+      | 'CACHE_HIT'
+      | 'DNSSEC'
+      | 'DNSSEC_AWARE'
+      | 'DNSSEC_E2E'
+      | 'MATCHING_ANSWER'
+      | 'PROTOCOL'
+      | 'QUERY_TYPE'
+      | 'RESPONSE_CODE'
+      | 'RESPONSE_TTL'
+      | 'TLD'
+      | 'TLD_DNS_MAGNITUDE',
+    query?: DNSSummaryV2Params,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DNSSummaryV2Response>;
+  summaryV2(
+    dimension:
+      | 'IP_VERSION'
+      | 'CACHE_HIT'
+      | 'DNSSEC'
+      | 'DNSSEC_AWARE'
+      | 'DNSSEC_E2E'
+      | 'MATCHING_ANSWER'
+      | 'PROTOCOL'
+      | 'QUERY_TYPE'
+      | 'RESPONSE_CODE'
+      | 'RESPONSE_TTL'
+      | 'TLD'
+      | 'TLD_DNS_MAGNITUDE',
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DNSSummaryV2Response>;
+  summaryV2(
+    dimension:
+      | 'IP_VERSION'
+      | 'CACHE_HIT'
+      | 'DNSSEC'
+      | 'DNSSEC_AWARE'
+      | 'DNSSEC_E2E'
+      | 'MATCHING_ANSWER'
+      | 'PROTOCOL'
+      | 'QUERY_TYPE'
+      | 'RESPONSE_CODE'
+      | 'RESPONSE_TTL'
+      | 'TLD'
+      | 'TLD_DNS_MAGNITUDE',
+    query: DNSSummaryV2Params | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DNSSummaryV2Response> {
+    if (isRequestOptions(query)) {
+      return this.summaryV2(dimension, {}, query);
+    }
+    return (
+      this._client.get(`/radar/dns/summary/${dimension}`, { query, ...options }) as Core.APIPromise<{
+        result: DNSSummaryV2Response;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
   /**
    * Retrieves normalized query volume to the 1.1.1.1 DNS resolver over time.
    *
@@ -87,6 +157,202 @@ export class DNS extends APIResource {
       }>
     )._thenUnwrap((obj) => obj.result);
   }
+
+  /**
+   * Retrieves the distribution of DNS queries grouped by dimension over time.
+   *
+   * @example
+   * ```ts
+   * const response = await client.radar.dns.timeseriesGroupsV2(
+   *   'IP_VERSION',
+   * );
+   * ```
+   */
+  timeseriesGroupsV2(
+    dimension:
+      | 'IP_VERSION'
+      | 'CACHE_HIT'
+      | 'DNSSEC'
+      | 'DNSSEC_AWARE'
+      | 'DNSSEC_E2E'
+      | 'MATCHING_ANSWER'
+      | 'PROTOCOL'
+      | 'QUERY_TYPE'
+      | 'RESPONSE_CODE'
+      | 'RESPONSE_TTL'
+      | 'TLD',
+    query?: DNSTimeseriesGroupsV2Params,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DNSTimeseriesGroupsV2Response>;
+  timeseriesGroupsV2(
+    dimension:
+      | 'IP_VERSION'
+      | 'CACHE_HIT'
+      | 'DNSSEC'
+      | 'DNSSEC_AWARE'
+      | 'DNSSEC_E2E'
+      | 'MATCHING_ANSWER'
+      | 'PROTOCOL'
+      | 'QUERY_TYPE'
+      | 'RESPONSE_CODE'
+      | 'RESPONSE_TTL'
+      | 'TLD',
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DNSTimeseriesGroupsV2Response>;
+  timeseriesGroupsV2(
+    dimension:
+      | 'IP_VERSION'
+      | 'CACHE_HIT'
+      | 'DNSSEC'
+      | 'DNSSEC_AWARE'
+      | 'DNSSEC_E2E'
+      | 'MATCHING_ANSWER'
+      | 'PROTOCOL'
+      | 'QUERY_TYPE'
+      | 'RESPONSE_CODE'
+      | 'RESPONSE_TTL'
+      | 'TLD',
+    query: DNSTimeseriesGroupsV2Params | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DNSTimeseriesGroupsV2Response> {
+    if (isRequestOptions(query)) {
+      return this.timeseriesGroupsV2(dimension, {}, query);
+    }
+    return (
+      this._client.get(`/radar/dns/timeseries_groups/${dimension}`, {
+        query,
+        ...options,
+      }) as Core.APIPromise<{ result: DNSTimeseriesGroupsV2Response }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export interface DNSSummaryV2Response {
+  /**
+   * Metadata for the results.
+   */
+  meta: DNSSummaryV2Response.Meta;
+
+  summary_0: { [key: string]: string };
+}
+
+export namespace DNSSummaryV2Response {
+  /**
+   * Metadata for the results.
+   */
+  export interface Meta {
+    confidenceInfo: Meta.ConfidenceInfo;
+
+    dateRange: Array<Meta.DateRange>;
+
+    /**
+     * Timestamp of the last dataset update.
+     */
+    lastUpdated: string;
+
+    /**
+     * Normalization method applied to the results. Refer to
+     * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+     */
+    normalization:
+      | 'PERCENTAGE'
+      | 'MIN0_MAX'
+      | 'MIN_MAX'
+      | 'RAW_VALUES'
+      | 'PERCENTAGE_CHANGE'
+      | 'ROLLING_AVERAGE'
+      | 'OVERLAPPED_PERCENTAGE'
+      | 'RATIO';
+
+    /**
+     * Measurement units for the results.
+     */
+    units: Array<Meta.Unit>;
+  }
+
+  export namespace Meta {
+    export interface ConfidenceInfo {
+      annotations: Array<ConfidenceInfo.Annotation>;
+
+      /**
+       * Provides an indication of how much confidence Cloudflare has in the data.
+       */
+      level: number;
+    }
+
+    export namespace ConfidenceInfo {
+      /**
+       * Annotation associated with the result (e.g. outage or other type of event).
+       */
+      export interface Annotation {
+        /**
+         * Data source for annotations.
+         */
+        dataSource:
+          | 'ALL'
+          | 'AI_BOTS'
+          | 'AI_GATEWAY'
+          | 'BGP'
+          | 'BOTS'
+          | 'CONNECTION_ANOMALY'
+          | 'CT'
+          | 'DNS'
+          | 'DNS_MAGNITUDE'
+          | 'DNS_AS112'
+          | 'DOS'
+          | 'EMAIL_ROUTING'
+          | 'EMAIL_SECURITY'
+          | 'FW'
+          | 'FW_PG'
+          | 'HTTP'
+          | 'HTTP_CONTROL'
+          | 'HTTP_CRAWLER_REFERER'
+          | 'HTTP_ORIGINS'
+          | 'IQI'
+          | 'LEAKED_CREDENTIALS'
+          | 'NET'
+          | 'ROBOTS_TXT'
+          | 'SPEED'
+          | 'WORKERS_AI';
+
+        description: string;
+
+        endDate: string;
+
+        /**
+         * Event type for annotations.
+         */
+        eventType: 'EVENT' | 'GENERAL' | 'OUTAGE' | 'PARTIAL_PROJECTION' | 'PIPELINE' | 'TRAFFIC_ANOMALY';
+
+        /**
+         * Whether event is a single point in time or a time range.
+         */
+        isInstantaneous: boolean;
+
+        linkedUrl: string;
+
+        startDate: string;
+      }
+    }
+
+    export interface DateRange {
+      /**
+       * Adjusted end of date range.
+       */
+      endTime: string;
+
+      /**
+       * Adjusted start of date range.
+       */
+      startTime: string;
+    }
+
+    export interface Unit {
+      name: string;
+
+      value: string;
+    }
+  }
 }
 
 export interface DNSTimeseriesResponse {
@@ -122,87 +388,719 @@ export namespace DNSTimeseriesResponse {
      */
     lastUpdated: string;
 
-    /**
-     * Normalization method applied to the results. Refer to
-     * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
-     */
-    normalization:
-      | 'PERCENTAGE'
-      | 'MIN0_MAX'
-      | 'MIN_MAX'
-      | 'RAW_VALUES'
-      | 'PERCENTAGE_CHANGE'
-      | 'ROLLING_AVERAGE'
-      | 'OVERLAPPED_PERCENTAGE'
-      | 'RATIO';
+    /**
+     * Normalization method applied to the results. Refer to
+     * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+     */
+    normalization:
+      | 'PERCENTAGE'
+      | 'MIN0_MAX'
+      | 'MIN_MAX'
+      | 'RAW_VALUES'
+      | 'PERCENTAGE_CHANGE'
+      | 'ROLLING_AVERAGE'
+      | 'OVERLAPPED_PERCENTAGE'
+      | 'RATIO';
+
+    /**
+     * Measurement units for the results.
+     */
+    units: Array<Meta.Unit>;
+  }
+
+  export namespace Meta {
+    export interface ConfidenceInfo {
+      annotations: Array<ConfidenceInfo.Annotation>;
+
+      /**
+       * Provides an indication of how much confidence Cloudflare has in the data.
+       */
+      level: number;
+    }
+
+    export namespace ConfidenceInfo {
+      /**
+       * Annotation associated with the result (e.g. outage or other type of event).
+       */
+      export interface Annotation {
+        /**
+         * Data source for annotations.
+         */
+        dataSource:
+          | 'ALL'
+          | 'AI_BOTS'
+          | 'AI_GATEWAY'
+          | 'BGP'
+          | 'BOTS'
+          | 'CONNECTION_ANOMALY'
+          | 'CT'
+          | 'DNS'
+          | 'DNS_MAGNITUDE'
+          | 'DNS_AS112'
+          | 'DOS'
+          | 'EMAIL_ROUTING'
+          | 'EMAIL_SECURITY'
+          | 'FW'
+          | 'FW_PG'
+          | 'HTTP'
+          | 'HTTP_CONTROL'
+          | 'HTTP_CRAWLER_REFERER'
+          | 'HTTP_ORIGINS'
+          | 'IQI'
+          | 'LEAKED_CREDENTIALS'
+          | 'NET'
+          | 'ROBOTS_TXT'
+          | 'SPEED'
+          | 'WORKERS_AI';
+
+        description: string;
+
+        endDate: string;
+
+        /**
+         * Event type for annotations.
+         */
+        eventType: 'EVENT' | 'GENERAL' | 'OUTAGE' | 'PARTIAL_PROJECTION' | 'PIPELINE' | 'TRAFFIC_ANOMALY';
+
+        /**
+         * Whether event is a single point in time or a time range.
+         */
+        isInstantaneous: boolean;
+
+        linkedUrl: string;
+
+        startDate: string;
+      }
+    }
+
+    export interface DateRange {
+      /**
+       * Adjusted end of date range.
+       */
+      endTime: string;
+
+      /**
+       * Adjusted start of date range.
+       */
+      startTime: string;
+    }
+
+    export interface Unit {
+      name: string;
+
+      value: string;
+    }
+  }
+
+  export interface unnamed_schema_ref_75bae70cf28e6bcef364b9840db3bdeb {
+    timestamps: Array<string>;
+
+    values: Array<string>;
+  }
+}
+
+export interface DNSTimeseriesGroupsV2Response {
+  /**
+   * Metadata for the results.
+   */
+  meta: DNSTimeseriesGroupsV2Response.Meta;
+
+  serie_0: DNSTimeseriesGroupsV2Response.Serie0;
+}
+
+export namespace DNSTimeseriesGroupsV2Response {
+  /**
+   * Metadata for the results.
+   */
+  export interface Meta {
+    /**
+     * Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals).
+     * Refer to
+     * [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).
+     */
+    aggInterval: 'FIFTEEN_MINUTES' | 'ONE_HOUR' | 'ONE_DAY' | 'ONE_WEEK' | 'ONE_MONTH';
+
+    confidenceInfo: Meta.ConfidenceInfo;
+
+    dateRange: Array<Meta.DateRange>;
+
+    /**
+     * Timestamp of the last dataset update.
+     */
+    lastUpdated: string;
+
+    /**
+     * Normalization method applied to the results. Refer to
+     * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+     */
+    normalization:
+      | 'PERCENTAGE'
+      | 'MIN0_MAX'
+      | 'MIN_MAX'
+      | 'RAW_VALUES'
+      | 'PERCENTAGE_CHANGE'
+      | 'ROLLING_AVERAGE'
+      | 'OVERLAPPED_PERCENTAGE'
+      | 'RATIO';
+
+    /**
+     * Measurement units for the results.
+     */
+    units: Array<Meta.Unit>;
+  }
+
+  export namespace Meta {
+    export interface ConfidenceInfo {
+      annotations: Array<ConfidenceInfo.Annotation>;
+
+      /**
+       * Provides an indication of how much confidence Cloudflare has in the data.
+       */
+      level: number;
+    }
+
+    export namespace ConfidenceInfo {
+      /**
+       * Annotation associated with the result (e.g. outage or other type of event).
+       */
+      export interface Annotation {
+        /**
+         * Data source for annotations.
+         */
+        dataSource:
+          | 'ALL'
+          | 'AI_BOTS'
+          | 'AI_GATEWAY'
+          | 'BGP'
+          | 'BOTS'
+          | 'CONNECTION_ANOMALY'
+          | 'CT'
+          | 'DNS'
+          | 'DNS_MAGNITUDE'
+          | 'DNS_AS112'
+          | 'DOS'
+          | 'EMAIL_ROUTING'
+          | 'EMAIL_SECURITY'
+          | 'FW'
+          | 'FW_PG'
+          | 'HTTP'
+          | 'HTTP_CONTROL'
+          | 'HTTP_CRAWLER_REFERER'
+          | 'HTTP_ORIGINS'
+          | 'IQI'
+          | 'LEAKED_CREDENTIALS'
+          | 'NET'
+          | 'ROBOTS_TXT'
+          | 'SPEED'
+          | 'WORKERS_AI';
+
+        description: string;
+
+        endDate: string;
+
+        /**
+         * Event type for annotations.
+         */
+        eventType: 'EVENT' | 'GENERAL' | 'OUTAGE' | 'PARTIAL_PROJECTION' | 'PIPELINE' | 'TRAFFIC_ANOMALY';
+
+        /**
+         * Whether event is a single point in time or a time range.
+         */
+        isInstantaneous: boolean;
+
+        linkedUrl: string;
+
+        startDate: string;
+      }
+    }
+
+    export interface DateRange {
+      /**
+       * Adjusted end of date range.
+       */
+      endTime: string;
+
+      /**
+       * Adjusted start of date range.
+       */
+      startTime: string;
+    }
+
+    export interface Unit {
+      name: string;
+
+      value: string;
+    }
+  }
+
+  export interface Serie0 {
+    timestamps: Array<string>;
+
+    [k: string]: Array<string> | Array<string> | undefined;
+  }
+}
+
+export interface DNSSummaryV2Params {
+  /**
+   * Filters results by Autonomous System. Specify one or more Autonomous System
+   * Numbers (ASNs) as a comma-separated list. Prefix with `-` to exclude ASNs from
+   * results. For example, `-174, 3356` excludes results from AS174, but includes
+   * results from AS3356.
+   */
+  asn?: Array<string>;
+
+  /**
+   * Filters results based on cache status.
+   */
+  cacheHit?: Array<boolean>;
+
+  /**
+   * Filters results by continent. Specify a comma-separated list of alpha-2 codes.
+   * Prefix with `-` to exclude continents from results. For example, `-EU,NA`
+   * excludes results from EU, but includes results from NA.
+   */
+  continent?: Array<string>;
+
+  /**
+   * End of the date range (inclusive).
+   */
+  dateEnd?: Array<string>;
+
+  /**
+   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
+   * this week with the previous week. Use this parameter or set specific start and
+   * end dates (`dateStart` and `dateEnd` parameters).
+   */
+  dateRange?: Array<string>;
+
+  /**
+   * Start of the date range.
+   */
+  dateStart?: Array<string>;
+
+  /**
+   * Filters results based on DNSSEC (DNS Security Extensions) support.
+   */
+  dnssec?: Array<'INVALID' | 'INSECURE' | 'SECURE' | 'OTHER'>;
+
+  /**
+   * Filters results based on DNSSEC (DNS Security Extensions) client awareness.
+   */
+  dnssecAware?: Array<'SUPPORTED' | 'NOT_SUPPORTED'>;
+
+  /**
+   * Filters results based on DNSSEC-validated answers by end-to-end security status.
+   */
+  dnssecE2e?: Array<boolean>;
+
+  /**
+   * Format in which results will be returned.
+   */
+  format?: 'JSON' | 'CSV';
+
+  /**
+   * Filters results by IP version (Ipv4 vs. IPv6).
+   */
+  ipVersion?: Array<'IPv4' | 'IPv6'>;
+
+  /**
+   * Limits the number of objects per group to the top items within the specified
+   * time range. When item count exceeds the limit, extra items appear grouped under
+   * an "other" category.
+   */
+  limitPerGroup?: number;
+
+  /**
+   * Filters results by location. Specify a comma-separated list of alpha-2 codes.
+   * Prefix with `-` to exclude locations from results. For example, `-US,PT`
+   * excludes results from the US, but includes results from PT.
+   */
+  location?: Array<string>;
+
+  /**
+   * Filters results based on whether the queries have a matching answer.
+   */
+  matchingAnswer?: Array<boolean>;
+
+  /**
+   * Array of names used to label the series in the response.
+   */
+  name?: Array<string>;
+
+  /**
+   * Specifies whether the response includes empty DNS responses (NODATA).
+   */
+  nodata?: Array<boolean>;
+
+  /**
+   * Filters results by DNS transport protocol.
+   */
+  protocol?: Array<'UDP' | 'TCP' | 'HTTPS' | 'TLS'>;
+
+  /**
+   * Filters results by DNS query type.
+   */
+  queryType?: Array<
+    | 'A'
+    | 'AAAA'
+    | 'A6'
+    | 'AFSDB'
+    | 'ANY'
+    | 'APL'
+    | 'ATMA'
+    | 'AXFR'
+    | 'CAA'
+    | 'CDNSKEY'
+    | 'CDS'
+    | 'CERT'
+    | 'CNAME'
+    | 'CSYNC'
+    | 'DHCID'
+    | 'DLV'
+    | 'DNAME'
+    | 'DNSKEY'
+    | 'DOA'
+    | 'DS'
+    | 'EID'
+    | 'EUI48'
+    | 'EUI64'
+    | 'GPOS'
+    | 'GID'
+    | 'HINFO'
+    | 'HIP'
+    | 'HTTPS'
+    | 'IPSECKEY'
+    | 'ISDN'
+    | 'IXFR'
+    | 'KEY'
+    | 'KX'
+    | 'L32'
+    | 'L64'
+    | 'LOC'
+    | 'LP'
+    | 'MAILA'
+    | 'MAILB'
+    | 'MB'
+    | 'MD'
+    | 'MF'
+    | 'MG'
+    | 'MINFO'
+    | 'MR'
+    | 'MX'
+    | 'NAPTR'
+    | 'NB'
+    | 'NBSTAT'
+    | 'NID'
+    | 'NIMLOC'
+    | 'NINFO'
+    | 'NS'
+    | 'NSAP'
+    | 'NSEC'
+    | 'NSEC3'
+    | 'NSEC3PARAM'
+    | 'NULL'
+    | 'NXT'
+    | 'OPENPGPKEY'
+    | 'OPT'
+    | 'PTR'
+    | 'PX'
+    | 'RKEY'
+    | 'RP'
+    | 'RRSIG'
+    | 'RT'
+    | 'SIG'
+    | 'SINK'
+    | 'SMIMEA'
+    | 'SOA'
+    | 'SPF'
+    | 'SRV'
+    | 'SSHFP'
+    | 'SVCB'
+    | 'TA'
+    | 'TALINK'
+    | 'TKEY'
+    | 'TLSA'
+    | 'TSIG'
+    | 'TXT'
+    | 'UINFO'
+    | 'UID'
+    | 'UNSPEC'
+    | 'URI'
+    | 'WKS'
+    | 'X25'
+    | 'ZONEMD'
+    | null
+  >;
+
+  /**
+   * Filters results by DNS response code.
+   */
+  responseCode?: Array<
+    | 'NOERROR'
+    | 'FORMERR'
+    | 'SERVFAIL'
+    | 'NXDOMAIN'
+    | 'NOTIMP'
+    | 'REFUSED'
+    | 'YXDOMAIN'
+    | 'YXRRSET'
+    | 'NXRRSET'
+    | 'NOTAUTH'
+    | 'NOTZONE'
+    | 'BADSIG'
+    | 'BADKEY'
+    | 'BADTIME'
+    | 'BADMODE'
+    | 'BADNAME'
+    | 'BADALG'
+    | 'BADTRUNC'
+    | 'BADCOOKIE'
+  >;
+
+  /**
+   * Filters results by DNS response TTL.
+   */
+  responseTtl?: Array<
+    'LTE_1M' | 'GT_1M_LTE_5M' | 'GT_5M_LTE_15M' | 'GT_15M_LTE_1H' | 'GT_1H_LTE_1D' | 'GT_1D_LTE_1W' | 'GT_1W'
+  >;
+
+  /**
+   * Filters results by top-level domain.
+   */
+  tld?: Array<string>;
+}
+
+export interface DNSTimeseriesParams {
+  /**
+   * Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals).
+   * Refer to
+   * [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).
+   */
+  aggInterval?: '15m' | '1h' | '1d' | '1w';
+
+  /**
+   * Filters results by Autonomous System. Specify one or more Autonomous System
+   * Numbers (ASNs) as a comma-separated list. Prefix with `-` to exclude ASNs from
+   * results. For example, `-174, 3356` excludes results from AS174, but includes
+   * results from AS3356.
+   */
+  asn?: Array<string>;
+
+  /**
+   * Filters results based on cache status.
+   */
+  cacheHit?: Array<boolean>;
+
+  /**
+   * Filters results by continent. Specify a comma-separated list of alpha-2 codes.
+   * Prefix with `-` to exclude continents from results. For example, `-EU,NA`
+   * excludes results from EU, but includes results from NA.
+   */
+  continent?: Array<string>;
 
-    /**
-     * Measurement units for the results.
-     */
-    units: Array<Meta.Unit>;
-  }
+  /**
+   * End of the date range (inclusive).
+   */
+  dateEnd?: Array<string>;
 
-  export namespace Meta {
-    export interface ConfidenceInfo {
-      annotations: Array<ConfidenceInfo.Annotation>;
+  /**
+   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
+   * this week with the previous week. Use this parameter or set specific start and
+   * end dates (`dateStart` and `dateEnd` parameters).
+   */
+  dateRange?: Array<string>;
 
-      /**
-       * Provides an indication of how much confidence Cloudflare has in the data.
-       */
-      level: number;
-    }
+  /**
+   * Start of the date range.
+   */
+  dateStart?: Array<string>;
 
-    export namespace ConfidenceInfo {
-      /**
-       * Annotation associated with the result (e.g. outage or other type of event).
-       */
-      export interface Annotation {
-        dataSource: string;
+  /**
+   * Filters results based on DNSSEC (DNS Security Extensions) support.
+   */
+  dnssec?: Array<'INVALID' | 'INSECURE' | 'SECURE' | 'OTHER'>;
 
-        description: string;
+  /**
+   * Filters results based on DNSSEC (DNS Security Extensions) client awareness.
+   */
+  dnssecAware?: Array<'SUPPORTED' | 'NOT_SUPPORTED'>;
 
-        endDate: string;
+  /**
+   * Filters results based on DNSSEC-validated answers by end-to-end security status.
+   */
+  dnssecE2e?: Array<boolean>;
 
-        eventType: string;
+  /**
+   * Format in which results will be returned.
+   */
+  format?: 'JSON' | 'CSV';
 
-        /**
-         * Whether event is a single point in time or a time range.
-         */
-        isInstantaneous: boolean;
+  /**
+   * Filters results by IP version (Ipv4 vs. IPv6).
+   */
+  ipVersion?: Array<'IPv4' | 'IPv6'>;
 
-        linkedUrl: string;
+  /**
+   * Filters results by location. Specify a comma-separated list of alpha-2 codes.
+   * Prefix with `-` to exclude locations from results. For example, `-US,PT`
+   * excludes results from the US, but includes results from PT.
+   */
+  location?: Array<string>;
 
-        startDate: string;
-      }
-    }
+  /**
+   * Filters results based on whether the queries have a matching answer.
+   */
+  matchingAnswer?: Array<boolean>;
 
-    export interface DateRange {
-      /**
-       * Adjusted end of date range.
-       */
-      endTime: string;
+  /**
+   * Array of names used to label the series in the response.
+   */
+  name?: Array<string>;
 
-      /**
-       * Adjusted start of date range.
-       */
-      startTime: string;
-    }
+  /**
+   * Specifies whether the response includes empty DNS responses (NODATA).
+   */
+  nodata?: Array<boolean>;
 
-    export interface Unit {
-      name: string;
+  /**
+   * Filters results by DNS transport protocol.
+   */
+  protocol?: Array<'UDP' | 'TCP' | 'HTTPS' | 'TLS'>;
 
-      value: string;
-    }
-  }
+  /**
+   * Filters results by DNS query type.
+   */
+  queryType?: Array<
+    | 'A'
+    | 'AAAA'
+    | 'A6'
+    | 'AFSDB'
+    | 'ANY'
+    | 'APL'
+    | 'ATMA'
+    | 'AXFR'
+    | 'CAA'
+    | 'CDNSKEY'
+    | 'CDS'
+    | 'CERT'
+    | 'CNAME'
+    | 'CSYNC'
+    | 'DHCID'
+    | 'DLV'
+    | 'DNAME'
+    | 'DNSKEY'
+    | 'DOA'
+    | 'DS'
+    | 'EID'
+    | 'EUI48'
+    | 'EUI64'
+    | 'GPOS'
+    | 'GID'
+    | 'HINFO'
+    | 'HIP'
+    | 'HTTPS'
+    | 'IPSECKEY'
+    | 'ISDN'
+    | 'IXFR'
+    | 'KEY'
+    | 'KX'
+    | 'L32'
+    | 'L64'
+    | 'LOC'
+    | 'LP'
+    | 'MAILA'
+    | 'MAILB'
+    | 'MB'
+    | 'MD'
+    | 'MF'
+    | 'MG'
+    | 'MINFO'
+    | 'MR'
+    | 'MX'
+    | 'NAPTR'
+    | 'NB'
+    | 'NBSTAT'
+    | 'NID'
+    | 'NIMLOC'
+    | 'NINFO'
+    | 'NS'
+    | 'NSAP'
+    | 'NSEC'
+    | 'NSEC3'
+    | 'NSEC3PARAM'
+    | 'NULL'
+    | 'NXT'
+    | 'OPENPGPKEY'
+    | 'OPT'
+    | 'PTR'
+    | 'PX'
+    | 'RKEY'
+    | 'RP'
+    | 'RRSIG'
+    | 'RT'
+    | 'SIG'
+    | 'SINK'
+    | 'SMIMEA'
+    | 'SOA'
+    | 'SPF'
+    | 'SRV'
+    | 'SSHFP'
+    | 'SVCB'
+    | 'TA'
+    | 'TALINK'
+    | 'TKEY'
+    | 'TLSA'
+    | 'TSIG'
+    | 'TXT'
+    | 'UINFO'
+    | 'UID'
+    | 'UNSPEC'
+    | 'URI'
+    | 'WKS'
+    | 'X25'
+    | 'ZONEMD'
+    | null
+  >;
 
-  export interface unnamed_schema_ref_75bae70cf28e6bcef364b9840db3bdeb {
-    timestamps: Array<string>;
+  /**
+   * Filters results by DNS response code.
+   */
+  responseCode?: Array<
+    | 'NOERROR'
+    | 'FORMERR'
+    | 'SERVFAIL'
+    | 'NXDOMAIN'
+    | 'NOTIMP'
+    | 'REFUSED'
+    | 'YXDOMAIN'
+    | 'YXRRSET'
+    | 'NXRRSET'
+    | 'NOTAUTH'
+    | 'NOTZONE'
+    | 'BADSIG'
+    | 'BADKEY'
+    | 'BADTIME'
+    | 'BADMODE'
+    | 'BADNAME'
+    | 'BADALG'
+    | 'BADTRUNC'
+    | 'BADCOOKIE'
+  >;
 
-    values: Array<string>;
-  }
+  /**
+   * Filters results by DNS response TTL.
+   */
+  responseTtl?: Array<
+    'LTE_1M' | 'GT_1M_LTE_5M' | 'GT_5M_LTE_15M' | 'GT_15M_LTE_1H' | 'GT_1H_LTE_1D' | 'GT_1D_LTE_1W' | 'GT_1W'
+  >;
+
+  /**
+   * Filters results by top-level domain.
+   */
+  tld?: Array<string>;
 }
 
-export interface DNSTimeseriesParams {
+export interface DNSTimeseriesGroupsV2Params {
   /**
    * Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals).
    * Refer to
@@ -218,6 +1116,11 @@ export interface DNSTimeseriesParams {
    */
   asn?: Array<string>;
 
+  /**
+   * Filters results based on cache status.
+   */
+  cacheHit?: Array<boolean>;
+
   /**
    * Filters results by continent. Specify a comma-separated list of alpha-2 codes.
    * Prefix with `-` to exclude continents from results. For example, `-EU,NA`
@@ -242,11 +1145,38 @@ export interface DNSTimeseriesParams {
    */
   dateStart?: Array<string>;
 
+  /**
+   * Filters results based on DNSSEC (DNS Security Extensions) support.
+   */
+  dnssec?: Array<'INVALID' | 'INSECURE' | 'SECURE' | 'OTHER'>;
+
+  /**
+   * Filters results based on DNSSEC (DNS Security Extensions) client awareness.
+   */
+  dnssecAware?: Array<'SUPPORTED' | 'NOT_SUPPORTED'>;
+
+  /**
+   * Filters results based on DNSSEC-validated answers by end-to-end security status.
+   */
+  dnssecE2e?: Array<boolean>;
+
   /**
    * Format in which results will be returned.
    */
   format?: 'JSON' | 'CSV';
 
+  /**
+   * Filters results by IP version (Ipv4 vs. IPv6).
+   */
+  ipVersion?: Array<'IPv4' | 'IPv6'>;
+
+  /**
+   * Limits the number of objects per group to the top items within the specified
+   * time range. When item count exceeds the limit, extra items appear grouped under
+   * an "other" category.
+   */
+  limitPerGroup?: number;
+
   /**
    * Filters results by location. Specify a comma-separated list of alpha-2 codes.
    * Prefix with `-` to exclude locations from results. For example, `-US,PT`
@@ -254,6 +1184,11 @@ export interface DNSTimeseriesParams {
    */
   location?: Array<string>;
 
+  /**
+   * Filters results based on whether the queries have a matching answer.
+   */
+  matchingAnswer?: Array<boolean>;
+
   /**
    * Array of names used to label the series in the response.
    */
@@ -262,17 +1197,23 @@ export interface DNSTimeseriesParams {
   /**
    * Specifies whether the response includes empty DNS responses (NODATA).
    */
-  nodata?: boolean;
+  nodata?: Array<boolean>;
+
+  /**
+   * Normalization method applied to the results. Refer to
+   * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+   */
+  normalization?: 'PERCENTAGE' | 'MIN0_MAX';
 
   /**
    * Filters results by DNS transport protocol.
    */
-  protocol?: 'UDP' | 'TCP' | 'HTTPS' | 'TLS';
+  protocol?: Array<'UDP' | 'TCP' | 'HTTPS' | 'TLS'>;
 
   /**
    * Filters results by DNS query type.
    */
-  queryType?:
+  queryType?: Array<
     | 'A'
     | 'AAAA'
     | 'A6'
@@ -361,12 +1302,13 @@ export interface DNSTimeseriesParams {
     | 'WKS'
     | 'X25'
     | 'ZONEMD'
-    | null;
+    | null
+  >;
 
   /**
    * Filters results by DNS response code.
    */
-  responseCode?:
+  responseCode?: Array<
     | 'NOERROR'
     | 'FORMERR'
     | 'SERVFAIL'
@@ -385,10 +1327,18 @@ export interface DNSTimeseriesParams {
     | 'BADNAME'
     | 'BADALG'
     | 'BADTRUNC'
-    | 'BADCOOKIE';
+    | 'BADCOOKIE'
+  >;
+
+  /**
+   * Filters results by DNS response TTL.
+   */
+  responseTtl?: Array<
+    'LTE_1M' | 'GT_1M_LTE_5M' | 'GT_5M_LTE_15M' | 'GT_15M_LTE_1H' | 'GT_1H_LTE_1D' | 'GT_1D_LTE_1W' | 'GT_1W'
+  >;
 
   /**
-   * Filters results by country code top-level domain (ccTLD).
+   * Filters results by top-level domain.
    */
   tld?: Array<string>;
 }
@@ -399,8 +1349,12 @@ DNS.TimeseriesGroups = TimeseriesGroups;
 
 export declare namespace DNS {
   export {
+    type DNSSummaryV2Response as DNSSummaryV2Response,
     type DNSTimeseriesResponse as DNSTimeseriesResponse,
+    type DNSTimeseriesGroupsV2Response as DNSTimeseriesGroupsV2Response,
+    type DNSSummaryV2Params as DNSSummaryV2Params,
     type DNSTimeseriesParams as DNSTimeseriesParams,
+    type DNSTimeseriesGroupsV2Params as DNSTimeseriesGroupsV2Params,
   };
 
   export {