cloudflare 6.1.0 → 6.3.0

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-security/investigate/investigate.ts

@@ -205,6 +205,10 @@ export interface InvestigateListResponse {
 
   sent_date?: string | null;
 
+  smtp_helo_server_ip?: string | null;
+
+  smtp_previous_hop_ip?: string | null;
+
   subject?: string | null;
 
   threat_categories?: Array<string> | null;
@@ -214,6 +218,8 @@ export interface InvestigateListResponse {
   to_name?: Array<string> | null;
 
   validation?: InvestigateListResponse.Validation;
+
+  x_originating_ip?: string | null;
 }
 
 export namespace InvestigateListResponse {
@@ -459,6 +465,10 @@ export interface InvestigateGetResponse {
 
   sent_date?: string | null;
 
+  smtp_helo_server_ip?: string | null;
+
+  smtp_previous_hop_ip?: string | null;
+
   subject?: string | null;
 
   threat_categories?: Array<string> | null;
@@ -468,6 +478,8 @@ export interface InvestigateGetResponse {
   to_name?: Array<string> | null;
 
   validation?: InvestigateGetResponse.Validation;
+
+  x_originating_ip?: string | null;
 }
 
 export namespace InvestigateGetResponse {
@@ -626,6 +638,11 @@ export interface InvestigateListParams extends V4PagePaginationArrayParams {
    */
   cursor?: string;
 
+  /**
+   * Query param: Delivery status to filter by.
+   */
+  delivery_status?: 'delivered' | 'moved' | 'quarantined' | 'rejected' | 'deferred' | 'bounced' | 'queued';
+
   /**
    * Query param: Whether to include only detections in search results.
    */

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

@@ -5,6 +5,7 @@ export { ACM } from './acm/acm';
 export { AI } from './ai/ai';
 export { AIGateway } from './ai-gateway/ai-gateway';
 export { AISearch } from './aisearch/aisearch';
+export { AISecurity } from './ai-security/ai-security';
 export { APIGateway } from './api-gateway/api-gateway';
 export { AbuseReports } from './abuse-reports/abuse-reports';
 export { Accounts } from './accounts/accounts';
@@ -31,6 +32,8 @@ export { CustomNameservers } from './custom-nameservers';
 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/indicator-feeds/indicator-feeds.ts

@@ -317,6 +317,17 @@ export interface IndicatorFeedGetResponse {
    */
   last_upload_summary?: IndicatorFeedGetResponse.LastUploadSummary;
 
+  /**
+   * Human-readable error message describing why the latest upload failed. Populated
+   * only when `latest_upload_status` is `Error`. Returns one of a small fixed set of
+   * category-level messages (invalid domain / IP / URL entries, malformed row or
+   * header, invalid valid_until timestamp, etc.) or the generic `Upload failed` for
+   * unknown or infrastructure-level errors. Never echoes raw error text from the
+   * underlying loader. Intel accounts receive the verbatim loader/API error text
+   * (including specific offending values) instead of these category-level messages.
+   */
+  latest_upload_error?: string;
+
   /**
    * Status of the latest snapshot uploaded
    */

package/src/resources/intel/miscategorizations.ts

@@ -7,6 +7,11 @@ export class Miscategorizations extends APIResource {
   /**
    * Allows you to submit requests to change a domain’s category.
    *
+   * Requests that include category `169` (New Domains) or category `177` (Newly
+   * Seen) in any of `content_adds`, `content_removes`, `security_adds`, or
+   * `security_removes` will be rejected with a `400 Bad Request`. These categories
+   * are automatically managed and fall off 30 days after they are applied.
+   *
    * @example
    * ```ts
    * const miscategorization =

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/load-balancers/api.md

@@ -70,16 +70,26 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/load-balancers/monitor-groups.ts">MonitorGroup</a></code>
+- <code><a href="./src/resources/load-balancers/monitor-groups/monitor-groups.ts">MonitorGroup</a></code>
 
 Methods:
 
-- <code title="post /accounts/{account_id}/load_balancers/monitor_groups">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups.ts">create</a>({ ...params }) -> MonitorGroup</code>
-- <code title="put /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups.ts">update</a>(monitorGroupId, { ...params }) -> MonitorGroup</code>
-- <code title="get /accounts/{account_id}/load_balancers/monitor_groups">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups.ts">list</a>({ ...params }) -> MonitorGroupsSinglePage</code>
-- <code title="delete /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups.ts">delete</a>(monitorGroupId, { ...params }) -> MonitorGroup</code>
-- <code title="patch /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups.ts">edit</a>(monitorGroupId, { ...params }) -> MonitorGroup</code>
-- <code title="get /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups.ts">get</a>(monitorGroupId, { ...params }) -> MonitorGroup</code>
+- <code title="post /accounts/{account_id}/load_balancers/monitor_groups">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups/monitor-groups.ts">create</a>({ ...params }) -> MonitorGroup</code>
+- <code title="put /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups/monitor-groups.ts">update</a>(monitorGroupId, { ...params }) -> MonitorGroup</code>
+- <code title="get /accounts/{account_id}/load_balancers/monitor_groups">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups/monitor-groups.ts">list</a>({ ...params }) -> MonitorGroupsSinglePage</code>
+- <code title="delete /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups/monitor-groups.ts">delete</a>(monitorGroupId, { ...params }) -> MonitorGroup</code>
+- <code title="patch /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups/monitor-groups.ts">edit</a>(monitorGroupId, { ...params }) -> MonitorGroup</code>
+- <code title="get /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}">client.loadBalancers.monitorGroups.<a href="./src/resources/load-balancers/monitor-groups/monitor-groups.ts">get</a>(monitorGroupId, { ...params }) -> MonitorGroup</code>
+
+### References
+
+Types:
+
+- <code><a href="./src/resources/load-balancers/monitor-groups/references.ts">ReferenceGetResponse</a></code>
+
+Methods:
+
+- <code title="get /accounts/{account_id}/load_balancers/monitor_groups/{monitor_group_id}/references">client.loadBalancers.monitorGroups.references.<a href="./src/resources/load-balancers/monitor-groups/references.ts">get</a>(monitorGroupId, { ...params }) -> ReferenceGetResponsesSinglePage</code>
 
 ## Pools
 

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

@@ -11,7 +11,7 @@ export {
   type MonitorGroupDeleteParams,
   type MonitorGroupEditParams,
   type MonitorGroupGetParams,
-} from './monitor-groups';
+} from './monitor-groups/index';
 export {
   MonitorsSinglePage,
   Monitors,

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

@@ -3,18 +3,6 @@
 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';
@@ -26,6 +14,18 @@ import {
   SearchListResponsesV4PagePagination,
   Searches,
 } from './searches';
+import * as MonitorGroupsAPI from './monitor-groups/monitor-groups';
+import {
+  MonitorGroup,
+  MonitorGroupCreateParams,
+  MonitorGroupDeleteParams,
+  MonitorGroupEditParams,
+  MonitorGroupGetParams,
+  MonitorGroupListParams,
+  MonitorGroupUpdateParams,
+  MonitorGroups,
+  MonitorGroupsSinglePage,
+} from './monitor-groups/monitor-groups';
 import * as MonitorsAPI from './monitors/monitors';
 import {
   Monitor,

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

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  MonitorGroupsSinglePage,
+  MonitorGroups,
+  type MonitorGroup,
+  type MonitorGroupCreateParams,
+  type MonitorGroupUpdateParams,
+  type MonitorGroupListParams,
+  type MonitorGroupDeleteParams,
+  type MonitorGroupEditParams,
+  type MonitorGroupGetParams,
+} from './monitor-groups';
+export {
+  ReferenceGetResponsesSinglePage,
+  References,
+  type ReferenceGetResponse,
+  type ReferenceGetParams,
+} from './references';