cloudflare 4.5.0 → 5.1.0

package/src/resources/radar/ct/index.ts

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Authorities,
+  type AuthorityListResponse,
+  type AuthorityGetResponse,
+  type AuthorityListParams,
+  type AuthorityGetParams,
+} from './authorities';
+export {
+  Ct,
+  type CtSummaryResponse,
+  type CtTimeseriesResponse,
+  type CtTimeseriesGroupsResponse,
+  type CtSummaryParams,
+  type CtTimeseriesParams,
+  type CtTimeseriesGroupsParams,
+} from './ct';
+export {
+  Logs,
+  type LogListResponse,
+  type LogGetResponse,
+  type LogListParams,
+  type LogGetParams,
+} from './logs';

package/src/resources/radar/ct/logs.ts

@@ -0,0 +1,271 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import { isRequestOptions } from '../../../core';
+import * as Core from '../../../core';
+
+export class Logs extends APIResource {
+  /**
+   * Retrieves a list of certificate logs.
+   *
+   * @example
+   * ```ts
+   * const logs = await client.radar.ct.logs.list();
+   * ```
+   */
+  list(query?: LogListParams, options?: Core.RequestOptions): Core.APIPromise<LogListResponse>;
+  list(options?: Core.RequestOptions): Core.APIPromise<LogListResponse>;
+  list(
+    query: LogListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<LogListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return (
+      this._client.get('/radar/ct/logs', { query, ...options }) as Core.APIPromise<{
+        result: LogListResponse;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Retrieves the requested certificate log information.
+   *
+   * @example
+   * ```ts
+   * const log = await client.radar.ct.logs.get('argon2024');
+   * ```
+   */
+  get(logSlug: string, query?: LogGetParams, options?: Core.RequestOptions): Core.APIPromise<LogGetResponse>;
+  get(logSlug: string, options?: Core.RequestOptions): Core.APIPromise<LogGetResponse>;
+  get(
+    logSlug: string,
+    query: LogGetParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<LogGetResponse> {
+    if (isRequestOptions(query)) {
+      return this.get(logSlug, {}, query);
+    }
+    return (
+      this._client.get(`/radar/ct/logs/${logSlug}`, { query, ...options }) as Core.APIPromise<{
+        result: LogGetResponse;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export interface LogListResponse {
+  certificateLogs: Array<LogListResponse.CertificateLog>;
+}
+
+export namespace LogListResponse {
+  export interface CertificateLog {
+    /**
+     * The API standard that the certificate log follows.
+     */
+    api: 'RFC6962' | 'STATIC';
+
+    /**
+     * A brief description of the certificate log.
+     */
+    description: string;
+
+    /**
+     * The end date and time for when the log will stop accepting certificates.
+     */
+    endExclusive: string;
+
+    /**
+     * The organization responsible for operating the certificate log.
+     */
+    operator: string;
+
+    /**
+     * A URL-friendly, kebab-case identifier for the certificate log.
+     */
+    slug: string;
+
+    /**
+     * The start date and time for when the log starts accepting certificates.
+     */
+    startInclusive: string;
+
+    /**
+     * The current state of the certificate log. More details about log states can be
+     * found here:
+     * https://googlechrome.github.io/CertificateTransparency/log_states.html
+     */
+    state: 'USABLE' | 'PENDING' | 'QUALIFIED' | 'READ_ONLY' | 'RETIRED' | 'REJECTED';
+
+    /**
+     * Timestamp of when the log state was last updated.
+     */
+    stateTimestamp: string;
+
+    /**
+     * The URL for the certificate log.
+     */
+    url: string;
+  }
+}
+
+export interface LogGetResponse {
+  certificateLog: LogGetResponse.CertificateLog;
+}
+
+export namespace LogGetResponse {
+  export interface CertificateLog {
+    /**
+     * The API standard that the certificate log follows.
+     */
+    api: 'RFC6962' | 'STATIC';
+
+    /**
+     * A brief description of the certificate log.
+     */
+    description: string;
+
+    /**
+     * The end date and time for when the log will stop accepting certificates.
+     */
+    endExclusive: string;
+
+    /**
+     * The organization responsible for operating the certificate log.
+     */
+    operator: string;
+
+    /**
+     * Log performance metrics, including averages and per-endpoint details.
+     */
+    performance: CertificateLog.Performance | null;
+
+    /**
+     * Logs from the same operator.
+     */
+    related: Array<CertificateLog.Related>;
+
+    /**
+     * A URL-friendly, kebab-case identifier for the certificate log.
+     */
+    slug: string;
+
+    /**
+     * The start date and time for when the log starts accepting certificates.
+     */
+    startInclusive: string;
+
+    /**
+     * The current state of the certificate log. More details about log states can be
+     * found here:
+     * https://googlechrome.github.io/CertificateTransparency/log_states.html
+     */
+    state: 'USABLE' | 'PENDING' | 'QUALIFIED' | 'READ_ONLY' | 'RETIRED' | 'REJECTED';
+
+    /**
+     * Timestamp of when the log state was last updated.
+     */
+    stateTimestamp: string;
+
+    /**
+     * The URL for the certificate log.
+     */
+    url: string;
+  }
+
+  export namespace CertificateLog {
+    /**
+     * Log performance metrics, including averages and per-endpoint details.
+     */
+    export interface Performance {
+      endpoints: Array<Performance.Endpoint>;
+
+      responseTime: number;
+
+      uptime: number;
+    }
+
+    export namespace Performance {
+      export interface Endpoint {
+        /**
+         * The certificate log endpoint names used in performance metrics.
+         */
+        endpoint:
+          | 'add-chain (new)'
+          | 'add-chain (old)'
+          | 'add-pre-chain (new)'
+          | 'add-pre-chain (old)'
+          | 'get-entries'
+          | 'get-roots'
+          | 'get-sth';
+
+        responseTime: number;
+
+        uptime: number;
+      }
+    }
+
+    export interface Related {
+      /**
+       * A brief description of the certificate log.
+       */
+      description: string;
+
+      /**
+       * The end date and time for when the log will stop accepting certificates.
+       */
+      endExclusive: string;
+
+      /**
+       * A URL-friendly, kebab-case identifier for the certificate log.
+       */
+      slug: string;
+
+      /**
+       * The start date and time for when the log starts accepting certificates.
+       */
+      startInclusive: string;
+
+      /**
+       * The current state of the certificate log. More details about log states can be
+       * found here:
+       * https://googlechrome.github.io/CertificateTransparency/log_states.html
+       */
+      state: 'USABLE' | 'PENDING' | 'QUALIFIED' | 'READ_ONLY' | 'RETIRED' | 'REJECTED';
+    }
+  }
+}
+
+export interface LogListParams {
+  /**
+   * Format in which results will be returned.
+   */
+  format?: 'JSON' | 'CSV';
+
+  /**
+   * Limits the number of objects returned in the response.
+   */
+  limit?: number;
+
+  /**
+   * Skips the specified number of objects before fetching the results.
+   */
+  offset?: number;
+}
+
+export interface LogGetParams {
+  /**
+   * Format in which results will be returned.
+   */
+  format?: 'JSON' | 'CSV';
+}
+
+export declare namespace Logs {
+  export {
+    type LogListResponse as LogListResponse,
+    type LogGetResponse as LogGetResponse,
+    type LogListParams as LogListParams,
+    type LogGetParams as LogGetParams,
+  };
+}

package/src/resources/radar/ct.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './ct/index';

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

@@ -294,7 +294,7 @@ export namespace SummaryCacheHitResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -403,7 +403,7 @@ export namespace SummaryDNSSECResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -522,7 +522,7 @@ export namespace SummaryDNSSECAwareResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -631,7 +631,7 @@ export namespace SummaryDNSSECE2EResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -740,7 +740,7 @@ export namespace SummaryIPVersionResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -849,7 +849,7 @@ export namespace SummaryMatchingAnswerResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -958,7 +958,7 @@ export namespace SummaryProtocolResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -1077,7 +1077,7 @@ export namespace SummaryQueryTypeResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -1174,7 +1174,7 @@ export namespace SummaryResponseCodeResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -1271,7 +1271,7 @@ export namespace SummaryResponseTTLResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 

package/src/resources/radar/email/routing/summary.ts

@@ -182,7 +182,7 @@ export namespace SummaryARCResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -279,7 +279,7 @@ export namespace SummaryDKIMResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -376,7 +376,7 @@ export namespace SummaryDMARCResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -473,7 +473,7 @@ export namespace SummaryEncryptedResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -582,7 +582,7 @@ export namespace SummaryIPVersionResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -691,7 +691,7 @@ export namespace SummarySPFResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 

package/src/resources/radar/email/security/summary.ts

@@ -262,7 +262,7 @@ export namespace SummaryARCResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -359,7 +359,7 @@ export namespace SummaryDKIMResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -456,7 +456,7 @@ export namespace SummaryDMARCResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -553,7 +553,7 @@ export namespace SummaryMaliciousResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -662,7 +662,7 @@ export namespace SummarySpamResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -771,7 +771,7 @@ export namespace SummarySPFResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -868,7 +868,7 @@ export namespace SummarySpoofResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -977,7 +977,7 @@ export namespace SummaryThreatCategoryResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -1096,7 +1096,7 @@ export namespace SummaryTLSVersionResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 

package/src/resources/radar/http/summary.ts

@@ -244,7 +244,7 @@ export namespace SummaryBotClassResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -353,7 +353,7 @@ export namespace SummaryDeviceTypeResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -467,7 +467,7 @@ export namespace SummaryHTTPProtocolResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -576,7 +576,7 @@ export namespace SummaryHTTPVersionResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -690,7 +690,7 @@ export namespace SummaryIPVersionResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -799,7 +799,7 @@ export namespace SummaryOSResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -908,7 +908,7 @@ export namespace SummaryPostQuantumResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -1017,7 +1017,7 @@ export namespace SummaryTLSVersionResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 

package/src/resources/radar/index.ts

@@ -18,6 +18,15 @@ export {
   type BotTimeseriesParams,
   type BotTimeseriesGroupsParams,
 } from './bots/index';
+export {
+  Ct,
+  type CtSummaryResponse,
+  type CtTimeseriesResponse,
+  type CtTimeseriesGroupsResponse,
+  type CtSummaryParams,
+  type CtTimeseriesParams,
+  type CtTimeseriesGroupsParams,
+} from './ct/index';
 export { DNS, type DNSTimeseriesResponse, type DNSTimeseriesParams } from './dns/index';
 export {
   Datasets,

package/src/resources/radar/leaked-credentials/summary.ts

@@ -79,7 +79,7 @@ export namespace SummaryBotClassResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -188,7 +188,7 @@ export namespace SummaryCompromisedResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 

package/src/resources/radar/netflows/netflows.ts

@@ -79,7 +79,7 @@ export namespace NetflowSummaryResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 

package/src/resources/radar/quality/iqi.ts

@@ -61,7 +61,7 @@ export namespace IQISummaryResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 

package/src/resources/radar/quality/speed/speed.ts

@@ -91,7 +91,7 @@ export namespace SpeedHistogramResponse {
      */
     bucketSize: number;
 
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;
 
@@ -190,7 +190,7 @@ export namespace SpeedSummaryResponse {
    * Metadata for the results.
    */
   export interface Meta {
-    confidenceInfo: Meta.ConfidenceInfo | null;
+    confidenceInfo: Meta.ConfidenceInfo;
 
     dateRange: Array<Meta.DateRange>;