@cloudflare/workers-types 3.15.0 → 3.17.0

package/index.d.ts

@@ -252,8 +252,14 @@ declare type CryptoKeyAlgorithmVariant =
   | CryptoKeyHmacKeyAlgorithm
   | CryptoKeyRsaKeyAlgorithm
   | CryptoKeyEllipticKeyAlgorithm
-  | CryptoKeyVoprfKeyAlgorithm
-  | CryptoKeyOprfKeyAlgorithm;
+  | CryptoKeyArbitraryKeyAlgorithm;
+
+interface CryptoKeyArbitraryKeyAlgorithm {
+  name: string;
+  hash?: CryptoKeyKeyAlgorithm;
+  namedCurve?: string;
+  length?: number;
+}
 
 interface CryptoKeyEllipticKeyAlgorithm {
   name: string;
@@ -270,11 +276,6 @@ interface CryptoKeyKeyAlgorithm {
   name: string;
 }
 
-interface CryptoKeyOprfKeyAlgorithm {
-  name: string;
-  namedCurve: string;
-}
-
 interface CryptoKeyPair {
   publicKey: CryptoKey;
   privateKey: CryptoKey;
@@ -287,12 +288,29 @@ interface CryptoKeyRsaKeyAlgorithm {
   hash?: CryptoKeyKeyAlgorithm;
 }
 
-interface CryptoKeyVoprfKeyAlgorithm {
-  name: string;
-  hash: CryptoKeyKeyAlgorithm;
-  namedCurve: string;
+interface D1Database {
+  prepare(query: string): D1PreparedStatement;
+  dump(): Promise<ArrayBuffer>;
+  batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
+  exec<T = unknown>(query: string): Promise<D1Result<T>>;
+}
+
+interface D1PreparedStatement {
+  bind(...values: any[]): D1PreparedStatement;
+  first<T = unknown>(colName?: string): Promise<T>;
+  run<T = unknown>(): Promise<D1Result<T>>;
+  all<T = unknown>(): Promise<D1Result<T>>;
+  raw<T = unknown>(): Promise<T[]>;
 }
 
+declare type D1Result<T = unknown> = {
+  results?: T[];
+  lastRowId: number | null;
+  changes: number;
+  duration: number;
+  error?: string;
+};
+
 declare class DOMException extends Error {
   constructor(message?: string, name?: string);
   readonly code: number;
@@ -399,7 +417,7 @@ interface DurableObjectSetAlarmOptions {
 
 interface DurableObjectState {
   waitUntil(promise: Promise<any>): void;
-  readonly id: DurableObjectId | string;
+  id: DurableObjectId;
   readonly storage: DurableObjectStorage;
   blockConcurrencyWhile<T>(callback: () => Promise<T>): Promise<T>;
 }
@@ -464,7 +482,10 @@ interface DurableObjectStub extends Fetcher {
 }
 
 interface DurableObjectTransaction {
-  get<T = unknown>(key: string, options?: DurableObjectGetOptions): Promise<T>;
+  get<T = unknown>(
+    key: string,
+    options?: DurableObjectGetOptions
+  ): Promise<T | undefined>;
   get<T = unknown>(
     keys: string[],
     options?: DurableObjectGetOptions
@@ -597,6 +618,10 @@ interface EventTargetEventListenerOptions {
   capture?: boolean;
 }
 
+interface EventTargetHandlerObject {
+  handleEvent(arg1: Event): any | undefined;
+}
+
 interface ExecutionContext {
   waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
@@ -664,12 +689,12 @@ declare class FormData {
   set(name: string, value: Blob, filename?: string): void;
   entries(): IterableIterator<[key: string, value: File | string]>;
   keys(): IterableIterator<string>;
-  values(): IterableIterator<File | string>;
+  values(): IterableIterator<string | File>;
   forEach<This = unknown>(
     callback: (
       this: This,
-      key: string,
       value: File | string,
+      key: string,
       parent: FormData
     ) => void,
     thisArg?: This
@@ -709,7 +734,7 @@ declare class Headers {
   append(name: string, value: string): void;
   delete(name: string): void;
   forEach<This = unknown>(
-    callback: (this: This, key: string, value: string, parent: Headers) => void,
+    callback: (this: This, value: string, key: string, parent: Headers) => void,
     thisArg?: This
   ): void;
   entries(): IterableIterator<[key: string, value: string]>;
@@ -754,7 +779,7 @@ interface IncomingRequestCfProperties {
   botManagement?: IncomingRequestCfPropertiesBotManagement;
   city?: string;
   clientAcceptEncoding?: string;
-  clientTcpRtt: number;
+  clientTcpRtt?: number;
   clientTrustScore?: number;
   /**
    * The three-letter airport code of the data center that the request
@@ -768,6 +793,7 @@ interface IncomingRequestCfProperties {
    */
   country: string;
   httpProtocol: string;
+  isEUCountry?: string;
   latitude?: string;
   longitude?: string;
   /**
@@ -797,6 +823,8 @@ interface IncomingRequestCfProperties {
 }
 
 interface IncomingRequestCfPropertiesBotManagement {
+  corporateProxy: boolean;
+  ja3Hash?: string;
   score: number;
   staticResource: boolean;
   verifiedBot: boolean;
@@ -805,9 +833,13 @@ interface IncomingRequestCfPropertiesBotManagement {
 interface IncomingRequestCfPropertiesTLSClientAuth {
   certIssuerDNLegacy: string;
   certIssuerDN: string;
+  certIssuerDNRFC2253: string;
+  certIssuerSKI: string;
+  certIssuerSerial: string;
   certPresented: "0" | "1";
   certSubjectDNLegacy: string;
   certSubjectDN: string;
+  certSubjectDNRFC2253: string;
   /**
    * In format "Dec 22 19:39:00 2018 GMT"
    */
@@ -822,6 +854,8 @@ interface IncomingRequestCfPropertiesTLSClientAuth {
    * "SUCCESS", "FAILED:reason", "NONE"
    */
   certVerified: string;
+  certRevoked: string;
+  certSKI: string;
 }
 
 interface JsonWebKey {
@@ -1030,10 +1064,21 @@ interface R2Bucket {
       | Blob,
     options?: R2PutOptions
   ): Promise<R2Object>;
-  delete(key: string): Promise<void>;
+  delete(keys: string | string[]): Promise<void>;
   list(options?: R2ListOptions): Promise<R2Objects>;
 }
 
+/**
+ * The checksums associated with the object.
+ */
+interface R2Checksums {
+  md5?: ArrayBuffer;
+  sha1?: ArrayBuffer;
+  sha256?: ArrayBuffer;
+  sha384?: ArrayBuffer;
+  sha512?: ArrayBuffer;
+}
+
 /**
  * Perform the operation conditionally based on meeting the defined criteria.
  */
@@ -1042,6 +1087,7 @@ interface R2Conditional {
   etagDoesNotMatch?: string;
   uploadedBefore?: Date;
   uploadedAfter?: Date;
+  secondsGranularity?: boolean;
 }
 
 /**
@@ -1049,7 +1095,7 @@ interface R2Conditional {
  */
 interface R2GetOptions {
   onlyIf?: R2Conditional | Headers;
-  range?: R2Range;
+  range?: R2Range | Headers;
 }
 
 /**
@@ -1077,6 +1123,7 @@ interface R2ListOptions {
   prefix?: string;
   cursor?: string;
   delimiter?: string;
+  startAfter?: string;
   /**
    * If you populate this array, then items returned will include this metadata.
    * A tradeoff is that fewer results may be returned depending on how big this
@@ -1102,9 +1149,10 @@ declare abstract class R2Object {
   readonly size: number;
   readonly etag: string;
   readonly httpEtag: string;
+  readonly checksums: R2Checksums;
   readonly uploaded: Date;
-  readonly httpMetadata: R2HTTPMetadata;
-  readonly customMetadata: Record<string, string>;
+  readonly httpMetadata?: R2HTTPMetadata;
+  readonly customMetadata?: Record<string, string>;
   readonly range?: R2Range;
   writeHttpMetadata(headers: Headers): void;
 }
@@ -1129,9 +1177,14 @@ interface R2Objects {
 }
 
 interface R2PutOptions {
+  onlyIf?: R2Conditional | Headers;
   httpMetadata?: R2HTTPMetadata | Headers;
   customMetadata?: Record<string, string>;
   md5?: ArrayBuffer | string;
+  sha1?: ArrayBuffer | string;
+  sha256?: ArrayBuffer | string;
+  sha384?: ArrayBuffer | string;
+  sha512?: ArrayBuffer | string;
 }
 
 declare type R2Range =
@@ -1365,8 +1418,10 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    *  - json: instead of generating an image, outputs information about the
    *    image, in JSON format. The JSON object will contain image size
    *    (before and after resizing), source image’s MIME type, file size, etc.
+   * - jpeg: generate images in JPEG format.
+   * - png: generate images in PNG format.
    */
-  format?: "avif" | "webp" | "json";
+  format?: "avif" | "webp" | "json" | "jpeg" | "png";
   /**
    * Whether to preserve animation frames from input files. Default is true.
    * Setting it to false reduces animations to still images. This setting is
@@ -1406,6 +1461,12 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    * entry is the topmost layer).
    */
   draw?: RequestInitCfPropertiesImageDraw[];
+  /**
+   * Fetching image from authenticated origin. Setting this property will
+   * pass authentication headers (Authorization, Cookie, etc.) through to
+   * the origin.
+   */
+  "origin-auth"?: "share-publicly";
 }
 
 interface RequestInitCfPropertiesImageDraw extends BasicImageTransformations {
@@ -1554,7 +1615,7 @@ interface ServiceWorkerGlobalScopeStructuredCloneOptions {
 declare type StreamPipeOptions = PipeToOptions;
 
 interface StreamQueuingStrategy {
-  highWaterMark?: number;
+  highWaterMark?: bigint;
   size(chunk: any): number;
 }
 
@@ -1624,6 +1685,10 @@ declare abstract class SubtleCrypto {
     extractable: boolean,
     keyUsages: string[]
   ): Promise<CryptoKey>;
+  timingSafeEqual(
+    a: ArrayBuffer | ArrayBufferView,
+    b: ArrayBuffer | ArrayBufferView
+  ): boolean;
 }
 
 interface SubtleCryptoDeriveKeyAlgorithm {
@@ -1718,6 +1783,14 @@ interface TextDecoderDecodeOptions {
   stream: boolean;
 }
 
+declare class TextDecoderStream extends TransformStream {
+  constructor(label?: string, options?: TextDecoderStreamTextDecoderStreamInit);
+}
+
+interface TextDecoderStreamTextDecoderStreamInit {
+  fatal?: boolean;
+}
+
 declare class TextEncoder {
   constructor();
   encode(input?: string): Uint8Array;
@@ -1730,6 +1803,72 @@ interface TextEncoderEncodeIntoResult {
   written: number;
 }
 
+declare class TextEncoderStream extends TransformStream {
+  constructor();
+}
+
+interface TraceEvent extends ExtendableEvent {
+  readonly traces: TraceItem[];
+}
+
+interface TraceException {
+  readonly timestamp: number;
+  readonly message: string;
+  readonly name: string;
+}
+
+interface TraceItem {
+  readonly event: TraceItemEventInfo | null;
+  readonly eventTimestamp: number | null;
+  readonly logs: TraceLog[];
+  readonly exceptions: TraceException[];
+  readonly scriptName: string | null;
+  readonly dispatchNamespace?: string;
+  readonly outcome: string;
+}
+
+interface TraceItemAlarmEventInfo {
+  readonly scheduledTime: Date;
+}
+
+declare type TraceItemEventInfo =
+  | TraceItemFetchEventInfo
+  | TraceItemScheduledEventInfo
+  | TraceItemAlarmEventInfo;
+
+interface TraceItemFetchEventInfo {
+  readonly response?: TraceItemFetchEventInfoResponse;
+  readonly request: TraceItemFetchEventInfoRequest;
+}
+
+interface TraceItemFetchEventInfoRequest {
+  readonly cf?: Object;
+  readonly headers: Record<string, string>;
+  readonly method: string;
+  readonly url: string;
+  getUnredacted(): TraceItemFetchEventInfoRequest;
+}
+
+interface TraceItemFetchEventInfoResponse {
+  readonly status: number;
+}
+
+interface TraceItemScheduledEventInfo {
+  readonly scheduledTime: number;
+  readonly cron: string;
+}
+
+interface TraceLog {
+  readonly timestamp: number;
+  readonly level: string;
+  readonly message: Object;
+}
+
+interface TraceMetrics {
+  readonly cpuTime: number;
+  readonly wallTime: number;
+}
+
 declare class TransformStream {
   constructor(
     maybeTransformer?: Transformer,
@@ -1834,8 +1973,8 @@ declare class URLSearchParams {
   forEach<This = unknown>(
     callback: (
       this: This,
-      key: string,
       value: string,
+      key: string,
       parent: URLSearchParams
     ) => void,
     thisArg?: This
@@ -1878,6 +2017,10 @@ interface UnderlyingSource {
   cancel?(reason?: any): any;
 }
 
+interface UnsafeTraceMetrics {
+  fromTrace(arg4: TraceItem): TraceMetrics;
+}
+
 declare class WebSocket extends EventTarget<WebSocketEventMap> {
   constructor(url: string, protocols?: string[] | string);
   accept(): void;

package/package.json

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