cloudflare 3.1.0 → 3.2.0

package/src/resources/ai-gateway/ai-gateway.ts

@@ -0,0 +1,343 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import * as Core from "../../core";
+import { APIResource } from "../../resource";
+import * as LogsAPI from "./logs";
+import { V4PagePaginationArray, type V4PagePaginationArrayParams } from "../../pagination";
+
+export class AIGateway extends APIResource {
+  logs: LogsAPI.Logs = new LogsAPI.Logs(this._client);
+
+  /**
+   * Create a new Gateway
+   */
+  create(
+    params: AIGatewayCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AIGatewayCreateResponse> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.post(`/accounts/${account_id}/ai-gateway/gateways`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: AIGatewayCreateResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Update a Gateway
+   */
+  update(
+    id: string,
+    params: AIGatewayUpdateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AIGatewayUpdateResponse> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.put(`/accounts/${account_id}/ai-gateway/gateways/${id}`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: AIGatewayUpdateResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * List Gateway's
+   */
+  list(
+    params: AIGatewayListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<AIGatewayListResponsesV4PagePaginationArray, AIGatewayListResponse> {
+    const { account_id, ...query } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/ai-gateway/gateways`,
+      AIGatewayListResponsesV4PagePaginationArray,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Delete a Gateway
+   */
+  delete(
+    id: string,
+    params: AIGatewayDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AIGatewayDeleteResponse> {
+    const { account_id } = params;
+    return (
+      this._client.delete(`/accounts/${account_id}/ai-gateway/gateways/${id}`, options) as Core.APIPromise<{
+        result: AIGatewayDeleteResponse;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Fetch a Gateway
+   */
+  get(
+    id: string,
+    params: AIGatewayGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AIGatewayGetResponse> {
+    const { account_id } = params;
+    return (
+      this._client.get(`/accounts/${account_id}/ai-gateway/gateways/${id}`, options) as Core.APIPromise<{
+        result: AIGatewayGetResponse;
+      }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export class AIGatewayListResponsesV4PagePaginationArray extends V4PagePaginationArray<AIGatewayListResponse> {}
+
+export interface AIGatewayCreateResponse {
+  task: AIGatewayCreateResponse.Task;
+}
+
+export namespace AIGatewayCreateResponse {
+  export interface Task {
+    id: string;
+
+    cache_invalidate_on_update: boolean;
+
+    cache_ttl: number;
+
+    collect_logs: boolean;
+
+    created_at: string;
+
+    modified_at: string;
+
+    name: string;
+
+    slug: string;
+
+    rate_limiting_interval?: number;
+
+    rate_limiting_limit?: number;
+
+    rate_limiting_technique?: string;
+  }
+}
+
+export interface AIGatewayUpdateResponse {
+  id: string;
+
+  cache_invalidate_on_update: boolean;
+
+  cache_ttl: number;
+
+  collect_logs: boolean;
+
+  created_at: string;
+
+  modified_at: string;
+
+  name: string;
+
+  slug: string;
+
+  rate_limiting_interval?: number;
+
+  rate_limiting_limit?: number;
+
+  rate_limiting_technique?: string;
+}
+
+export interface AIGatewayListResponse {
+  id: string;
+
+  cache_invalidate_on_update: boolean;
+
+  cache_ttl: number;
+
+  collect_logs: boolean;
+
+  created_at: string;
+
+  modified_at: string;
+
+  name: string;
+
+  slug: string;
+
+  rate_limiting_interval?: number;
+
+  rate_limiting_limit?: number;
+
+  rate_limiting_technique?: string;
+}
+
+export interface AIGatewayDeleteResponse {
+  id: string;
+
+  cache_invalidate_on_update: boolean;
+
+  cache_ttl: number;
+
+  collect_logs: boolean;
+
+  created_at: string;
+
+  modified_at: string;
+
+  name: string;
+
+  slug: string;
+
+  rate_limiting_interval?: number;
+
+  rate_limiting_limit?: number;
+
+  rate_limiting_technique?: string;
+}
+
+export interface AIGatewayGetResponse {
+  id: string;
+
+  cache_invalidate_on_update: boolean;
+
+  cache_ttl: number;
+
+  collect_logs: boolean;
+
+  created_at: string;
+
+  modified_at: string;
+
+  name: string;
+
+  slug: string;
+
+  rate_limiting_interval?: number;
+
+  rate_limiting_limit?: number;
+
+  rate_limiting_technique?: string;
+}
+
+export interface AIGatewayCreateParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Body param:
+   */
+  cache_invalidate_on_update: boolean;
+
+  /**
+   * Body param:
+   */
+  cache_ttl: number;
+
+  /**
+   * Body param:
+   */
+  collect_logs: boolean;
+
+  /**
+   * Body param:
+   */
+  name: string;
+
+  /**
+   * Body param:
+   */
+  slug: string;
+
+  /**
+   * Body param:
+   */
+  rate_limiting_interval?: number;
+
+  /**
+   * Body param:
+   */
+  rate_limiting_limit?: number;
+
+  /**
+   * Body param:
+   */
+  rate_limiting_technique?: string;
+}
+
+export interface AIGatewayUpdateParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Body param:
+   */
+  cache_invalidate_on_update: boolean;
+
+  /**
+   * Body param:
+   */
+  cache_ttl: number;
+
+  /**
+   * Body param:
+   */
+  collect_logs: boolean;
+
+  /**
+   * Body param:
+   */
+  name: string;
+
+  /**
+   * Body param:
+   */
+  slug: string;
+
+  /**
+   * Body param:
+   */
+  rate_limiting_interval?: number;
+
+  /**
+   * Body param:
+   */
+  rate_limiting_limit?: number;
+
+  /**
+   * Body param:
+   */
+  rate_limiting_technique?: string;
+}
+
+export interface AIGatewayListParams extends V4PagePaginationArrayParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Query param:
+   */
+  id?: string;
+
+  /**
+   * Query param: Order By Column Name
+   */
+  order_by?: string;
+}
+
+export interface AIGatewayDeleteParams {
+  account_id: string;
+}
+
+export interface AIGatewayGetParams {
+  account_id: string;
+}
+
+export namespace AIGateway {
+  export import Logs = LogsAPI.Logs;
+  export import LogGetResponse = LogsAPI.LogGetResponse;
+  export import LogGetParams = LogsAPI.LogGetParams;
+}

package/src/resources/ai-gateway/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { AIGateway } from './ai-gateway';
+export { LogGetResponse, LogGetParams, Logs } from './logs';

package/src/resources/ai-gateway/logs.ts

@@ -0,0 +1,107 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import * as Core from "../../core";
+import { APIResource } from "../../resource";
+import * as LogsAPI from "./logs";
+
+export class Logs extends APIResource {
+  /**
+   * List Gateway Logs
+   */
+  get(id: string, params: LogGetParams, options?: Core.RequestOptions): Core.APIPromise<LogGetResponse> {
+    const { account_id, ...query } = params;
+    return (
+      this._client.get(`/accounts/${account_id}/ai-gateway/gateways/${id}/logs`, {
+        query,
+        ...options,
+      }) as Core.APIPromise<{ result: LogGetResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export type LogGetResponse = Array<LogGetResponse.LogGetResponseItem>;
+
+export namespace LogGetResponse {
+  export interface LogGetResponseItem {
+    id: string;
+
+    cached: boolean;
+
+    created_at: string;
+
+    duration: number;
+
+    model: string;
+
+    path: string;
+
+    provider: string;
+
+    request: string;
+
+    response: string;
+
+    success: boolean;
+
+    tokens_in: number;
+
+    tokens_out: number;
+  }
+}
+
+export interface LogGetParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Query param:
+   */
+  cached?: boolean;
+
+  /**
+   * Query param:
+   */
+  direction?: 'asc' | 'desc';
+
+  /**
+   * Query param:
+   */
+  end_date?: string;
+
+  /**
+   * Query param:
+   */
+  order_by?: 'created_at' | 'provider';
+
+  /**
+   * Query param:
+   */
+  page?: number;
+
+  /**
+   * Query param:
+   */
+  per_page?: number;
+
+  /**
+   * Query param:
+   */
+  search?: string;
+
+  /**
+   * Query param:
+   */
+  start_date?: string;
+
+  /**
+   * Query param:
+   */
+  success?: boolean;
+}
+
+export namespace Logs {
+  export import LogGetResponse = LogsAPI.LogGetResponse;
+  export import LogGetParams = LogsAPI.LogGetParams;
+}

package/src/resources/alerting/policies.ts

@@ -99,6 +99,21 @@ export namespace Mechanism {
   }
 }
 
+/**
+ * List of IDs that will be used when dispatching a notification. IDs for email
+ * type will be the email address.
+ */
+export type MechanismParam = Record<string, Array<MechanismParam.UnnamedSchemaWithMapParent1>>;
+
+export namespace MechanismParam {
+  export interface UnnamedSchemaWithMapParent1 {
+    /**
+     * UUID
+     */
+    id?: string | string;
+  }
+}
+
 export interface Policy {
   /**
    * The unique identifier of a notification policy
@@ -410,6 +425,216 @@ export interface PolicyFilter {
   zones?: Array<string>;
 }
 
+/**
+ * Optional filters that allow you to be alerted only on a subset of events for
+ * that alert type based on some criteria. This is only available for select alert
+ * types. See alert type documentation for more details.
+ */
+export interface PolicyFilterParam {
+  /**
+   * Usage depends on specific alert type
+   */
+  actions?: Array<string>;
+
+  /**
+   * Used for configuring radar_notification
+   */
+  affected_asns?: Array<string>;
+
+  /**
+   * Used for configuring incident_alert. A list of identifiers for each component to
+   * monitor.
+   */
+  affected_components?: Array<string>;
+
+  /**
+   * Used for configuring radar_notification
+   */
+  affected_locations?: Array<string>;
+
+  /**
+   * Used for configuring maintenance_event_notification
+   */
+  airport_code?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  alert_trigger_preferences?: Array<string>;
+
+  /**
+   * Used for configuring magic_tunnel_health_check_event
+   */
+  alert_trigger_preferences_value?: Array<'99.0' | '98.0' | '97.0'>;
+
+  /**
+   * Used for configuring load_balancing_pool_enablement_alert
+   */
+  enabled?: Array<string>;
+
+  /**
+   * Used for configuring pages_event_alert
+   */
+  environment?: Array<string>;
+
+  /**
+   * Used for configuring pages_event_alert
+   */
+  event?: Array<string>;
+
+  /**
+   * Used for configuring load_balancing_health_alert
+   */
+  event_source?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  event_type?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  group_by?: Array<string>;
+
+  /**
+   * Used for configuring health_check_status_notification
+   */
+  health_check_id?: Array<string>;
+
+  /**
+   * Used for configuring incident_alert
+   */
+  incident_impact?: Array<
+    'INCIDENT_IMPACT_NONE' | 'INCIDENT_IMPACT_MINOR' | 'INCIDENT_IMPACT_MAJOR' | 'INCIDENT_IMPACT_CRITICAL'
+  >;
+
+  /**
+   * Used for configuring stream_live_notifications
+   */
+  input_id?: Array<string>;
+
+  /**
+   * Used for configuring billing_usage_alert
+   */
+  limit?: Array<string>;
+
+  /**
+   * Used for configuring logo_match_alert
+   */
+  logo_tag?: Array<string>;
+
+  /**
+   * Used for configuring advanced_ddos_attack_l4_alert
+   */
+  megabits_per_second?: Array<string>;
+
+  /**
+   * Used for configuring load_balancing_health_alert
+   */
+  new_health?: Array<string>;
+
+  /**
+   * Used for configuring tunnel_health_event
+   */
+  new_status?: Array<string>;
+
+  /**
+   * Used for configuring advanced_ddos_attack_l4_alert
+   */
+  packets_per_second?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  pool_id?: Array<string>;
+
+  /**
+   * Used for configuring billing_usage_alert
+   */
+  product?: Array<string>;
+
+  /**
+   * Used for configuring pages_event_alert
+   */
+  project_id?: Array<string>;
+
+  /**
+   * Used for configuring advanced_ddos_attack_l4_alert
+   */
+  protocol?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  query_tag?: Array<string>;
+
+  /**
+   * Used for configuring advanced_ddos_attack_l7_alert
+   */
+  requests_per_second?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  selectors?: Array<string>;
+
+  /**
+   * Used for configuring clickhouse_alert_fw_ent_anomaly
+   */
+  services?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  slo?: Array<string>;
+
+  /**
+   * Used for configuring health_check_status_notification
+   */
+  status?: Array<string>;
+
+  /**
+   * Used for configuring advanced_ddos_attack_l7_alert
+   */
+  target_hostname?: Array<string>;
+
+  /**
+   * Used for configuring advanced_ddos_attack_l4_alert
+   */
+  target_ip?: Array<string>;
+
+  /**
+   * Used for configuring advanced_ddos_attack_l7_alert
+   */
+  target_zone_name?: Array<string>;
+
+  /**
+   * Used for configuring traffic_anomalies_alert
+   */
+  traffic_exclusions?: Array<'security_events'>;
+
+  /**
+   * Used for configuring tunnel_health_event
+   */
+  tunnel_id?: Array<string>;
+
+  /**
+   * Used for configuring magic_tunnel_health_check_event
+   */
+  tunnel_name?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  where?: Array<string>;
+
+  /**
+   * Usage depends on specific alert type
+   */
+  zones?: Array<string>;
+}
+
 export interface PolicyCreateResponse {
   /**
    * UUID
@@ -503,7 +728,7 @@ export interface PolicyCreateParams {
    * Body param: List of IDs that will be used when dispatching a notification. IDs
    * for email type will be the email address.
    */
-  mechanisms: Mechanism;
+  mechanisms: MechanismParam;
 
   /**
    * Body param: Name of the policy.
@@ -520,7 +745,7 @@ export interface PolicyCreateParams {
    * events for that alert type based on some criteria. This is only available for
    * select alert types. See alert type documentation for more details.
    */
-  filters?: PolicyFilter;
+  filters?: PolicyFilterParam;
 }
 
 export interface PolicyUpdateParams {
@@ -606,13 +831,13 @@ export interface PolicyUpdateParams {
    * events for that alert type based on some criteria. This is only available for
    * select alert types. See alert type documentation for more details.
    */
-  filters?: PolicyFilter;
+  filters?: PolicyFilterParam;
 
   /**
    * Body param: List of IDs that will be used when dispatching a notification. IDs
    * for email type will be the email address.
    */
-  mechanisms?: Mechanism;
+  mechanisms?: MechanismParam;
 
   /**
    * Body param: Name of the policy.