cloudflare 5.1.0 → 5.2.0

package/src/resources/email-security/settings/domains.ts

@@ -173,6 +173,8 @@ export interface DomainListResponse {
 
   authorization?: DomainListResponse.Authorization | null;
 
+  dmarc_status?: 'none' | 'good' | 'invalid' | null;
+
   emails_processed?: DomainListResponse.EmailsProcessed | null;
 
   folder?: 'AllItems' | 'Inbox' | null;
@@ -186,6 +188,8 @@ export interface DomainListResponse {
   require_tls_inbound?: boolean | null;
 
   require_tls_outbound?: boolean | null;
+
+  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid' | null;
 }
 
 export namespace DomainListResponse {
@@ -257,6 +261,8 @@ export interface DomainEditResponse {
 
   authorization?: DomainEditResponse.Authorization | null;
 
+  dmarc_status?: 'none' | 'good' | 'invalid' | null;
+
   emails_processed?: DomainEditResponse.EmailsProcessed | null;
 
   folder?: 'AllItems' | 'Inbox' | null;
@@ -270,6 +276,8 @@ export interface DomainEditResponse {
   require_tls_inbound?: boolean | null;
 
   require_tls_outbound?: boolean | null;
+
+  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid' | null;
 }
 
 export namespace DomainEditResponse {
@@ -327,6 +335,8 @@ export interface DomainGetResponse {
 
   authorization?: DomainGetResponse.Authorization | null;
 
+  dmarc_status?: 'none' | 'good' | 'invalid' | null;
+
   emails_processed?: DomainGetResponse.EmailsProcessed | null;
 
   folder?: 'AllItems' | 'Inbox' | null;
@@ -340,6 +350,8 @@ export interface DomainGetResponse {
   require_tls_inbound?: boolean | null;
 
   require_tls_outbound?: boolean | null;
+
+  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid' | null;
 }
 
 export namespace DomainGetResponse {

package/src/resources/images/v1/stats.ts

@@ -5,7 +5,9 @@ import * as Core from '../../../core';
 
 export class Stats extends APIResource {
   /**
-   * Fetch usage statistics details for Cloudflare Images.
+   * Fetch image statistics details for Cloudflare Images. The returned statistics
+   * detail storage usage, including the current image count vs this account's
+   * allowance.
    *
    * @example
    * ```ts

package/src/resources/intel/indicator-feeds/downloads.ts

@@ -1,59 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../resource';
-import * as Core from '../../../core';
 
-export class Downloads extends APIResource {
-  /**
-   * Download indicator feed data
-   *
-   * @example
-   * ```ts
-   * const download =
-   *   await client.intel.indicatorFeeds.downloads.get(12, {
-   *     account_id: '023e105f4ecef8ad9ca31a8372d0c353',
-   *   });
-   * ```
-   */
-  get(
-    feedId: number,
-    params: DownloadGetParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<DownloadGetResponse> {
-    const { account_id } = params;
-    return (
-      this._client.get(
-        `/accounts/${account_id}/intel/indicator_feeds/${feedId}/download`,
-        options,
-      ) as Core.APIPromise<{ result: DownloadGetResponse }>
-    )._thenUnwrap((obj) => obj.result);
-  }
-}
-
-export interface DownloadGetResponse {
-  /**
-   * Feed id
-   */
-  file_id?: number;
-
-  /**
-   * Name of the file unified in our system
-   */
-  filename?: string;
-
-  /**
-   * Current status of upload, should be unified
-   */
-  status?: string;
-}
-
-export interface DownloadGetParams {
-  /**
-   * Identifier
-   */
-  account_id: string;
-}
-
-export declare namespace Downloads {
-  export { type DownloadGetResponse as DownloadGetResponse, type DownloadGetParams as DownloadGetParams };
-}
+export class Downloads extends APIResource {}

package/src/resources/intel/indicator-feeds/index.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Downloads, type DownloadGetResponse, type DownloadGetParams } from './downloads';
+export { Downloads } from './downloads';
 export {
   IndicatorFeedListResponsesSinglePage,
   IndicatorFeeds,

package/src/resources/intel/indicator-feeds/indicator-feeds.ts

@@ -3,7 +3,7 @@
 import { APIResource } from '../../../resource';
 import * as Core from '../../../core';
 import * as DownloadsAPI from './downloads';
-import { DownloadGetParams, DownloadGetResponse, Downloads } from './downloads';
+import { Downloads } from './downloads';
 import * as PermissionsAPI from './permissions';
 import {
   PermissionCreateParams,
@@ -439,9 +439,5 @@ export declare namespace IndicatorFeeds {
     type PermissionDeleteParams as PermissionDeleteParams,
   };
 
-  export {
-    Downloads as Downloads,
-    type DownloadGetResponse as DownloadGetResponse,
-    type DownloadGetParams as DownloadGetParams,
-  };
+  export { Downloads as Downloads };
 }

package/src/resources/load-balancers/index.ts

@@ -1,6 +1,17 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { LoadBalancers } from './load-balancers';
+export {
+  MonitorGroupsSinglePage,
+  MonitorGroups,
+  type MonitorGroup,
+  type MonitorGroupCreateParams,
+  type MonitorGroupUpdateParams,
+  type MonitorGroupListParams,
+  type MonitorGroupDeleteParams,
+  type MonitorGroupEditParams,
+  type MonitorGroupGetParams,
+} from './monitor-groups';
 export {
   MonitorsSinglePage,
   Monitors,

package/src/resources/load-balancers/load-balancers.ts

@@ -3,6 +3,18 @@
 import { APIResource } from '../../resource';
 import * as Core from '../../core';
 import * as LoadBalancersAPI from './load-balancers';
+import * as MonitorGroupsAPI from './monitor-groups';
+import {
+  MonitorGroup,
+  MonitorGroupCreateParams,
+  MonitorGroupDeleteParams,
+  MonitorGroupEditParams,
+  MonitorGroupGetParams,
+  MonitorGroupListParams,
+  MonitorGroupUpdateParams,
+  MonitorGroups,
+  MonitorGroupsSinglePage,
+} from './monitor-groups';
 import * as PreviewsAPI from './previews';
 import { PreviewGetParams, PreviewGetResponse, Previews } from './previews';
 import * as RegionsAPI from './regions';
@@ -45,6 +57,7 @@ import { SinglePage } from '../../pagination';
 
 export class LoadBalancers extends APIResource {
   monitors: MonitorsAPI.Monitors = new MonitorsAPI.Monitors(this._client);
+  monitorGroups: MonitorGroupsAPI.MonitorGroups = new MonitorGroupsAPI.MonitorGroups(this._client);
   pools: PoolsAPI.Pools = new PoolsAPI.Pools(this._client);
   previews: PreviewsAPI.Previews = new PreviewsAPI.Previews(this._client);
   regions: RegionsAPI.Regions = new RegionsAPI.Regions(this._client);
@@ -2132,6 +2145,8 @@ export interface LoadBalancerGetParams {
 LoadBalancers.LoadBalancersSinglePage = LoadBalancersSinglePage;
 LoadBalancers.Monitors = Monitors;
 LoadBalancers.MonitorsSinglePage = MonitorsSinglePage;
+LoadBalancers.MonitorGroups = MonitorGroups;
+LoadBalancers.MonitorGroupsSinglePage = MonitorGroupsSinglePage;
 LoadBalancers.Pools = Pools;
 LoadBalancers.PoolsSinglePage = PoolsSinglePage;
 LoadBalancers.Previews = Previews;
@@ -2181,6 +2196,18 @@ export declare namespace LoadBalancers {
     type MonitorGetParams as MonitorGetParams,
   };
 
+  export {
+    MonitorGroups as MonitorGroups,
+    type MonitorGroup as MonitorGroup,
+    MonitorGroupsSinglePage as MonitorGroupsSinglePage,
+    type MonitorGroupCreateParams as MonitorGroupCreateParams,
+    type MonitorGroupUpdateParams as MonitorGroupUpdateParams,
+    type MonitorGroupListParams as MonitorGroupListParams,
+    type MonitorGroupDeleteParams as MonitorGroupDeleteParams,
+    type MonitorGroupEditParams as MonitorGroupEditParams,
+    type MonitorGroupGetParams as MonitorGroupGetParams,
+  };
+
   export {
     Pools as Pools,
     type Pool as Pool,

package/src/resources/load-balancers/monitor-groups.ts

@@ -0,0 +1,436 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import * as Core from '../../core';
+import { SinglePage } from '../../pagination';
+
+export class MonitorGroups extends APIResource {
+  /**
+   * Create a new monitor group.
+   *
+   * @example
+   * ```ts
+   * const monitorGroup =
+   *   await client.loadBalancers.monitorGroups.create({
+   *     account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *     id: 'id',
+   *     description: 'Primary datacenter monitors',
+   *     members: [
+   *       {
+   *         enabled: true,
+   *         monitor_id: 'monitor_id',
+   *         monitoring_only: false,
+   *         must_be_healthy: true,
+   *       },
+   *     ],
+   *   });
+   * ```
+   */
+  create(params: MonitorGroupCreateParams, options?: Core.RequestOptions): Core.APIPromise<MonitorGroup> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.post(`/accounts/${account_id}/load_balancers/monitor_groups`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: MonitorGroup }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Modify a configured monitor group.
+   *
+   * @example
+   * ```ts
+   * const monitorGroup =
+   *   await client.loadBalancers.monitorGroups.update(
+   *     '17b5962d775c646f3f9725cbc7a53df4',
+   *     {
+   *       account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *       id: 'id',
+   *       description: 'Primary datacenter monitors',
+   *       members: [
+   *         {
+   *           enabled: true,
+   *           monitor_id: 'monitor_id',
+   *           monitoring_only: false,
+   *           must_be_healthy: true,
+   *         },
+   *       ],
+   *     },
+   *   );
+   * ```
+   */
+  update(
+    monitorGroupId: string,
+    params: MonitorGroupUpdateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<MonitorGroup> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.put(`/accounts/${account_id}/load_balancers/monitor_groups/${monitorGroupId}`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: MonitorGroup }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * List configured monitor groups.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const monitorGroup of client.loadBalancers.monitorGroups.list(
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: MonitorGroupListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<MonitorGroupsSinglePage, MonitorGroup> {
+    const { account_id } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/load_balancers/monitor_groups`,
+      MonitorGroupsSinglePage,
+      options,
+    );
+  }
+
+  /**
+   * Delete a configured monitor group.
+   *
+   * @example
+   * ```ts
+   * const monitorGroup =
+   *   await client.loadBalancers.monitorGroups.delete(
+   *     '17b5962d775c646f3f9725cbc7a53df4',
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  delete(
+    monitorGroupId: string,
+    params: MonitorGroupDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<MonitorGroup> {
+    const { account_id } = params;
+    return (
+      this._client.delete(
+        `/accounts/${account_id}/load_balancers/monitor_groups/${monitorGroupId}`,
+        options,
+      ) as Core.APIPromise<{ result: MonitorGroup }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Apply changes to an existing monitor group, overwriting the supplied properties.
+   *
+   * @example
+   * ```ts
+   * const monitorGroup =
+   *   await client.loadBalancers.monitorGroups.edit(
+   *     '17b5962d775c646f3f9725cbc7a53df4',
+   *     {
+   *       account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *       id: 'id',
+   *       description: 'Primary datacenter monitors',
+   *       members: [
+   *         {
+   *           enabled: true,
+   *           monitor_id: 'monitor_id',
+   *           monitoring_only: false,
+   *           must_be_healthy: true,
+   *         },
+   *       ],
+   *     },
+   *   );
+   * ```
+   */
+  edit(
+    monitorGroupId: string,
+    params: MonitorGroupEditParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<MonitorGroup> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.patch(`/accounts/${account_id}/load_balancers/monitor_groups/${monitorGroupId}`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: MonitorGroup }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Fetch a single configured monitor group.
+   *
+   * @example
+   * ```ts
+   * const monitorGroup =
+   *   await client.loadBalancers.monitorGroups.get(
+   *     '17b5962d775c646f3f9725cbc7a53df4',
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  get(
+    monitorGroupId: string,
+    params: MonitorGroupGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<MonitorGroup> {
+    const { account_id } = params;
+    return (
+      this._client.get(
+        `/accounts/${account_id}/load_balancers/monitor_groups/${monitorGroupId}`,
+        options,
+      ) as Core.APIPromise<{ result: MonitorGroup }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export class MonitorGroupsSinglePage extends SinglePage<MonitorGroup> {}
+
+export interface MonitorGroup {
+  /**
+   * The ID of the Monitor Group to use for checking the health of origins within
+   * this pool.
+   */
+  id: string;
+
+  /**
+   * A short description of the monitor group
+   */
+  description: string;
+
+  /**
+   * List of monitors in this group
+   */
+  members: Array<MonitorGroup.Member>;
+
+  /**
+   * The timestamp of when the monitor group was created
+   */
+  created_at?: string;
+
+  /**
+   * The timestamp of when the monitor group was last updated
+   */
+  updated_at?: string;
+}
+
+export namespace MonitorGroup {
+  export interface Member {
+    /**
+     * Whether this monitor is enabled in the group
+     */
+    enabled: boolean;
+
+    /**
+     * The ID of the Monitor to use for checking the health of origins within this
+     * pool.
+     */
+    monitor_id: string;
+
+    /**
+     * Whether this monitor is used for monitoring only (does not affect pool health)
+     */
+    monitoring_only: boolean;
+
+    /**
+     * Whether this monitor must be healthy for the pool to be considered healthy
+     */
+    must_be_healthy: boolean;
+
+    /**
+     * The timestamp of when the monitor was added to the group
+     */
+    created_at?: string;
+
+    /**
+     * The timestamp of when the monitor group member was last updated
+     */
+    updated_at?: string;
+  }
+}
+
+export interface MonitorGroupCreateParams {
+  /**
+   * Path param: Identifier.
+   */
+  account_id: string;
+
+  /**
+   * Body param: The ID of the Monitor Group to use for checking the health of
+   * origins within this pool.
+   */
+  id: string;
+
+  /**
+   * Body param: A short description of the monitor group
+   */
+  description: string;
+
+  /**
+   * Body param: List of monitors in this group
+   */
+  members: Array<MonitorGroupCreateParams.Member>;
+}
+
+export namespace MonitorGroupCreateParams {
+  export interface Member {
+    /**
+     * Whether this monitor is enabled in the group
+     */
+    enabled: boolean;
+
+    /**
+     * The ID of the Monitor to use for checking the health of origins within this
+     * pool.
+     */
+    monitor_id: string;
+
+    /**
+     * Whether this monitor is used for monitoring only (does not affect pool health)
+     */
+    monitoring_only: boolean;
+
+    /**
+     * Whether this monitor must be healthy for the pool to be considered healthy
+     */
+    must_be_healthy: boolean;
+  }
+}
+
+export interface MonitorGroupUpdateParams {
+  /**
+   * Path param: Identifier.
+   */
+  account_id: string;
+
+  /**
+   * Body param: The ID of the Monitor Group to use for checking the health of
+   * origins within this pool.
+   */
+  id: string;
+
+  /**
+   * Body param: A short description of the monitor group
+   */
+  description: string;
+
+  /**
+   * Body param: List of monitors in this group
+   */
+  members: Array<MonitorGroupUpdateParams.Member>;
+}
+
+export namespace MonitorGroupUpdateParams {
+  export interface Member {
+    /**
+     * Whether this monitor is enabled in the group
+     */
+    enabled: boolean;
+
+    /**
+     * The ID of the Monitor to use for checking the health of origins within this
+     * pool.
+     */
+    monitor_id: string;
+
+    /**
+     * Whether this monitor is used for monitoring only (does not affect pool health)
+     */
+    monitoring_only: boolean;
+
+    /**
+     * Whether this monitor must be healthy for the pool to be considered healthy
+     */
+    must_be_healthy: boolean;
+  }
+}
+
+export interface MonitorGroupListParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
+export interface MonitorGroupDeleteParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
+export interface MonitorGroupEditParams {
+  /**
+   * Path param: Identifier.
+   */
+  account_id: string;
+
+  /**
+   * Body param: The ID of the Monitor Group to use for checking the health of
+   * origins within this pool.
+   */
+  id: string;
+
+  /**
+   * Body param: A short description of the monitor group
+   */
+  description: string;
+
+  /**
+   * Body param: List of monitors in this group
+   */
+  members: Array<MonitorGroupEditParams.Member>;
+}
+
+export namespace MonitorGroupEditParams {
+  export interface Member {
+    /**
+     * Whether this monitor is enabled in the group
+     */
+    enabled: boolean;
+
+    /**
+     * The ID of the Monitor to use for checking the health of origins within this
+     * pool.
+     */
+    monitor_id: string;
+
+    /**
+     * Whether this monitor is used for monitoring only (does not affect pool health)
+     */
+    monitoring_only: boolean;
+
+    /**
+     * Whether this monitor must be healthy for the pool to be considered healthy
+     */
+    must_be_healthy: boolean;
+  }
+}
+
+export interface MonitorGroupGetParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
+MonitorGroups.MonitorGroupsSinglePage = MonitorGroupsSinglePage;
+
+export declare namespace MonitorGroups {
+  export {
+    type MonitorGroup as MonitorGroup,
+    MonitorGroupsSinglePage as MonitorGroupsSinglePage,
+    type MonitorGroupCreateParams as MonitorGroupCreateParams,
+    type MonitorGroupUpdateParams as MonitorGroupUpdateParams,
+    type MonitorGroupListParams as MonitorGroupListParams,
+    type MonitorGroupDeleteParams as MonitorGroupDeleteParams,
+    type MonitorGroupEditParams as MonitorGroupEditParams,
+    type MonitorGroupGetParams as MonitorGroupGetParams,
+  };
+}

package/src/resources/load-balancers/pools/pools.ts

@@ -250,6 +250,12 @@ export interface Pool {
    */
   monitor?: string;
 
+  /**
+   * The ID of the Monitor Group to use for checking the health of origins within
+   * this pool.
+   */
+  monitor_group?: string;
+
   /**
    * A short name (tag) for the pool. Only alphanumeric characters, hyphens, and
    * underscores are allowed.
@@ -354,6 +360,12 @@ export interface PoolCreateParams {
    */
   monitor?: string;
 
+  /**
+   * Body param: The ID of the Monitor Group to use for checking the health of
+   * origins within this pool.
+   */
+  monitor_group?: string;
+
   /**
    * Body param: This field is now deprecated. It has been moved to Cloudflare's
    * Centralized Notification service
@@ -443,6 +455,12 @@ export interface PoolUpdateParams {
    */
   monitor?: string;
 
+  /**
+   * Body param: The ID of the Monitor Group to use for checking the health of
+   * origins within this pool.
+   */
+  monitor_group?: string;
+
   /**
    * Body param: This field is now deprecated. It has been moved to Cloudflare's
    * Centralized Notification service
@@ -553,6 +571,12 @@ export interface PoolEditParams {
    */
   monitor?: string;
 
+  /**
+   * Body param: The ID of the Monitor Group to use for checking the health of
+   * origins within this pool.
+   */
+  monitor_group?: string;
+
   /**
    * Body param: A short name (tag) for the pool. Only alphanumeric characters,
    * hyphens, and underscores are allowed.