@cloudflare/workers-types 4.20260228.0 → 4.20260301.1

package/2023-03-01/index.d.ts

@@ -3848,6 +3848,12 @@ declare abstract class Performance {
   get timeOrigin(): number;
   /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */
   now(): number;
+  /**
+   * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
+   */
+  toJSON(): object;
 }
 // AI Search V2 API Error Interfaces
 interface AiSearchInternalError extends Error {}
@@ -9551,7 +9557,7 @@ declare abstract class Ai<AiModelList extends AiModelListType = AiModels> {
    * });
    * ```
    */
-  aiSearch: AiSearchAccountService;
+  aiSearch(): AiSearchAccountService;
   /**
    * @deprecated AutoRAG has been replaced by AI Search.
    * Use `env.AI.aiSearch` instead for better API design and new features.
@@ -11256,6 +11262,86 @@ type ImageOutputOptions = {
   background?: string;
   anim?: boolean;
 };
+interface ImageMetadata {
+  id: string;
+  filename?: string;
+  uploaded?: string;
+  requireSignedURLs: boolean;
+  meta?: Record<string, unknown>;
+  variants: string[];
+  draft?: boolean;
+  creator?: string;
+}
+interface ImageUploadOptions {
+  id?: string;
+  filename?: string;
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+  encoding?: "base64";
+}
+interface ImageUpdateOptions {
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+}
+interface ImageListOptions {
+  limit?: number;
+  cursor?: string;
+  sortOrder?: "asc" | "desc";
+  creator?: string;
+}
+interface ImageList {
+  images: ImageMetadata[];
+  cursor?: string;
+  listComplete: boolean;
+}
+interface HostedImagesBinding {
+  /**
+   * Get detailed metadata for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns Image metadata, or null if not found
+   */
+  details(imageId: string): Promise<ImageMetadata | null>;
+  /**
+   * Get the raw image data for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns ReadableStream of image bytes, or null if not found
+   */
+  image(imageId: string): Promise<ReadableStream<Uint8Array> | null>;
+  /**
+   * Upload a new hosted image
+   * @param image The image file to upload
+   * @param options Upload configuration
+   * @returns Metadata for the uploaded image
+   * @throws {@link ImagesError} if upload fails
+   */
+  upload(
+    image: ReadableStream<Uint8Array> | ArrayBuffer,
+    options?: ImageUploadOptions,
+  ): Promise<ImageMetadata>;
+  /**
+   * Update hosted image metadata
+   * @param imageId The ID of the image
+   * @param options Properties to update
+   * @returns Updated image metadata
+   * @throws {@link ImagesError} if update fails
+   */
+  update(imageId: string, options: ImageUpdateOptions): Promise<ImageMetadata>;
+  /**
+   * Delete a hosted image
+   * @param imageId The ID of the image
+   * @returns True if deleted, false if not found
+   */
+  delete(imageId: string): Promise<boolean>;
+  /**
+   * List hosted images with pagination
+   * @param options List configuration
+   * @returns List of images with pagination info
+   * @throws {@link ImagesError} if list fails
+   */
+  list(options?: ImageListOptions): Promise<ImageList>;
+}
 interface ImagesBinding {
   /**
    * Get image metadata (type, width and height)
@@ -11275,6 +11361,10 @@ interface ImagesBinding {
     stream: ReadableStream<Uint8Array>,
     options?: ImageInputOptions,
   ): ImageTransformer;
+  /**
+   * Access hosted images CRUD operations
+   */
+  readonly hosted: HostedImagesBinding;
 }
 interface ImageTransformer {
   /**
@@ -11345,8 +11435,14 @@ interface MediaTransformer {
    * @returns A generator for producing the transformed media output
    */
   transform(
-    transform: MediaTransformationInputOptions,
+    transform?: MediaTransformationInputOptions,
   ): MediaTransformationGenerator;
+  /**
+   * Generates the final media output with specified options.
+   * @param output - Configuration for the output format and parameters
+   * @returns The final transformation result containing the transformed media
+   */
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Generator for producing media transformation results.
@@ -11358,7 +11454,7 @@ interface MediaTransformationGenerator {
    * @param output - Configuration for the output format and parameters
    * @returns The final transformation result containing the transformed media
    */
-  output(output: MediaTransformationOutputOptions): MediaTransformationResult;
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Result of a media transformation operation.
@@ -11367,19 +11463,19 @@ interface MediaTransformationGenerator {
 interface MediaTransformationResult {
   /**
    * Returns the transformed media as a readable stream of bytes.
-   * @returns A stream containing the transformed media data
+   * @returns A promise containing a readable stream with the transformed media
    */
-  media(): ReadableStream<Uint8Array>;
+  media(): Promise<ReadableStream<Uint8Array>>;
   /**
    * Returns the transformed media as an HTTP response object.
-   * @returns The transformed media as a Response, ready to store in cache or return to users
+   * @returns The transformed media as a Promise<Response>, ready to store in cache or return to users
    */
-  response(): Response;
+  response(): Promise<Response>;
   /**
    * Returns the MIME type of the transformed media.
-   * @returns The content type string (e.g., 'image/jpeg', 'video/mp4')
+   * @returns A promise containing the content type string (e.g., 'image/jpeg', 'video/mp4')
    */
-  contentType(): string;
+  contentType(): Promise<string>;
 }
 /**
  * Configuration options for transforming media input.

package/2023-03-01/index.ts

@@ -3857,6 +3857,12 @@ export declare abstract class Performance {
   get timeOrigin(): number;
   /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */
   now(): number;
+  /**
+   * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
+   */
+  toJSON(): object;
 }
 // AI Search V2 API Error Interfaces
 export interface AiSearchInternalError extends Error {}
@@ -9563,7 +9569,7 @@ export declare abstract class Ai<
    * });
    * ```
    */
-  aiSearch: AiSearchAccountService;
+  aiSearch(): AiSearchAccountService;
   /**
    * @deprecated AutoRAG has been replaced by AI Search.
    * Use `env.AI.aiSearch` instead for better API design and new features.
@@ -11273,6 +11279,86 @@ export type ImageOutputOptions = {
   background?: string;
   anim?: boolean;
 };
+export interface ImageMetadata {
+  id: string;
+  filename?: string;
+  uploaded?: string;
+  requireSignedURLs: boolean;
+  meta?: Record<string, unknown>;
+  variants: string[];
+  draft?: boolean;
+  creator?: string;
+}
+export interface ImageUploadOptions {
+  id?: string;
+  filename?: string;
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+  encoding?: "base64";
+}
+export interface ImageUpdateOptions {
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+}
+export interface ImageListOptions {
+  limit?: number;
+  cursor?: string;
+  sortOrder?: "asc" | "desc";
+  creator?: string;
+}
+export interface ImageList {
+  images: ImageMetadata[];
+  cursor?: string;
+  listComplete: boolean;
+}
+export interface HostedImagesBinding {
+  /**
+   * Get detailed metadata for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns Image metadata, or null if not found
+   */
+  details(imageId: string): Promise<ImageMetadata | null>;
+  /**
+   * Get the raw image data for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns ReadableStream of image bytes, or null if not found
+   */
+  image(imageId: string): Promise<ReadableStream<Uint8Array> | null>;
+  /**
+   * Upload a new hosted image
+   * @param image The image file to upload
+   * @param options Upload configuration
+   * @returns Metadata for the uploaded image
+   * @throws {@link ImagesError} if upload fails
+   */
+  upload(
+    image: ReadableStream<Uint8Array> | ArrayBuffer,
+    options?: ImageUploadOptions,
+  ): Promise<ImageMetadata>;
+  /**
+   * Update hosted image metadata
+   * @param imageId The ID of the image
+   * @param options Properties to update
+   * @returns Updated image metadata
+   * @throws {@link ImagesError} if update fails
+   */
+  update(imageId: string, options: ImageUpdateOptions): Promise<ImageMetadata>;
+  /**
+   * Delete a hosted image
+   * @param imageId The ID of the image
+   * @returns True if deleted, false if not found
+   */
+  delete(imageId: string): Promise<boolean>;
+  /**
+   * List hosted images with pagination
+   * @param options List configuration
+   * @returns List of images with pagination info
+   * @throws {@link ImagesError} if list fails
+   */
+  list(options?: ImageListOptions): Promise<ImageList>;
+}
 export interface ImagesBinding {
   /**
    * Get image metadata (type, width and height)
@@ -11292,6 +11378,10 @@ export interface ImagesBinding {
     stream: ReadableStream<Uint8Array>,
     options?: ImageInputOptions,
   ): ImageTransformer;
+  /**
+   * Access hosted images CRUD operations
+   */
+  readonly hosted: HostedImagesBinding;
 }
 export interface ImageTransformer {
   /**
@@ -11362,8 +11452,14 @@ export interface MediaTransformer {
    * @returns A generator for producing the transformed media output
    */
   transform(
-    transform: MediaTransformationInputOptions,
+    transform?: MediaTransformationInputOptions,
   ): MediaTransformationGenerator;
+  /**
+   * Generates the final media output with specified options.
+   * @param output - Configuration for the output format and parameters
+   * @returns The final transformation result containing the transformed media
+   */
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Generator for producing media transformation results.
@@ -11375,7 +11471,7 @@ export interface MediaTransformationGenerator {
    * @param output - Configuration for the output format and parameters
    * @returns The final transformation result containing the transformed media
    */
-  output(output: MediaTransformationOutputOptions): MediaTransformationResult;
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Result of a media transformation operation.
@@ -11384,19 +11480,19 @@ export interface MediaTransformationGenerator {
 export interface MediaTransformationResult {
   /**
    * Returns the transformed media as a readable stream of bytes.
-   * @returns A stream containing the transformed media data
+   * @returns A promise containing a readable stream with the transformed media
    */
-  media(): ReadableStream<Uint8Array>;
+  media(): Promise<ReadableStream<Uint8Array>>;
   /**
    * Returns the transformed media as an HTTP response object.
-   * @returns The transformed media as a Response, ready to store in cache or return to users
+   * @returns The transformed media as a Promise<Response>, ready to store in cache or return to users
    */
-  response(): Response;
+  response(): Promise<Response>;
   /**
    * Returns the MIME type of the transformed media.
-   * @returns The content type string (e.g., 'image/jpeg', 'video/mp4')
+   * @returns A promise containing the content type string (e.g., 'image/jpeg', 'video/mp4')
    */
-  contentType(): string;
+  contentType(): Promise<string>;
 }
 /**
  * Configuration options for transforming media input.

package/2023-07-01/index.d.ts

@@ -3848,6 +3848,12 @@ declare abstract class Performance {
   get timeOrigin(): number;
   /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */
   now(): number;
+  /**
+   * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
+   */
+  toJSON(): object;
 }
 // AI Search V2 API Error Interfaces
 interface AiSearchInternalError extends Error {}
@@ -9551,7 +9557,7 @@ declare abstract class Ai<AiModelList extends AiModelListType = AiModels> {
    * });
    * ```
    */
-  aiSearch: AiSearchAccountService;
+  aiSearch(): AiSearchAccountService;
   /**
    * @deprecated AutoRAG has been replaced by AI Search.
    * Use `env.AI.aiSearch` instead for better API design and new features.
@@ -11256,6 +11262,86 @@ type ImageOutputOptions = {
   background?: string;
   anim?: boolean;
 };
+interface ImageMetadata {
+  id: string;
+  filename?: string;
+  uploaded?: string;
+  requireSignedURLs: boolean;
+  meta?: Record<string, unknown>;
+  variants: string[];
+  draft?: boolean;
+  creator?: string;
+}
+interface ImageUploadOptions {
+  id?: string;
+  filename?: string;
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+  encoding?: "base64";
+}
+interface ImageUpdateOptions {
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+}
+interface ImageListOptions {
+  limit?: number;
+  cursor?: string;
+  sortOrder?: "asc" | "desc";
+  creator?: string;
+}
+interface ImageList {
+  images: ImageMetadata[];
+  cursor?: string;
+  listComplete: boolean;
+}
+interface HostedImagesBinding {
+  /**
+   * Get detailed metadata for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns Image metadata, or null if not found
+   */
+  details(imageId: string): Promise<ImageMetadata | null>;
+  /**
+   * Get the raw image data for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns ReadableStream of image bytes, or null if not found
+   */
+  image(imageId: string): Promise<ReadableStream<Uint8Array> | null>;
+  /**
+   * Upload a new hosted image
+   * @param image The image file to upload
+   * @param options Upload configuration
+   * @returns Metadata for the uploaded image
+   * @throws {@link ImagesError} if upload fails
+   */
+  upload(
+    image: ReadableStream<Uint8Array> | ArrayBuffer,
+    options?: ImageUploadOptions,
+  ): Promise<ImageMetadata>;
+  /**
+   * Update hosted image metadata
+   * @param imageId The ID of the image
+   * @param options Properties to update
+   * @returns Updated image metadata
+   * @throws {@link ImagesError} if update fails
+   */
+  update(imageId: string, options: ImageUpdateOptions): Promise<ImageMetadata>;
+  /**
+   * Delete a hosted image
+   * @param imageId The ID of the image
+   * @returns True if deleted, false if not found
+   */
+  delete(imageId: string): Promise<boolean>;
+  /**
+   * List hosted images with pagination
+   * @param options List configuration
+   * @returns List of images with pagination info
+   * @throws {@link ImagesError} if list fails
+   */
+  list(options?: ImageListOptions): Promise<ImageList>;
+}
 interface ImagesBinding {
   /**
    * Get image metadata (type, width and height)
@@ -11275,6 +11361,10 @@ interface ImagesBinding {
     stream: ReadableStream<Uint8Array>,
     options?: ImageInputOptions,
   ): ImageTransformer;
+  /**
+   * Access hosted images CRUD operations
+   */
+  readonly hosted: HostedImagesBinding;
 }
 interface ImageTransformer {
   /**
@@ -11345,8 +11435,14 @@ interface MediaTransformer {
    * @returns A generator for producing the transformed media output
    */
   transform(
-    transform: MediaTransformationInputOptions,
+    transform?: MediaTransformationInputOptions,
   ): MediaTransformationGenerator;
+  /**
+   * Generates the final media output with specified options.
+   * @param output - Configuration for the output format and parameters
+   * @returns The final transformation result containing the transformed media
+   */
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Generator for producing media transformation results.
@@ -11358,7 +11454,7 @@ interface MediaTransformationGenerator {
    * @param output - Configuration for the output format and parameters
    * @returns The final transformation result containing the transformed media
    */
-  output(output: MediaTransformationOutputOptions): MediaTransformationResult;
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Result of a media transformation operation.
@@ -11367,19 +11463,19 @@ interface MediaTransformationGenerator {
 interface MediaTransformationResult {
   /**
    * Returns the transformed media as a readable stream of bytes.
-   * @returns A stream containing the transformed media data
+   * @returns A promise containing a readable stream with the transformed media
    */
-  media(): ReadableStream<Uint8Array>;
+  media(): Promise<ReadableStream<Uint8Array>>;
   /**
    * Returns the transformed media as an HTTP response object.
-   * @returns The transformed media as a Response, ready to store in cache or return to users
+   * @returns The transformed media as a Promise<Response>, ready to store in cache or return to users
    */
-  response(): Response;
+  response(): Promise<Response>;
   /**
    * Returns the MIME type of the transformed media.
-   * @returns The content type string (e.g., 'image/jpeg', 'video/mp4')
+   * @returns A promise containing the content type string (e.g., 'image/jpeg', 'video/mp4')
    */
-  contentType(): string;
+  contentType(): Promise<string>;
 }
 /**
  * Configuration options for transforming media input.

package/2023-07-01/index.ts

@@ -3857,6 +3857,12 @@ export declare abstract class Performance {
   get timeOrigin(): number;
   /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */
   now(): number;
+  /**
+   * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
+   */
+  toJSON(): object;
 }
 // AI Search V2 API Error Interfaces
 export interface AiSearchInternalError extends Error {}
@@ -9563,7 +9569,7 @@ export declare abstract class Ai<
    * });
    * ```
    */
-  aiSearch: AiSearchAccountService;
+  aiSearch(): AiSearchAccountService;
   /**
    * @deprecated AutoRAG has been replaced by AI Search.
    * Use `env.AI.aiSearch` instead for better API design and new features.
@@ -11273,6 +11279,86 @@ export type ImageOutputOptions = {
   background?: string;
   anim?: boolean;
 };
+export interface ImageMetadata {
+  id: string;
+  filename?: string;
+  uploaded?: string;
+  requireSignedURLs: boolean;
+  meta?: Record<string, unknown>;
+  variants: string[];
+  draft?: boolean;
+  creator?: string;
+}
+export interface ImageUploadOptions {
+  id?: string;
+  filename?: string;
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+  encoding?: "base64";
+}
+export interface ImageUpdateOptions {
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+}
+export interface ImageListOptions {
+  limit?: number;
+  cursor?: string;
+  sortOrder?: "asc" | "desc";
+  creator?: string;
+}
+export interface ImageList {
+  images: ImageMetadata[];
+  cursor?: string;
+  listComplete: boolean;
+}
+export interface HostedImagesBinding {
+  /**
+   * Get detailed metadata for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns Image metadata, or null if not found
+   */
+  details(imageId: string): Promise<ImageMetadata | null>;
+  /**
+   * Get the raw image data for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns ReadableStream of image bytes, or null if not found
+   */
+  image(imageId: string): Promise<ReadableStream<Uint8Array> | null>;
+  /**
+   * Upload a new hosted image
+   * @param image The image file to upload
+   * @param options Upload configuration
+   * @returns Metadata for the uploaded image
+   * @throws {@link ImagesError} if upload fails
+   */
+  upload(
+    image: ReadableStream<Uint8Array> | ArrayBuffer,
+    options?: ImageUploadOptions,
+  ): Promise<ImageMetadata>;
+  /**
+   * Update hosted image metadata
+   * @param imageId The ID of the image
+   * @param options Properties to update
+   * @returns Updated image metadata
+   * @throws {@link ImagesError} if update fails
+   */
+  update(imageId: string, options: ImageUpdateOptions): Promise<ImageMetadata>;
+  /**
+   * Delete a hosted image
+   * @param imageId The ID of the image
+   * @returns True if deleted, false if not found
+   */
+  delete(imageId: string): Promise<boolean>;
+  /**
+   * List hosted images with pagination
+   * @param options List configuration
+   * @returns List of images with pagination info
+   * @throws {@link ImagesError} if list fails
+   */
+  list(options?: ImageListOptions): Promise<ImageList>;
+}
 export interface ImagesBinding {
   /**
    * Get image metadata (type, width and height)
@@ -11292,6 +11378,10 @@ export interface ImagesBinding {
     stream: ReadableStream<Uint8Array>,
     options?: ImageInputOptions,
   ): ImageTransformer;
+  /**
+   * Access hosted images CRUD operations
+   */
+  readonly hosted: HostedImagesBinding;
 }
 export interface ImageTransformer {
   /**
@@ -11362,8 +11452,14 @@ export interface MediaTransformer {
    * @returns A generator for producing the transformed media output
    */
   transform(
-    transform: MediaTransformationInputOptions,
+    transform?: MediaTransformationInputOptions,
   ): MediaTransformationGenerator;
+  /**
+   * Generates the final media output with specified options.
+   * @param output - Configuration for the output format and parameters
+   * @returns The final transformation result containing the transformed media
+   */
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Generator for producing media transformation results.
@@ -11375,7 +11471,7 @@ export interface MediaTransformationGenerator {
    * @param output - Configuration for the output format and parameters
    * @returns The final transformation result containing the transformed media
    */
-  output(output: MediaTransformationOutputOptions): MediaTransformationResult;
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Result of a media transformation operation.
@@ -11384,19 +11480,19 @@ export interface MediaTransformationGenerator {
 export interface MediaTransformationResult {
   /**
    * Returns the transformed media as a readable stream of bytes.
-   * @returns A stream containing the transformed media data
+   * @returns A promise containing a readable stream with the transformed media
    */
-  media(): ReadableStream<Uint8Array>;
+  media(): Promise<ReadableStream<Uint8Array>>;
   /**
    * Returns the transformed media as an HTTP response object.
-   * @returns The transformed media as a Response, ready to store in cache or return to users
+   * @returns The transformed media as a Promise<Response>, ready to store in cache or return to users
    */
-  response(): Response;
+  response(): Promise<Response>;
   /**
    * Returns the MIME type of the transformed media.
-   * @returns The content type string (e.g., 'image/jpeg', 'video/mp4')
+   * @returns A promise containing the content type string (e.g., 'image/jpeg', 'video/mp4')
    */
-  contentType(): string;
+  contentType(): Promise<string>;
 }
 /**
  * Configuration options for transforming media input.