cloudflare 6.4.0 → 6.5.0

package/src/resources/logs/log-explorer/log-explorer.ts

@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as QueryAPI from './query';
+import { Query, QuerySqlParams, QuerySqlResponse, QuerySqlResponsesSinglePage } from './query';
+import * as DatasetsAPI from './datasets/datasets';
+import {
+  CreateRequest,
+  Dataset,
+  DatasetCreateParams,
+  DatasetGetParams,
+  DatasetListParams,
+  DatasetSummariesSinglePage,
+  DatasetSummary,
+  DatasetUpdateParams,
+  Datasets,
+  UpdateRequest,
+} from './datasets/datasets';
+
+export class LogExplorer extends APIResource {
+  query: QueryAPI.Query = new QueryAPI.Query(this._client);
+  datasets: DatasetsAPI.Datasets = new DatasetsAPI.Datasets(this._client);
+}
+
+LogExplorer.Query = Query;
+LogExplorer.QuerySqlResponsesSinglePage = QuerySqlResponsesSinglePage;
+LogExplorer.Datasets = Datasets;
+LogExplorer.DatasetSummariesSinglePage = DatasetSummariesSinglePage;
+
+export declare namespace LogExplorer {
+  export {
+    Query as Query,
+    type QuerySqlResponse as QuerySqlResponse,
+    QuerySqlResponsesSinglePage as QuerySqlResponsesSinglePage,
+    type QuerySqlParams as QuerySqlParams,
+  };
+
+  export {
+    Datasets as Datasets,
+    type CreateRequest as CreateRequest,
+    type Dataset as Dataset,
+    type DatasetSummary as DatasetSummary,
+    type UpdateRequest as UpdateRequest,
+    DatasetSummariesSinglePage as DatasetSummariesSinglePage,
+    type DatasetCreateParams as DatasetCreateParams,
+    type DatasetUpdateParams as DatasetUpdateParams,
+    type DatasetListParams as DatasetListParams,
+    type DatasetGetParams as DatasetGetParams,
+  };
+}

package/src/resources/logs/log-explorer/query.ts

@@ -0,0 +1,102 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
+import { CloudflareError } from '../../../error';
+import { SinglePage } from '../../../pagination';
+
+export class Query extends APIResource {
+  /**
+   * Run a SQL query against account or zone-level datasets.
+   *
+   * Timestamp fields are RFC3339 strings. Filter with: WHERE {timestamp_field} >=
+   * now() - INTERVAL '30' DAY WHERE {timestamp_field} >= '2026-04-01T00:00:00Z'
+   * WHERE {timestamp_field} BETWEEN '2026-04-01T00:00:00Z' AND
+   * '2026-04-30T23:59:59Z'
+   *
+   * Check /account or zones/{account or zone_id}/logs/explorer/datasets to see
+   * enabled account or zone level datasets. Zone-level datasets will not appear
+   * here. Check /account or zones/{account or
+   * zone_id}/logs/explorer/datasets/available for the schemas, and the name of the
+   * timestamp fields.
+   *
+   * For zone-level datasets use the zone-scoped endpoint: POST
+   * /zones/{zone_id}/logs/explorer/query/sql
+   *
+   * For more information about the datasets, and the meaning of each field, check
+   * out https://developers.cloudflare.com/logs/logpush/logpush-job/datasets/
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const querySqlResponse of client.logs.logExplorer.query.sql(
+   *   fs.createReadStream('path/to/file'),
+   *   { account_id: 'account_id' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  sql(
+    body: Core.Uploadable,
+    params: QuerySqlParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<QuerySqlResponsesSinglePage, QuerySqlResponse> {
+    const { account_id, zone_id } = 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.getAPIList(
+      `/${accountOrZone}/${accountOrZoneId}/logs/explorer/query/sql`,
+      QuerySqlResponsesSinglePage,
+      {
+        body: body,
+        method: 'post',
+        ...options,
+        headers: { 'Content-Type': 'text/plain', ...options?.headers },
+        __binaryRequest: true,
+      },
+    );
+  }
+}
+
+export class QuerySqlResponsesSinglePage extends SinglePage<QuerySqlResponse> {}
+
+export type QuerySqlResponse = { [key: string]: unknown };
+
+export interface QuerySqlParams {
+  /**
+   * 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;
+}
+
+Query.QuerySqlResponsesSinglePage = QuerySqlResponsesSinglePage;
+
+export declare namespace Query {
+  export {
+    type QuerySqlResponse as QuerySqlResponse,
+    QuerySqlResponsesSinglePage as QuerySqlResponsesSinglePage,
+    type QuerySqlParams as QuerySqlParams,
+  };
+}

package/src/resources/logs/log-explorer.ts

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

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';