@cloudflare/workers-types 3.1.0 → 3.1.1

package/index.d.ts

@@ -49,7 +49,7 @@ interface BasicImageTransformations {
   /**
    * When cropping with fit: "cover", this defines the side or point that should
    * be left uncropped. The value is either a string
-   * "left", "right", "top", "bottom" or "center" (the default),
+   * "left", "right", "top", "bottom", "auto", or "center" (the default),
    * or an object {x, y} containing focal point coordinates in the original
    * image expressed as fractions ranging from 0.0 (top or left) to 1.0
    * (bottom or right), 0.5 being the center. {fit: "cover", gravity: "top"} will
@@ -58,7 +58,7 @@ interface BasicImageTransformations {
    * preserve as much as possible around a point at 20% of the height of the
    * source image.
    */
-  gravity?: "left" | "right" | "top" | "bottom" | "center" | BasicImageTransformationsGravityCoordinates;
+  gravity?: "left" | "right" | "top" | "bottom" | "center" | "auto" | BasicImageTransformationsGravityCoordinates;
   /**
    * Background color to add underneath the image. Applies only to images with
    * transparency (such as PNG). Accepts any CSS color (#RRGGBB, rgba(…),
@@ -180,7 +180,7 @@ interface ContentOptions {
 
 declare abstract class Crypto {
   readonly subtle: SubtleCrypto;
-  getRandomValues(buffer: ArrayBufferView): ArrayBufferView;
+  getRandomValues<T extends Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array>(buffer: T): T;
   randomUUID(): string;
 }
 
@@ -280,12 +280,27 @@ interface DurableObject {
   fetch(request: Request): Promise<Response>;
 }
 
+interface DurableObjectGetOptions {
+  allowConcurrency?: boolean;
+  noCache?: boolean;
+}
+
 interface DurableObjectId {
   toString(): string;
   equals(other: DurableObjectId): boolean;
   readonly name?: string;
 }
 
+interface DurableObjectListOptions {
+  start?: string;
+  end?: string;
+  prefix?: string;
+  reverse?: boolean;
+  limit?: number;
+  allowConcurrency?: boolean;
+  noCache?: boolean;
+}
+
 interface DurableObjectNamespace {
   newUniqueId(options?: DurableObjectNamespaceNewUniqueIdOptions): DurableObjectId;
   idFromName(name: string): DurableObjectId;
@@ -297,6 +312,12 @@ interface DurableObjectNamespaceNewUniqueIdOptions {
   jurisdiction?: string;
 }
 
+interface DurableObjectPutOptions {
+  allowConcurrency?: boolean;
+  allowUnconfirmed?: boolean;
+  noCache?: boolean;
+}
+
 interface DurableObjectState {
   waitUntil(promise: Promise<any>): void;
   readonly id: DurableObjectId | string;
@@ -305,37 +326,34 @@ interface DurableObjectState {
 }
 
 interface DurableObjectStorage {
-  get<T = unknown>(key: string, options?: DurableObjectStorageOperationsGetOptions): Promise<T | undefined>;
-  get<T = unknown>(keys: string[], options?: DurableObjectStorageOperationsGetOptions): Promise<Map<string, T>>;
-  list<T = unknown>(options?: DurableObjectStorageOperationsListOptions): Promise<Map<string, T>>;
-  put<T>(key: string, value: T, options?: DurableObjectStorageOperationsPutOptions): Promise<void>;
-  put<T>(entries: Record<string, T>, options?: DurableObjectStorageOperationsPutOptions): Promise<void>;
-  delete(key: string, options?: DurableObjectStorageOperationsPutOptions): Promise<boolean>;
-  delete(keys: string[], options?: DurableObjectStorageOperationsPutOptions): Promise<number>;
-  deleteAll(options?: DurableObjectStorageOperationsPutOptions): Promise<void>;
+  get<T = unknown>(key: string, options?: DurableObjectGetOptions): Promise<T | undefined>;
+  get<T = unknown>(keys: string[], options?: DurableObjectGetOptions): Promise<Map<string, T>>;
+  list<T = unknown>(options?: DurableObjectListOptions): Promise<Map<string, T>>;
+  put<T>(key: string, value: T, options?: DurableObjectPutOptions): Promise<void>;
+  put<T>(entries: Record<string, T>, options?: DurableObjectPutOptions): Promise<void>;
+  delete(key: string, options?: DurableObjectPutOptions): Promise<boolean>;
+  delete(keys: string[], options?: DurableObjectPutOptions): Promise<number>;
+  deleteAll(options?: DurableObjectPutOptions): Promise<void>;
   transaction<T>(closure: (txn: DurableObjectTransaction) => Promise<T>): Promise<T>;
 }
 
-interface DurableObjectStorageOperationsGetOptions {
-  allowConcurrency?: boolean;
-  noCache?: boolean;
-}
+/**
+ * 
+ * @deprecated Don't use. Introduced incidentally in 3.x. Scheduled for removal.
+ */
+declare type DurableObjectStorageOperationsGetOptions = DurableObjectGetOptions;
 
-interface DurableObjectStorageOperationsListOptions {
-  start?: string;
-  end?: string;
-  prefix?: string;
-  reverse?: boolean;
-  limit?: number;
-  allowConcurrency?: boolean;
-  noCache?: boolean;
-}
+/**
+ * 
+ * @deprecated Don't use. Introduced incidentally in 3.x. Scheduled for removal.
+ */
+declare type DurableObjectStorageOperationsListOptions = DurableObjectListOptions;
 
-interface DurableObjectStorageOperationsPutOptions {
-  allowConcurrency?: boolean;
-  allowUnconfirmed?: boolean;
-  noCache?: boolean;
-}
+/**
+ * 
+ * @deprecated Don't use. Introduced incidentally in 3.x. Scheduled for removal.
+ */
+declare type DurableObjectStorageOperationsPutOptions = DurableObjectPutOptions;
 
 interface DurableObjectStub extends Fetcher {
   readonly id: DurableObjectId;
@@ -343,13 +361,13 @@ interface DurableObjectStub extends Fetcher {
 }
 
 interface DurableObjectTransaction {
-  get<T = unknown>(key: string, options?: DurableObjectStorageOperationsGetOptions): Promise<T>;
-  get<T = unknown>(keys: string[], options?: DurableObjectStorageOperationsGetOptions): Promise<Map<string, T>>;
-  list<T = unknown>(options?: DurableObjectStorageOperationsListOptions): Promise<Map<string, T>>;
-  put<T>(key: string, value: T, options?: DurableObjectStorageOperationsPutOptions): Promise<void>;
-  put<T>(entries: Record<string, T>, options?: DurableObjectStorageOperationsPutOptions): Promise<void>;
-  delete(key: string, options?: DurableObjectStorageOperationsPutOptions): Promise<boolean>;
-  delete(keys: string[], options?: DurableObjectStorageOperationsPutOptions): Promise<number>;
+  get<T = unknown>(key: string, options?: DurableObjectGetOptions): Promise<T>;
+  get<T = unknown>(keys: string[], options?: DurableObjectGetOptions): Promise<Map<string, T>>;
+  list<T = unknown>(options?: DurableObjectListOptions): Promise<Map<string, T>>;
+  put<T>(key: string, value: T, options?: DurableObjectPutOptions): Promise<void>;
+  put<T>(entries: Record<string, T>, options?: DurableObjectPutOptions): Promise<void>;
+  delete(key: string, options?: DurableObjectPutOptions): Promise<boolean>;
+  delete(keys: string[], options?: DurableObjectPutOptions): Promise<number>;
   rollback(): void;
 }
 
@@ -618,6 +636,27 @@ interface IncomingRequestCfPropertiesTLSClientAuth {
   certVerified: string;
 }
 
+interface JsonWebKey {
+  kty: string;
+  use?: string;
+  key_ops?: string[];
+  alg?: string;
+  ext?: boolean;
+  crv?: string;
+  x?: string;
+  y?: string;
+  d?: string;
+  n?: string;
+  e?: string;
+  p?: string;
+  q?: string;
+  dp?: string;
+  dq?: string;
+  qi?: string;
+  oth?: RsaOtherPrimesInfo[];
+  k?: string;
+}
+
 /**
  * Workers KV is a global, low-latency, key-value data store. It supports exceptionally high read volumes with low-latency,
  * making it possible to build highly dynamic APIs and websites which respond as quickly as a cached static file would.
@@ -846,6 +885,7 @@ interface RequestInitCfProperties {
   image?: RequestInitCfPropertiesImage;
   minify?: RequestInitCfPropertiesImageMinify;
   mirage?: boolean;
+  polish?: 'lossy' | 'lossless' | 'off';
   /**
    * Redirects the request to an alternate origin server. You can use this,
    * for example, to implement load balancing across several origins.
@@ -984,6 +1024,12 @@ interface ResponseInit {
  */
 declare type ResponseInitializerDict = ResponseInit;
 
+interface RsaOtherPrimesInfo {
+  r?: string;
+  d?: string;
+  t?: string;
+}
+
 interface ScheduledController {
   readonly scheduledTime: number;
   readonly cron: string;
@@ -1028,8 +1074,8 @@ declare abstract class SubtleCrypto {
   generateKey(algorithm: string | SubtleCryptoGenerateKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise<CryptoKey | CryptoKeyPair>;
   deriveKey(algorithm: string | SubtleCryptoDeriveKeyAlgorithm, baseKey: CryptoKey, derivedKeyAlgorithm: string | SubtleCryptoImportKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise<CryptoKey>;
   deriveBits(algorithm: string | SubtleCryptoDeriveKeyAlgorithm, baseKey: CryptoKey, length: number | null): Promise<ArrayBuffer>;
-  importKey(format: string, keyData: ArrayBuffer | SubtleCryptoJsonWebKey, algorithm: string | SubtleCryptoImportKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise<CryptoKey>;
-  exportKey(format: string, key: CryptoKey): Promise<ArrayBuffer | SubtleCryptoJsonWebKey>;
+  importKey(format: string, keyData: ArrayBuffer | JsonWebKey, algorithm: string | SubtleCryptoImportKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise<CryptoKey>;
+  exportKey(format: string, key: CryptoKey): Promise<ArrayBuffer | JsonWebKey>;
   wrapKey(format: string, key: CryptoKey, wrappingKey: CryptoKey, wrapAlgorithm: string | SubtleCryptoEncryptAlgorithm): Promise<ArrayBuffer>;
   unwrapKey(format: string, wrappedKey: ArrayBuffer, unwrappingKey: CryptoKey, unwrapAlgorithm: string | SubtleCryptoEncryptAlgorithm, unwrappedKeyAlgorithm: string | SubtleCryptoImportKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise<CryptoKey>;
 }
@@ -1074,32 +1120,17 @@ interface SubtleCryptoImportKeyAlgorithm {
   compressed?: boolean;
 }
 
-interface SubtleCryptoJsonWebKey {
-  kty: string;
-  use?: string;
-  key_ops?: string[];
-  alg?: string;
-  ext?: boolean;
-  crv?: string;
-  x?: string;
-  y?: string;
-  d?: string;
-  n?: string;
-  e?: string;
-  p?: string;
-  q?: string;
-  dp?: string;
-  dq?: string;
-  qi?: string;
-  oth?: SubtleCryptoJsonWebKeyRsaOtherPrimesInfo[];
-  k?: string;
-}
+/**
+ * 
+ * @deprecated Don't use. Introduced incidentally in 3.x. Scheduled for removal.
+ */
+declare type SubtleCryptoJsonWebKey = JsonWebKey;
 
-interface SubtleCryptoJsonWebKeyRsaOtherPrimesInfo {
-  r?: string;
-  d?: string;
-  t?: string;
-}
+/**
+ * 
+ * @deprecated Don't use. Introduced incidentally in 3.x. Scheduled for removal.
+ */
+declare type SubtleCryptoJsonWebKeyRsaOtherPrimesInfo = RsaOtherPrimesInfo;
 
 interface SubtleCryptoSignAlgorithm {
   name: string;

package/package.json

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