@cloudflare/workers-types 3.2.0 → 3.3.0

package/index.d.ts

@@ -10,8 +10,10 @@ declare class AbortController {
 declare class AbortSignal extends EventTarget {
   constructor();
   static abort(reason?: any): AbortSignal;
+  static timeout(delay: number): AbortSignal;
   readonly aborted: boolean;
   readonly reason: any;
+  throwIfAborted(): void;
 }
 
 interface BasicImageTransformations {
@@ -36,10 +38,11 @@ interface BasicImageTransformations {
    *  - cover: Resizes (shrinks or enlarges) to fill the entire area of width
    *    and height. If the image has an aspect ratio different from the ratio
    *    of width and height, it will be cropped to fit.
-   *  - crop: The image will shrunk and cropped to fit within the area
-   *    specified by width and height. The image won’t be enlarged. For images
-   *    smaller than the given dimensions it’s the same as scale-down. For
-   *    images larger than the given dimensions, it’s the same as cover.
+   *  - crop: The image will be shrunk and cropped to fit within the area
+   *    specified by width and height. The image will not be enlarged. For images
+   *    smaller than the given dimensions it's the same as scale-down. For
+   *    images larger than the given dimensions, it's the same as cover.
+   *    See also trim.
    *  - pad: Resizes to the maximum size that fits within the given width and
    *    height, and then fills the remaining area with a background color
    *    (white by default). Use of this mode is not recommended, as the same
@@ -267,6 +270,11 @@ declare class DOMException extends Error {
   static readonly DATA_CLONE_ERR: number;
 }
 
+declare class DigestStream extends WritableStream {
+  constructor(algorithm: string | SubtleCryptoHashAlgorithm);
+  readonly digest: Promise<ArrayBuffer>;
+}
+
 interface Doctype {
   readonly name: string | null;
   readonly publicId: string | null;
@@ -763,7 +771,16 @@ interface ReadResult {
   done: boolean;
 }
 
-declare abstract class ReadableStream {
+interface ReadableByteStreamController {
+  readonly byobRequest: ReadableStreamBYOBRequest | null;
+  readonly desiredSize: number | null;
+  close(): void;
+  enqueue(chunk: ArrayBufferView): void;
+  error(reason: any): void;
+}
+
+declare class ReadableStream {
+  constructor(underlyingSource?: Object, queuingStrategy?: Object);
   readonly locked: boolean;
   cancel(reason?: any): Promise<void>;
   getReader(options: ReadableStreamGetReaderOptions): ReadableStreamBYOBReader;
@@ -782,6 +799,20 @@ declare class ReadableStreamBYOBReader {
   readAtLeast(minBytes: number, view: Uint8Array): Promise<ReadableStreamReadResult<Uint8Array>>;
 }
 
+interface ReadableStreamBYOBRequest {
+  readonly view: Uint8Array | null;
+  respond(bytesWritten: number): void;
+  respondWithNewView(view: ArrayBufferView): void;
+  readonly atLeast: number | null;
+}
+
+interface ReadableStreamDefaultController {
+  readonly desiredSize: number | null;
+  close(): void;
+  enqueue(chunk?: any): void;
+  error(reason: any): void;
+}
+
 declare class ReadableStreamDefaultReader {
   constructor(stream: ReadableStream);
   readonly closed: Promise<void>;
@@ -909,6 +940,13 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    * easier to specify higher-DPI sizes in <img srcset>.
    */
   dpr?: number;
+  /**
+   * An object with four properties {left, top, right, bottom} that specify
+   * a number of pixels to cut off on each side. Allows removal of borders
+   * or cutting out a specific fragment of an image. Trimming is performed
+   * before resizing or rotation. Takes dpr into account.
+   */
+  trim?: { left?: number; top?: number; right?: number; bottom?: number; };
   /**
    * Quality setting from 1-100 (useful values are in 60-90 range). Lower values
    * make images look worse, but load faster. The default is 85. It applies only
@@ -925,6 +963,15 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    *    (before and after resizing), source image’s MIME type, file size, etc.
    */
   format?: "avif" | "webp" | "json";
+  /**
+   * Whether to preserve animation frames from input files. Default is true.
+   * Setting it to false reduces animations to still images. This setting is
+   * recommended when enlarging images or processing arbitrary user content,
+   * because large GIF animations can weigh tens or even hundreds of megabytes.
+   * It is also useful to set anim:false when using format:"json" to get the
+   * response quicker without the number of frames.
+   */
+  anim?: boolean;
   /**
    * What EXIF data should be preserved in the output image. Note that EXIF
    * rotation and embedded color profiles are always applied ("baked in" into
@@ -939,6 +986,17 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    *    output formats always discard metadata.
    */
   metadata?: "keep" | "copyright" | "none";
+  /**
+   * Strength of sharpening filter to apply to the image. Floating-point
+   * number between 0 (no sharpening, default) and 10 (maximum). 1.0 is a
+   * recommended value for downscaled images.
+   */
+  sharpen?: number;
+  /**
+   * Radius of a blur filter (approximate gaussian). Maximum supported radius
+   * is 250.
+   */
+  blur?: number;
   /**
    * Overlays are drawn in the order they appear in the array (last array
    * entry is the topmost layer).
@@ -1044,6 +1102,14 @@ declare abstract class ScheduledEvent extends Event {
   waitUntil(promise: Promise<any>): void;
 }
 
+interface Scheduler {
+  wait(delay: number, maybeOptions?: SchedulerWaitOptions): Promise<void>;
+}
+
+interface SchedulerWaitOptions {
+  signal?: AbortSignal;
+}
+
 interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
   btoa(data: string): string;
   atob(data: string): string;
@@ -1054,10 +1120,12 @@ interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
   queueMicrotask(task: Function): void;
   structuredClone(value: any, options?: ServiceWorkerGlobalScopeStructuredCloneOptions): any;
   fetch(request: Request | string, requestInitr?: RequestInit | Request): Promise<Response>;
-  readonly self: ServiceWorkerGlobalScope;
-  readonly crypto: Crypto;
-  readonly caches: CacheStorage;
+  self: ServiceWorkerGlobalScope;
+  crypto: Crypto;
+  caches: CacheStorage;
+  scheduler: Scheduler;
   readonly console: Console;
+  origin: void;
 }
 
 interface ServiceWorkerGlobalScopeStructuredCloneOptions {
@@ -1251,13 +1319,19 @@ declare abstract class WorkerGlobalScope extends EventTarget<WorkerGlobalScopeEv
 
 declare type WorkerGlobalScopeEventMap = { fetch: FetchEvent; scheduled: ScheduledEvent; unhandledrejection: PromiseRejectionEvent; rejectionhandled: PromiseRejectionEvent; };
 
-declare abstract class WritableStream {
+declare class WritableStream {
+  constructor(underlyingSink?: Object, queuingStrategy?: Object);
   readonly locked: boolean;
   abort(reason: any): Promise<void>;
   close(): Promise<void>;
   getWriter(): WritableStreamDefaultWriter;
 }
 
+interface WritableStreamDefaultController {
+  readonly signal: AbortSignal;
+  error(reason?: any): void;
+}
+
 declare class WritableStreamDefaultWriter {
   constructor(stream: WritableStream);
   readonly closed: Promise<void>;
@@ -1295,10 +1369,14 @@ declare function dispatchEvent(event: WorkerGlobalScopeEventMap[keyof WorkerGlob
 
 declare function fetch(request: Request | string, requestInitr?: RequestInit | Request): Promise<Response>;
 
+declare const origin: void;
+
 declare function queueMicrotask(task: Function): void;
 
 declare function removeEventListener<Type extends keyof WorkerGlobalScopeEventMap>(type: Type, handler: EventListenerOrEventListenerObject<WorkerGlobalScopeEventMap[Type]>, options?: EventTargetEventListenerOptions | boolean): void;
 
+declare const scheduler: Scheduler;
+
 declare const self: ServiceWorkerGlobalScope;
 
 declare function setInterval<Args extends any[]>(callback: (...args: Args) => void, msDelay?: number, ...args: Args): number;
@@ -1314,7 +1392,7 @@ type EventContext<Env, P extends string, Data> = {
   request: Request;
   waitUntil: (promise: Promise<any>) => void;
   next: (input?: Request | string, init?: RequestInit) => Promise<Response>;
-  env: Env;
+  env: Env & { ASSETS: { fetch: typeof fetch }};
   params: Params<P>;
   data: Data;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudflare/workers-types",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "TypeScript typings for Cloudflare Workers",
   "repository": {
     "type": "git",