cloudflare 6.2.0 → 6.3.0

package/src/resources/dls/regional-services/prefix-bindings.ts

@@ -0,0 +1,301 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
+import * as Shared from '../../shared';
+import { CursorPagination, type CursorPaginationParams } from '../../../pagination';
+
+export class PrefixBindings extends APIResource {
+  /**
+   * Create a DLS prefix binding
+   *
+   * @example
+   * ```ts
+   * const prefixBinding =
+   *   await client.dls.regionalServices.prefixBindings.create({
+   *     account_id: 0,
+   *     cidr: '10.0.1.0/24',
+   *     prefix_id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *     region_key: 'eu',
+   *   });
+   * ```
+   */
+  create(
+    params: PrefixBindingCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<PrefixBindingCreateResponse> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.post(`/accounts/${account_id}/dls/regional_services/prefix_bindings`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: PrefixBindingCreateResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * List DLS prefix bindings for an account
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const prefixBindingListResponse of client.dls.regionalServices.prefixBindings.list(
+   *   { account_id: 0 },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: PrefixBindingListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<PrefixBindingListResponsesCursorPagination, PrefixBindingListResponse> {
+    const { account_id, ...query } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/dls/regional_services/prefix_bindings`,
+      PrefixBindingListResponsesCursorPagination,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Delete a DLS prefix binding
+   *
+   * @example
+   * ```ts
+   * const prefixBinding =
+   *   await client.dls.regionalServices.prefixBindings.delete(
+   *     'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *     { account_id: 0 },
+   *   );
+   * ```
+   */
+  delete(
+    bindingId: string,
+    params: PrefixBindingDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<PrefixBindingDeleteResponse> {
+    const { account_id } = params;
+    return this._client.delete(
+      `/accounts/${account_id}/dls/regional_services/prefix_bindings/${bindingId}`,
+      options,
+    );
+  }
+
+  /**
+   * Update a DLS prefix binding
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.dls.regionalServices.prefixBindings.edit(
+   *     'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *     { account_id: 0, region_key: 'eu' },
+   *   );
+   * ```
+   */
+  edit(
+    bindingId: string,
+    params: PrefixBindingEditParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<PrefixBindingEditResponse> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.patch(`/accounts/${account_id}/dls/regional_services/prefix_bindings/${bindingId}`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: PrefixBindingEditResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Get a DLS prefix binding
+   *
+   * @example
+   * ```ts
+   * const prefixBinding =
+   *   await client.dls.regionalServices.prefixBindings.get(
+   *     'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *     { account_id: 0 },
+   *   );
+   * ```
+   */
+  get(
+    bindingId: string,
+    params: PrefixBindingGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<PrefixBindingGetResponse> {
+    const { account_id } = params;
+    return (
+      this._client.get(
+        `/accounts/${account_id}/dls/regional_services/prefix_bindings/${bindingId}`,
+        options,
+      ) as Core.APIPromise<{ result: PrefixBindingGetResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export class PrefixBindingListResponsesCursorPagination extends CursorPagination<PrefixBindingListResponse> {}
+
+export interface PrefixBindingCreateResponse {
+  /**
+   * The ID of the binding.
+   */
+  id: string;
+
+  /**
+   * The CIDR that is bound.
+   */
+  cidr: string;
+
+  /**
+   * The ID of the parent prefix.
+   */
+  prefix_id: string;
+
+  /**
+   * The region key used for the binding.
+   */
+  region_key: string;
+}
+
+export interface PrefixBindingListResponse {
+  /**
+   * The ID of the binding.
+   */
+  id: string;
+
+  /**
+   * The CIDR that is bound.
+   */
+  cidr: string;
+
+  /**
+   * The ID of the parent prefix.
+   */
+  prefix_id: string;
+
+  /**
+   * The region key used for the binding.
+   */
+  region_key: string;
+}
+
+export interface PrefixBindingDeleteResponse {
+  messages: Array<Shared.ResponseInfo>;
+
+  success: boolean;
+
+  errors?: Array<Shared.ResponseInfo>;
+}
+
+export interface PrefixBindingEditResponse {
+  /**
+   * The ID of the binding.
+   */
+  id: string;
+
+  /**
+   * The CIDR that is bound.
+   */
+  cidr: string;
+
+  /**
+   * The ID of the parent prefix.
+   */
+  prefix_id: string;
+
+  /**
+   * The region key used for the binding.
+   */
+  region_key: string;
+}
+
+export interface PrefixBindingGetResponse {
+  /**
+   * The ID of the binding.
+   */
+  id: string;
+
+  /**
+   * The CIDR that is bound.
+   */
+  cidr: string;
+
+  /**
+   * The ID of the parent prefix.
+   */
+  prefix_id: string;
+
+  /**
+   * The region key used for the binding.
+   */
+  region_key: string;
+}
+
+export interface PrefixBindingCreateParams {
+  /**
+   * Path param
+   */
+  account_id: number;
+
+  /**
+   * Body param: IP prefix in CIDR notation to bind.
+   */
+  cidr: string;
+
+  /**
+   * Body param: The ID of the parent IP prefix that contains the CIDR.
+   */
+  prefix_id: string;
+
+  /**
+   * Body param: Region key from managed regions (e.g., "us", "eu").
+   */
+  region_key: string;
+}
+
+export interface PrefixBindingListParams extends CursorPaginationParams {
+  /**
+   * Path param
+   */
+  account_id: number;
+}
+
+export interface PrefixBindingDeleteParams {
+  account_id: number;
+}
+
+export interface PrefixBindingEditParams {
+  /**
+   * Path param
+   */
+  account_id: number;
+
+  /**
+   * Body param: New region key to assign (e.g., "us", "eu", "cfcanary").
+   */
+  region_key: string;
+}
+
+export interface PrefixBindingGetParams {
+  account_id: number;
+}
+
+PrefixBindings.PrefixBindingListResponsesCursorPagination = PrefixBindingListResponsesCursorPagination;
+
+export declare namespace PrefixBindings {
+  export {
+    type PrefixBindingCreateResponse as PrefixBindingCreateResponse,
+    type PrefixBindingListResponse as PrefixBindingListResponse,
+    type PrefixBindingDeleteResponse as PrefixBindingDeleteResponse,
+    type PrefixBindingEditResponse as PrefixBindingEditResponse,
+    type PrefixBindingGetResponse as PrefixBindingGetResponse,
+    PrefixBindingListResponsesCursorPagination as PrefixBindingListResponsesCursorPagination,
+    type PrefixBindingCreateParams as PrefixBindingCreateParams,
+    type PrefixBindingListParams as PrefixBindingListParams,
+    type PrefixBindingDeleteParams as PrefixBindingDeleteParams,
+    type PrefixBindingEditParams as PrefixBindingEditParams,
+    type PrefixBindingGetParams as PrefixBindingGetParams,
+  };
+}

package/src/resources/dls/regional-services/regional-services.ts

@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as PrefixBindingsAPI from './prefix-bindings';
+import {
+  PrefixBindingCreateParams,
+  PrefixBindingCreateResponse,
+  PrefixBindingDeleteParams,
+  PrefixBindingDeleteResponse,
+  PrefixBindingEditParams,
+  PrefixBindingEditResponse,
+  PrefixBindingGetParams,
+  PrefixBindingGetResponse,
+  PrefixBindingListParams,
+  PrefixBindingListResponse,
+  PrefixBindingListResponsesCursorPagination,
+  PrefixBindings,
+} from './prefix-bindings';
+
+export class RegionalServices extends APIResource {
+  prefixBindings: PrefixBindingsAPI.PrefixBindings = new PrefixBindingsAPI.PrefixBindings(this._client);
+}
+
+RegionalServices.PrefixBindings = PrefixBindings;
+RegionalServices.PrefixBindingListResponsesCursorPagination = PrefixBindingListResponsesCursorPagination;
+
+export declare namespace RegionalServices {
+  export {
+    PrefixBindings as PrefixBindings,
+    type PrefixBindingCreateResponse as PrefixBindingCreateResponse,
+    type PrefixBindingListResponse as PrefixBindingListResponse,
+    type PrefixBindingDeleteResponse as PrefixBindingDeleteResponse,
+    type PrefixBindingEditResponse as PrefixBindingEditResponse,
+    type PrefixBindingGetResponse as PrefixBindingGetResponse,
+    PrefixBindingListResponsesCursorPagination as PrefixBindingListResponsesCursorPagination,
+    type PrefixBindingCreateParams as PrefixBindingCreateParams,
+    type PrefixBindingListParams as PrefixBindingListParams,
+    type PrefixBindingDeleteParams as PrefixBindingDeleteParams,
+    type PrefixBindingEditParams as PrefixBindingEditParams,
+    type PrefixBindingGetParams as PrefixBindingGetParams,
+  };
+}

package/src/resources/dls/regional-services.ts

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

package/src/resources/dls/regions.ts

@@ -0,0 +1,118 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import * as Core from '../../core';
+import { CursorPagination, type CursorPaginationParams } from '../../pagination';
+
+export class Regions extends APIResource {
+  /**
+   * List DLS regions for an account
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const regionListResponse of client.dls.regions.list(
+   *   { account_id: 0 },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: RegionListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<RegionListResponsesCursorPagination, RegionListResponse> {
+    const { account_id, ...query } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/dls/regions`,
+      RegionListResponsesCursorPagination,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Get a DLS region
+   *
+   * @example
+   * ```ts
+   * const region = await client.dls.regions.get(
+   *   'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *   { account_id: 0 },
+   * );
+   * ```
+   */
+  get(
+    regionId: string,
+    params: RegionGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<RegionGetResponse> {
+    const { account_id } = params;
+    return (
+      this._client.get(`/accounts/${account_id}/dls/regions/${regionId}`, options) as Core.APIPromise<{
+        result: RegionGetResponse;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export class RegionListResponsesCursorPagination extends CursorPagination<RegionListResponse> {}
+
+export interface RegionListResponse {
+  id: string;
+
+  created_on: string;
+
+  modified_on: string;
+
+  name: string;
+
+  region_key: string;
+
+  version: number;
+
+  version_created_on: string;
+}
+
+export interface RegionGetResponse {
+  id: string;
+
+  created_on: string;
+
+  modified_on: string;
+
+  name: string;
+
+  region_key: string;
+
+  version: number;
+
+  version_created_on: string;
+}
+
+export interface RegionListParams extends CursorPaginationParams {
+  /**
+   * Path param
+   */
+  account_id: number;
+
+  /**
+   * Query param: Filter regions by type. Omit to return all regions.
+   */
+  type?: 'managed' | 'custom';
+}
+
+export interface RegionGetParams {
+  account_id: number;
+}
+
+Regions.RegionListResponsesCursorPagination = RegionListResponsesCursorPagination;
+
+export declare namespace Regions {
+  export {
+    type RegionListResponse as RegionListResponse,
+    type RegionGetResponse as RegionGetResponse,
+    RegionListResponsesCursorPagination as RegionListResponsesCursorPagination,
+    type RegionListParams as RegionListParams,
+    type RegionGetParams as RegionGetParams,
+  };
+}

package/src/resources/dls.ts

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

package/src/resources/email-sending/email-sending.ts

@@ -155,7 +155,7 @@ export interface EmailSendingSendParams {
 
   /**
    * Body param: HTML body of the email. At least one of text or html must be
-   * provided.
+   * provided (non-empty).
    */
   html?: string;
 
@@ -167,7 +167,7 @@ export interface EmailSendingSendParams {
 
   /**
    * Body param: Plain text body of the email. At least one of text or html must be
-   * provided.
+   * provided (non-empty).
    */
   text?: string;
 }

package/src/resources/index.ts

@@ -33,6 +33,7 @@ export { CustomPages } from './custom-pages/custom-pages';
 export { D1Resource } from './d1/d1';
 export { DCVDelegation } from './dcv-delegation';
 export { DDoSProtection } from './ddos-protection/ddos-protection';
+export { DLS } from './dls/dls';
 export { DNS } from './dns/dns';
 export { DNSFirewall } from './dns-firewall/dns-firewall';
 export { Diagnostics } from './diagnostics/diagnostics';

package/src/resources/intel/sinkholes.ts

@@ -6,7 +6,7 @@ import { SinglePage } from '../../pagination';
 
 export class Sinkholes extends APIResource {
   /**
-   * List sinkholes owned by this account
+   * Lists sinkholes owned by the account for redirecting malicious traffic.
    *
    * @example
    * ```ts
@@ -31,44 +31,44 @@ export class SinkholesSinglePage extends SinglePage<Sinkhole> {}
 
 export interface Sinkhole {
   /**
-   * The unique identifier for the sinkhole
+   * The unique identifier for the sinkhole.
    */
   id?: number;
 
   /**
-   * The account tag that owns this sinkhole
+   * The account tag that owns this sinkhole.
    */
   account_tag?: string;
 
   /**
-   * The date and time when the sinkhole was created
+   * The date and time when the sinkhole was created.
    */
   created_on?: string;
 
   /**
-   * The date and time when the sinkhole was last modified
+   * The date and time when the sinkhole was last modified.
    */
   modified_on?: string;
 
   /**
-   * The name of the sinkhole
+   * The name of the sinkhole.
    */
   name?: string;
 
   /**
-   * The name of the R2 bucket to store results
+   * The name of the R2 bucket to store results.
    */
   r2_bucket?: string;
 
   /**
-   * The id of the R2 instance
+   * The id of the R2 instance.
    */
   r2_id?: string;
 }
 
 export interface SinkholeListParams {
   /**
-   * Identifier
+   * Identifier.
    */
   account_id: string;
 }

package/src/resources/logpush/datasets/fields.ts

@@ -41,6 +41,7 @@ export class Fields extends APIResource {
       | 'ipsec_logs'
       | 'magic_ids_detections'
       | 'mcp_portal_logs'
+      | 'mnm_flow_logs'
       | 'nel_reports'
       | 'network_analytics_logs'
       | 'page_shield_events'
@@ -78,6 +79,7 @@ export class Fields extends APIResource {
       | 'ipsec_logs'
       | 'magic_ids_detections'
       | 'mcp_portal_logs'
+      | 'mnm_flow_logs'
       | 'nel_reports'
       | 'network_analytics_logs'
       | 'page_shield_events'
@@ -114,6 +116,7 @@ export class Fields extends APIResource {
       | 'ipsec_logs'
       | 'magic_ids_detections'
       | 'mcp_portal_logs'
+      | 'mnm_flow_logs'
       | 'nel_reports'
       | 'network_analytics_logs'
       | 'page_shield_events'

package/src/resources/logpush/datasets/jobs.ts

@@ -45,6 +45,7 @@ export class Jobs extends APIResource {
       | 'ipsec_logs'
       | 'magic_ids_detections'
       | 'mcp_portal_logs'
+      | 'mnm_flow_logs'
       | 'nel_reports'
       | 'network_analytics_logs'
       | 'page_shield_events'
@@ -82,6 +83,7 @@ export class Jobs extends APIResource {
       | 'ipsec_logs'
       | 'magic_ids_detections'
       | 'mcp_portal_logs'
+      | 'mnm_flow_logs'
       | 'nel_reports'
       | 'network_analytics_logs'
       | 'page_shield_events'
@@ -118,6 +120,7 @@ export class Jobs extends APIResource {
       | 'ipsec_logs'
       | 'magic_ids_detections'
       | 'mcp_portal_logs'
+      | 'mnm_flow_logs'
       | 'nel_reports'
       | 'network_analytics_logs'
       | 'page_shield_events'

package/src/resources/logpush/jobs.ts

@@ -307,6 +307,7 @@ export interface LogpushJob {
     | 'ipsec_logs'
     | 'magic_ids_detections'
     | 'mcp_portal_logs'
+    | 'mnm_flow_logs'
     | 'nel_reports'
     | 'network_analytics_logs'
     | 'page_shield_events'
@@ -635,6 +636,7 @@ export interface JobCreateParams {
     | 'ipsec_logs'
     | 'magic_ids_detections'
     | 'mcp_portal_logs'
+    | 'mnm_flow_logs'
     | 'nel_reports'
     | 'network_analytics_logs'
     | 'page_shield_events'

package/src/resources/organizations/api.md

@@ -35,3 +35,15 @@ Types:
 Methods:
 
 - <code title="get /organizations/{organization_id}/logs/audit">client.organizations.logs.audit.<a href="./src/resources/organizations/logs/audit.ts">list</a>(organizationId, { ...params }) -> AuditListResponsesCursorPaginationAfter</code>
+
+## Billing
+
+### Usage
+
+Types:
+
+- <code><a href="./src/resources/organizations/billing/usage.ts">UsageGetResponse</a></code>
+
+Methods:
+
+- <code title="get /organizations/{organization_id}/billable/usage">client.organizations.billing.usage.<a href="./src/resources/organizations/billing/usage.ts">get</a>(organizationId, { ...params }) -> UsageGetResponse</code>

package/src/resources/organizations/billing/billing.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as UsageAPI from './usage';
+import { Usage, UsageGetParams, UsageGetResponse } from './usage';
+
+export class Billing extends APIResource {
+  usage: UsageAPI.Usage = new UsageAPI.Usage(this._client);
+}
+
+Billing.Usage = Usage;
+
+export declare namespace Billing {
+  export { Usage as Usage, type UsageGetResponse as UsageGetResponse, type UsageGetParams as UsageGetParams };
+}

package/src/resources/organizations/billing/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Billing } from './billing';
+export { Usage, type UsageGetResponse, type UsageGetParams } from './usage';