feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 1791
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-64483197e6ec54fe413eb3d5e1aa5802dd66280506b340471310d18aaf2e7893.yml
-openapi_spec_hash: a6226495494c058cd1753989aaa27b06
+configured_endpoints: 1793
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-2119f3b01d3ef7f8c45c95c01f473a249a08f79bad8297e7aa4b2d2665503bc9.yml
+openapi_spec_hash: a52c7f5deed1454a7288c7c374b1e569
 config_hash: de4c81cee29cd7dd907279e8916b334f

api.md

@@ -1646,6 +1646,11 @@ Types:
 
 - <code><a href="./src/resources/logpush/edge.ts">InstantLogpushJob</a></code>
 
+Methods:
+
+- <code title="post /zones/{zone_id}/logpush/edge">client.logpush.edge.<a href="./src/resources/logpush/edge.ts">create</a>({ ...params }) -> InstantLogpushJob | null</code>
+- <code title="get /zones/{zone_id}/logpush/edge">client.logpush.edge.<a href="./src/resources/logpush/edge.ts">get</a>({ ...params }) -> InstantLogpushJobsSinglePage</code>
+
 ## Jobs
 
 Types:

scripts/detect-breaking-changes

@@ -138,6 +138,7 @@ TEST_PATHS=(
 	tests/api-resources/logpush/datasets/datasets.test.ts
 	tests/api-resources/logpush/datasets/fields.test.ts
 	tests/api-resources/logpush/datasets/jobs.test.ts
+	tests/api-resources/logpush/edge.test.ts
 	tests/api-resources/logpush/jobs.test.ts
 	tests/api-resources/logpush/ownership.test.ts
 	tests/api-resources/logpush/validate.test.ts

src/resources/logpush/edge.ts

@@ -1,8 +1,52 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
+import * as Core from '../../core';
+import { SinglePage } from '../../pagination';
 
-export class Edge extends APIResource {}
+export class Edge extends APIResource {
+  /**
+   * Creates a new Instant Logs job for a zone.
+   *
+   * @example
+   * ```ts
+   * const instantLogpushJob = await client.logpush.edge.create({
+   *   zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   * });
+   * ```
+   */
+  create(params: EdgeCreateParams, options?: Core.RequestOptions): Core.APIPromise<InstantLogpushJob | null> {
+    const { zone_id, ...body } = params;
+    return (
+      this._client.post(`/zones/${zone_id}/logpush/edge`, { body, ...options }) as Core.APIPromise<{
+        result: InstantLogpushJob | null;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Lists Instant Logs jobs for a zone.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const instantLogpushJob of client.logpush.edge.get(
+   *   { zone_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  get(
+    params: EdgeGetParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<InstantLogpushJobsSinglePage, InstantLogpushJob | null> {
+    const { zone_id } = params;
+    return this._client.getAPIList(`/zones/${zone_id}/logpush/edge`, InstantLogpushJobsSinglePage, options);
+  }
+}
+
+export class InstantLogpushJobsSinglePage extends SinglePage<InstantLogpushJob | null> {}
 
 export interface InstantLogpushJob {
   /**
@@ -32,6 +76,43 @@ export interface InstantLogpushJob {
   session_id?: string;
 }
 
+export interface EdgeCreateParams {
+  /**
+   * Path param: Identifier.
+   */
+  zone_id: string;
+
+  /**
+   * Body param: Comma-separated list of fields.
+   */
+  fields?: string;
+
+  /**
+   * Body param: Filters to drill down into specific events.
+   */
+  filter?: string;
+
+  /**
+   * Body param: The sample parameter is the sample rate of the records set by the
+   * client: "sample": 1 is 100% of records "sample": 10 is 10% and so on.
+   */
+  sample?: number;
+}
+
+export interface EdgeGetParams {
+  /**
+   * Identifier.
+   */
+  zone_id: string;
+}
+
+Edge.InstantLogpushJobsSinglePage = InstantLogpushJobsSinglePage;
+
 export declare namespace Edge {
-  export { type InstantLogpushJob as InstantLogpushJob };
+  export {
+    type InstantLogpushJob as InstantLogpushJob,
+    InstantLogpushJobsSinglePage as InstantLogpushJobsSinglePage,
+    type EdgeCreateParams as EdgeCreateParams,
+    type EdgeGetParams as EdgeGetParams,
+  };
 }

src/resources/logpush/index.ts

@@ -1,7 +1,13 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Datasets } from './datasets/index';
-export { Edge, type InstantLogpushJob } from './edge';
+export {
+  InstantLogpushJobsSinglePage,
+  Edge,
+  type InstantLogpushJob,
+  type EdgeCreateParams,
+  type EdgeGetParams,
+} from './edge';
 export { Logpush } from './logpush';
 export {
   LogpushJobsSinglePage,

src/resources/logpush/logpush.ts

@@ -2,7 +2,13 @@
 
 import { APIResource } from '../../resource';
 import * as EdgeAPI from './edge';
-import { Edge, InstantLogpushJob } from './edge';
+import {
+  Edge,
+  EdgeCreateParams,
+  EdgeGetParams,
+  InstantLogpushJob,
+  InstantLogpushJobsSinglePage,
+} from './edge';
 import * as JobsAPI from './jobs';
 import {
   JobCreateParams,
@@ -47,6 +53,7 @@ export class Logpush extends APIResource {
 
 Logpush.Datasets = Datasets;
 Logpush.Edge = Edge;
+Logpush.InstantLogpushJobsSinglePage = InstantLogpushJobsSinglePage;
 Logpush.Jobs = Jobs;
 Logpush.LogpushJobsSinglePage = LogpushJobsSinglePage;
 Logpush.Ownership = Ownership;
@@ -55,7 +62,13 @@ Logpush.Validate = Validate;
 export declare namespace Logpush {
   export { Datasets as Datasets };
 
-  export { Edge as Edge, type InstantLogpushJob as InstantLogpushJob };
+  export {
+    Edge as Edge,
+    type InstantLogpushJob as InstantLogpushJob,
+    InstantLogpushJobsSinglePage as InstantLogpushJobsSinglePage,
+    type EdgeCreateParams as EdgeCreateParams,
+    type EdgeGetParams as EdgeGetParams,
+  };
 
   export {
     Jobs as Jobs,

tests/api-resources/logpush/edge.test.ts

@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Cloudflare from 'cloudflare';
+import { Response } from 'node-fetch';
+
+const client = new Cloudflare({
+  apiKey: '144c9defac04969c7bfad8efaa8ea194',
+  apiEmail: '[email protected]',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource edge', () => {
+  test('create: only required params', async () => {
+    const responsePromise = client.logpush.edge.create({ zone_id: '023e105f4ecef8ad9ca31a8372d0c353' });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('create: required and optional params', async () => {
+    const response = await client.logpush.edge.create({
+      zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+      fields:
+        'ClientIP,ClientRequestHost,ClientRequestMethod,ClientRequestURI,EdgeEndTimestamp,EdgeResponseBytes,EdgeResponseStatus,EdgeStartTimestamp,RayID',
+      filter: '{"where":{"and":[{"key":"ClientCountry","operator":"neq","value":"ca"}]}}',
+      sample: 1,
+    });
+  });
+
+  test('get: only required params', async () => {
+    const responsePromise = client.logpush.edge.get({ zone_id: '023e105f4ecef8ad9ca31a8372d0c353' });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('get: required and optional params', async () => {
+    const response = await client.logpush.edge.get({ zone_id: '023e105f4ecef8ad9ca31a8372d0c353' });
+  });
+});