cloudflare 6.2.0 → 6.4.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>;
 
@@ -2335,18 +2335,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/api.md

@@ -0,0 +1,33 @@
+# DLS
+
+## Regions
+
+Types:
+
+- <code><a href="./src/resources/dls/regions.ts">RegionListResponse</a></code>
+- <code><a href="./src/resources/dls/regions.ts">RegionGetResponse</a></code>
+
+Methods:
+
+- <code title="get /accounts/{account_id}/dls/regions">client.dls.regions.<a href="./src/resources/dls/regions.ts">list</a>({ ...params }) -> RegionListResponsesCursorPagination</code>
+- <code title="get /accounts/{account_id}/dls/regions/{region_id}">client.dls.regions.<a href="./src/resources/dls/regions.ts">get</a>(regionId, { ...params }) -> RegionGetResponse</code>
+
+## RegionalServices
+
+### PrefixBindings
+
+Types:
+
+- <code><a href="./src/resources/dls/regional-services/prefix-bindings.ts">PrefixBindingCreateResponse</a></code>
+- <code><a href="./src/resources/dls/regional-services/prefix-bindings.ts">PrefixBindingListResponse</a></code>
+- <code><a href="./src/resources/dls/regional-services/prefix-bindings.ts">PrefixBindingDeleteResponse</a></code>
+- <code><a href="./src/resources/dls/regional-services/prefix-bindings.ts">PrefixBindingEditResponse</a></code>
+- <code><a href="./src/resources/dls/regional-services/prefix-bindings.ts">PrefixBindingGetResponse</a></code>
+
+Methods:
+
+- <code title="post /accounts/{account_id}/dls/regional_services/prefix_bindings">client.dls.regionalServices.prefixBindings.<a href="./src/resources/dls/regional-services/prefix-bindings.ts">create</a>({ ...params }) -> PrefixBindingCreateResponse</code>
+- <code title="get /accounts/{account_id}/dls/regional_services/prefix_bindings">client.dls.regionalServices.prefixBindings.<a href="./src/resources/dls/regional-services/prefix-bindings.ts">list</a>({ ...params }) -> PrefixBindingListResponsesCursorPagination</code>
+- <code title="delete /accounts/{account_id}/dls/regional_services/prefix_bindings/{binding_id}">client.dls.regionalServices.prefixBindings.<a href="./src/resources/dls/regional-services/prefix-bindings.ts">delete</a>(bindingId, { ...params }) -> PrefixBindingDeleteResponse</code>
+- <code title="patch /accounts/{account_id}/dls/regional_services/prefix_bindings/{binding_id}">client.dls.regionalServices.prefixBindings.<a href="./src/resources/dls/regional-services/prefix-bindings.ts">edit</a>(bindingId, { ...params }) -> PrefixBindingEditResponse</code>
+- <code title="get /accounts/{account_id}/dls/regional_services/prefix_bindings/{binding_id}">client.dls.regionalServices.prefixBindings.<a href="./src/resources/dls/regional-services/prefix-bindings.ts">get</a>(bindingId, { ...params }) -> PrefixBindingGetResponse</code>

package/src/resources/dls/dls.ts

@@ -0,0 +1,38 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import * as RegionsAPI from './regions';
+import {
+  RegionGetParams,
+  RegionGetResponse,
+  RegionListParams,
+  RegionListResponse,
+  RegionListResponsesCursorPagination,
+  Regions,
+} from './regions';
+import * as RegionalServicesAPI from './regional-services/regional-services';
+import { RegionalServices } from './regional-services/regional-services';
+
+export class DLS extends APIResource {
+  regions: RegionsAPI.Regions = new RegionsAPI.Regions(this._client);
+  regionalServices: RegionalServicesAPI.RegionalServices = new RegionalServicesAPI.RegionalServices(
+    this._client,
+  );
+}
+
+DLS.Regions = Regions;
+DLS.RegionListResponsesCursorPagination = RegionListResponsesCursorPagination;
+DLS.RegionalServices = RegionalServices;
+
+export declare namespace DLS {
+  export {
+    Regions as Regions,
+    type RegionListResponse as RegionListResponse,
+    type RegionGetResponse as RegionGetResponse,
+    RegionListResponsesCursorPagination as RegionListResponsesCursorPagination,
+    type RegionListParams as RegionListParams,
+    type RegionGetParams as RegionGetParams,
+  };
+
+  export { RegionalServices as RegionalServices };
+}

package/src/resources/dls/index.ts

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { DLS } from './dls';
+export {
+  RegionListResponsesCursorPagination,
+  Regions,
+  type RegionListResponse,
+  type RegionGetResponse,
+  type RegionListParams,
+  type RegionGetParams,
+} from './regions';
+export { RegionalServices } from './regional-services/index';

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

@@ -0,0 +1,17 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  PrefixBindingListResponsesCursorPagination,
+  PrefixBindings,
+  type PrefixBindingCreateResponse,
+  type PrefixBindingListResponse,
+  type PrefixBindingDeleteResponse,
+  type PrefixBindingEditResponse,
+  type PrefixBindingGetResponse,
+  type PrefixBindingCreateParams,
+  type PrefixBindingListParams,
+  type PrefixBindingDeleteParams,
+  type PrefixBindingEditParams,
+  type PrefixBindingGetParams,
+} from './prefix-bindings';
+export { RegionalServices } from './regional-services';

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

@@ -0,0 +1,310 @@
+// 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: '023e105f4ecef8ad9ca31a8372d0c353',
+   *     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: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  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: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  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: '023e105f4ecef8ad9ca31a8372d0c353',
+   *       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: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  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: Identifier of a Cloudflare account.
+   */
+  account_id: string;
+
+  /**
+   * 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: Identifier of a Cloudflare account.
+   */
+  account_id: string;
+}
+
+export interface PrefixBindingDeleteParams {
+  /**
+   * Identifier of a Cloudflare account.
+   */
+  account_id: string;
+}
+
+export interface PrefixBindingEditParams {
+  /**
+   * Path param: Identifier of a Cloudflare account.
+   */
+  account_id: string;
+
+  /**
+   * Body param: New region key to assign (e.g., "us", "eu", "cfcanary").
+   */
+  region_key: string;
+}
+
+export interface PrefixBindingGetParams {
+  /**
+   * Identifier of a Cloudflare account.
+   */
+  account_id: string;
+}
+
+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';