@cloudflare/workers-types 4.20221111.1 → 4.20230115.0

package/README.md

@@ -30,33 +30,43 @@ The following is a minimal `tsconfig.json` for use alongside this package:
 
 ### Compatibility dates
 
-The Cloudflare Workers runtime manages backwards compatibility through the use of [Compatibility Dates](https://developers.cloudflare.com/workers/platform/compatibility-dates/). Using different compatibility dates affects the runtime types available to your Worker, and so it's important you specify the correct entrypoint to the `workers-types` package to match your compatibility date (which is usually set in your `wrangler.toml` configuration file). `workers-types` currently exposes 7 entrypoints to choose from:
+![Entrypoints for compatibility dates](./entrypoints.svg)
+
+The Cloudflare Workers runtime manages backwards compatibility through the use of [Compatibility Dates](https://developers.cloudflare.com/workers/platform/compatibility-dates/). Using different compatibility dates affects the runtime types available to your Worker, and so it's important you specify the correct entrypoint to the `workers-types` package to match your compatibility date (which is usually set in your `wrangler.toml` configuration file). `workers-types` currently exposes the following entrypoints to choose from:
 
 - `@cloudflare/workers-types`
 
-  The default entrypoint exposes the runtime types for a compatibility date of `2021-01-01` or before.
+  The default entrypoint exposes the runtime types for a compatibility date before `2021-11-03`.
 
 - `@cloudflare/workers-types/2021-11-03`
 
-  This entrypoint exposes the runtime types for a compatibility date between `2021-01-01` and `2021-11-03`.
+  This entrypoint exposes the runtime types for a compatibility date between `2021-11-03` and `2022-01-31`.
 
 - `@cloudflare/workers-types/2022-01-31`
 
-  This entrypoint exposes the runtime types for a compatibility date between `2021-11-03` and `2022-01-31`.
+  This entrypoint exposes the runtime types for a compatibility date between `2022-01-31` and `2022-03-21`.
 
 - `@cloudflare/workers-types/2022-03-21`
 
-  This entrypoint exposes the runtime types for a compatibility date between `2022-01-31` and `2022-03-21`.
+  This entrypoint exposes the runtime types for a compatibility date between `2022-03-21` and `2022-08-04`.
 
 - `@cloudflare/workers-types/2022-08-04`
 
-  This entrypoint exposes the runtime types for a compatibility date between `2022-03-21` and `2022-08-04`.
+  This entrypoint exposes the runtime types for a compatibility date between `2022-08-04` and `2022-10-31`.
+
+- `@cloudflare/workers-types/2022-10-31`
+
+  This entrypoint exposes the runtime types for a compatibility date between `2022-10-31` and `2022-11-30`.
+
+- `@cloudflare/workers-types/2022-11-30`
+
+  This entrypoint exposes the runtime types for a compatibility date after `2022-11-30`.
 
 - `@cloudflare/workers-types/experimental`
 
   This entrypoint exposes the runtime types for the latest compatibility date. The types exposed by this entrypoint will change over time to always reflect the latest version of the Workers runtime.
 
-To use one of these entrypoints, you need to specify them in your `tsconfig.json`. For example, this is a sample `tsconfig.json` for using the `experimental` entrypoint.
+To use one of these entrypoints, you need to specify them in your `tsconfig.json`. For example, this is a sample `tsconfig.json` for using the `2022-08-04` entrypoint.
 
 ```json
 {
@@ -64,7 +74,7 @@ To use one of these entrypoints, you need to specify them in your `tsconfig.json
     "target": "esnext",
     "module": "esnext",
     "lib": ["esnext"],
-    "types": ["@cloudflare/workers-types/experimental"]
+    "types": ["@cloudflare/workers-types/2022-08-04"]
   }
 }
 ```

package/entrypoints.svg

@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="utf-8"?>
+<svg viewBox="0 0 540 280" width="540px" height="280px" xmlns="http://www.w3.org/2000/svg">
+  <rect width="540" height="280" style="fill: rgb(255, 255, 255);"/>
+  <g transform="matrix(1, 0, 0, 1, 61.018997, -319.418854)">
+    <rect x="128.981" y="349.42" width="340" height="30" style="fill: rgb(238, 238, 238);"/>
+    <text style="font-family: monospace; font-size: 14px; white-space: pre;" x="135.709" y="369.298">@cloudflare/workers-types</text>
+  </g>
+  <g transform="matrix(1, 0, 0, 1, 61.018997, -289.418793)">
+    <rect x="128.981" y="349.42" width="340" height="30" style="fill: rgb(221, 221, 221);"/>
+    <text style="font-family: monospace; font-size: 14px; white-space: pre;"><tspan x="135.709" y="369.298">@cloudflare/workers-types/</tspan><tspan style="fill: rgb(0, 85, 220); font-weight: 700;">2021-11-03</tspan></text>
+  </g>
+  <g transform="matrix(1, 0, 0, 1, 61.018997, -259.418793)">
+    <rect x="128.981" y="349.42" width="340" height="30" style="fill: rgb(238, 238, 238);"/>
+    <text style="font-family: monospace; font-size: 14px; white-space: pre;"><tspan x="135.709" y="369.298">@cloudflare/workers-types/</tspan><tspan style="fill: rgb(0, 54, 130); font-weight: 700;">2022-01-31</tspan></text>
+  </g>
+  <g transform="matrix(1, 0, 0, 1, 61.018997, -229.418869)">
+    <rect x="128.981" y="349.42" width="340" height="30" style="fill: rgb(221, 221, 221);"/>
+    <text style="font-family: monospace; font-size: 14px; white-space: pre;"><tspan x="135.709" y="369.298">@cloudflare/workers-types/</tspan><tspan style="fill: rgb(0, 85, 220); font-weight: 700;">2022-03-21</tspan></text>
+  </g>
+  <g transform="matrix(1, 0, 0, 1, 61.018997, -199.418839)">
+    <rect x="128.981" y="349.42" width="340" height="30" style="fill: rgb(238, 238, 238);"/>
+    <text style="font-family: monospace; font-size: 14px; white-space: pre;"><tspan x="135.709" y="369.298">@cloudflare/workers-types/</tspan><tspan style="fill: rgb(0, 54, 130); font-weight: 700;">2022-08-04</tspan></text>
+  </g>
+  <g transform="matrix(1, 0, 0, 1, 61.018997, -169.418839)">
+    <rect x="128.981" y="349.42" width="340" height="30" style="fill: rgb(221, 221, 221);"/>
+    <text style="font-family: monospace; font-size: 14px; white-space: pre;"><tspan x="135.709" y="369.298">@cloudflare/workers-types/</tspan><tspan style="fill: rgb(0, 85, 220); font-weight: 700;">2022-10-31</tspan></text>
+  </g>
+  <g transform="matrix(1, 0, 0, 1, 61.017925, -139.418854)">
+    <rect x="128.981" y="349.42" width="340" height="30" style="fill: rgb(238, 238, 238);"/>
+    <text style="font-family: monospace; font-size: 14px; white-space: pre;"><tspan x="135.709" y="369.298">@cloudflare/workers-types/</tspan><tspan style="fill: rgb(0, 54, 130); font-weight: 700;">2022-11-30</tspan></text>
+  </g>
+  <g transform="matrix(1, 0, 0, 1, 61.017925, -109.418816)">
+    <rect x="128.981" y="349.42" width="340" height="30" style="fill: rgb(221, 221, 221);"/>
+    <text style="font-family: monospace; font-size: 14px; white-space: pre;" x="135.709" y="369.298">@cloudflare/workers-types/experimental</text>
+  </g>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0);" x1="160" y1="60" x2="190" y2="60"/>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0);" x1="160" y1="90" x2="190" y2="90"/>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0);" x1="160" y1="120" x2="190" y2="120"/>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0);" x1="160" y1="150" x2="190" y2="150"/>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0);" x1="160" y1="180" x2="190" y2="180"/>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0);" x1="160" y1="210" x2="190" y2="210"/>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0);" x1="175" y1="60" x2="175" y2="240"/>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0); stroke-dasharray: 2px;" x1="175" y1="30" x2="175" y2="60"/>
+  <line style="fill: rgb(216, 216, 216); stroke: rgb(0, 0, 0); stroke-dasharray: 2px;" x1="175" y1="240" x2="175" y2="270"/>
+  <text style="fill: rgb(51, 51, 51); font-family: monospace; font-size: 14px; font-weight: 700; text-anchor: middle; white-space: pre;" transform="matrix(1, 0, 0, 1, 307.347992, -77.253761)"><tspan x="52.652" y="98.052">types Entrypoint</tspan></text>
+  <text style="fill: rgb(51, 51, 51); font-family: monospace; font-size: 14px; font-weight: 700; text-anchor: end; white-space: pre;" x="157.185" y="20.798">compatibility_date</text>
+  <text style="fill: rgb(0, 85, 220); font-family: monospace; font-size: 14px; font-weight: 700; text-anchor: end; white-space: pre;" x="153.994" y="64.798">2021-11-03</text>
+  <text style="fill: rgb(0, 54, 130); font-family: monospace; font-size: 14px; font-weight: 700; text-anchor: end; white-space: pre;" x="153.994" y="94.798">2022-01-31</text>
+  <text style="fill: rgb(0, 85, 220); font-family: monospace; font-size: 14px; font-weight: 700; text-anchor: end; white-space: pre;" x="153.994" y="124.798">2022-03-21</text>
+  <text style="fill: rgb(0, 54, 130); font-family: monospace; font-size: 14px; font-weight: 700; text-anchor: end; white-space: pre;" x="153.994" y="154.798">2022-08-04</text>
+  <text style="fill: rgb(0, 85, 220); font-family: monospace; font-size: 14px; font-weight: 700; text-anchor: end; white-space: pre;" x="153.994" y="184.798">2022-10-31</text>
+  <text style="fill: rgb(0, 54, 130); font-family: monospace; font-size: 14px; font-weight: 700; text-anchor: end; white-space: pre;" x="153.994" y="214.798">2022-11-30</text>
+</svg>

package/experimental/index.d.ts

@@ -233,7 +233,6 @@ declare interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
   FixedLengthStream: typeof FixedLengthStream;
   IdentityTransformStream: typeof IdentityTransformStream;
   HTMLRewriter: typeof HTMLRewriter;
-  connect(address: string, options?: SocketOptions): Socket;
 }
 declare function addEventListener<Type extends keyof WorkerGlobalScopeEventMap>(
   type: Type,
@@ -287,9 +286,8 @@ declare const crypto: Crypto;
 declare const caches: CacheStorage;
 declare const scheduler: Scheduler;
 declare const navigator: Navigator;
-declare function connect(address: string, options?: SocketOptions): Socket;
 declare interface ExecutionContext {
-  waitUntil(promise: void | Promise<void>): void;
+  waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
 }
 declare type ExportedHandlerFetchHandler<Env = unknown> = (
@@ -347,13 +345,20 @@ declare interface DurableObjectNamespace {
   ): DurableObjectId;
   idFromName(name: string): DurableObjectId;
   idFromString(id: string): DurableObjectId;
-  get(id: DurableObjectId): DurableObjectStub;
+  get(
+    id: DurableObjectId,
+    options?: DurableObjectNamespaceGetDurableObjectOptions
+  ): DurableObjectStub;
+  jurisdiction(jurisdiction: string): DurableObjectNamespace;
 }
 declare interface DurableObjectNamespaceNewUniqueIdOptions {
   jurisdiction?: string;
 }
+declare interface DurableObjectNamespaceGetDurableObjectOptions {
+  locationHint?: string;
+}
 declare interface DurableObjectState {
-  waitUntil(promise: void | Promise<void>): void;
+  waitUntil(promise: Promise<any>): void;
   readonly id: DurableObjectId;
   readonly storage: DurableObjectStorage;
   blockConcurrencyWhile<T>(callback: () => Promise<T>): Promise<T>;
@@ -543,7 +548,7 @@ declare interface SchedulerWaitOptions {
   signal?: AbortSignal;
 }
 declare abstract class ExtendableEvent extends Event {
-  waitUntil(promise: void | Promise<void>): void;
+  waitUntil(promise: Promise<any>): void;
 }
 declare class Blob {
   constructor(
@@ -1013,7 +1018,6 @@ declare abstract class Fetcher {
     input: RequestInfo,
     init?: RequestInit<RequestInitCfProperties>
   ): Promise<Response>;
-  connect(address: string, options?: SocketOptions): Socket;
 }
 declare interface FetcherPutOptions {
   expiration?: number;
@@ -1161,6 +1165,19 @@ declare abstract class R2Bucket {
       | Blob,
     options?: R2PutOptions
   ): Promise<R2Object>;
+  put(
+    key: string,
+    value:
+      | ReadableStream
+      | ArrayBuffer
+      | ArrayBufferView
+      | string
+      | null
+      | Blob,
+    options?: R2PutOptions & {
+      onlyIf: R2Conditional | Headers;
+    }
+  ): Promise<R2Object | null>;
   createMultipartUpload(
     key: string,
     options?: R2MultipartOptions
@@ -1543,6 +1560,8 @@ declare interface TraceItem {
         | TraceItemFetchEventInfo
         | TraceItemScheduledEventInfo
         | TraceItemAlarmEventInfo
+        | TraceItemQueueEventInfo
+        | TraceItemEmailEventInfo
         | TraceItemCustomEventInfo
       )
     | null;
@@ -1551,6 +1570,7 @@ declare interface TraceItem {
   readonly exceptions: TraceException[];
   readonly scriptName: string | null;
   readonly dispatchNamespace?: string;
+  readonly scriptTags?: string[];
   readonly outcome: string;
 }
 declare interface TraceItemAlarmEventInfo {
@@ -1561,6 +1581,15 @@ declare interface TraceItemScheduledEventInfo {
   readonly scheduledTime: number;
   readonly cron: string;
 }
+declare interface TraceItemQueueEventInfo {
+  readonly queue: string;
+  readonly batchSize: number;
+}
+declare interface TraceItemEmailEventInfo {
+  readonly mailFrom: string;
+  readonly rcptTo: string;
+  readonly rawSize: number;
+}
 declare interface TraceItemFetchEventInfo {
   readonly response?: TraceItemFetchEventInfoResponse;
   readonly request: TraceItemFetchEventInfoRequest;
@@ -1742,15 +1771,6 @@ declare const WebSocketPair: {
     1: WebSocket;
   };
 };
-declare interface Socket {
-  readonly readable: ReadableStream;
-  readonly writable: WritableStream;
-  readonly closed: Promise<void>;
-  close(): Promise<void>;
-}
-declare interface SocketOptions {
-  tsl: boolean;
-}
 declare interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.
@@ -2695,6 +2715,52 @@ declare abstract class D1PreparedStatement {
   all<T = unknown>(): Promise<D1Result<T>>;
   raw<T = unknown>(): Promise<T[]>;
 }
+/**
+ * A email message that is sent to a consumer Worker.
+ */
+declare interface EmailMessage<Body = unknown> {
+  /**
+   * Envelope From attribute of the email message.
+   */
+  readonly from: string;
+  /**
+   * Envelope To attribute of the email message.
+   */
+  readonly to: string;
+  /**
+   * A [Headers object](https://developer.mozilla.org/en-US/docs/Web/API/Headers).
+   */
+  readonly headers: Headers;
+  /**
+   * Stream of the email message content.
+   */
+  readonly raw: ReadableStream;
+  /**
+   * Size of the email message content.
+   */
+  readonly rawSize: number;
+  /**
+   * Reject this email message by returning a permanent SMTP error back to the connecting client including the given reason.
+   * @param reason The reject reason.
+   * @returns void
+   */
+  setReject(reason: string): void;
+  /**
+   * Forward this email message to a verified destination address of the account.
+   * @param rcptTo Verified destination address.
+   * @param headers A [Headers object](https://developer.mozilla.org/en-US/docs/Web/API/Headers).
+   * @returns A promise that resolves when the email message is forwarded.
+   */
+  forward(rcptTo: string, headers?: Headers): Promise<void>;
+}
+declare abstract class EmailEvent extends ExtendableEvent {
+  readonly message: EmailMessage;
+}
+declare type EmailExportedHandler<Env = unknown> = (
+  message: EmailMessage,
+  env: Env,
+  ctx: ExecutionContext
+) => void | Promise<void>;
 declare type Params<P extends string = any> = Record<P, string | string[]>;
 declare type EventContext<Env, P extends string, Data> = {
   request: Request;
@@ -2741,6 +2807,40 @@ declare type PagesPluginFunction<
 declare module "assets:*" {
   export const onRequest: PagesFunction;
 }
+// https://developers.cloudflare.com/pub-sub/
+// PubSubMessage represents an incoming PubSub message.
+// The message includes metadata about the broker, the client, and the payload
+// itself.
+declare interface PubSubMessage {
+  // Message ID
+  readonly mid: number;
+  // MQTT broker FQDN in the form mqtts://BROKER.NAMESPACE.cloudflarepubsub.com:PORT
+  readonly broker: string;
+  // The MQTT topic the message was sent on.
+  readonly topic: string;
+  // The client ID of the client that published this message.
+  readonly clientId: string;
+  // The unique identifier (JWT ID) used by the client to authenticate, if token
+  // auth was used.
+  readonly jti?: string;
+  // A Unix timestamp (seconds from Jan 1, 1970), set when the Pub/Sub Broker
+  // received the message from the client.
+  readonly receivedAt: number;
+  // An (optional) string with the MIME type of the payload, if set by the
+  // client.
+  readonly contentType: string;
+  // Set to 1 when the payload is a UTF-8 string
+  // https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc3901063
+  readonly payloadFormatIndicator: number;
+  // Pub/Sub (MQTT) payloads can be UTF-8 strings, or byte arrays.
+  // You can use payloadFormatIndicator to inspect this before decoding.
+  payload: string | Uint8Array;
+}
+// JsonWebKey extended by kid parameter
+declare interface JsonWebKeyWithKid extends JsonWebKey {
+  // Key Identifier of the JWK
+  readonly kid: string;
+}
 /**
  * A message that is sent to a consumer Worker.
  */
@@ -2775,6 +2875,15 @@ declare interface MessageBatch<Body = unknown> {
    */
   retryAll(): void;
 }
+/**
+ * A wrapper class used to structure message batches.
+ */
+declare type MessageSendRequest<Body = unknown> = {
+  /**
+   * The body of the message.
+   */
+  body: Body;
+};
 /**
  * A binding that allows a producer to send messages to a Queue.
  */
@@ -2785,4 +2894,10 @@ declare interface Queue<Body = any> {
    * @returns A promise that resolves when the message is confirmed to be written to disk.
    */
   send(message: Body): Promise<void>;
+  /**
+   * Sends a batch of messages to the Queue.
+   * @param messages Each item in the input must be supported by the [structured clone algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm#supported_types). A batch can contain up to 100 messages, though items are limited to 128 KB each, and the total size of the array cannot exceed 256 KB.
+   * @returns A promise that resolves when the messages are confirmed to be written to disk.
+   */
+  sendBatch(messages: Iterable<MessageSendRequest<Body>>): Promise<void>;
 }

package/experimental/index.ts

@@ -233,7 +233,6 @@ export interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
   FixedLengthStream: typeof FixedLengthStream;
   IdentityTransformStream: typeof IdentityTransformStream;
   HTMLRewriter: typeof HTMLRewriter;
-  connect(address: string, options?: SocketOptions): Socket;
 }
 export declare function addEventListener<
   Type extends keyof WorkerGlobalScopeEventMap
@@ -289,12 +288,8 @@ export declare const crypto: Crypto;
 export declare const caches: CacheStorage;
 export declare const scheduler: Scheduler;
 export declare const navigator: Navigator;
-export declare function connect(
-  address: string,
-  options?: SocketOptions
-): Socket;
 export interface ExecutionContext {
-  waitUntil(promise: void | Promise<void>): void;
+  waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
 }
 export type ExportedHandlerFetchHandler<Env = unknown> = (
@@ -352,13 +347,20 @@ export interface DurableObjectNamespace {
   ): DurableObjectId;
   idFromName(name: string): DurableObjectId;
   idFromString(id: string): DurableObjectId;
-  get(id: DurableObjectId): DurableObjectStub;
+  get(
+    id: DurableObjectId,
+    options?: DurableObjectNamespaceGetDurableObjectOptions
+  ): DurableObjectStub;
+  jurisdiction(jurisdiction: string): DurableObjectNamespace;
 }
 export interface DurableObjectNamespaceNewUniqueIdOptions {
   jurisdiction?: string;
 }
+export interface DurableObjectNamespaceGetDurableObjectOptions {
+  locationHint?: string;
+}
 export interface DurableObjectState {
-  waitUntil(promise: void | Promise<void>): void;
+  waitUntil(promise: Promise<any>): void;
   readonly id: DurableObjectId;
   readonly storage: DurableObjectStorage;
   blockConcurrencyWhile<T>(callback: () => Promise<T>): Promise<T>;
@@ -548,7 +550,7 @@ export interface SchedulerWaitOptions {
   signal?: AbortSignal;
 }
 export declare abstract class ExtendableEvent extends Event {
-  waitUntil(promise: void | Promise<void>): void;
+  waitUntil(promise: Promise<any>): void;
 }
 export declare class Blob {
   constructor(
@@ -1018,7 +1020,6 @@ export declare abstract class Fetcher {
     input: RequestInfo,
     init?: RequestInit<RequestInitCfProperties>
   ): Promise<Response>;
-  connect(address: string, options?: SocketOptions): Socket;
 }
 export interface FetcherPutOptions {
   expiration?: number;
@@ -1166,6 +1167,19 @@ export declare abstract class R2Bucket {
       | Blob,
     options?: R2PutOptions
   ): Promise<R2Object>;
+  put(
+    key: string,
+    value:
+      | ReadableStream
+      | ArrayBuffer
+      | ArrayBufferView
+      | string
+      | null
+      | Blob,
+    options?: R2PutOptions & {
+      onlyIf: R2Conditional | Headers;
+    }
+  ): Promise<R2Object | null>;
   createMultipartUpload(
     key: string,
     options?: R2MultipartOptions
@@ -1551,6 +1565,8 @@ export interface TraceItem {
         | TraceItemFetchEventInfo
         | TraceItemScheduledEventInfo
         | TraceItemAlarmEventInfo
+        | TraceItemQueueEventInfo
+        | TraceItemEmailEventInfo
         | TraceItemCustomEventInfo
       )
     | null;
@@ -1559,6 +1575,7 @@ export interface TraceItem {
   readonly exceptions: TraceException[];
   readonly scriptName: string | null;
   readonly dispatchNamespace?: string;
+  readonly scriptTags?: string[];
   readonly outcome: string;
 }
 export interface TraceItemAlarmEventInfo {
@@ -1569,6 +1586,15 @@ export interface TraceItemScheduledEventInfo {
   readonly scheduledTime: number;
   readonly cron: string;
 }
+export interface TraceItemQueueEventInfo {
+  readonly queue: string;
+  readonly batchSize: number;
+}
+export interface TraceItemEmailEventInfo {
+  readonly mailFrom: string;
+  readonly rcptTo: string;
+  readonly rawSize: number;
+}
 export interface TraceItemFetchEventInfo {
   readonly response?: TraceItemFetchEventInfoResponse;
   readonly request: TraceItemFetchEventInfoRequest;
@@ -1750,15 +1776,6 @@ export declare const WebSocketPair: {
     1: WebSocket;
   };
 };
-export interface Socket {
-  readonly readable: ReadableStream;
-  readonly writable: WritableStream;
-  readonly closed: Promise<void>;
-  close(): Promise<void>;
-}
-export interface SocketOptions {
-  tsl: boolean;
-}
 export interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.
@@ -2703,6 +2720,52 @@ export declare abstract class D1PreparedStatement {
   all<T = unknown>(): Promise<D1Result<T>>;
   raw<T = unknown>(): Promise<T[]>;
 }
+/**
+ * A email message that is sent to a consumer Worker.
+ */
+export interface EmailMessage<Body = unknown> {
+  /**
+   * Envelope From attribute of the email message.
+   */
+  readonly from: string;
+  /**
+   * Envelope To attribute of the email message.
+   */
+  readonly to: string;
+  /**
+   * A [Headers object](https://developer.mozilla.org/en-US/docs/Web/API/Headers).
+   */
+  readonly headers: Headers;
+  /**
+   * Stream of the email message content.
+   */
+  readonly raw: ReadableStream;
+  /**
+   * Size of the email message content.
+   */
+  readonly rawSize: number;
+  /**
+   * Reject this email message by returning a permanent SMTP error back to the connecting client including the given reason.
+   * @param reason The reject reason.
+   * @returns void
+   */
+  setReject(reason: string): void;
+  /**
+   * Forward this email message to a verified destination address of the account.
+   * @param rcptTo Verified destination address.
+   * @param headers A [Headers object](https://developer.mozilla.org/en-US/docs/Web/API/Headers).
+   * @returns A promise that resolves when the email message is forwarded.
+   */
+  forward(rcptTo: string, headers?: Headers): Promise<void>;
+}
+export declare abstract class EmailEvent extends ExtendableEvent {
+  readonly message: EmailMessage;
+}
+export type EmailExportedHandler<Env = unknown> = (
+  message: EmailMessage,
+  env: Env,
+  ctx: ExecutionContext
+) => void | Promise<void>;
 export type Params<P extends string = any> = Record<P, string | string[]>;
 export type EventContext<Env, P extends string, Data> = {
   request: Request;
@@ -2746,6 +2809,40 @@ export type PagesPluginFunction<
 > = (
   context: EventPluginContext<Env, Params, Data, PluginArgs>
 ) => Response | Promise<Response>;
+// https://developers.cloudflare.com/pub-sub/
+// PubSubMessage represents an incoming PubSub message.
+// The message includes metadata about the broker, the client, and the payload
+// itself.
+export interface PubSubMessage {
+  // Message ID
+  readonly mid: number;
+  // MQTT broker FQDN in the form mqtts://BROKER.NAMESPACE.cloudflarepubsub.com:PORT
+  readonly broker: string;
+  // The MQTT topic the message was sent on.
+  readonly topic: string;
+  // The client ID of the client that published this message.
+  readonly clientId: string;
+  // The unique identifier (JWT ID) used by the client to authenticate, if token
+  // auth was used.
+  readonly jti?: string;
+  // A Unix timestamp (seconds from Jan 1, 1970), set when the Pub/Sub Broker
+  // received the message from the client.
+  readonly receivedAt: number;
+  // An (optional) string with the MIME type of the payload, if set by the
+  // client.
+  readonly contentType: string;
+  // Set to 1 when the payload is a UTF-8 string
+  // https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc3901063
+  readonly payloadFormatIndicator: number;
+  // Pub/Sub (MQTT) payloads can be UTF-8 strings, or byte arrays.
+  // You can use payloadFormatIndicator to inspect this before decoding.
+  payload: string | Uint8Array;
+}
+// JsonWebKey extended by kid parameter
+export interface JsonWebKeyWithKid extends JsonWebKey {
+  // Key Identifier of the JWK
+  readonly kid: string;
+}
 /**
  * A message that is sent to a consumer Worker.
  */
@@ -2780,6 +2877,15 @@ export interface MessageBatch<Body = unknown> {
    */
   retryAll(): void;
 }
+/**
+ * A wrapper class used to structure message batches.
+ */
+export type MessageSendRequest<Body = unknown> = {
+  /**
+   * The body of the message.
+   */
+  body: Body;
+};
 /**
  * A binding that allows a producer to send messages to a Queue.
  */
@@ -2790,4 +2896,10 @@ export interface Queue<Body = any> {
    * @returns A promise that resolves when the message is confirmed to be written to disk.
    */
   send(message: Body): Promise<void>;
+  /**
+   * Sends a batch of messages to the Queue.
+   * @param messages Each item in the input must be supported by the [structured clone algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm#supported_types). A batch can contain up to 100 messages, though items are limited to 128 KB each, and the total size of the array cannot exceed 256 KB.
+   * @returns A promise that resolves when the messages are confirmed to be written to disk.
+   */
+  sendBatch(messages: Iterable<MessageSendRequest<Body>>): Promise<void>;
 }