cloudflare 6.3.0 → 6.5.0

package/src/resources/logs/logs.ts

@@ -5,20 +5,26 @@ import * as RayIDAPI from './rayid';
 import { RayID, RayIDGetParams, RayIDGetResponse } from './rayid';
 import * as ControlAPI from './control/control';
 import { Control } from './control/control';
+import * as LogExplorerAPI from './log-explorer/log-explorer';
+import { LogExplorer } from './log-explorer/log-explorer';
 import * as ReceivedAPI from './received/received';
 import { Received, ReceivedGetParams, ReceivedGetResponse } from './received/received';
 
 export class Logs extends APIResource {
+  logExplorer: LogExplorerAPI.LogExplorer = new LogExplorerAPI.LogExplorer(this._client);
   control: ControlAPI.Control = new ControlAPI.Control(this._client);
   RayID: RayIDAPI.RayID = new RayIDAPI.RayID(this._client);
   received: ReceivedAPI.Received = new ReceivedAPI.Received(this._client);
 }
 
+Logs.LogExplorer = LogExplorer;
 Logs.Control = Control;
 Logs.RayID = RayID;
 Logs.Received = Received;
 
 export declare namespace Logs {
+  export { LogExplorer as LogExplorer };
+
   export { Control as Control };
 
   export { RayID as RayID, type RayIDGetResponse as RayIDGetResponse, type RayIDGetParams as RayIDGetParams };

package/src/resources/magic-transit/api.md

@@ -72,6 +72,7 @@ Types:
 - <code><a href="./src/resources/magic-transit/ipsec-tunnels.ts">IPSECTunnelBulkUpdateResponse</a></code>
 - <code><a href="./src/resources/magic-transit/ipsec-tunnels.ts">IPSECTunnelGetResponse</a></code>
 - <code><a href="./src/resources/magic-transit/ipsec-tunnels.ts">IPSECTunnelPSKGenerateResponse</a></code>
+- <code><a href="./src/resources/magic-transit/ipsec-tunnels.ts">IPSECTunnelPSKSetResponse</a></code>
 
 Methods:
 
@@ -82,6 +83,7 @@ Methods:
 - <code title="put /accounts/{account_id}/magic/ipsec_tunnels">client.magicTransit.ipsecTunnels.<a href="./src/resources/magic-transit/ipsec-tunnels.ts">bulkUpdate</a>({ ...params }) -> IPSECTunnelBulkUpdateResponse</code>
 - <code title="get /accounts/{account_id}/magic/ipsec_tunnels/{ipsec_tunnel_id}">client.magicTransit.ipsecTunnels.<a href="./src/resources/magic-transit/ipsec-tunnels.ts">get</a>(ipsecTunnelId, { ...params }) -> IPSECTunnelGetResponse</code>
 - <code title="post /accounts/{account_id}/magic/ipsec_tunnels/{ipsec_tunnel_id}/psk_generate">client.magicTransit.ipsecTunnels.<a href="./src/resources/magic-transit/ipsec-tunnels.ts">pskGenerate</a>(ipsecTunnelId, { ...params }) -> IPSECTunnelPSKGenerateResponse</code>
+- <code title="post /accounts/{account_id}/magic/ipsec_tunnels/psk">client.magicTransit.ipsecTunnels.<a href="./src/resources/magic-transit/ipsec-tunnels.ts">pskSet</a>({ ...params }) -> IPSECTunnelPSKSetResponse</code>
 
 ## Routes
 
@@ -240,6 +242,35 @@ Methods:
 
 - <code title="get /accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots/latest">client.magicTransit.connectors.snapshots.latest.<a href="./src/resources/magic-transit/connectors/snapshots/latest.ts">list</a>(connectorId, { ...params }) -> LatestListResponse</code>
 
+## Cf1Sites
+
+Types:
+
+- <code><a href="./src/resources/magic-transit/cf1-sites/cf1-sites.ts">Cf1Site</a></code>
+- <code><a href="./src/resources/magic-transit/cf1-sites/cf1-sites.ts">Cf1SiteLocation</a></code>
+
+Methods:
+
+- <code title="post /accounts/{account_id}/magic/cf1_sites">client.magicTransit.cf1Sites.<a href="./src/resources/magic-transit/cf1-sites/cf1-sites.ts">create</a>([ ...body ]) -> Cf1SitesSinglePage</code>
+- <code title="patch /accounts/{account_id}/magic/cf1_sites/{cf1_site_id}">client.magicTransit.cf1Sites.<a href="./src/resources/magic-transit/cf1-sites/cf1-sites.ts">update</a>(cf1SiteId, { ...params }) -> Cf1Site</code>
+- <code title="get /accounts/{account_id}/magic/cf1_sites">client.magicTransit.cf1Sites.<a href="./src/resources/magic-transit/cf1-sites/cf1-sites.ts">list</a>({ ...params }) -> Cf1SitesSinglePage</code>
+- <code title="delete /accounts/{account_id}/magic/cf1_sites/{cf1_site_id}">client.magicTransit.cf1Sites.<a href="./src/resources/magic-transit/cf1-sites/cf1-sites.ts">delete</a>(cf1SiteId, { ...params }) -> Cf1Site</code>
+- <code title="get /accounts/{account_id}/magic/cf1_sites/{cf1_site_id}">client.magicTransit.cf1Sites.<a href="./src/resources/magic-transit/cf1-sites/cf1-sites.ts">get</a>(cf1SiteId, { ...params }) -> Cf1Site</code>
+
+### Ramps
+
+Types:
+
+- <code><a href="./src/resources/magic-transit/cf1-sites/ramps.ts">Ramp</a></code>
+- <code><a href="./src/resources/magic-transit/cf1-sites/ramps.ts">RampType</a></code>
+
+Methods:
+
+- <code title="post /accounts/{account_id}/magic/cf1_sites/{cf1_site_id}/ramps">client.magicTransit.cf1Sites.ramps.<a href="./src/resources/magic-transit/cf1-sites/ramps.ts">create</a>(cf1SiteId, [ ...body ]) -> RampsSinglePage</code>
+- <code title="get /accounts/{account_id}/magic/cf1_sites/{cf1_site_id}/ramps">client.magicTransit.cf1Sites.ramps.<a href="./src/resources/magic-transit/cf1-sites/ramps.ts">list</a>(cf1SiteId, { ...params }) -> RampsSinglePage</code>
+- <code title="delete /accounts/{account_id}/magic/cf1_sites/{cf1_site_id}/ramps/{ramp_id}">client.magicTransit.cf1Sites.ramps.<a href="./src/resources/magic-transit/cf1-sites/ramps.ts">delete</a>(cf1SiteId, rampId, { ...params }) -> Ramp</code>
+- <code title="get /accounts/{account_id}/magic/cf1_sites/{cf1_site_id}/ramps/{ramp_id}">client.magicTransit.cf1Sites.ramps.<a href="./src/resources/magic-transit/cf1-sites/ramps.ts">get</a>(cf1SiteId, rampId, { ...params }) -> Ramp</code>
+
 ## PCAPs
 
 Types:

package/src/resources/magic-transit/cf1-sites/cf1-sites.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 RampsAPI from './ramps';
+import {
+  Ramp,
+  RampCreateParams,
+  RampDeleteParams,
+  RampGetParams,
+  RampListParams,
+  RampType,
+  Ramps,
+  RampsSinglePage,
+} from './ramps';
+import { SinglePage } from '../../../pagination';
+
+export class Cf1Sites extends APIResource {
+  ramps: RampsAPI.Ramps = new RampsAPI.Ramps(this._client);
+
+  /**
+   * Creates new CF1 Sites for an account. Each site must have a unique name within
+   * the account.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const cf1Site of client.magicTransit.cf1Sites.create(
+   *   {
+   *     account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *     body: [{ name: 'Pad 34' }],
+   *   },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  create(
+    params: Cf1SiteCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<Cf1SitesSinglePage, Cf1Site> {
+    const { account_id, body } = params;
+    return this._client.getAPIList(`/accounts/${account_id}/magic/cf1_sites`, Cf1SitesSinglePage, {
+      body: body,
+      method: 'post',
+      ...options,
+    });
+  }
+
+  /**
+   * Partially updates a specific CF1 Site for an account. Only the fields included
+   * in the request body are modified; omitted fields retain their existing values.
+   *
+   * @example
+   * ```ts
+   * const cf1Site = await client.magicTransit.cf1Sites.update(
+   *   '023e105f4ecef8ad9ca31a8372d0c353',
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * );
+   * ```
+   */
+  update(
+    cf1SiteId: string,
+    params: Cf1SiteUpdateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Cf1Site> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.patch(`/accounts/${account_id}/magic/cf1_sites/${cf1SiteId}`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: Cf1Site }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Lists CF1 Sites associated with an account. A CF1 Site represents a physical
+   * customer network location with optional geographic coordinates.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const cf1Site of client.magicTransit.cf1Sites.list(
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: Cf1SiteListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<Cf1SitesSinglePage, Cf1Site> {
+    const { account_id } = params;
+    return this._client.getAPIList(`/accounts/${account_id}/magic/cf1_sites`, Cf1SitesSinglePage, options);
+  }
+
+  /**
+   * Deletes a specific CF1 Site for an account.
+   *
+   * @example
+   * ```ts
+   * const cf1Site = await client.magicTransit.cf1Sites.delete(
+   *   '023e105f4ecef8ad9ca31a8372d0c353',
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * );
+   * ```
+   */
+  delete(
+    cf1SiteId: string,
+    params: Cf1SiteDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Cf1Site> {
+    const { account_id } = params;
+    return (
+      this._client.delete(
+        `/accounts/${account_id}/magic/cf1_sites/${cf1SiteId}`,
+        options,
+      ) as Core.APIPromise<{ result: Cf1Site }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Gets a specific CF1 Site for an account.
+   *
+   * @example
+   * ```ts
+   * const cf1Site = await client.magicTransit.cf1Sites.get(
+   *   '023e105f4ecef8ad9ca31a8372d0c353',
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * );
+   * ```
+   */
+  get(cf1SiteId: string, params: Cf1SiteGetParams, options?: Core.RequestOptions): Core.APIPromise<Cf1Site> {
+    const { account_id } = params;
+    return (
+      this._client.get(`/accounts/${account_id}/magic/cf1_sites/${cf1SiteId}`, options) as Core.APIPromise<{
+        result: Cf1Site;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export class Cf1SitesSinglePage extends SinglePage<Cf1Site> {}
+
+export interface Cf1Site {
+  /**
+   * A human-provided name describing the CF1 Site that should be unique within the
+   * account.
+   */
+  name: string;
+
+  /**
+   * Identifier
+   */
+  id?: string;
+
+  created_on?: string;
+
+  /**
+   * A human-provided description of the CF1 Site.
+   */
+  description?: string;
+
+  location?: Cf1SiteLocation;
+
+  modified_on?: string;
+}
+
+export interface Cf1SiteParam {
+  /**
+   * A human-provided name describing the CF1 Site that should be unique within the
+   * account.
+   */
+  name: string;
+
+  /**
+   * A human-provided description of the CF1 Site.
+   */
+  description?: string;
+
+  location?: Cf1SiteLocationParam;
+}
+
+export interface Cf1SiteLocation {
+  /**
+   * Latitude of the CF1 Site.
+   */
+  lat?: number;
+
+  /**
+   * Longitude of the CF1 Site.
+   */
+  long?: number;
+
+  /**
+   * Name of nearest town, city, or village.
+   */
+  name?: string;
+}
+
+export interface Cf1SiteLocationParam {
+  /**
+   * Latitude of the CF1 Site.
+   */
+  lat?: number;
+
+  /**
+   * Longitude of the CF1 Site.
+   */
+  long?: number;
+
+  /**
+   * Name of nearest town, city, or village.
+   */
+  name?: string;
+}
+
+export interface Cf1SiteCreateParams {
+  /**
+   * Path param: Identifier
+   */
+  account_id: string;
+
+  /**
+   * Body param
+   */
+  body: Array<Cf1SiteParam>;
+}
+
+export interface Cf1SiteUpdateParams {
+  /**
+   * Path param: Identifier
+   */
+  account_id: string;
+
+  /**
+   * Body param: A human-provided description of the CF1 Site.
+   */
+  description?: string;
+
+  /**
+   * Body param
+   */
+  location?: Cf1SiteLocationParam;
+
+  /**
+   * Body param: A human-provided name describing the CF1 Site that should be unique
+   * within the account.
+   */
+  name?: string;
+}
+
+export interface Cf1SiteListParams {
+  /**
+   * Identifier
+   */
+  account_id: string;
+}
+
+export interface Cf1SiteDeleteParams {
+  /**
+   * Identifier
+   */
+  account_id: string;
+}
+
+export interface Cf1SiteGetParams {
+  /**
+   * Identifier
+   */
+  account_id: string;
+}
+
+Cf1Sites.Cf1SitesSinglePage = Cf1SitesSinglePage;
+Cf1Sites.Ramps = Ramps;
+Cf1Sites.RampsSinglePage = RampsSinglePage;
+
+export declare namespace Cf1Sites {
+  export {
+    type Cf1Site as Cf1Site,
+    type Cf1SiteLocation as Cf1SiteLocation,
+    Cf1SitesSinglePage as Cf1SitesSinglePage,
+    type Cf1SiteCreateParams as Cf1SiteCreateParams,
+    type Cf1SiteUpdateParams as Cf1SiteUpdateParams,
+    type Cf1SiteListParams as Cf1SiteListParams,
+    type Cf1SiteDeleteParams as Cf1SiteDeleteParams,
+    type Cf1SiteGetParams as Cf1SiteGetParams,
+  };
+
+  export {
+    Ramps as Ramps,
+    type Ramp as Ramp,
+    type RampType as RampType,
+    RampsSinglePage as RampsSinglePage,
+    type RampCreateParams as RampCreateParams,
+    type RampListParams as RampListParams,
+    type RampDeleteParams as RampDeleteParams,
+    type RampGetParams as RampGetParams,
+  };
+}

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

@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Cf1SitesSinglePage,
+  Cf1Sites,
+  type Cf1Site,
+  type Cf1SiteLocation,
+  type Cf1SiteCreateParams,
+  type Cf1SiteUpdateParams,
+  type Cf1SiteListParams,
+  type Cf1SiteDeleteParams,
+  type Cf1SiteGetParams,
+} from './cf1-sites';
+export {
+  RampsSinglePage,
+  Ramps,
+  type Ramp,
+  type RampType,
+  type RampCreateParams,
+  type RampListParams,
+  type RampDeleteParams,
+  type RampGetParams,
+} from './ramps';

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

@@ -0,0 +1,277 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
+import * as RampsAPI from './ramps';
+import { SinglePage } from '../../../pagination';
+
+export class Ramps extends APIResource {
+  /**
+   * Creates ramps (network connections) for a CF1 Site.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const ramp of client.magicTransit.cf1Sites.ramps.create(
+   *   '023e105f4ecef8ad9ca31a8372d0c353',
+   *   {
+   *     account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *     body: [
+   *       {
+   *         source_ramp_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *         type: 'gre',
+   *       },
+   *     ],
+   *   },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  create(
+    cf1SiteId: string,
+    params: RampCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<RampsSinglePage, Ramp> {
+    const { account_id, body } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/magic/cf1_sites/${cf1SiteId}/ramps`,
+      RampsSinglePage,
+      { body: body, method: 'post', ...options },
+    );
+  }
+
+  /**
+   * Lists ramps (network connections) associated with a CF1 Site. Ramps represent
+   * GRE tunnels, IPsec tunnels, interconnects, or MCONN links.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const ramp of client.magicTransit.cf1Sites.ramps.list(
+   *   '023e105f4ecef8ad9ca31a8372d0c353',
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    cf1SiteId: string,
+    params: RampListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<RampsSinglePage, Ramp> {
+    const { account_id } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/magic/cf1_sites/${cf1SiteId}/ramps`,
+      RampsSinglePage,
+      options,
+    );
+  }
+
+  /**
+   * Deletes a specific ramp from a CF1 Site.
+   *
+   * @example
+   * ```ts
+   * const ramp =
+   *   await client.magicTransit.cf1Sites.ramps.delete(
+   *     '023e105f4ecef8ad9ca31a8372d0c353',
+   *     '023e105f4ecef8ad9ca31a8372d0c353',
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  delete(
+    cf1SiteId: string,
+    rampId: string,
+    params: RampDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Ramp> {
+    const { account_id } = params;
+    return (
+      this._client.delete(
+        `/accounts/${account_id}/magic/cf1_sites/${cf1SiteId}/ramps/${rampId}`,
+        options,
+      ) as Core.APIPromise<{ result: Ramp }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Gets a specific ramp for a CF1 Site.
+   *
+   * @example
+   * ```ts
+   * const ramp = await client.magicTransit.cf1Sites.ramps.get(
+   *   '023e105f4ecef8ad9ca31a8372d0c353',
+   *   '023e105f4ecef8ad9ca31a8372d0c353',
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * );
+   * ```
+   */
+  get(
+    cf1SiteId: string,
+    rampId: string,
+    params: RampGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Ramp> {
+    const { account_id } = params;
+    return (
+      this._client.get(
+        `/accounts/${account_id}/magic/cf1_sites/${cf1SiteId}/ramps/${rampId}`,
+        options,
+      ) as Core.APIPromise<{ result: Ramp }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export class RampsSinglePage extends SinglePage<Ramp> {}
+
+export interface Ramp {
+  /**
+   * Identifier
+   */
+  id: string;
+
+  created_on: string;
+
+  modified_on: string;
+
+  /**
+   * A human-provided name describing the ramp that should be unique within the CF1
+   * Site.
+   */
+  name: string;
+
+  /**
+   * The type of network connection (ramp) linking a CF1 Site to Cloudflare's
+   * network.
+   */
+  type: RampType;
+
+  /**
+   * A human-provided description of the ramp.
+   */
+  description?: string;
+
+  gre?: Ramp.GRE;
+
+  gre_interconnect?: Ramp.GREInterconnect;
+
+  ipsec?: Ramp.IPSEC;
+
+  mconn?: Ramp.Mconn;
+
+  mpls_interconnect?: Ramp.MplsInterconnect;
+}
+
+export namespace Ramp {
+  export interface GRE {
+    /**
+     * URL reference to the source network resource that this ramp is managed by.
+     */
+    managed_by?: string;
+  }
+
+  export interface GREInterconnect {
+    /**
+     * URL reference to the source network resource that this ramp is managed by.
+     */
+    managed_by?: string;
+  }
+
+  export interface IPSEC {
+    /**
+     * URL reference to the source network resource that this ramp is managed by.
+     */
+    managed_by?: string;
+  }
+
+  export interface Mconn {
+    /**
+     * URL reference to the source network resource that this ramp is managed by.
+     */
+    managed_by?: string;
+  }
+
+  export interface MplsInterconnect {
+    /**
+     * URL reference to the source network resource that this ramp is managed by.
+     */
+    managed_by?: string;
+  }
+}
+
+/**
+ * The type of network connection (ramp) linking a CF1 Site to Cloudflare's
+ * network.
+ */
+export type RampType = 'gre' | 'gre_interconnect' | 'mpls_interconnect' | 'mconn' | 'ipsec';
+
+/**
+ * The type of network connection (ramp) linking a CF1 Site to Cloudflare's
+ * network.
+ */
+export type RampTypeParam = 'gre' | 'gre_interconnect' | 'mpls_interconnect' | 'mconn' | 'ipsec';
+
+export interface RampCreateParams {
+  /**
+   * Path param: Identifier
+   */
+  account_id: string;
+
+  /**
+   * Body param
+   */
+  body: Array<RampCreateParams.Body>;
+}
+
+export namespace RampCreateParams {
+  export interface Body {
+    /**
+     * Identifier of the source network resource to associate as a ramp.
+     */
+    source_ramp_id: string;
+
+    /**
+     * The type of network connection (ramp) linking a CF1 Site to Cloudflare's
+     * network.
+     */
+    type: RampsAPI.RampTypeParam;
+  }
+}
+
+export interface RampListParams {
+  /**
+   * Identifier
+   */
+  account_id: string;
+}
+
+export interface RampDeleteParams {
+  /**
+   * Identifier
+   */
+  account_id: string;
+}
+
+export interface RampGetParams {
+  /**
+   * Identifier
+   */
+  account_id: string;
+}
+
+Ramps.RampsSinglePage = RampsSinglePage;
+
+export declare namespace Ramps {
+  export {
+    type Ramp as Ramp,
+    type RampType as RampType,
+    RampsSinglePage as RampsSinglePage,
+    type RampCreateParams as RampCreateParams,
+    type RampListParams as RampListParams,
+    type RampDeleteParams as RampDeleteParams,
+    type RampGetParams as RampGetParams,
+  };
+}

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

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