@cloudflare/workers-types 4.20230518.0 → 4.20230710.0

package/index.d.ts

@@ -213,6 +213,7 @@ declare interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
   Response: typeof Response;
   WebSocket: typeof WebSocket;
   WebSocketPair: typeof WebSocketPair;
+  WebSocketRequestResponsePair: typeof WebSocketRequestResponsePair;
   AbortController: typeof AbortController;
   AbortSignal: typeof AbortSignal;
   TextDecoder: typeof TextDecoder;
@@ -325,7 +326,7 @@ declare type ExportedHandlerTestHandler<Env = unknown> = (
 ) => void | Promise<void>;
 declare interface ExportedHandler<
   Env = unknown,
-  QueueMessage = unknown,
+  QueueHandlerMessage = unknown,
   CfHostMetadata = unknown
 > {
   fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata>;
@@ -333,7 +334,8 @@ declare interface ExportedHandler<
   trace?: ExportedHandlerTraceHandler<Env>;
   scheduled?: ExportedHandlerScheduledHandler<Env>;
   test?: ExportedHandlerTestHandler<Env>;
-  queue?: ExportedHandlerQueueHandler<Env, Message>;
+  email?: EmailExportedHandler<Env>;
+  queue?: ExportedHandlerQueueHandler<Env, QueueHandlerMessage>;
 }
 declare interface StructuredSerializeOptions {
   transfer?: any[];
@@ -350,6 +352,17 @@ declare interface Performance {
 declare interface DurableObject {
   fetch(request: Request): Response | Promise<Response>;
   alarm?(): void | Promise<void>;
+  webSocketMessage(
+    ws: WebSocket,
+    message: string | ArrayBuffer
+  ): void | Promise<void>;
+  webSocketClose(
+    ws: WebSocket,
+    code: number,
+    reason: string,
+    wasClean: boolean
+  ): void | Promise<void>;
+  webSocketError(ws: WebSocket, error: unknown): void | Promise<void>;
 }
 declare interface DurableObjectStub extends Fetcher {
   readonly id: DurableObjectId;
@@ -396,6 +409,9 @@ declare interface DurableObjectState {
   blockConcurrencyWhile<T>(callback: () => Promise<T>): Promise<T>;
   acceptWebSocket(ws: WebSocket, tags?: string[]): void;
   getWebSockets(tag?: string): WebSocket[];
+  setWebSocketAutoResponse(maybeReqResp?: WebSocketRequestResponsePair): void;
+  getWebSocketAutoResponse(): WebSocketRequestResponsePair | null;
+  getWebSocketAutoResponseTimestamp(ws: WebSocket): Date | null;
 }
 declare interface DurableObjectTransaction {
   get<T = unknown>(
@@ -490,6 +506,11 @@ declare interface DurableObjectSetAlarmOptions {
   allowConcurrency?: boolean;
   allowUnconfirmed?: boolean;
 }
+declare class WebSocketRequestResponsePair {
+  constructor(request: string, response: string);
+  get request(): string;
+  get response(): string;
+}
 declare interface AnalyticsEngineDataset {
   writeDataPoint(event?: AnalyticsEngineDataPoint): void;
 }
@@ -1670,6 +1691,7 @@ declare interface TraceItem {
   readonly eventTimestamp: number | null;
   readonly logs: TraceLog[];
   readonly exceptions: TraceException[];
+  readonly diagnosticsChannelEvents: TraceDiagnosticChannelEvent[];
   readonly scriptName: string | null;
   readonly dispatchNamespace?: string;
   readonly scriptTags?: string[];
@@ -1716,6 +1738,11 @@ declare interface TraceException {
   readonly message: string;
   readonly name: string;
 }
+declare interface TraceDiagnosticChannelEvent {
+  readonly timestamp: number;
+  readonly channel: string;
+  readonly message: any;
+}
 declare interface TraceMetrics {
   readonly cpuTime: number;
   readonly wallTime: number;
@@ -2863,25 +2890,36 @@ declare type ContinentCode = "AF" | "AN" | "AS" | "EU" | "NA" | "OC" | "SA";
 declare type CfProperties<HostMetadata = unknown> =
   | IncomingRequestCfProperties<HostMetadata>
   | RequestInitCfProperties;
+// Copyright (c) 2022-2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 declare interface D1Result<T = unknown> {
-  results?: T[];
-  success: boolean;
-  error?: string;
+  results: T[];
+  success: true;
   meta: any;
+  error?: never;
+}
+declare interface D1ExecResult {
+  count: number;
+  duration: number;
 }
 declare abstract class D1Database {
   prepare(query: string): D1PreparedStatement;
   dump(): Promise<ArrayBuffer>;
   batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
-  exec<T = unknown>(query: string): Promise<D1Result<T>>;
+  exec<T = unknown>(query: string): Promise<D1ExecResult>;
 }
 declare abstract class D1PreparedStatement {
   bind(...values: any[]): D1PreparedStatement;
-  first<T = unknown>(colName?: string): Promise<T>;
+  first<T = unknown>(colName: string): Promise<T | null>;
+  first<T = unknown>(): Promise<Record<string, T> | null>;
   run<T = unknown>(): Promise<D1Result<T>>;
-  all<T = unknown>(): Promise<D1Result<T>>;
+  all<T = unknown>(): Promise<D1Result<T[]>>;
   raw<T = unknown>(): Promise<T[]>;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 /**
  * An email message that can be sent from a Worker.
  */
@@ -2946,6 +2984,9 @@ declare module "cloudflare:email" {
   };
   export { _EmailMessage as EmailMessage };
 }
+// Copyright (c) 2022-2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 declare type Params<P extends string = any> = Record<P, string | string[]>;
 declare type EventContext<Env, P extends string, Data> = {
   request: Request;
@@ -2992,6 +3033,9 @@ declare type PagesPluginFunction<
 declare module "assets:*" {
   export const onRequest: PagesFunction;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 // https://developers.cloudflare.com/pub-sub/
 // PubSubMessage represents an incoming PubSub message.
 // The message includes metadata about the broker, the client, and the payload
@@ -3026,6 +3070,9 @@ declare interface JsonWebKeyWithKid extends JsonWebKey {
   // Key Identifier of the JWK
   readonly kid: string;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 declare module "cloudflare:sockets" {
   function _connect(
     address: string | SocketAddress,
@@ -3033,6 +3080,9 @@ declare module "cloudflare:sockets" {
   ): Socket;
   export { _connect as connect };
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 // https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/
 declare interface DynamicDispatchLimits {
   /**

package/index.ts

@@ -213,6 +213,7 @@ export interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
   Response: typeof Response;
   WebSocket: typeof WebSocket;
   WebSocketPair: typeof WebSocketPair;
+  WebSocketRequestResponsePair: typeof WebSocketRequestResponsePair;
   AbortController: typeof AbortController;
   AbortSignal: typeof AbortSignal;
   TextDecoder: typeof TextDecoder;
@@ -327,7 +328,7 @@ export type ExportedHandlerTestHandler<Env = unknown> = (
 ) => void | Promise<void>;
 export interface ExportedHandler<
   Env = unknown,
-  QueueMessage = unknown,
+  QueueHandlerMessage = unknown,
   CfHostMetadata = unknown
 > {
   fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata>;
@@ -335,7 +336,8 @@ export interface ExportedHandler<
   trace?: ExportedHandlerTraceHandler<Env>;
   scheduled?: ExportedHandlerScheduledHandler<Env>;
   test?: ExportedHandlerTestHandler<Env>;
-  queue?: ExportedHandlerQueueHandler<Env, Message>;
+  email?: EmailExportedHandler<Env>;
+  queue?: ExportedHandlerQueueHandler<Env, QueueHandlerMessage>;
 }
 export interface StructuredSerializeOptions {
   transfer?: any[];
@@ -352,6 +354,17 @@ export interface Performance {
 export interface DurableObject {
   fetch(request: Request): Response | Promise<Response>;
   alarm?(): void | Promise<void>;
+  webSocketMessage(
+    ws: WebSocket,
+    message: string | ArrayBuffer
+  ): void | Promise<void>;
+  webSocketClose(
+    ws: WebSocket,
+    code: number,
+    reason: string,
+    wasClean: boolean
+  ): void | Promise<void>;
+  webSocketError(ws: WebSocket, error: unknown): void | Promise<void>;
 }
 export interface DurableObjectStub extends Fetcher {
   readonly id: DurableObjectId;
@@ -398,6 +411,9 @@ export interface DurableObjectState {
   blockConcurrencyWhile<T>(callback: () => Promise<T>): Promise<T>;
   acceptWebSocket(ws: WebSocket, tags?: string[]): void;
   getWebSockets(tag?: string): WebSocket[];
+  setWebSocketAutoResponse(maybeReqResp?: WebSocketRequestResponsePair): void;
+  getWebSocketAutoResponse(): WebSocketRequestResponsePair | null;
+  getWebSocketAutoResponseTimestamp(ws: WebSocket): Date | null;
 }
 export interface DurableObjectTransaction {
   get<T = unknown>(
@@ -492,6 +508,11 @@ export interface DurableObjectSetAlarmOptions {
   allowConcurrency?: boolean;
   allowUnconfirmed?: boolean;
 }
+export declare class WebSocketRequestResponsePair {
+  constructor(request: string, response: string);
+  get request(): string;
+  get response(): string;
+}
 export interface AnalyticsEngineDataset {
   writeDataPoint(event?: AnalyticsEngineDataPoint): void;
 }
@@ -1675,6 +1696,7 @@ export interface TraceItem {
   readonly eventTimestamp: number | null;
   readonly logs: TraceLog[];
   readonly exceptions: TraceException[];
+  readonly diagnosticsChannelEvents: TraceDiagnosticChannelEvent[];
   readonly scriptName: string | null;
   readonly dispatchNamespace?: string;
   readonly scriptTags?: string[];
@@ -1721,6 +1743,11 @@ export interface TraceException {
   readonly message: string;
   readonly name: string;
 }
+export interface TraceDiagnosticChannelEvent {
+  readonly timestamp: number;
+  readonly channel: string;
+  readonly message: any;
+}
 export interface TraceMetrics {
   readonly cpuTime: number;
   readonly wallTime: number;
@@ -2868,25 +2895,36 @@ export type ContinentCode = "AF" | "AN" | "AS" | "EU" | "NA" | "OC" | "SA";
 export type CfProperties<HostMetadata = unknown> =
   | IncomingRequestCfProperties<HostMetadata>
   | RequestInitCfProperties;
+// Copyright (c) 2022-2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 export interface D1Result<T = unknown> {
-  results?: T[];
-  success: boolean;
-  error?: string;
+  results: T[];
+  success: true;
   meta: any;
+  error?: never;
+}
+export interface D1ExecResult {
+  count: number;
+  duration: number;
 }
 export declare abstract class D1Database {
   prepare(query: string): D1PreparedStatement;
   dump(): Promise<ArrayBuffer>;
   batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
-  exec<T = unknown>(query: string): Promise<D1Result<T>>;
+  exec<T = unknown>(query: string): Promise<D1ExecResult>;
 }
 export declare abstract class D1PreparedStatement {
   bind(...values: any[]): D1PreparedStatement;
-  first<T = unknown>(colName?: string): Promise<T>;
+  first<T = unknown>(colName: string): Promise<T | null>;
+  first<T = unknown>(): Promise<Record<string, T> | null>;
   run<T = unknown>(): Promise<D1Result<T>>;
-  all<T = unknown>(): Promise<D1Result<T>>;
+  all<T = unknown>(): Promise<D1Result<T[]>>;
   raw<T = unknown>(): Promise<T[]>;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 /**
  * An email message that can be sent from a Worker.
  */
@@ -2944,6 +2982,9 @@ export type EmailExportedHandler<Env = unknown> = (
   env: Env,
   ctx: ExecutionContext
 ) => void | Promise<void>;
+// Copyright (c) 2022-2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 export type Params<P extends string = any> = Record<P, string | string[]>;
 export type EventContext<Env, P extends string, Data> = {
   request: Request;
@@ -2987,6 +3028,9 @@ export type PagesPluginFunction<
 > = (
   context: EventPluginContext<Env, Params, Data, PluginArgs>
 ) => Response | Promise<Response>;
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 // https://developers.cloudflare.com/pub-sub/
 // PubSubMessage represents an incoming PubSub message.
 // The message includes metadata about the broker, the client, and the payload
@@ -3021,6 +3065,9 @@ export interface JsonWebKeyWithKid extends JsonWebKey {
   // Key Identifier of the JWK
   readonly kid: string;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 // https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/
 export interface DynamicDispatchLimits {
   /**

package/oldest/index.d.ts

@@ -213,6 +213,7 @@ declare interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
   Response: typeof Response;
   WebSocket: typeof WebSocket;
   WebSocketPair: typeof WebSocketPair;
+  WebSocketRequestResponsePair: typeof WebSocketRequestResponsePair;
   AbortController: typeof AbortController;
   AbortSignal: typeof AbortSignal;
   TextDecoder: typeof TextDecoder;
@@ -325,7 +326,7 @@ declare type ExportedHandlerTestHandler<Env = unknown> = (
 ) => void | Promise<void>;
 declare interface ExportedHandler<
   Env = unknown,
-  QueueMessage = unknown,
+  QueueHandlerMessage = unknown,
   CfHostMetadata = unknown
 > {
   fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata>;
@@ -333,7 +334,8 @@ declare interface ExportedHandler<
   trace?: ExportedHandlerTraceHandler<Env>;
   scheduled?: ExportedHandlerScheduledHandler<Env>;
   test?: ExportedHandlerTestHandler<Env>;
-  queue?: ExportedHandlerQueueHandler<Env, Message>;
+  email?: EmailExportedHandler<Env>;
+  queue?: ExportedHandlerQueueHandler<Env, QueueHandlerMessage>;
 }
 declare interface StructuredSerializeOptions {
   transfer?: any[];
@@ -350,6 +352,17 @@ declare interface Performance {
 declare interface DurableObject {
   fetch(request: Request): Response | Promise<Response>;
   alarm?(): void | Promise<void>;
+  webSocketMessage(
+    ws: WebSocket,
+    message: string | ArrayBuffer
+  ): void | Promise<void>;
+  webSocketClose(
+    ws: WebSocket,
+    code: number,
+    reason: string,
+    wasClean: boolean
+  ): void | Promise<void>;
+  webSocketError(ws: WebSocket, error: unknown): void | Promise<void>;
 }
 declare interface DurableObjectStub extends Fetcher {
   readonly id: DurableObjectId;
@@ -396,6 +409,9 @@ declare interface DurableObjectState {
   blockConcurrencyWhile<T>(callback: () => Promise<T>): Promise<T>;
   acceptWebSocket(ws: WebSocket, tags?: string[]): void;
   getWebSockets(tag?: string): WebSocket[];
+  setWebSocketAutoResponse(maybeReqResp?: WebSocketRequestResponsePair): void;
+  getWebSocketAutoResponse(): WebSocketRequestResponsePair | null;
+  getWebSocketAutoResponseTimestamp(ws: WebSocket): Date | null;
 }
 declare interface DurableObjectTransaction {
   get<T = unknown>(
@@ -490,6 +506,11 @@ declare interface DurableObjectSetAlarmOptions {
   allowConcurrency?: boolean;
   allowUnconfirmed?: boolean;
 }
+declare class WebSocketRequestResponsePair {
+  constructor(request: string, response: string);
+  get request(): string;
+  get response(): string;
+}
 declare interface AnalyticsEngineDataset {
   writeDataPoint(event?: AnalyticsEngineDataPoint): void;
 }
@@ -1670,6 +1691,7 @@ declare interface TraceItem {
   readonly eventTimestamp: number | null;
   readonly logs: TraceLog[];
   readonly exceptions: TraceException[];
+  readonly diagnosticsChannelEvents: TraceDiagnosticChannelEvent[];
   readonly scriptName: string | null;
   readonly dispatchNamespace?: string;
   readonly scriptTags?: string[];
@@ -1716,6 +1738,11 @@ declare interface TraceException {
   readonly message: string;
   readonly name: string;
 }
+declare interface TraceDiagnosticChannelEvent {
+  readonly timestamp: number;
+  readonly channel: string;
+  readonly message: any;
+}
 declare interface TraceMetrics {
   readonly cpuTime: number;
   readonly wallTime: number;
@@ -2863,25 +2890,36 @@ declare type ContinentCode = "AF" | "AN" | "AS" | "EU" | "NA" | "OC" | "SA";
 declare type CfProperties<HostMetadata = unknown> =
   | IncomingRequestCfProperties<HostMetadata>
   | RequestInitCfProperties;
+// Copyright (c) 2022-2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 declare interface D1Result<T = unknown> {
-  results?: T[];
-  success: boolean;
-  error?: string;
+  results: T[];
+  success: true;
   meta: any;
+  error?: never;
+}
+declare interface D1ExecResult {
+  count: number;
+  duration: number;
 }
 declare abstract class D1Database {
   prepare(query: string): D1PreparedStatement;
   dump(): Promise<ArrayBuffer>;
   batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
-  exec<T = unknown>(query: string): Promise<D1Result<T>>;
+  exec<T = unknown>(query: string): Promise<D1ExecResult>;
 }
 declare abstract class D1PreparedStatement {
   bind(...values: any[]): D1PreparedStatement;
-  first<T = unknown>(colName?: string): Promise<T>;
+  first<T = unknown>(colName: string): Promise<T | null>;
+  first<T = unknown>(): Promise<Record<string, T> | null>;
   run<T = unknown>(): Promise<D1Result<T>>;
-  all<T = unknown>(): Promise<D1Result<T>>;
+  all<T = unknown>(): Promise<D1Result<T[]>>;
   raw<T = unknown>(): Promise<T[]>;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 /**
  * An email message that can be sent from a Worker.
  */
@@ -2946,6 +2984,9 @@ declare module "cloudflare:email" {
   };
   export { _EmailMessage as EmailMessage };
 }
+// Copyright (c) 2022-2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 declare type Params<P extends string = any> = Record<P, string | string[]>;
 declare type EventContext<Env, P extends string, Data> = {
   request: Request;
@@ -2992,6 +3033,9 @@ declare type PagesPluginFunction<
 declare module "assets:*" {
   export const onRequest: PagesFunction;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 // https://developers.cloudflare.com/pub-sub/
 // PubSubMessage represents an incoming PubSub message.
 // The message includes metadata about the broker, the client, and the payload
@@ -3026,6 +3070,9 @@ declare interface JsonWebKeyWithKid extends JsonWebKey {
   // Key Identifier of the JWK
   readonly kid: string;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 declare module "cloudflare:sockets" {
   function _connect(
     address: string | SocketAddress,
@@ -3033,6 +3080,9 @@ declare module "cloudflare:sockets" {
   ): Socket;
   export { _connect as connect };
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 // https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/
 declare interface DynamicDispatchLimits {
   /**

package/oldest/index.ts

@@ -213,6 +213,7 @@ export interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
   Response: typeof Response;
   WebSocket: typeof WebSocket;
   WebSocketPair: typeof WebSocketPair;
+  WebSocketRequestResponsePair: typeof WebSocketRequestResponsePair;
   AbortController: typeof AbortController;
   AbortSignal: typeof AbortSignal;
   TextDecoder: typeof TextDecoder;
@@ -327,7 +328,7 @@ export type ExportedHandlerTestHandler<Env = unknown> = (
 ) => void | Promise<void>;
 export interface ExportedHandler<
   Env = unknown,
-  QueueMessage = unknown,
+  QueueHandlerMessage = unknown,
   CfHostMetadata = unknown
 > {
   fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata>;
@@ -335,7 +336,8 @@ export interface ExportedHandler<
   trace?: ExportedHandlerTraceHandler<Env>;
   scheduled?: ExportedHandlerScheduledHandler<Env>;
   test?: ExportedHandlerTestHandler<Env>;
-  queue?: ExportedHandlerQueueHandler<Env, Message>;
+  email?: EmailExportedHandler<Env>;
+  queue?: ExportedHandlerQueueHandler<Env, QueueHandlerMessage>;
 }
 export interface StructuredSerializeOptions {
   transfer?: any[];
@@ -352,6 +354,17 @@ export interface Performance {
 export interface DurableObject {
   fetch(request: Request): Response | Promise<Response>;
   alarm?(): void | Promise<void>;
+  webSocketMessage(
+    ws: WebSocket,
+    message: string | ArrayBuffer
+  ): void | Promise<void>;
+  webSocketClose(
+    ws: WebSocket,
+    code: number,
+    reason: string,
+    wasClean: boolean
+  ): void | Promise<void>;
+  webSocketError(ws: WebSocket, error: unknown): void | Promise<void>;
 }
 export interface DurableObjectStub extends Fetcher {
   readonly id: DurableObjectId;
@@ -398,6 +411,9 @@ export interface DurableObjectState {
   blockConcurrencyWhile<T>(callback: () => Promise<T>): Promise<T>;
   acceptWebSocket(ws: WebSocket, tags?: string[]): void;
   getWebSockets(tag?: string): WebSocket[];
+  setWebSocketAutoResponse(maybeReqResp?: WebSocketRequestResponsePair): void;
+  getWebSocketAutoResponse(): WebSocketRequestResponsePair | null;
+  getWebSocketAutoResponseTimestamp(ws: WebSocket): Date | null;
 }
 export interface DurableObjectTransaction {
   get<T = unknown>(
@@ -492,6 +508,11 @@ export interface DurableObjectSetAlarmOptions {
   allowConcurrency?: boolean;
   allowUnconfirmed?: boolean;
 }
+export declare class WebSocketRequestResponsePair {
+  constructor(request: string, response: string);
+  get request(): string;
+  get response(): string;
+}
 export interface AnalyticsEngineDataset {
   writeDataPoint(event?: AnalyticsEngineDataPoint): void;
 }
@@ -1675,6 +1696,7 @@ export interface TraceItem {
   readonly eventTimestamp: number | null;
   readonly logs: TraceLog[];
   readonly exceptions: TraceException[];
+  readonly diagnosticsChannelEvents: TraceDiagnosticChannelEvent[];
   readonly scriptName: string | null;
   readonly dispatchNamespace?: string;
   readonly scriptTags?: string[];
@@ -1721,6 +1743,11 @@ export interface TraceException {
   readonly message: string;
   readonly name: string;
 }
+export interface TraceDiagnosticChannelEvent {
+  readonly timestamp: number;
+  readonly channel: string;
+  readonly message: any;
+}
 export interface TraceMetrics {
   readonly cpuTime: number;
   readonly wallTime: number;
@@ -2868,25 +2895,36 @@ export type ContinentCode = "AF" | "AN" | "AS" | "EU" | "NA" | "OC" | "SA";
 export type CfProperties<HostMetadata = unknown> =
   | IncomingRequestCfProperties<HostMetadata>
   | RequestInitCfProperties;
+// Copyright (c) 2022-2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 export interface D1Result<T = unknown> {
-  results?: T[];
-  success: boolean;
-  error?: string;
+  results: T[];
+  success: true;
   meta: any;
+  error?: never;
+}
+export interface D1ExecResult {
+  count: number;
+  duration: number;
 }
 export declare abstract class D1Database {
   prepare(query: string): D1PreparedStatement;
   dump(): Promise<ArrayBuffer>;
   batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
-  exec<T = unknown>(query: string): Promise<D1Result<T>>;
+  exec<T = unknown>(query: string): Promise<D1ExecResult>;
 }
 export declare abstract class D1PreparedStatement {
   bind(...values: any[]): D1PreparedStatement;
-  first<T = unknown>(colName?: string): Promise<T>;
+  first<T = unknown>(colName: string): Promise<T | null>;
+  first<T = unknown>(): Promise<Record<string, T> | null>;
   run<T = unknown>(): Promise<D1Result<T>>;
-  all<T = unknown>(): Promise<D1Result<T>>;
+  all<T = unknown>(): Promise<D1Result<T[]>>;
   raw<T = unknown>(): Promise<T[]>;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 /**
  * An email message that can be sent from a Worker.
  */
@@ -2944,6 +2982,9 @@ export type EmailExportedHandler<Env = unknown> = (
   env: Env,
   ctx: ExecutionContext
 ) => void | Promise<void>;
+// Copyright (c) 2022-2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 export type Params<P extends string = any> = Record<P, string | string[]>;
 export type EventContext<Env, P extends string, Data> = {
   request: Request;
@@ -2987,6 +3028,9 @@ export type PagesPluginFunction<
 > = (
   context: EventPluginContext<Env, Params, Data, PluginArgs>
 ) => Response | Promise<Response>;
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 // https://developers.cloudflare.com/pub-sub/
 // PubSubMessage represents an incoming PubSub message.
 // The message includes metadata about the broker, the client, and the payload
@@ -3021,6 +3065,9 @@ export interface JsonWebKeyWithKid extends JsonWebKey {
   // Key Identifier of the JWK
   readonly kid: string;
 }
+// Copyright (c) 2023 Cloudflare, Inc.
+// Licensed under the Apache 2.0 license found in the LICENSE file or at:
+//     https://opensource.org/licenses/Apache-2.0
 // https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/
 export interface DynamicDispatchLimits {
   /**

package/package.json

@@ -7,5 +7,5 @@
   },
   "author": "Cloudflare Workers DevProd Team <workers-devprod@cloudflare.com> (https://workers.cloudflare.com)",
   "license": "MIT OR Apache-2.0",
-  "version": "4.20230518.0"
+  "version": "4.20230710.0"
 }