cloudflare 6.3.0 → 6.5.0

package/src/resources/custom-hostnames/custom-hostnames.ts

@@ -305,7 +305,7 @@ export namespace CustomHostname {
     bundle_method?: CustomHostnamesAPI.BundleMethod;
 
     /**
-     * The Certificate Authority that will issue the certificate
+     * The Certificate Authority that will issue the certificate.
      */
     certificate_authority?: Shared.CertificateCA;
 
@@ -694,7 +694,7 @@ export namespace CustomHostnameCreateResponse {
     bundle_method?: CustomHostnamesAPI.BundleMethod;
 
     /**
-     * The Certificate Authority that will issue the certificate
+     * The Certificate Authority that will issue the certificate.
      */
     certificate_authority?: Shared.CertificateCA;
 
@@ -1061,7 +1061,7 @@ export namespace CustomHostnameListResponse {
     bundle_method?: CustomHostnamesAPI.BundleMethod;
 
     /**
-     * The Certificate Authority that will issue the certificate
+     * The Certificate Authority that will issue the certificate.
      */
     certificate_authority?: Shared.CertificateCA;
 
@@ -1435,7 +1435,7 @@ export namespace CustomHostnameEditResponse {
     bundle_method?: CustomHostnamesAPI.BundleMethod;
 
     /**
-     * The Certificate Authority that will issue the certificate
+     * The Certificate Authority that will issue the certificate.
      */
     certificate_authority?: Shared.CertificateCA;
 
@@ -1802,7 +1802,7 @@ export namespace CustomHostnameGetResponse {
     bundle_method?: CustomHostnamesAPI.BundleMethod;
 
     /**
-     * The Certificate Authority that will issue the certificate
+     * The Certificate Authority that will issue the certificate.
      */
     certificate_authority?: Shared.CertificateCA;
 
@@ -2076,18 +2076,18 @@ export namespace CustomHostnameCreateParams {
     bundle_method?: CustomHostnamesAPI.BundleMethodParam;
 
     /**
-     * The Certificate Authority that will issue the certificate
+     * The Certificate Authority that will issue the certificate.
      */
     certificate_authority?: Shared.CertificateCAParam;
 
     /**
      * Whether or not to add Cloudflare Branding for the order. This will add a
-     * subdomain of sni.cloudflaressl.com as the Common Name if set to true
+     * subdomain of sni.cloudflaressl.com as the Common Name if set to true.
      */
     cloudflare_branding?: boolean;
 
     /**
-     * Array of custom certificate and key pairs (1 or 2 pairs allowed)
+     * Array of custom certificate and key pairs (1 or 2 pairs allowed).
      */
     custom_cert_bundle?: Array<SSL.CustomCERTBundle>;
 
@@ -2183,7 +2183,8 @@ export interface CustomHostnameListParams extends V4PagePaginationArrayParams {
   /**
    * Query param: Hostname ID to match against. This ID was generated and returned
    * during the initial custom_hostname creation. This parameter cannot be used with
-   * the 'hostname' parameter.
+   * the 'hostname', 'hostname.exact', 'hostname.contain', or 'hostname.startsWith'
+   * parameters.
    */
   id?: string;
 
@@ -2275,9 +2276,23 @@ export namespace CustomHostnameListParams {
   export interface Hostname {
     /**
      * Filters hostnames by a substring match on the hostname value. This parameter
-     * cannot be used with the 'id' parameter.
+     * cannot be used with the 'id', 'hostname', 'hostname.exact', or
+     * 'hostname.startsWith' parameters.
      */
     contain?: string;
+
+    /**
+     * Fully qualified domain name to match against. This parameter cannot be used with
+     * the 'id', 'hostname', 'hostname.contain', or 'hostname.startsWith' parameters.
+     */
+    exact?: string;
+
+    /**
+     * Filters hostnames by a prefix match on the hostname value. This parameter cannot
+     * be used with the 'id', 'hostname', 'hostname.exact', or 'hostname.contain'
+     * parameters.
+     */
+    startsWith?: string;
   }
 }
 
@@ -2335,18 +2350,18 @@ export namespace CustomHostnameEditParams {
     bundle_method?: CustomHostnamesAPI.BundleMethodParam;
 
     /**
-     * The Certificate Authority that will issue the certificate
+     * The Certificate Authority that will issue the certificate.
      */
     certificate_authority?: Shared.CertificateCAParam;
 
     /**
      * Whether or not to add Cloudflare Branding for the order. This will add a
-     * subdomain of sni.cloudflaressl.com as the Common Name if set to true
+     * subdomain of sni.cloudflaressl.com as the Common Name if set to true.
      */
     cloudflare_branding?: boolean;
 
     /**
-     * Array of custom certificate and key pairs (1 or 2 pairs allowed)
+     * Array of custom certificate and key pairs (1 or 2 pairs allowed).
      */
     custom_cert_bundle?: Array<SSL.CustomCERTBundle>;
 

package/src/resources/d1/database/database.ts

@@ -185,11 +185,12 @@ export class Database extends APIResource {
     params: DatabaseGetParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<D1API.D1> {
-    const { account_id } = params;
+    const { account_id, ...query } = params;
     return (
-      this._client.get(`/accounts/${account_id}/d1/database/${databaseId}`, options) as Core.APIPromise<{
-        result: D1API.D1;
-      }>
+      this._client.get(`/accounts/${account_id}/d1/database/${databaseId}`, {
+        query,
+        ...options,
+      }) as Core.APIPromise<{ result: D1API.D1 }>
     )._thenUnwrap((obj) => obj.result);
   }
 
@@ -839,9 +840,25 @@ export namespace DatabaseExportParams {
 
 export interface DatabaseGetParams {
   /**
-   * Account identifier tag.
+   * Path param: Account identifier tag.
    */
   account_id: string;
+
+  /**
+   * Query param: Comma-separated list of fields to include in the response. When
+   * omitted, all fields are returned.
+   */
+  fields?: Array<
+    | 'uuid'
+    | 'name'
+    | 'created_at'
+    | 'version'
+    | 'jurisdiction'
+    | 'num_tables'
+    | 'file_size'
+    | 'running_in_region'
+    | 'read_replication'
+  >;
 }
 
 export type DatabaseImportParams =

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

@@ -13,7 +13,7 @@ export class PrefixBindings extends APIResource {
    * ```ts
    * const prefixBinding =
    *   await client.dls.regionalServices.prefixBindings.create({
-   *     account_id: 0,
+   *     account_id: '023e105f4ecef8ad9ca31a8372d0c353',
    *     cidr: '10.0.1.0/24',
    *     prefix_id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
    *     region_key: 'eu',
@@ -40,7 +40,7 @@ export class PrefixBindings extends APIResource {
    * ```ts
    * // Automatically fetches more pages as needed.
    * for await (const prefixBindingListResponse of client.dls.regionalServices.prefixBindings.list(
-   *   { account_id: 0 },
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    * )) {
    *   // ...
    * }
@@ -66,7 +66,7 @@ export class PrefixBindings extends APIResource {
    * const prefixBinding =
    *   await client.dls.regionalServices.prefixBindings.delete(
    *     'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
-   *     { account_id: 0 },
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    *   );
    * ```
    */
@@ -90,7 +90,10 @@ export class PrefixBindings extends APIResource {
    * const response =
    *   await client.dls.regionalServices.prefixBindings.edit(
    *     'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
-   *     { account_id: 0, region_key: 'eu' },
+   *     {
+   *       account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *       region_key: 'eu',
+   *     },
    *   );
    * ```
    */
@@ -116,7 +119,7 @@ export class PrefixBindings extends APIResource {
    * const prefixBinding =
    *   await client.dls.regionalServices.prefixBindings.get(
    *     'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
-   *     { account_id: 0 },
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    *   );
    * ```
    */
@@ -235,9 +238,9 @@ export interface PrefixBindingGetResponse {
 
 export interface PrefixBindingCreateParams {
   /**
-   * Path param
+   * Path param: Identifier of a Cloudflare account.
    */
-  account_id: number;
+  account_id: string;
 
   /**
    * Body param: IP prefix in CIDR notation to bind.
@@ -257,20 +260,23 @@ export interface PrefixBindingCreateParams {
 
 export interface PrefixBindingListParams extends CursorPaginationParams {
   /**
-   * Path param
+   * Path param: Identifier of a Cloudflare account.
    */
-  account_id: number;
+  account_id: string;
 }
 
 export interface PrefixBindingDeleteParams {
-  account_id: number;
+  /**
+   * Identifier of a Cloudflare account.
+   */
+  account_id: string;
 }
 
 export interface PrefixBindingEditParams {
   /**
-   * Path param
+   * Path param: Identifier of a Cloudflare account.
    */
-  account_id: number;
+  account_id: string;
 
   /**
    * Body param: New region key to assign (e.g., "us", "eu", "cfcanary").
@@ -279,7 +285,10 @@ export interface PrefixBindingEditParams {
 }
 
 export interface PrefixBindingGetParams {
-  account_id: number;
+  /**
+   * Identifier of a Cloudflare account.
+   */
+  account_id: string;
 }
 
 PrefixBindings.PrefixBindingListResponsesCursorPagination = PrefixBindingListResponsesCursorPagination;

package/src/resources/dls/regions.ts

@@ -12,7 +12,7 @@ export class Regions extends APIResource {
    * ```ts
    * // Automatically fetches more pages as needed.
    * for await (const regionListResponse of client.dls.regions.list(
-   *   { account_id: 0 },
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    * )) {
    *   // ...
    * }
@@ -37,7 +37,7 @@ export class Regions extends APIResource {
    * ```ts
    * const region = await client.dls.regions.get(
    *   'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
-   *   { account_id: 0 },
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    * );
    * ```
    */
@@ -91,9 +91,9 @@ export interface RegionGetResponse {
 
 export interface RegionListParams extends CursorPaginationParams {
   /**
-   * Path param
+   * Path param: Identifier of a Cloudflare account.
    */
-  account_id: number;
+  account_id: string;
 
   /**
    * Query param: Filter regions by type. Omit to return all regions.
@@ -102,7 +102,10 @@ export interface RegionListParams extends CursorPaginationParams {
 }
 
 export interface RegionGetParams {
-  account_id: number;
+  /**
+   * Identifier of a Cloudflare account.
+   */
+  account_id: string;
 }
 
 Regions.RegionListResponsesCursorPagination = RegionListResponsesCursorPagination;

package/src/resources/dns/api.md

@@ -71,8 +71,24 @@ Methods:
 
 ### Zone
 
+Types:
+
+- <code><a href="./src/resources/dns/usage/zone.ts">ZoneGetResponse</a></code>
+
+Methods:
+
+- <code title="get /zones/{zone_id}/dns_records/usage">client.dns.usage.zone.<a href="./src/resources/dns/usage/zone.ts">get</a>({ ...params }) -> ZoneGetResponse</code>
+
 ### Account
 
+Types:
+
+- <code><a href="./src/resources/dns/usage/account.ts">AccountGetResponse</a></code>
+
+Methods:
+
+- <code title="get /accounts/{account_id}/dns_records/usage">client.dns.usage.account.<a href="./src/resources/dns/usage/account.ts">get</a>({ ...params }) -> AccountGetResponse</code>
+
 ## Settings
 
 ### Zone

package/src/resources/dns/usage/account.ts

@@ -1,5 +1,62 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
 
-export class Account extends APIResource {}
+export class Account extends APIResource {
+  /**
+   * Get the current DNS record usage and quota for an account. May include internal
+   * DNS usage and quota.
+   *
+   * @example
+   * ```ts
+   * const account = await client.dns.usage.account.get({
+   *   account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   * });
+   * ```
+   */
+  get(params: AccountGetParams, options?: Core.RequestOptions): Core.APIPromise<AccountGetResponse> {
+    const { account_id } = params;
+    return (
+      this._client.get(`/accounts/${account_id}/dns_records/usage`, options) as Core.APIPromise<{
+        result: AccountGetResponse;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export interface AccountGetResponse {
+  /**
+   * Maximum number of DNS records allowed across all public zones in the account.
+   * Null if using zone-level quota.
+   */
+  record_quota: number | null;
+
+  /**
+   * Current number of DNS records across all public zones in the account.
+   */
+  record_usage: number;
+
+  /**
+   * Maximum number of DNS records allowed across all internal zones in the account.
+   * Only present if internal DNS is enabled.
+   */
+  internal_record_quota?: number;
+
+  /**
+   * Current number of DNS records across all internal zones in the account. Only
+   * present if internal DNS is enabled.
+   */
+  internal_record_usage?: number;
+}
+
+export interface AccountGetParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
+export declare namespace Account {
+  export { type AccountGetResponse as AccountGetResponse, type AccountGetParams as AccountGetParams };
+}

package/src/resources/dns/usage/index.ts

@@ -1,5 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Account } from './account';
+export { Account, type AccountGetResponse, type AccountGetParams } from './account';
 export { Usage } from './usage';
-export { Zone } from './zone';
+export { Zone, type ZoneGetResponse, type ZoneGetParams } from './zone';

package/src/resources/dns/usage/usage.ts

@@ -2,9 +2,9 @@
 
 import { APIResource } from '../../../resource';
 import * as AccountAPI from './account';
-import { Account } from './account';
+import { Account, AccountGetParams, AccountGetResponse } from './account';
 import * as ZoneAPI from './zone';
-import { Zone } from './zone';
+import { Zone, ZoneGetParams, ZoneGetResponse } from './zone';
 
 export class Usage extends APIResource {
   zone: ZoneAPI.Zone = new ZoneAPI.Zone(this._client);
@@ -15,7 +15,11 @@ Usage.Zone = Zone;
 Usage.Account = Account;
 
 export declare namespace Usage {
-  export { Zone as Zone };
+  export { Zone as Zone, type ZoneGetResponse as ZoneGetResponse, type ZoneGetParams as ZoneGetParams };
 
-  export { Account as Account };
+  export {
+    Account as Account,
+    type AccountGetResponse as AccountGetResponse,
+    type AccountGetParams as AccountGetParams,
+  };
 }

package/src/resources/dns/usage/zone.ts

@@ -1,5 +1,50 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
 
-export class Zone extends APIResource {}
+export class Zone extends APIResource {
+  /**
+   * Get the current DNS record usage for a zone, including the number of records and
+   * the quota limit.
+   *
+   * @example
+   * ```ts
+   * const zone = await client.dns.usage.zone.get({
+   *   zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   * });
+   * ```
+   */
+  get(params: ZoneGetParams, options?: Core.RequestOptions): Core.APIPromise<ZoneGetResponse> {
+    const { zone_id } = params;
+    return (
+      this._client.get(`/zones/${zone_id}/dns_records/usage`, options) as Core.APIPromise<{
+        result: ZoneGetResponse;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export interface ZoneGetResponse {
+  /**
+   * Maximum number of DNS records allowed for the zone. Null if using account-level
+   * quota.
+   */
+  record_quota: number | null;
+
+  /**
+   * Current number of DNS records in the zone.
+   */
+  record_usage: number;
+}
+
+export interface ZoneGetParams {
+  /**
+   * Identifier.
+   */
+  zone_id: string;
+}
+
+export declare namespace Zone {
+  export { type ZoneGetResponse as ZoneGetResponse, type ZoneGetParams as ZoneGetParams };
+}

package/src/resources/dns-firewall/dns-firewall.ts

@@ -262,8 +262,11 @@ export interface DNSFirewallCreateResponse {
   negative_cache_ttl: number | null;
 
   /**
-   * Ratelimit in queries per second per datacenter (applies to DNS queries sent to
-   * the upstream nameservers configured on the cluster)
+   * Maximum number of DNS queries per second that will be forwarded to your upstream
+   * nameservers. The limit is enforced per server, where each server receives a
+   * fraction of the configured value. The actual aggregate rate for a data center
+   * may vary depending on how many servers are present. Responses served from cache
+   * do not count toward this limit. Set to null to disable rate limiting.
    */
   ratelimit: number | null;
 
@@ -348,8 +351,11 @@ export interface DNSFirewallListResponse {
   negative_cache_ttl: number | null;
 
   /**
-   * Ratelimit in queries per second per datacenter (applies to DNS queries sent to
-   * the upstream nameservers configured on the cluster)
+   * Maximum number of DNS queries per second that will be forwarded to your upstream
+   * nameservers. The limit is enforced per server, where each server receives a
+   * fraction of the configured value. The actual aggregate rate for a data center
+   * may vary depending on how many servers are present. Responses served from cache
+   * do not count toward this limit. Set to null to disable rate limiting.
    */
   ratelimit: number | null;
 
@@ -441,8 +447,11 @@ export interface DNSFirewallEditResponse {
   negative_cache_ttl: number | null;
 
   /**
-   * Ratelimit in queries per second per datacenter (applies to DNS queries sent to
-   * the upstream nameservers configured on the cluster)
+   * Maximum number of DNS queries per second that will be forwarded to your upstream
+   * nameservers. The limit is enforced per server, where each server receives a
+   * fraction of the configured value. The actual aggregate rate for a data center
+   * may vary depending on how many servers are present. Responses served from cache
+   * do not count toward this limit. Set to null to disable rate limiting.
    */
   ratelimit: number | null;
 
@@ -527,8 +536,11 @@ export interface DNSFirewallGetResponse {
   negative_cache_ttl: number | null;
 
   /**
-   * Ratelimit in queries per second per datacenter (applies to DNS queries sent to
-   * the upstream nameservers configured on the cluster)
+   * Maximum number of DNS queries per second that will be forwarded to your upstream
+   * nameservers. The limit is enforced per server, where each server receives a
+   * fraction of the configured value. The actual aggregate rate for a data center
+   * may vary depending on how many servers are present. Responses served from cache
+   * do not count toward this limit. Set to null to disable rate limiting.
    */
   ratelimit: number | null;
 
@@ -572,6 +584,12 @@ export interface DNSFirewallCreateParams {
    */
   deprecate_any_requests?: boolean;
 
+  /**
+   * Body param: Number of IPv4 addresses to assign to the DNS Firewall cluster. Only
+   * used during cluster creation and cannot be changed later.
+   */
+  dns_firewall_ip_count?: number;
+
   /**
    * Body param: Whether to forward client IP (resolver) subnet if no EDNS Client
    * Subnet is sent
@@ -617,8 +635,11 @@ export interface DNSFirewallCreateParams {
   negative_cache_ttl?: number | null;
 
   /**
-   * Body param: Ratelimit in queries per second per datacenter (applies to DNS
-   * queries sent to the upstream nameservers configured on the cluster)
+   * Body param: Maximum number of DNS queries per second that will be forwarded to
+   * your upstream nameservers. The limit is enforced per server, where each server
+   * receives a fraction of the configured value. The actual aggregate rate for a
+   * data center may vary depending on how many servers are present. Responses served
+   * from cache do not count toward this limit. Set to null to disable rate limiting.
    */
   ratelimit?: number | null;
 
@@ -709,8 +730,11 @@ export interface DNSFirewallEditParams {
   negative_cache_ttl?: number | null;
 
   /**
-   * Body param: Ratelimit in queries per second per datacenter (applies to DNS
-   * queries sent to the upstream nameservers configured on the cluster)
+   * Body param: Maximum number of DNS queries per second that will be forwarded to
+   * your upstream nameservers. The limit is enforced per server, where each server
+   * receives a fraction of the configured value. The actual aggregate rate for a
+   * data center may vary depending on how many servers are present. Responses served
+   * from cache do not count toward this limit. Set to null to disable rate limiting.
    */
   ratelimit?: number | null;
 

package/src/resources/email-auth/api.md

@@ -0,0 +1,25 @@
+# EmailAuth
+
+## DMARCReports
+
+Types:
+
+- <code><a href="./src/resources/email-auth/dmarc-reports.ts">DMARCReportEditResponse</a></code>
+- <code><a href="./src/resources/email-auth/dmarc-reports.ts">DMARCReportGetResponse</a></code>
+
+Methods:
+
+- <code title="patch /zones/{zone_id}/email/auth/dmarc-reports">client.emailAuth.dmarcReports.<a href="./src/resources/email-auth/dmarc-reports.ts">edit</a>({ ...params }) -> DMARCReportEditResponse</code>
+- <code title="get /zones/{zone_id}/email/auth/dmarc-reports">client.emailAuth.dmarcReports.<a href="./src/resources/email-auth/dmarc-reports.ts">get</a>({ ...params }) -> DMARCReportGetResponse</code>
+
+## SPF
+
+### Inspect
+
+Types:
+
+- <code><a href="./src/resources/email-auth/spf/inspect.ts">InspectGetResponse</a></code>
+
+Methods:
+
+- <code title="get /zones/{zone_id}/email/auth/spf/inspect">client.emailAuth.spf.inspect.<a href="./src/resources/email-auth/spf/inspect.ts">get</a>({ ...params }) -> InspectGetResponse</code>