cloudflare 4.5.0 → 5.1.0

package/src/resources/brand-protection/logos.ts

@@ -1,5 +1,77 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
+import * as Core from '../../core';
 
-export class Logos extends APIResource {}
+export class Logos extends APIResource {
+  /**
+   * Return new saved logo queries created from image files
+   */
+  create(params: LogoCreateParams, options?: Core.RequestOptions): Core.APIPromise<LogoCreateResponse> {
+    const { account_id, match_type, tag, threshold, ...body } = params;
+    return this._client.post(`/accounts/${account_id}/brand-protection/logos`, {
+      query: { match_type, tag, threshold },
+      body,
+      ...options,
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded', ...options?.headers },
+    });
+  }
+
+  /**
+   * Return a success message after deleting saved logo queries by ID
+   */
+  delete(logoId: string, params: LogoDeleteParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+    const { account_id } = params;
+    return this._client.delete(`/accounts/${account_id}/brand-protection/logos/${logoId}`, {
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
+}
+
+export interface LogoCreateResponse {
+  id?: number;
+
+  tag?: string;
+
+  upload_path?: string;
+}
+
+export interface LogoCreateParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Query param:
+   */
+  match_type?: string;
+
+  /**
+   * Query param:
+   */
+  tag?: string;
+
+  /**
+   * Query param:
+   */
+  threshold?: number;
+
+  /**
+   * Body param:
+   */
+  image?: Core.Uploadable;
+}
+
+export interface LogoDeleteParams {
+  account_id: string;
+}
+
+export declare namespace Logos {
+  export {
+    type LogoCreateResponse as LogoCreateResponse,
+    type LogoCreateParams as LogoCreateParams,
+    type LogoDeleteParams as LogoDeleteParams,
+  };
+}

package/src/resources/brand-protection/matches.ts

@@ -1,5 +1,103 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
+import * as Core from '../../core';
 
-export class Matches extends APIResource {}
+export class Matches extends APIResource {
+  /**
+   * Return matches as CSV for string queries based on ID
+   */
+  download(
+    params: MatchDownloadParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<MatchDownloadResponse> {
+    const { account_id, ...query } = params;
+    return this._client.get(`/accounts/${account_id}/brand-protection/matches/download`, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Return matches for string queries based on ID
+   */
+  get(params: MatchGetParams, options?: Core.RequestOptions): Core.APIPromise<MatchGetResponse> {
+    const { account_id, ...query } = params;
+    return this._client.get(`/accounts/${account_id}/brand-protection/matches`, { query, ...options });
+  }
+}
+
+export interface MatchDownloadResponse {
+  matches?: Array<{ [key: string]: unknown }>;
+
+  total?: number;
+}
+
+export interface MatchGetResponse {
+  matches?: Array<{ [key: string]: unknown }>;
+
+  total?: number;
+}
+
+export interface MatchDownloadParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Query param:
+   */
+  id?: string;
+
+  /**
+   * Query param:
+   */
+  include_domain_id?: boolean;
+
+  /**
+   * Query param:
+   */
+  limit?: number;
+
+  /**
+   * Query param:
+   */
+  offset?: number;
+}
+
+export interface MatchGetParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Query param:
+   */
+  id?: string;
+
+  /**
+   * Query param:
+   */
+  include_domain_id?: boolean;
+
+  /**
+   * Query param:
+   */
+  limit?: number;
+
+  /**
+   * Query param:
+   */
+  offset?: number;
+}
+
+export declare namespace Matches {
+  export {
+    type MatchDownloadResponse as MatchDownloadResponse,
+    type MatchGetResponse as MatchGetResponse,
+    type MatchDownloadParams as MatchDownloadParams,
+    type MatchGetParams as MatchGetParams,
+  };
+}

package/src/resources/brand-protection/queries.ts

@@ -1,5 +1,132 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
+import * as Core from '../../core';
 
-export class Queries extends APIResource {}
+export class Queries extends APIResource {
+  /**
+   * Return a success message after creating new saved string queries
+   */
+  create(params: QueryCreateParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+    const { account_id, id, query_scan, query_tag, ...body } = params;
+    return this._client.post(`/accounts/${account_id}/brand-protection/queries`, {
+      query: { id, scan: query_scan, tag: query_tag },
+      body,
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
+
+  /**
+   * Return a success message after deleting saved string queries by ID
+   */
+  delete(params: QueryDeleteParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+    const { account_id, id, scan, tag } = params;
+    return this._client.delete(`/accounts/${account_id}/brand-protection/queries`, {
+      query: { id, scan, tag },
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
+
+  /**
+   * Return a success message after creating new saved string queries in bulk
+   */
+  bulk(params: QueryBulkParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+    const { account_id, ...body } = params;
+    return this._client.post(`/accounts/${account_id}/brand-protection/queries/bulk`, {
+      body,
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
+}
+
+export interface QueryCreateParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Query param:
+   */
+  id?: string;
+
+  /**
+   * Query param:
+   */
+  query_scan?: boolean;
+
+  /**
+   * Query param:
+   */
+  query_tag?: string;
+
+  /**
+   * Body param:
+   */
+  max_time?: string | null;
+
+  /**
+   * Body param:
+   */
+  min_time?: string | null;
+
+  /**
+   * Body param:
+   */
+  body_scan?: boolean;
+
+  /**
+   * Body param:
+   */
+  string_matches?: unknown;
+
+  /**
+   * Body param:
+   */
+  body_tag?: string;
+}
+
+export interface QueryDeleteParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Query param:
+   */
+  id?: string;
+
+  /**
+   * Query param:
+   */
+  scan?: boolean;
+
+  /**
+   * Query param:
+   */
+  tag?: string;
+}
+
+export interface QueryBulkParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+
+  /**
+   * Body param:
+   */
+  queries?: Array<{ [key: string]: unknown }>;
+}
+
+export declare namespace Queries {
+  export {
+    type QueryCreateParams as QueryCreateParams,
+    type QueryDeleteParams as QueryDeleteParams,
+    type QueryBulkParams as QueryBulkParams,
+  };
+}

package/src/resources/browser-rendering/json.ts

@@ -98,6 +98,13 @@ export interface JsonCreateParams {
    */
   cookies?: Array<JsonCreateParams.Cookie>;
 
+  /**
+   * Body param: Optional list of custom AI models to use for the request. The models
+   * will be tried in the order provided, and in case a model returns an error, the
+   * next one will be used as fallback.
+   */
+  custom_ai?: Array<JsonCreateParams.CustomAI>;
+
   /**
    * Body param:
    */
@@ -248,6 +255,19 @@ export namespace JsonCreateParams {
     url?: string;
   }
 
+  export interface CustomAI {
+    /**
+     * Authorization token for the AI model: `Bearer <token>`.
+     */
+    authorization: string;
+
+    /**
+     * AI model to use for the request. Must be formed as `<provider>/<model_name>`,
+     * e.g. `workers-ai/@cf/meta/llama-3.3-70b-instruct-fp8-fast`
+     */
+    model: string;
+  }
+
   /**
    * Check [options](https://pptr.dev/api/puppeteer.gotooptions).
    */

package/src/resources/cache/cache-reserve.ts

@@ -113,7 +113,7 @@ export class CacheReserveResource extends APIResource {
 }
 
 /**
- * ID of the zone setting.
+ * The identifier of the caching setting.
  */
 export type CacheReserve = 'cache_reserve';
 
@@ -162,17 +162,17 @@ export interface CacheReserveClearResponse {
 
 export interface CacheReserveEditResponse {
   /**
-   * ID of the zone setting.
+   * The identifier of the caching setting.
    */
   id: CacheReserve;
 
   /**
-   * Whether the setting is editable
+   * Whether the setting is editable.
    */
   editable: boolean;
 
   /**
-   * The value of the feature
+   * Value of the Cache Reserve zone setting.
    */
   value: 'on' | 'off';
 
@@ -184,17 +184,17 @@ export interface CacheReserveEditResponse {
 
 export interface CacheReserveGetResponse {
   /**
-   * ID of the zone setting.
+   * The identifier of the caching setting.
    */
   id: CacheReserve;
 
   /**
-   * Whether the setting is editable
+   * Whether the setting is editable.
    */
   editable: boolean;
 
   /**
-   * The value of the feature
+   * Value of the Cache Reserve zone setting.
    */
   value: 'on' | 'off';
 
@@ -239,7 +239,7 @@ export interface CacheReserveStatusResponse {
 
 export interface CacheReserveClearParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   zone_id: string;
 
@@ -251,7 +251,7 @@ export interface CacheReserveClearParams {
 
 export interface CacheReserveEditParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   zone_id: string;
 
@@ -263,14 +263,14 @@ export interface CacheReserveEditParams {
 
 export interface CacheReserveGetParams {
   /**
-   * Identifier
+   * Identifier.
    */
   zone_id: string;
 }
 
 export interface CacheReserveStatusParams {
   /**
-   * Identifier
+   * Identifier.
    */
   zone_id: string;
 }

package/src/resources/cache/cache.ts

@@ -123,7 +123,7 @@ export class Cache extends APIResource {
    * @example
    * ```ts
    * const response = await client.cache.purge({
-   *   zone_id: 'zone_id',
+   *   zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
    * });
    * ```
    */
@@ -138,9 +138,6 @@ export class Cache extends APIResource {
 }
 
 export interface CachePurgeResponse {
-  /**
-   * Identifier.
-   */
   id: string;
 }
 

package/src/resources/cache/regional-tiered-cache.ts

@@ -58,23 +58,23 @@ export class RegionalTieredCacheResource extends APIResource {
 }
 
 /**
- * ID of the zone setting.
+ * The identifier of the caching setting.
  */
 export type RegionalTieredCache = 'tc_regional';
 
 export interface RegionalTieredCacheEditResponse {
   /**
-   * ID of the zone setting.
+   * The identifier of the caching setting.
    */
   id: RegionalTieredCache;
 
   /**
-   * Whether the setting is editable
+   * Whether the setting is editable.
    */
   editable: boolean;
 
   /**
-   * The value of the feature
+   * Value of the Regional Tiered Cache zone setting.
    */
   value: 'on' | 'off';
 
@@ -86,17 +86,17 @@ export interface RegionalTieredCacheEditResponse {
 
 export interface RegionalTieredCacheGetResponse {
   /**
-   * ID of the zone setting.
+   * The identifier of the caching setting.
    */
   id: RegionalTieredCache;
 
   /**
-   * Whether the setting is editable
+   * Whether the setting is editable.
    */
   editable: boolean;
 
   /**
-   * The value of the feature
+   * Value of the Regional Tiered Cache zone setting.
    */
   value: 'on' | 'off';
 
@@ -108,7 +108,7 @@ export interface RegionalTieredCacheGetResponse {
 
 export interface RegionalTieredCacheEditParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   zone_id: string;
 
@@ -120,7 +120,7 @@ export interface RegionalTieredCacheEditParams {
 
 export interface RegionalTieredCacheGetParams {
   /**
-   * Identifier
+   * Identifier.
    */
   zone_id: string;
 }

package/src/resources/cache/smart-tiered-cache.ts

@@ -94,12 +94,12 @@ export class SmartTieredCache extends APIResource {
 
 export interface SmartTieredCacheDeleteResponse {
   /**
-   * ID of the zone setting.
+   * The identifier of the caching setting.
    */
   id: 'tiered_cache_smart_topology_enable';
 
   /**
-   * Whether the setting is editable
+   * Whether the setting is editable.
    */
   editable: boolean;
 
@@ -111,17 +111,17 @@ export interface SmartTieredCacheDeleteResponse {
 
 export interface SmartTieredCacheEditResponse {
   /**
-   * ID of the zone setting.
+   * The identifier of the caching setting.
    */
   id: 'tiered_cache_smart_topology_enable';
 
   /**
-   * Whether the setting is editable
+   * Whether the setting is editable.
    */
   editable: boolean;
 
   /**
-   * The value of the feature
+   * Value of the Smart Tiered Cache zone setting.
    */
   value: 'on' | 'off';
 
@@ -133,17 +133,17 @@ export interface SmartTieredCacheEditResponse {
 
 export interface SmartTieredCacheGetResponse {
   /**
-   * ID of the zone setting.
+   * The identifier of the caching setting.
    */
   id: 'tiered_cache_smart_topology_enable';
 
   /**
-   * Whether the setting is editable
+   * Whether the setting is editable.
    */
   editable: boolean;
 
   /**
-   * The value of the feature
+   * Value of the Smart Tiered Cache zone setting.
    */
   value: 'on' | 'off';
 
@@ -155,26 +155,26 @@ export interface SmartTieredCacheGetResponse {
 
 export interface SmartTieredCacheDeleteParams {
   /**
-   * Identifier
+   * Identifier.
    */
   zone_id: string;
 }
 
 export interface SmartTieredCacheEditParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   zone_id: string;
 
   /**
-   * Body param: Enable or disable the Smart Tiered Cache
+   * Body param: Enable or disable the Smart Tiered Cache.
    */
   value: 'on' | 'off';
 }
 
 export interface SmartTieredCacheGetParams {
   /**
-   * Identifier
+   * Identifier.
    */
   zone_id: string;
 }