cloudflare 4.0.0 → 4.1.0

package/src/resources/logpush/validate.ts

@@ -2,11 +2,11 @@
 
 import { APIResource } from '../../resource';
 import * as Core from '../../core';
-import { CloudflareError } from "../../error";
+import { CloudflareError } from '../../error';
 
 export class Validate extends APIResource {
   /**
-   * Checks if there is an existing job with a destination.
+   * Validates destination.
    */
   destination(
     params: ValidateDestinationParams,
@@ -30,13 +30,45 @@ export class Validate extends APIResource {
           accountOrZoneId: zone_id,
         };
     return (
-      this._client.post(`/${accountOrZone}/${accountOrZoneId}/logpush/validate/destination/exists`, {
+      this._client.post(`/${accountOrZone}/${accountOrZoneId}/logpush/validate/destination`, {
         body,
         ...options,
       }) as Core.APIPromise<{ result: ValidateDestinationResponse | null }>
     )._thenUnwrap((obj) => obj.result);
   }
 
+  /**
+   * Checks if there is an existing job with a destination.
+   */
+  destinationExists(
+    params: ValidateDestinationExistsParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ValidateDestinationExistsResponse | null> {
+    const { account_id, zone_id, ...body } = params;
+    if (!account_id && !zone_id) {
+      throw new CloudflareError('You must provide either account_id or zone_id.');
+    }
+    if (account_id && zone_id) {
+      throw new CloudflareError('You cannot provide both account_id and zone_id.');
+    }
+    const { accountOrZone, accountOrZoneId } =
+      account_id ?
+        {
+          accountOrZone: 'accounts',
+          accountOrZoneId: account_id,
+        }
+      : {
+          accountOrZone: 'zones',
+          accountOrZoneId: zone_id,
+        };
+    return (
+      this._client.post(`/${accountOrZone}/${accountOrZoneId}/logpush/validate/destination/exists`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: ValidateDestinationExistsResponse | null }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
   /**
    * Validates logpull origin with logpull_options.
    */
@@ -71,6 +103,12 @@ export class Validate extends APIResource {
 }
 
 export interface ValidateDestinationResponse {
+  message?: string;
+
+  valid?: boolean;
+}
+
+export interface ValidateDestinationExistsResponse {
   exists?: boolean;
 }
 
@@ -101,6 +139,27 @@ export interface ValidateDestinationParams {
   zone_id?: string;
 }
 
+export interface ValidateDestinationExistsParams {
+  /**
+   * Body param: Uniquely identifies a resource (such as an s3 bucket) where data
+   * will be pushed. Additional configuration parameters supported by the destination
+   * may be included.
+   */
+  destination_conf: string;
+
+  /**
+   * Path param: The Account ID to use for this endpoint. Mutually exclusive with the
+   * Zone ID.
+   */
+  account_id?: string;
+
+  /**
+   * Path param: The Zone ID to use for this endpoint. Mutually exclusive with the
+   * Account ID.
+   */
+  zone_id?: string;
+}
+
 export interface ValidateOriginParams {
   /**
    * Body param: This field is deprecated. Use `output_options` instead.
@@ -127,8 +186,10 @@ export interface ValidateOriginParams {
 export declare namespace Validate {
   export {
     type ValidateDestinationResponse as ValidateDestinationResponse,
+    type ValidateDestinationExistsResponse as ValidateDestinationExistsResponse,
     type ValidateOriginResponse as ValidateOriginResponse,
     type ValidateDestinationParams as ValidateDestinationParams,
+    type ValidateDestinationExistsParams as ValidateDestinationExistsParams,
     type ValidateOriginParams as ValidateOriginParams,
   };
 }

package/src/resources/magic-transit/pcaps/index.ts

@@ -2,9 +2,9 @@
 
 export { Download, type DownloadGetParams } from './download';
 export {
+  OwnershipsSinglePage,
   OwnershipResource,
   type Ownership,
-  type OwnershipGetResponse,
   type OwnershipCreateParams,
   type OwnershipDeleteParams,
   type OwnershipGetParams,

package/src/resources/magic-transit/pcaps/ownership.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../../resource';
 import * as Core from '../../../core';
+import { SinglePage } from '../../../pagination';
 
 export class OwnershipResource extends APIResource {
   /**
@@ -37,13 +38,9 @@ export class OwnershipResource extends APIResource {
   get(
     params: OwnershipGetParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<OwnershipGetResponse | null> {
+  ): Core.PagePromise<OwnershipsSinglePage, Ownership> {
     const { account_id } = params;
-    return (
-      this._client.get(`/accounts/${account_id}/pcaps/ownership`, options) as Core.APIPromise<{
-        result: OwnershipGetResponse | null;
-      }>
-    )._thenUnwrap((obj) => obj.result);
+    return this._client.getAPIList(`/accounts/${account_id}/pcaps/ownership`, OwnershipsSinglePage, options);
   }
 
   /**
@@ -60,6 +57,8 @@ export class OwnershipResource extends APIResource {
   }
 }
 
+export class OwnershipsSinglePage extends SinglePage<Ownership> {}
+
 export interface Ownership {
   /**
    * The bucket ID associated with the packet captures API.
@@ -92,8 +91,6 @@ export interface Ownership {
   validated?: string;
 }
 
-export type OwnershipGetResponse = Array<Ownership>;
-
 export interface OwnershipCreateParams {
   /**
    * Path param: Identifier
@@ -139,10 +136,12 @@ export interface OwnershipValidateParams {
   ownership_challenge: string;
 }
 
+OwnershipResource.OwnershipsSinglePage = OwnershipsSinglePage;
+
 export declare namespace OwnershipResource {
   export {
     type Ownership as Ownership,
-    type OwnershipGetResponse as OwnershipGetResponse,
+    OwnershipsSinglePage as OwnershipsSinglePage,
     type OwnershipCreateParams as OwnershipCreateParams,
     type OwnershipDeleteParams as OwnershipDeleteParams,
     type OwnershipGetParams as OwnershipGetParams,

package/src/resources/magic-transit/pcaps/pcaps.ts

@@ -11,9 +11,9 @@ import {
   OwnershipCreateParams,
   OwnershipDeleteParams,
   OwnershipGetParams,
-  OwnershipGetResponse,
   OwnershipResource,
   OwnershipValidateParams,
+  OwnershipsSinglePage,
 } from './ownership';
 import { SinglePage } from '../../../pagination';
 
@@ -500,6 +500,7 @@ export interface PCAPGetParams {
 
 PCAPs.PCAPListResponsesSinglePage = PCAPListResponsesSinglePage;
 PCAPs.OwnershipResource = OwnershipResource;
+PCAPs.OwnershipsSinglePage = OwnershipsSinglePage;
 PCAPs.Download = Download;
 
 export declare namespace PCAPs {
@@ -518,7 +519,7 @@ export declare namespace PCAPs {
   export {
     OwnershipResource as OwnershipResource,
     type Ownership as Ownership,
-    type OwnershipGetResponse as OwnershipGetResponse,
+    OwnershipsSinglePage as OwnershipsSinglePage,
     type OwnershipCreateParams as OwnershipCreateParams,
     type OwnershipDeleteParams as OwnershipDeleteParams,
     type OwnershipGetParams as OwnershipGetParams,

package/src/resources/magic-transit/sites/acls.ts

@@ -141,6 +141,13 @@ export interface ACL {
   name?: string;
 
   protocols?: Array<AllowedProtocol>;
+
+  /**
+   * The desired traffic direction for this ACL policy. If set to "false", the policy
+   * will allow bidirectional traffic. If set to "true", the policy will only allow
+   * traffic in one direction. If not included in request, will default to false.
+   */
+  unidirectional?: boolean;
 }
 
 export interface ACLConfiguration {
@@ -154,9 +161,16 @@ export interface ACLConfiguration {
    */
   lan_name?: string;
 
+  /**
+   * Array of port ranges on the provided LAN that will be included in the ACL. If no
+   * ports or port rangess are provided, communication on any port on this LAN is
+   * allowed.
+   */
+  port_ranges?: Array<string>;
+
   /**
    * Array of ports on the provided LAN that will be included in the ACL. If no ports
-   * are provided, communication on any port on this LAN is allowed.
+   * or port ranges are provided, communication on any port on this LAN is allowed.
    */
   ports?: Array<number>;
 
@@ -178,9 +192,16 @@ export interface ACLConfigurationParam {
    */
   lan_name?: string;
 
+  /**
+   * Array of port ranges on the provided LAN that will be included in the ACL. If no
+   * ports or port rangess are provided, communication on any port on this LAN is
+   * allowed.
+   */
+  port_ranges?: Array<string>;
+
   /**
    * Array of ports on the provided LAN that will be included in the ACL. If no ports
-   * are provided, communication on any port on this LAN is allowed.
+   * or port ranges are provided, communication on any port on this LAN is allowed.
    */
   ports?: Array<number>;
 
@@ -251,6 +272,14 @@ export interface ACLCreateParams {
    * Body param:
    */
   protocols?: Array<AllowedProtocolParam>;
+
+  /**
+   * Body param: The desired traffic direction for this ACL policy. If set to
+   * "false", the policy will allow bidirectional traffic. If set to "true", the
+   * policy will only allow traffic in one direction. If not included in request,
+   * will default to false.
+   */
+  unidirectional?: boolean;
 }
 
 export interface ACLUpdateParams {
@@ -291,6 +320,14 @@ export interface ACLUpdateParams {
    * Body param:
    */
   protocols?: Array<AllowedProtocolParam>;
+
+  /**
+   * Body param: The desired traffic direction for this ACL policy. If set to
+   * "false", the policy will allow bidirectional traffic. If set to "true", the
+   * policy will only allow traffic in one direction. If not included in request,
+   * will default to false.
+   */
+  unidirectional?: boolean;
 }
 
 export interface ACLListParams {
@@ -345,6 +382,14 @@ export interface ACLEditParams {
    * Body param:
    */
   protocols?: Array<AllowedProtocolParam>;
+
+  /**
+   * Body param: The desired traffic direction for this ACL policy. If set to
+   * "false", the policy will allow bidirectional traffic. If set to "true", the
+   * policy will only allow traffic in one direction. If not included in request,
+   * will default to false.
+   */
+  unidirectional?: boolean;
 }
 
 export interface ACLGetParams {

package/src/resources/magic-transit/sites/index.ts

@@ -23,7 +23,6 @@ export {
   type LANStaticAddressing,
   type Nat,
   type RoutedSubnet,
-  type LANCreateResponse,
   type LANCreateParams,
   type LANUpdateParams,
   type LANListParams,
@@ -48,7 +47,6 @@ export {
   WANs,
   type WAN,
   type WANStaticAddressing,
-  type WANCreateResponse,
   type WANCreateParams,
   type WANUpdateParams,
   type WANListParams,

package/src/resources/magic-transit/sites/lans.ts

@@ -13,14 +13,13 @@ export class LANs extends APIResource {
     siteId: string,
     params: LANCreateParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<LANCreateResponse> {
+  ): Core.PagePromise<LANsSinglePage, LAN> {
     const { account_id, ...body } = params;
-    return (
-      this._client.post(`/accounts/${account_id}/magic/sites/${siteId}/lans`, {
-        body,
-        ...options,
-      }) as Core.APIPromise<{ result: LANCreateResponse }>
-    )._thenUnwrap((obj) => obj.result);
+    return this._client.getAPIList(`/accounts/${account_id}/magic/sites/${siteId}/lans`, LANsSinglePage, {
+      body,
+      method: 'post',
+      ...options,
+    });
   }
 
   /**
@@ -144,6 +143,8 @@ export interface DHCPServer {
    */
   dns_server?: string;
 
+  dns_servers?: Array<string>;
+
   /**
    * Mapping of MAC addresses to IP addresses
    */
@@ -166,6 +167,8 @@ export interface DHCPServerParam {
    */
   dns_server?: string;
 
+  dns_servers?: Array<string>;
+
   /**
    * Mapping of MAC addresses to IP addresses
    */
@@ -304,8 +307,6 @@ export interface RoutedSubnetParam {
   nat?: NatParam;
 }
 
-export type LANCreateResponse = Array<LAN>;
-
 export interface LANCreateParams {
   /**
    * Path param: Identifier
@@ -463,7 +464,6 @@ export declare namespace LANs {
     type LANStaticAddressing as LANStaticAddressing,
     type Nat as Nat,
     type RoutedSubnet as RoutedSubnet,
-    type LANCreateResponse as LANCreateResponse,
     LANsSinglePage as LANsSinglePage,
     type LANCreateParams as LANCreateParams,
     type LANUpdateParams as LANUpdateParams,

package/src/resources/magic-transit/sites/sites.ts

@@ -23,7 +23,6 @@ import {
   DHCPServer,
   LAN,
   LANCreateParams,
-  LANCreateResponse,
   LANDeleteParams,
   LANEditParams,
   LANGetParams,
@@ -39,7 +38,6 @@ import * as WANsAPI from './wans';
 import {
   WAN,
   WANCreateParams,
-  WANCreateResponse,
   WANDeleteParams,
   WANEditParams,
   WANGetParams,
@@ -82,8 +80,8 @@ export class Sites extends APIResource {
   }
 
   /**
-   * Lists Sites associated with an account. Use connector_identifier query param to
-   * return sites where connector_identifier matches either site.ConnectorID or
+   * Lists Sites associated with an account. Use connectorid query param to return
+   * sites where connectorid matches either site.ConnectorID or
    * site.SecondaryConnectorID.
    */
   list(params: SiteListParams, options?: Core.RequestOptions): Core.PagePromise<SitesSinglePage, Site> {
@@ -286,7 +284,7 @@ export interface SiteListParams {
   /**
    * Query param: Identifier
    */
-  connector_identifier?: string;
+  connectorid?: string;
 }
 
 export interface SiteDeleteParams {
@@ -386,7 +384,6 @@ export declare namespace Sites {
     type LANStaticAddressing as LANStaticAddressing,
     type Nat as Nat,
     type RoutedSubnet as RoutedSubnet,
-    type LANCreateResponse as LANCreateResponse,
     LANsSinglePage as LANsSinglePage,
     type LANCreateParams as LANCreateParams,
     type LANUpdateParams as LANUpdateParams,
@@ -400,7 +397,6 @@ export declare namespace Sites {
     WANs as WANs,
     type WAN as WAN,
     type WANStaticAddressing as WANStaticAddressing,
-    type WANCreateResponse as WANCreateResponse,
     WANsSinglePage as WANsSinglePage,
     type WANCreateParams as WANCreateParams,
     type WANUpdateParams as WANUpdateParams,

package/src/resources/magic-transit/sites/wans.ts

@@ -12,14 +12,13 @@ export class WANs extends APIResource {
     siteId: string,
     params: WANCreateParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<WANCreateResponse> {
+  ): Core.PagePromise<WANsSinglePage, WAN> {
     const { account_id, ...body } = params;
-    return (
-      this._client.post(`/accounts/${account_id}/magic/sites/${siteId}/wans`, {
-        body,
-        ...options,
-      }) as Core.APIPromise<{ result: WANCreateResponse }>
-    )._thenUnwrap((obj) => obj.result);
+    return this._client.getAPIList(`/accounts/${account_id}/magic/sites/${siteId}/wans`, WANsSinglePage, {
+      body,
+      method: 'post',
+      ...options,
+    });
   }
 
   /**
@@ -193,8 +192,6 @@ export interface WANStaticAddressingParam {
   secondary_address?: string;
 }
 
-export type WANCreateResponse = Array<WAN>;
-
 export interface WANCreateParams {
   /**
    * Path param: Identifier
@@ -321,7 +318,6 @@ export declare namespace WANs {
   export {
     type WAN as WAN,
     type WANStaticAddressing as WANStaticAddressing,
-    type WANCreateResponse as WANCreateResponse,
     WANsSinglePage as WANsSinglePage,
     type WANCreateParams as WANCreateParams,
     type WANUpdateParams as WANUpdateParams,

package/src/resources/mtls-certificates/associations.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../resource';
 import * as Core from '../../core';
+import { SinglePage } from '../../pagination';
 
 export class Associations extends APIResource {
   /**
@@ -11,17 +12,18 @@ export class Associations extends APIResource {
     mtlsCertificateId: string,
     params: AssociationGetParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<AssociationGetResponse> {
+  ): Core.PagePromise<CertificateAsssociationsSinglePage, CertificateAsssociation> {
     const { account_id } = params;
-    return (
-      this._client.get(
-        `/accounts/${account_id}/mtls_certificates/${mtlsCertificateId}/associations`,
-        options,
-      ) as Core.APIPromise<{ result: AssociationGetResponse }>
-    )._thenUnwrap((obj) => obj.result);
+    return this._client.getAPIList(
+      `/accounts/${account_id}/mtls_certificates/${mtlsCertificateId}/associations`,
+      CertificateAsssociationsSinglePage,
+      options,
+    );
   }
 }
 
+export class CertificateAsssociationsSinglePage extends SinglePage<CertificateAsssociation> {}
+
 export interface CertificateAsssociation {
   /**
    * The service using the certificate.
@@ -34,8 +36,6 @@ export interface CertificateAsssociation {
   status?: string;
 }
 
-export type AssociationGetResponse = Array<CertificateAsssociation>;
-
 export interface AssociationGetParams {
   /**
    * Identifier
@@ -43,10 +43,12 @@ export interface AssociationGetParams {
   account_id: string;
 }
 
+Associations.CertificateAsssociationsSinglePage = CertificateAsssociationsSinglePage;
+
 export declare namespace Associations {
   export {
     type CertificateAsssociation as CertificateAsssociation,
-    type AssociationGetResponse as AssociationGetResponse,
+    CertificateAsssociationsSinglePage as CertificateAsssociationsSinglePage,
     type AssociationGetParams as AssociationGetParams,
   };
 }

package/src/resources/mtls-certificates/index.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export {
+  CertificateAsssociationsSinglePage,
   Associations,
   type CertificateAsssociation,
-  type AssociationGetResponse,
   type AssociationGetParams,
 } from './associations';
 export { MTLSCertificates } from './mtls-certificates';

package/src/resources/mtls-certificates/mtls-certificates.ts

@@ -5,9 +5,9 @@ import * as Core from '../../core';
 import * as AssociationsAPI from './associations';
 import {
   AssociationGetParams,
-  AssociationGetResponse,
   Associations,
   CertificateAsssociation,
+  CertificateAsssociationsSinglePage,
 } from './associations';
 import { SinglePage } from '../../pagination';
 
@@ -232,12 +232,13 @@ export interface MTLSCertificateGetParams {
 }
 
 MTLSCertificates.Associations = Associations;
+MTLSCertificates.CertificateAsssociationsSinglePage = CertificateAsssociationsSinglePage;
 
 export declare namespace MTLSCertificates {
   export {
     Associations as Associations,
     type CertificateAsssociation as CertificateAsssociation,
-    type AssociationGetResponse as AssociationGetResponse,
+    CertificateAsssociationsSinglePage as CertificateAsssociationsSinglePage,
     type AssociationGetParams as AssociationGetParams,
   };
 }