cloudflare 4.4.1 → 5.0.0

package/src/resources/images/v1/v1.ts

@@ -151,6 +151,11 @@ export interface Image {
    */
   id?: string;
 
+  /**
+   * Can set the creator field with an internal user ID.
+   */
+  creator?: string | null;
+
   /**
    * Image file name.
    */
@@ -191,10 +196,20 @@ export interface V1CreateParams {
    */
   account_id: string;
 
+  /**
+   * Body param: An optional custom unique identifier for your image.
+   */
+  id?: string;
+
+  /**
+   * Body param: Can set the creator field with an internal user ID.
+   */
+  creator?: string;
+
   /**
    * Body param: An image binary data. Only needed when type is uploading a file.
    */
-  file?: unknown;
+  file?: Core.Uploadable;
 
   /**
    * Body param: User modifiable key-value store. Can use used for keeping references
@@ -220,6 +235,12 @@ export interface V1ListParams extends V4PagePaginationParams {
    * Path param: Account identifier tag.
    */
   account_id: string;
+
+  /**
+   * Query param: Internal user ID set within the creator field. Setting to empty
+   * string "" will return images where creator field is not set
+   */
+  creator?: string | null;
 }
 
 export interface V1DeleteParams {
@@ -235,6 +256,11 @@ export interface V1EditParams {
    */
   account_id: string;
 
+  /**
+   * Body param: Can set the creator field with an internal user ID.
+   */
+  creator?: string;
+
   /**
    * Body param: User modifiable key-value store. Can be used for keeping references
    * to another system of record for managing images. No change if not specified.

package/src/resources/images/v2/direct-uploads.ts

@@ -61,6 +61,11 @@ export interface DirectUploadCreateParams {
    */
   id?: string;
 
+  /**
+   * Body param: Can set the creator field with an internal user ID.
+   */
+  creator?: string;
+
   /**
    * Body param: The date after which the upload will not be accepted. Minimum: Now +
    * 2 minutes. Maximum: Now + 6 hours.

package/src/resources/images/v2/v2.ts

@@ -53,6 +53,12 @@ export interface V2ListParams {
    */
   continuation_token?: string | null;
 
+  /**
+   * Query param: Internal user ID set within the creator field. Setting to empty
+   * string "" will return images where creator field is not set
+   */
+  creator?: string | null;
+
   /**
    * Query param: Number of items per page.
    */

package/src/resources/index.ts

@@ -14,7 +14,7 @@ export { AuditLogs } from './audit-logs';
 export { Billing } from './billing/billing';
 export { BotManagement } from './bot-management';
 export { BotnetFeed } from './botnet-feed/botnet-feed';
-export { BrandProtection } from './brand-protection';
+export { BrandProtection } from './brand-protection/brand-protection';
 export { BrowserRendering } from './browser-rendering/browser-rendering';
 export { Cache } from './cache/cache';
 export { Calls } from './calls/calls';

package/src/resources/kv/namespaces/index.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export {
-  KeysCursorLimitPagination,
+  KeysCursorPaginationAfter,
   Keys,
   type Key,
   type KeyBulkDeleteResponse,

package/src/resources/kv/namespaces/keys.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../../resource';
 import * as Core from '../../../core';
-import { CursorLimitPagination, type CursorLimitPaginationParams } from '../../../pagination';
+import { CursorPaginationAfter, type CursorPaginationAfterParams } from '../../../pagination';
 
 export class Keys extends APIResource {
   /**
@@ -23,11 +23,11 @@ export class Keys extends APIResource {
     namespaceId: string,
     params: KeyListParams,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<KeysCursorLimitPagination, Key> {
+  ): Core.PagePromise<KeysCursorPaginationAfter, Key> {
     const { account_id, ...query } = params;
     return this._client.getAPIList(
       `/accounts/${account_id}/storage/kv/namespaces/${namespaceId}/keys`,
-      KeysCursorLimitPagination,
+      KeysCursorPaginationAfter,
       { query, ...options },
     );
   }
@@ -53,10 +53,9 @@ export class Keys extends APIResource {
   }
 
   /**
-   * Get multiple KV pairs from the namespace. Body should contain keys to retrieve
-   * at most 100. Keys must contain text-based values. If value is json, it can be
-   * requested to return in JSON, instead of string. Metadata can be return if
-   * withMetadata is true.
+   * Retrieve up to 100 KV pairs from the namespace. Keys must contain text-based
+   * values. JSON values can optionally be parsed instead of being returned as a
+   * string value. Metadata can be included if `withMetadata` is true.
    *
    * @deprecated Please use kv.namespaces.bulk_get instead
    */
@@ -99,7 +98,7 @@ export class Keys extends APIResource {
   }
 }
 
-export class KeysCursorLimitPagination extends CursorLimitPagination<Key> {}
+export class KeysCursorPaginationAfter extends CursorPaginationAfter<Key> {}
 
 /**
  * A name for a value. A value stored under a given key may be retrieved via the
@@ -121,12 +120,12 @@ export interface Key {
   /**
    * Arbitrary JSON that is associated with a key.
    */
-  metadata?: Record<string, unknown>;
+  metadata?: unknown;
 }
 
 export interface KeyBulkDeleteResponse {
   /**
-   * Number of keys successfully updated
+   * Number of keys successfully updated.
    */
   successful_key_count?: number;
 
@@ -143,33 +142,33 @@ export type KeyBulkGetResponse =
 export namespace KeyBulkGetResponse {
   export interface WorkersKVBulkGetResult {
     /**
-     * Requested keys are paired with their values in an object
+     * Requested keys are paired with their values in an object.
      */
-    values?: Record<string, string | number | boolean | Record<string, unknown>>;
+    values?: { [key: string]: string | number | boolean | { [key: string]: unknown } };
   }
 
   export interface WorkersKVBulkGetResultWithMetadata {
     /**
-     * Requested keys are paired with their values and metadata in an object
+     * Requested keys are paired with their values and metadata in an object.
      */
-    values?: Record<string, WorkersKVBulkGetResultWithMetadata.Values | null>;
+    values?: { [key: string]: WorkersKVBulkGetResultWithMetadata.Values | null };
   }
 
   export namespace WorkersKVBulkGetResultWithMetadata {
     export interface Values {
       /**
-       * The metadata associated with the key
+       * The metadata associated with the key.
        */
-      metadata: Record<string, unknown> | null;
+      metadata: unknown;
 
       /**
-       * The value associated with the key
+       * The value associated with the key.
        */
-      value: string | number | boolean | Record<string, unknown>;
+      value: unknown;
 
       /**
-       * The time, measured in number of seconds since the UNIX epoch, at which the key
-       * should expire.
+       * Expires the key at a certain time, measured in number of seconds since the UNIX
+       * epoch.
        */
       expiration?: number;
     }
@@ -178,7 +177,7 @@ export namespace KeyBulkGetResponse {
 
 export interface KeyBulkUpdateResponse {
   /**
-   * Number of keys successfully updated
+   * Number of keys successfully updated.
    */
   successful_key_count?: number;
 
@@ -188,22 +187,29 @@ export interface KeyBulkUpdateResponse {
   unsuccessful_keys?: Array<string>;
 }
 
-export interface KeyListParams extends CursorLimitPaginationParams {
+export interface KeyListParams extends CursorPaginationAfterParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
   /**
-   * Query param: A string prefix used to filter down which keys will be returned.
-   * Exact matches and any key names that begin with the prefix will be returned.
+   * Query param: Limits the number of keys returned in the response. The cursor
+   * attribute may be used to iterate over the next batch of keys if there are more
+   * than the limit.
+   */
+  limit?: number;
+
+  /**
+   * Query param: Filters returned keys by a name prefix. Exact matches and any key
+   * names that begin with the prefix will be returned.
    */
   prefix?: string;
 }
 
 export interface KeyBulkDeleteParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
@@ -215,29 +221,29 @@ export interface KeyBulkDeleteParams {
 
 export interface KeyBulkGetParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
   /**
-   * Body param: Array of keys to retrieve (maximum 100)
+   * Body param: Array of keys to retrieve (maximum of 100).
    */
   keys: Array<string>;
 
   /**
-   * Body param: Whether to parse JSON values in the response
+   * Body param: Whether to parse JSON values in the response.
    */
   type?: 'text' | 'json';
 
   /**
-   * Body param: Whether to include metadata in the response
+   * Body param: Whether to include metadata in the response.
    */
   withMetadata?: boolean;
 }
 
 export interface KeyBulkUpdateParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
@@ -250,43 +256,42 @@ export interface KeyBulkUpdateParams {
 export namespace KeyBulkUpdateParams {
   export interface Body {
     /**
-     * Whether or not the server should base64 decode the value before storing it.
-     * Useful for writing values that wouldn't otherwise be valid JSON strings, such as
-     * images.
+     * A key's name. The name may be at most 512 bytes. All printable, non-whitespace
+     * characters are valid.
      */
-    base64?: boolean;
+    key: string;
 
     /**
-     * The time, measured in number of seconds since the UNIX epoch, at which the key
-     * should expire.
+     * A UTF-8 encoded string to be stored, up to 25 MiB in length.
      */
-    expiration?: number;
+    value: string;
 
     /**
-     * The number of seconds for which the key should be visible before it expires. At
-     * least 60.
+     * Indicates whether or not the server should base64 decode the value before
+     * storing it. Useful for writing values that wouldn't otherwise be valid JSON
+     * strings, such as images.
      */
-    expiration_ttl?: number;
+    base64?: boolean;
 
     /**
-     * A key's name. The name may be at most 512 bytes. All printable, non-whitespace
-     * characters are valid.
+     * Expires the key at a certain time, measured in number of seconds since the UNIX
+     * epoch.
      */
-    key?: string;
+    expiration?: number;
 
     /**
-     * Arbitrary JSON that is associated with a key.
+     * Expires the key after a number of seconds. Must be at least 60.
      */
-    metadata?: Record<string, unknown>;
+    expiration_ttl?: number;
 
     /**
-     * A UTF-8 encoded string to be stored, up to 25 MiB in length.
+     * Arbitrary JSON that is associated with a key.
      */
-    value?: string;
+    metadata?: unknown;
   }
 }
 
-Keys.KeysCursorLimitPagination = KeysCursorLimitPagination;
+Keys.KeysCursorPaginationAfter = KeysCursorPaginationAfter;
 
 export declare namespace Keys {
   export {
@@ -294,7 +299,7 @@ export declare namespace Keys {
     type KeyBulkDeleteResponse as KeyBulkDeleteResponse,
     type KeyBulkGetResponse as KeyBulkGetResponse,
     type KeyBulkUpdateResponse as KeyBulkUpdateResponse,
-    KeysCursorLimitPagination as KeysCursorLimitPagination,
+    KeysCursorPaginationAfter as KeysCursorPaginationAfter,
     type KeyListParams as KeyListParams,
     type KeyBulkDeleteParams as KeyBulkDeleteParams,
     type KeyBulkGetParams as KeyBulkGetParams,

package/src/resources/kv/namespaces/metadata.ts

@@ -37,11 +37,11 @@ export class Metadata extends APIResource {
 /**
  * Arbitrary JSON that is associated with a key.
  */
-export type MetadataGetResponse = Record<string, unknown>;
+export type MetadataGetResponse = unknown;
 
 export interface MetadataGetParams {
   /**
-   * Identifier
+   * Identifier.
    */
   account_id: string;
 }

package/src/resources/kv/namespaces/namespaces.ts

@@ -13,7 +13,7 @@ import {
   KeyBulkUpdateResponse,
   KeyListParams,
   Keys,
-  KeysCursorLimitPagination,
+  KeysCursorPaginationAfter,
 } from './keys';
 import * as MetadataAPI from './metadata';
 import { Metadata, MetadataGetParams, MetadataGetResponse } from './metadata';
@@ -164,10 +164,9 @@ export class Namespaces extends APIResource {
   }
 
   /**
-   * Get multiple KV pairs from the namespace. Body should contain keys to retrieve
-   * at most 100. Keys must contain text-based values. If value is json, it can be
-   * requested to return in JSON, instead of string. Metadata can be return if
-   * withMetadata is true.
+   * Retrieve up to 100 KV pairs from the namespace. Keys must contain text-based
+   * values. JSON values can optionally be parsed instead of being returned as a
+   * string value. Metadata can be included if `withMetadata` is true.
    *
    * @example
    * ```ts
@@ -208,7 +207,7 @@ export class Namespaces extends APIResource {
    *   '0f2ac74b498b48028cb68387c421e279',
    *   {
    *     account_id: '023e105f4ecef8ad9ca31a8372d0c353',
-   *     body: [{}],
+   *     body: [{ key: 'My-Key', value: 'Some string' }],
    *   },
    * );
    * ```
@@ -266,11 +265,6 @@ export interface Namespace {
    */
   title: string;
 
-  /**
-   * True if new beta namespace, with additional preview features.
-   */
-  beta?: boolean;
-
   /**
    * True if keys written on the URL will be URL-decoded before storing. For example,
    * if set to "true", a key written on the URL as "%3F" will be stored as "?".
@@ -282,7 +276,7 @@ export interface NamespaceDeleteResponse {}
 
 export interface NamespaceBulkDeleteResponse {
   /**
-   * Number of keys successfully updated
+   * Number of keys successfully updated.
    */
   successful_key_count?: number;
 
@@ -299,33 +293,33 @@ export type NamespaceBulkGetResponse =
 export namespace NamespaceBulkGetResponse {
   export interface WorkersKVBulkGetResult {
     /**
-     * Requested keys are paired with their values in an object
+     * Requested keys are paired with their values in an object.
      */
-    values?: Record<string, string | number | boolean | Record<string, unknown>>;
+    values?: { [key: string]: string | number | boolean | { [key: string]: unknown } };
   }
 
   export interface WorkersKVBulkGetResultWithMetadata {
     /**
-     * Requested keys are paired with their values and metadata in an object
+     * Requested keys are paired with their values and metadata in an object.
      */
-    values?: Record<string, WorkersKVBulkGetResultWithMetadata.Values | null>;
+    values?: { [key: string]: WorkersKVBulkGetResultWithMetadata.Values | null };
   }
 
   export namespace WorkersKVBulkGetResultWithMetadata {
     export interface Values {
       /**
-       * The metadata associated with the key
+       * The metadata associated with the key.
        */
-      metadata: Record<string, unknown> | null;
+      metadata: unknown;
 
       /**
-       * The value associated with the key
+       * The value associated with the key.
        */
-      value: string | number | boolean | Record<string, unknown>;
+      value: unknown;
 
       /**
-       * The time, measured in number of seconds since the UNIX epoch, at which the key
-       * should expire.
+       * Expires the key at a certain time, measured in number of seconds since the UNIX
+       * epoch.
        */
       expiration?: number;
     }
@@ -334,7 +328,7 @@ export namespace NamespaceBulkGetResponse {
 
 export interface NamespaceBulkUpdateResponse {
   /**
-   * Number of keys successfully updated
+   * Number of keys successfully updated.
    */
   successful_key_count?: number;
 
@@ -346,7 +340,7 @@ export interface NamespaceBulkUpdateResponse {
 
 export interface NamespaceCreateParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
@@ -358,7 +352,7 @@ export interface NamespaceCreateParams {
 
 export interface NamespaceUpdateParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
@@ -370,7 +364,7 @@ export interface NamespaceUpdateParams {
 
 export interface NamespaceListParams extends V4PagePaginationArrayParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
@@ -387,14 +381,14 @@ export interface NamespaceListParams extends V4PagePaginationArrayParams {
 
 export interface NamespaceDeleteParams {
   /**
-   * Identifier
+   * Identifier.
    */
   account_id: string;
 }
 
 export interface NamespaceBulkDeleteParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
@@ -406,29 +400,29 @@ export interface NamespaceBulkDeleteParams {
 
 export interface NamespaceBulkGetParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
   /**
-   * Body param: Array of keys to retrieve (maximum 100)
+   * Body param: Array of keys to retrieve (maximum of 100).
    */
   keys: Array<string>;
 
   /**
-   * Body param: Whether to parse JSON values in the response
+   * Body param: Whether to parse JSON values in the response.
    */
   type?: 'text' | 'json';
 
   /**
-   * Body param: Whether to include metadata in the response
+   * Body param: Whether to include metadata in the response.
    */
   withMetadata?: boolean;
 }
 
 export interface NamespaceBulkUpdateParams {
   /**
-   * Path param: Identifier
+   * Path param: Identifier.
    */
   account_id: string;
 
@@ -441,52 +435,51 @@ export interface NamespaceBulkUpdateParams {
 export namespace NamespaceBulkUpdateParams {
   export interface Body {
     /**
-     * Whether or not the server should base64 decode the value before storing it.
-     * Useful for writing values that wouldn't otherwise be valid JSON strings, such as
-     * images.
+     * A key's name. The name may be at most 512 bytes. All printable, non-whitespace
+     * characters are valid.
      */
-    base64?: boolean;
+    key: string;
 
     /**
-     * The time, measured in number of seconds since the UNIX epoch, at which the key
-     * should expire.
+     * A UTF-8 encoded string to be stored, up to 25 MiB in length.
      */
-    expiration?: number;
+    value: string;
 
     /**
-     * The number of seconds for which the key should be visible before it expires. At
-     * least 60.
+     * Indicates whether or not the server should base64 decode the value before
+     * storing it. Useful for writing values that wouldn't otherwise be valid JSON
+     * strings, such as images.
      */
-    expiration_ttl?: number;
+    base64?: boolean;
 
     /**
-     * A key's name. The name may be at most 512 bytes. All printable, non-whitespace
-     * characters are valid.
+     * Expires the key at a certain time, measured in number of seconds since the UNIX
+     * epoch.
      */
-    key?: string;
+    expiration?: number;
 
     /**
-     * Arbitrary JSON that is associated with a key.
+     * Expires the key after a number of seconds. Must be at least 60.
      */
-    metadata?: Record<string, unknown>;
+    expiration_ttl?: number;
 
     /**
-     * A UTF-8 encoded string to be stored, up to 25 MiB in length.
+     * Arbitrary JSON that is associated with a key.
      */
-    value?: string;
+    metadata?: unknown;
   }
 }
 
 export interface NamespaceGetParams {
   /**
-   * Identifier
+   * Identifier.
    */
   account_id: string;
 }
 
 Namespaces.NamespacesV4PagePaginationArray = NamespacesV4PagePaginationArray;
 Namespaces.Keys = Keys;
-Namespaces.KeysCursorLimitPagination = KeysCursorLimitPagination;
+Namespaces.KeysCursorPaginationAfter = KeysCursorPaginationAfter;
 Namespaces.Metadata = Metadata;
 Namespaces.Values = ValuesAPIValues;
 
@@ -514,7 +507,7 @@ export declare namespace Namespaces {
     type KeyBulkDeleteResponse as KeyBulkDeleteResponse,
     type KeyBulkGetResponse as KeyBulkGetResponse,
     type KeyBulkUpdateResponse as KeyBulkUpdateResponse,
-    KeysCursorLimitPagination as KeysCursorLimitPagination,
+    KeysCursorPaginationAfter as KeysCursorPaginationAfter,
     type KeyListParams as KeyListParams,
     type KeyBulkDeleteParams as KeyBulkDeleteParams,
     type KeyBulkGetParams as KeyBulkGetParams,