wrangler 0.0.0-e7a0cd5b → 0.0.0-e87ad068

package/wrangler-dist/cli.d.ts

@@ -1,10 +1,21 @@
 /// <reference types="node" />
 
 import { Blob as Blob_2 } from 'buffer';
-import Dispatcher = require('./dispatcher');
+import { ConnectionOptions } from 'tls';
+import { Duplex } from 'stream';
+import { EventEmitter } from 'events';
+import { IpcNetConnectOpts } from 'net';
+import { Readable } from 'stream';
 import { ReadableStream } from 'stream/web';
+import { Socket } from 'net';
+import { TcpNetConnectOpts } from 'net';
+import { TlsOptions } from 'tls';
+import { TLSSocket } from 'tls';
 import { URL as URL_2 } from 'url';
 import { URLSearchParams as URLSearchParams_2 } from 'url';
+import { Writable } from 'stream';
+
+declare type AbortSignal_2 = unknown;
 
 declare interface BlobPropertyBag {
     type?: string
@@ -33,6 +44,193 @@ declare interface BodyMixin {
     readonly text: () => Promise<string>
 }
 
+declare class BodyReadable extends Readable {
+    constructor(
+    resume?: (this: Readable, size: number) => void | null,
+    abort?: () => void | null,
+    contentType?: string
+    )
+
+    /** Consumes and returns the body as a string
+     *  https://fetch.spec.whatwg.org/#dom-body-text
+     */
+    text(): Promise<string>
+
+    /** Consumes and returns the body as a JavaScript Object
+     *  https://fetch.spec.whatwg.org/#dom-body-json
+     */
+    json(): Promise<any>
+
+    /** Consumes and returns the body as a Blob
+     *  https://fetch.spec.whatwg.org/#dom-body-blob
+     */
+    blob(): Promise<Blob_2>
+
+    /** Consumes and returns the body as an ArrayBuffer
+     *  https://fetch.spec.whatwg.org/#dom-body-arraybuffer
+     */
+    arrayBuffer(): Promise<ArrayBuffer>
+
+    /** Not implemented
+     *
+     *  https://fetch.spec.whatwg.org/#dom-body-formdata
+     */
+    formData(): Promise<never>
+
+    /** Returns true if the body is not null and the body has been consumed
+     *
+     *  Otherwise, returns false
+     *
+     * https://fetch.spec.whatwg.org/#dom-body-bodyused
+     */
+    readonly bodyUsed: boolean
+
+    /** Throws on node 16.6.0
+     *
+     *  If body is null, it should return null as the body
+     *
+     *  If body is not null, should return the body as a ReadableStream
+     *
+     *  https://fetch.spec.whatwg.org/#dom-body-body
+     */
+    readonly body: never | undefined
+
+    /** Dumps the response body by reading `limit` number of bytes.
+     * @param opts.limit Number of bytes to read (optional) - Default: 262144
+     */
+    dump(opts?: { limit: number }): Promise<void>
+}
+
+declare function buildConnector (options?: buildConnector.BuildOptions): buildConnector.connector
+
+declare namespace buildConnector {
+    type BuildOptions = (ConnectionOptions | TcpNetConnectOpts | IpcNetConnectOpts) & {
+        maxCachedSessions?: number | null;
+        socketPath?: string | null;
+        timeout?: number | null;
+        port?: number;
+        keepAlive?: boolean | null;
+        keepAliveInitialDelay?: number | null;
+    }
+
+    interface Options {
+        hostname: string
+        host?: string
+        protocol: string
+        port: string
+        servername?: string
+        localAddress?: string | null
+        httpSocket?: Socket
+    }
+
+    type Callback = (...args: CallbackArgs) => void
+    type CallbackArgs = [null, Socket | TLSSocket] | [Error, null]
+
+    type connector = connectorAsync | connectorSync
+
+    interface connectorSync {
+        (options: buildConnector.Options): Socket | TLSSocket
+    }
+
+    interface connectorAsync {
+        (options: buildConnector.Options, callback: buildConnector.Callback): void
+    }
+}
+
+/**
+ * An imported module.
+ */
+declare interface CfModule {
+    /**
+     * The module name.
+     *
+     * @example
+     * './src/index.js'
+     */
+    name: string;
+    /**
+     * The module content, usually JavaScript or WASM code.
+     *
+     * @example
+     * export default {
+     *   async fetch(request) {
+     *     return new Response('Ok')
+     *   }
+     * }
+     */
+    content: string | Buffer;
+    /**
+     * The module type.
+     *
+     * If absent, will default to the main module's type.
+     */
+    type?: CfModuleType;
+}
+
+/**
+ * A module type.
+ */
+declare type CfModuleType = "esm" | "commonjs" | "compiled-wasm" | "text" | "buffer";
+
+/** A basic HTTP/1.1 client, mapped on top a single TCP/TLS connection. Pipelining is disabled by default. */
+declare class Client extends Dispatcher {
+    constructor(url: string | URL_2, options?: Client.Options);
+    /** Property to get and set the pipelining factor. */
+    pipelining: number;
+    /** `true` after `client.close()` has been called. */
+    closed: boolean;
+    /** `true` after `client.destroyed()` has been called or `client.close()` has been called and the client shutdown has completed. */
+    destroyed: boolean;
+}
+
+declare namespace Client {
+    interface Options {
+        /** the timeout after which a socket without active requests will time out. Monitors time between activity on a connected socket. This value may be overridden by *keep-alive* hints from the server. Default: `4e3` milliseconds (4s). */
+        keepAliveTimeout?: number | null;
+        /** the maximum allowed `idleTimeout` when overridden by *keep-alive* hints from the server. Default: `600e3` milliseconds (10min). */
+        keepAliveMaxTimeout?: number | null;
+        /** A number subtracted from server *keep-alive* hints when overriding `idleTimeout` to account for timing inaccuracies caused by e.g. transport latency. Default: `1e3` milliseconds (1s). */
+        keepAliveTimeoutThreshold?: number | null;
+        /** The amount of concurrent requests to be sent over the single TCP/TLS connection according to [RFC7230](https://tools.ietf.org/html/rfc7230#section-6.3.2). Default: `1`. */
+        pipelining?: number | null;
+        /** **/
+        connect?: buildConnector.BuildOptions | buildConnector.connector | null;
+        /** The maximum length of request headers in bytes. Default: `16384` (16KiB). */
+        maxHeaderSize?: number | null;
+        /** The timeout after which a request will time out, in milliseconds. Monitors time between receiving body data. Use `0` to disable it entirely. Default: `300e3` milliseconds (300s). */
+        bodyTimeout?: number | null;
+        /** The amount of time the parser will wait to receive the complete HTTP headers (Node 14 and above only). Default: `300e3` milliseconds (300s). */
+        headersTimeout?: number | null;
+        /** If `true`, an error is thrown when the request content-length header doesn't match the length of the request body. Default: `true`. */
+        strictContentLength?: boolean;
+        /** @deprecated use the connect option instead */
+        tls?: TlsOptions | null;
+        /** */
+        maxRequestsPerClient?: number;
+        /** Max response body size in bytes, -1 is disabled */
+        maxResponseSize?: number | null;
+        /** Enables a family autodetection algorithm that loosely implements section 5 of RFC 8305. */
+        autoSelectFamily?: boolean;
+        /** The amount of time in milliseconds to wait for a connection attempt to finish before trying the next address when using the `autoSelectFamily` option. */
+        autoSelectFamilyAttemptTimeout?: number;
+
+        interceptors?: {Client: readonly Dispatcher[] | undefined}
+    }
+
+    interface SocketInfo {
+        localAddress?: string
+        localPort?: number
+        remoteAddress?: string
+        remotePort?: number
+        remoteFamily?: string
+        timeout?: number
+        bytesWritten?: number
+        bytesRead?: number
+    }
+
+
+}
+
 /**
  * The possible types for a `Rule`.
  */
@@ -43,6 +241,8 @@ declare type CustomDomainRoute = {
     custom_domain: boolean;
 };
 
+export declare function deleteMTlsCertificate(accountId: string, certificateId: string): Promise<unknown>;
+
 /**
  * Deprecated upload configuration.
  */
@@ -74,63 +274,242 @@ declare interface DeprecatedUpload {
     rules?: Environment["rules"];
 }
 
-declare interface DevApiOptions {
-    testMode?: boolean;
-    disableExperimentalWarning?: boolean;
+/** Dispatcher is the core API used to dispatch requests. */
+declare class Dispatcher extends EventEmitter {
+    /** Dispatches a request. This API is expected to evolve through semver-major versions and is less stable than the preceding higher level APIs. It is primarily intended for library developers who implement higher level APIs on top of this. */
+    dispatch(options: Dispatcher.DispatchOptions, handler: Dispatcher.DispatchHandlers): boolean;
+    /** Starts two-way communications with the requested resource. */
+    connect(options: Dispatcher.ConnectOptions): Promise<Dispatcher.ConnectData>;
+    connect(options: Dispatcher.ConnectOptions, callback: (err: Error | null, data: Dispatcher.ConnectData) => void): void;
+    /** Performs an HTTP request. */
+    request(options: Dispatcher.RequestOptions): Promise<Dispatcher.ResponseData>;
+    request(options: Dispatcher.RequestOptions, callback: (err: Error | null, data: Dispatcher.ResponseData) => void): void;
+    /** For easy use with `stream.pipeline`. */
+    pipeline(options: Dispatcher.PipelineOptions, handler: Dispatcher.PipelineHandler): Duplex;
+    /** A faster version of `Dispatcher.request`. */
+    stream(options: Dispatcher.RequestOptions, factory: Dispatcher.StreamFactory): Promise<Dispatcher.StreamData>;
+    stream(options: Dispatcher.RequestOptions, factory: Dispatcher.StreamFactory, callback: (err: Error | null, data: Dispatcher.StreamData) => void): void;
+    /** Upgrade to a different protocol. */
+    upgrade(options: Dispatcher.UpgradeOptions): Promise<Dispatcher.UpgradeData>;
+    upgrade(options: Dispatcher.UpgradeOptions, callback: (err: Error | null, data: Dispatcher.UpgradeData) => void): void;
+    /** Closes the client and gracefully waits for enqueued requests to complete before invoking the callback (or returning a promise if no callback is provided). */
+    close(): Promise<void>;
+    close(callback: () => void): void;
+    /** Destroy the client abruptly with the given err. All the pending and running requests will be asynchronously aborted and error. Waits until socket is closed before invoking the callback (or returning a promise if no callback is provided). Since this operation is asynchronously dispatched there might still be some progress on dispatched requests. */
+    destroy(): Promise<void>;
+    destroy(err: Error | null): Promise<void>;
+    destroy(callback: () => void): void;
+    destroy(err: Error | null, callback: () => void): void;
+
+    on(eventName: 'connect', callback: (origin: URL_2, targets: readonly Dispatcher[]) => void): this;
+    on(eventName: 'disconnect', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    on(eventName: 'connectionError', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    on(eventName: 'drain', callback: (origin: URL_2) => void): this;
+
+
+    once(eventName: 'connect', callback: (origin: URL_2, targets: readonly Dispatcher[]) => void): this;
+    once(eventName: 'disconnect', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    once(eventName: 'connectionError', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    once(eventName: 'drain', callback: (origin: URL_2) => void): this;
+
+
+    off(eventName: 'connect', callback: (origin: URL_2, targets: readonly Dispatcher[]) => void): this;
+    off(eventName: 'disconnect', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    off(eventName: 'connectionError', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    off(eventName: 'drain', callback: (origin: URL_2) => void): this;
+
+
+    addListener(eventName: 'connect', callback: (origin: URL_2, targets: readonly Dispatcher[]) => void): this;
+    addListener(eventName: 'disconnect', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    addListener(eventName: 'connectionError', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    addListener(eventName: 'drain', callback: (origin: URL_2) => void): this;
+
+    removeListener(eventName: 'connect', callback: (origin: URL_2, targets: readonly Dispatcher[]) => void): this;
+    removeListener(eventName: 'disconnect', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    removeListener(eventName: 'connectionError', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    removeListener(eventName: 'drain', callback: (origin: URL_2) => void): this;
+
+    prependListener(eventName: 'connect', callback: (origin: URL_2, targets: readonly Dispatcher[]) => void): this;
+    prependListener(eventName: 'disconnect', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    prependListener(eventName: 'connectionError', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    prependListener(eventName: 'drain', callback: (origin: URL_2) => void): this;
+
+    prependOnceListener(eventName: 'connect', callback: (origin: URL_2, targets: readonly Dispatcher[]) => void): this;
+    prependOnceListener(eventName: 'disconnect', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    prependOnceListener(eventName: 'connectionError', callback: (origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void): this;
+    prependOnceListener(eventName: 'drain', callback: (origin: URL_2) => void): this;
+
+    listeners(eventName: 'connect'): ((origin: URL_2, targets: readonly Dispatcher[]) => void)[]
+    listeners(eventName: 'disconnect'): ((origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void)[];
+    listeners(eventName: 'connectionError'): ((origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void)[];
+    listeners(eventName: 'drain'): ((origin: URL_2) => void)[];
+
+    rawListeners(eventName: 'connect'): ((origin: URL_2, targets: readonly Dispatcher[]) => void)[]
+    rawListeners(eventName: 'disconnect'): ((origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void)[];
+    rawListeners(eventName: 'connectionError'): ((origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError) => void)[];
+    rawListeners(eventName: 'drain'): ((origin: URL_2) => void)[];
+
+    emit(eventName: 'connect', origin: URL_2, targets: readonly Dispatcher[]): boolean;
+    emit(eventName: 'disconnect', origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError): boolean;
+    emit(eventName: 'connectionError', origin: URL_2, targets: readonly Dispatcher[], error: Errors.UndiciError): boolean;
+    emit(eventName: 'drain', origin: URL_2): boolean;
 }
 
-declare interface DevOptions {
-    config?: string;
-    env?: string;
-    ip?: string;
-    port?: number;
-    bundle?: boolean;
-    inspectorPort?: number;
-    localProtocol?: "http" | "https";
-    assets?: string;
-    site?: string;
-    siteInclude?: string[];
-    siteExclude?: string[];
-    nodeCompat?: boolean;
-    compatibilityDate?: string;
-    compatibilityFlags?: string[];
-    persist?: boolean;
-    persistTo?: string;
-    liveReload?: boolean;
-    watch?: boolean;
-    vars?: {
-        [key: string]: unknown;
-    };
-    kv?: {
-        binding: string;
-        id: string;
-        preview_id?: string;
-    }[];
-    durableObjects?: {
-        name: string;
-        class_name: string;
-        script_name?: string | undefined;
-        environment?: string | undefined;
-    }[];
-    r2?: {
-        binding: string;
-        bucket_name: string;
-        preview_bucket_name?: string;
-    }[];
-    d1Databases?: Environment["d1_databases"];
-    showInteractiveDevSession?: boolean;
-    logLevel?: "none" | "info" | "error" | "log" | "warn" | "debug";
-    logPrefix?: string;
-    inspect?: boolean;
-    local?: boolean;
-    forceLocal?: boolean;
-    enablePagesAssetsServiceBinding?: EnablePagesAssetsServiceBindingOptions;
-    _?: (string | number)[];
-    $0?: string;
-    testScheduled?: boolean;
-    experimentalLocal?: boolean;
+declare namespace Dispatcher {
+    interface DispatchOptions {
+        origin?: string | URL_2;
+        path: string;
+        method: HttpMethod;
+        /** Default: `null` */
+        body?: string | Buffer | Uint8Array | Readable | null | FormData;
+        /** Default: `null` */
+        headers?: IncomingHttpHeaders | string[] | null;
+        /** Query string params to be embedded in the request URL. Default: `null` */
+        query?: Record<string, any>;
+        /** Whether the requests can be safely retried or not. If `false` the request won't be sent until all preceding requests in the pipeline have completed. Default: `true` if `method` is `HEAD` or `GET`. */
+        idempotent?: boolean;
+        /** Whether the response is expected to take a long time and would end up blocking the pipeline. When this is set to `true` further pipelining will be avoided on the same connection until headers have been received. */
+        blocking?: boolean;
+        /** Upgrade the request. Should be used to specify the kind of upgrade i.e. `'Websocket'`. Default: `method === 'CONNECT' || null`. */
+        upgrade?: boolean | string | null;
+        /** The amount of time the parser will wait to receive the complete HTTP headers. Defaults to 300 seconds. */
+        headersTimeout?: number | null;
+        /** The timeout after which a request will time out, in milliseconds. Monitors time between receiving body data. Use 0 to disable it entirely. Defaults to 300 seconds. */
+        bodyTimeout?: number | null;
+        /** Whether the request should stablish a keep-alive or not. Default `false` */
+        reset?: boolean;
+        /** Whether Undici should throw an error upon receiving a 4xx or 5xx response from the server. Defaults to false */
+        throwOnError?: boolean;
+    }
+    interface ConnectOptions {
+        path: string;
+        /** Default: `null` */
+        headers?: IncomingHttpHeaders | string[] | null;
+        /** Default: `null` */
+        signal?: AbortSignal_2 | EventEmitter | null;
+        /** This argument parameter is passed through to `ConnectData` */
+        opaque?: unknown;
+        /** Default: 0 */
+        maxRedirections?: number;
+        /** Default: `null` */
+        responseHeader?: 'raw' | null;
+    }
+    interface RequestOptions extends DispatchOptions {
+        /** Default: `null` */
+        opaque?: unknown;
+        /** Default: `null` */
+        signal?: AbortSignal_2 | EventEmitter | null;
+        /** Default: 0 */
+        maxRedirections?: number;
+        /** Default: `null` */
+        onInfo?: (info: { statusCode: number, headers: Record<string, string | string[]> }) => void;
+        /** Default: `null` */
+        responseHeader?: 'raw' | null;
+    }
+    interface PipelineOptions extends RequestOptions {
+        /** `true` if the `handler` will return an object stream. Default: `false` */
+        objectMode?: boolean;
+    }
+    interface UpgradeOptions {
+        path: string;
+        /** Default: `'GET'` */
+        method?: string;
+        /** Default: `null` */
+        headers?: IncomingHttpHeaders | string[] | null;
+        /** A string of comma separated protocols, in descending preference order. Default: `'Websocket'` */
+        protocol?: string;
+        /** Default: `null` */
+        signal?: AbortSignal_2 | EventEmitter | null;
+        /** Default: 0 */
+        maxRedirections?: number;
+        /** Default: `null` */
+        responseHeader?: 'raw' | null;
+    }
+    interface ConnectData {
+        statusCode: number;
+        headers: IncomingHttpHeaders;
+        socket: Duplex;
+        opaque: unknown;
+    }
+    interface ResponseData {
+        statusCode: number;
+        headers: IncomingHttpHeaders;
+        body: BodyReadable & BodyMixin;
+        trailers: Record<string, string>;
+        opaque: unknown;
+        context: object;
+    }
+    interface PipelineHandlerData {
+        statusCode: number;
+        headers: IncomingHttpHeaders;
+        opaque: unknown;
+        body: BodyReadable;
+        context: object;
+    }
+    interface StreamData {
+        opaque: unknown;
+        trailers: Record<string, string>;
+    }
+    interface UpgradeData {
+        headers: IncomingHttpHeaders;
+        socket: Duplex;
+        opaque: unknown;
+    }
+    interface StreamFactoryData {
+        statusCode: number;
+        headers: IncomingHttpHeaders;
+        opaque: unknown;
+        context: object;
+    }
+    type StreamFactory = (data: StreamFactoryData) => Writable;
+    interface DispatchHandlers {
+        /** Invoked before request is dispatched on socket. May be invoked multiple times when a request is retried when the request at the head of the pipeline fails. */
+        onConnect?(abort: () => void): void;
+        /** Invoked when an error has occurred. */
+        onError?(err: Error): void;
+        /** Invoked when request is upgraded either due to a `Upgrade` header or `CONNECT` method. */
+        onUpgrade?(statusCode: number, headers: Buffer[] | string[] | null, socket: Duplex): void;
+        /** Invoked when statusCode and headers have been received. May be invoked multiple times due to 1xx informational headers. */
+        onHeaders?(statusCode: number, headers: Buffer[] | string[] | null, resume: () => void): boolean;
+        /** Invoked when response payload data is received. */
+        onData?(chunk: Buffer): boolean;
+        /** Invoked when response payload and trailers have been received and the request has completed. */
+        onComplete?(trailers: string[] | null): void;
+        /** Invoked when a body chunk is sent to the server. May be invoked multiple times for chunked requests */
+        onBodySent?(chunkSize: number, totalBytesSent: number): void;
+    }
+    type PipelineHandler = (data: PipelineHandlerData) => Readable;
+    type HttpMethod = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE' | 'PATCH';
+
+    /**
+     * @link https://fetch.spec.whatwg.org/#body-mixin
+     */
+    interface BodyMixin {
+        readonly body?: never; // throws on node v16.6.0
+        readonly bodyUsed: boolean;
+        arrayBuffer(): Promise<ArrayBuffer>;
+        blob(): Promise<Blob_2>;
+        formData(): Promise<never>;
+        json(): Promise<any>;
+        text(): Promise<string>;
+    }
+
+    interface DispatchInterceptor {
+        (dispatch: Dispatcher['dispatch']): Dispatcher['dispatch']
+    }
 }
 
+declare type DurableObjectBindings = {
+    /** The name of the binding used to refer to the Durable Object */
+    name: string;
+    /** The exported class name of the Durable Object */
+    class_name: string;
+    /** The script where the Durable Object is defined (if it's external to this worker) */
+    script_name?: string;
+    /** The service environment of the script_name to bind to */
+    environment?: string;
+}[];
+
 declare interface EnablePagesAssetsServiceBindingOptions {
     proxyPort?: number;
     directory?: string;
@@ -188,11 +567,16 @@ declare interface EnvironmentInheritable {
      * The entrypoint/path to the JavaScript file that will be executed.
      */
     main: string | undefined;
+    /**
+     * The directory in which module rules should be evaluated in a `--no-bundle` worker
+     * This defaults to dirname(main) when left undefined
+     */
+    base_dir: string | undefined;
     /**
      * Whether we use <name>.<subdomain>.workers.dev to
      * test and deploy your worker.
      *
-     * @default `true` (This is a breaking change from wrangler 1)
+     * @default `true` (This is a breaking change from Wrangler v1)
      * @breaking
      * @inheritable
      */
@@ -358,6 +742,14 @@ declare interface EnvironmentInheritable {
      * @inheritable
      */
     logpush: boolean | undefined;
+    /**
+     * Specify how the worker should be located to minimize round-trip time.
+     *
+     * More details: https://developers.cloudflare.com/workers/platform/smart-placement/
+     */
+    placement: {
+        mode: "off" | "smart";
+    } | undefined;
 }
 
 /**
@@ -390,13 +782,6 @@ declare interface EnvironmentNonInheritable {
     vars: {
         [key: string]: unknown;
     };
-    /**
-     * Specifies namespace binding that is bound to this Worker environment.
-     * It allows for access at runtime to the Workers metadata.
-     *  @default `undefined`
-     *  @nonInheritable
-     **/
-    metadata_binding: string | undefined;
     /**
      * A list of durable objects that your worker should be bound to.
      *
@@ -410,16 +795,7 @@ declare interface EnvironmentNonInheritable {
      * @nonInheritable
      */
     durable_objects: {
-        bindings: {
-            /** The name of the binding used to refer to the Durable Object */
-            name: string;
-            /** The exported class name of the Durable Object */
-            class_name: string;
-            /** The script where the Durable Object is defined (if it's external to this worker) */
-            script_name?: string;
-            /** The service environment of the script_name to bind to */
-            environment?: string;
-        }[];
+        bindings: DurableObjectBindings;
     };
     /**
      * These specify any Workers KV Namespaces you want to
@@ -442,6 +818,23 @@ declare interface EnvironmentNonInheritable {
         /** The ID of the KV namespace used during `wrangler dev` */
         preview_id?: string;
     }[];
+    /**
+     * These specify bindings to send email from inside your Worker.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default `[]`
+     * @nonInheritable
+     */
+    send_email: {
+        /** The binding name used to refer to the this binding */
+        name: string;
+        /** If this binding should be restricted to a specific verified address */
+        destination_address?: string;
+        /** If this binding should be restricted to a set of verified addresses */
+        allowed_destination_addresses?: string[];
+    }[];
     /**
      * Specifies Queues that are bound to this Worker environment.
      *
@@ -471,6 +864,8 @@ declare interface EnvironmentNonInheritable {
             max_retries?: number;
             /** The queue to send messages that failed to be consumed. */
             dead_letter_queue?: string;
+            /** The maximum number of concurrent consumer Worker invocations. Leaving this unset will allow your consumer to scale to the maximum concurrency needed to keep up with the message backlog. */
+            max_concurrency?: number | null;
         }[];
     };
     /**
@@ -508,6 +903,27 @@ declare interface EnvironmentNonInheritable {
         database_id: string;
         /** The UUID of this D1 database for Wrangler Dev (if specified). */
         preview_database_id?: string;
+        /** The name of the migrations table for this D1 database (defaults to 'd1_migrations'). */
+        migrations_table?: string;
+        /** The path to the directory of migrations for this D1 database (defaults to './migrations'). */
+        migrations_dir?: string;
+        /** Internal use only. */
+        database_internal_env?: string;
+    }[];
+    /**
+     * Specifies Constellation projects that are bound to this Worker environment.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default `[]`
+     * @nonInheritable
+     */
+    constellation: {
+        /** The binding name used to refer to the project in the worker. */
+        binding: string;
+        /** The id of the project. */
+        project_id: string;
     }[];
     /**
      * Specifies service bindings (worker-to-worker) that are bound to this Worker environment.
@@ -526,13 +942,33 @@ declare interface EnvironmentNonInheritable {
         /** The environment of the service (e.g. production, staging, etc). */
         environment?: string;
     }[] | undefined;
+    /**
+     * Specifies analytics engine datasets that are bound to this Worker environment.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default `[]`
+     * @nonInheritable
+     */
+    analytics_engine_datasets: {
+        /** The binding name used to refer to the dataset in the worker. */
+        binding: string;
+        /** The name of this dataset to write to. */
+        dataset?: string;
+    }[];
+    /**
+     * A browser that will be usable from the worker.
+     */
+    browser: {
+        binding: string;
+    } | undefined;
     /**
      * "Unsafe" tables for features that aren't directly supported by wrangler.
      *
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{ bindings: [] }`
      * @nonInheritable
      */
     unsafe: {
@@ -540,15 +976,142 @@ declare interface EnvironmentNonInheritable {
          * A set of bindings that should be put into a Worker's upload metadata without changes. These
          * can be used to implement bindings for features that haven't released and aren't supported
          * directly by wrangler or miniflare.
-         *
-         * @default []
          */
-        bindings: {
+        bindings?: {
             name: string;
             type: string;
             [key: string]: unknown;
         }[];
+        /**
+         * Arbitrary key/value pairs that will be included in the uploaded metadata.  Values specified
+         * here will always be applied to metadata last, so can add new or override existing fields.
+         */
+        metadata?: {
+            [key: string]: string;
+        };
     };
+    mtls_certificates: {
+        /** The binding name used to refer to the certificate in the worker */
+        binding: string;
+        /** The uuid of the uploaded mTLS certificate */
+        certificate_id: string;
+    }[];
+    tail_consumers?: TailConsumer[];
+}
+
+declare namespace Errors {
+    class UndiciError extends Error { }
+
+    /** Connect timeout error. */
+    class ConnectTimeoutError extends UndiciError {
+        name: 'ConnectTimeoutError';
+        code: 'UND_ERR_CONNECT_TIMEOUT';
+    }
+
+    /** A header exceeds the `headersTimeout` option. */
+    class HeadersTimeoutError extends UndiciError {
+        name: 'HeadersTimeoutError';
+        code: 'UND_ERR_HEADERS_TIMEOUT';
+    }
+
+    /** Headers overflow error. */
+    class HeadersOverflowError extends UndiciError {
+        name: 'HeadersOverflowError'
+        code: 'UND_ERR_HEADERS_OVERFLOW'
+    }
+
+    /** A body exceeds the `bodyTimeout` option. */
+    class BodyTimeoutError extends UndiciError {
+        name: 'BodyTimeoutError';
+        code: 'UND_ERR_BODY_TIMEOUT';
+    }
+
+    class ResponseStatusCodeError extends UndiciError {
+        name: 'ResponseStatusCodeError';
+        code: 'UND_ERR_RESPONSE_STATUS_CODE';
+        body: null | Record<string, any> | string
+        status: number
+        statusCode: number
+        headers: IncomingHttpHeaders | string[] | null;
+    }
+
+    /** Passed an invalid argument. */
+    class InvalidArgumentError extends UndiciError {
+        name: 'InvalidArgumentError';
+        code: 'UND_ERR_INVALID_ARG';
+    }
+
+    /** Returned an invalid value. */
+    class InvalidReturnValueError extends UndiciError {
+        name: 'InvalidReturnValueError';
+        code: 'UND_ERR_INVALID_RETURN_VALUE';
+    }
+
+    /** The request has been aborted by the user. */
+    class RequestAbortedError extends UndiciError {
+        name: 'AbortError';
+        code: 'UND_ERR_ABORTED';
+    }
+
+    /** Expected error with reason. */
+    class InformationalError extends UndiciError {
+        name: 'InformationalError';
+        code: 'UND_ERR_INFO';
+    }
+
+    /** Request body length does not match content-length header. */
+    class RequestContentLengthMismatchError extends UndiciError {
+        name: 'RequestContentLengthMismatchError';
+        code: 'UND_ERR_REQ_CONTENT_LENGTH_MISMATCH';
+    }
+
+    /** Response body length does not match content-length header. */
+    class ResponseContentLengthMismatchError extends UndiciError {
+        name: 'ResponseContentLengthMismatchError';
+        code: 'UND_ERR_RES_CONTENT_LENGTH_MISMATCH';
+    }
+
+    /** Trying to use a destroyed client. */
+    class ClientDestroyedError extends UndiciError {
+        name: 'ClientDestroyedError';
+        code: 'UND_ERR_DESTROYED';
+    }
+
+    /** Trying to use a closed client. */
+    class ClientClosedError extends UndiciError {
+        name: 'ClientClosedError';
+        code: 'UND_ERR_CLOSED';
+    }
+
+    /** There is an error with the socket. */
+    class SocketError extends UndiciError {
+        name: 'SocketError';
+        code: 'UND_ERR_SOCKET';
+        socket: Client.SocketInfo | null
+    }
+
+    /** Encountered unsupported functionality. */
+    class NotSupportedError extends UndiciError {
+        name: 'NotSupportedError';
+        code: 'UND_ERR_NOT_SUPPORTED';
+    }
+
+    /** No upstream has been added to the BalancedPool. */
+    class BalancedPoolMissingUpstreamError extends UndiciError {
+        name: 'MissingUpstreamError';
+        code: 'UND_ERR_BPL_MISSING_UPSTREAM';
+    }
+
+    class HTTPParserError extends UndiciError {
+        name: 'HTTPParserError';
+        code: string;
+    }
+
+    /** The response exceed the length allowed. */
+    class ResponseExceededMaxSizeError extends UndiciError {
+        name: 'ResponseExceededMaxSizeError';
+        code: 'UND_ERR_RES_EXCEEDED_MAX_SIZE';
+    }
 }
 
 declare class File extends Blob_2 {
@@ -684,6 +1247,16 @@ declare class FormData {
  */
 declare type FormDataEntryValue = string | File
 
+/**
+ *  fetches an mTLS certificate from the account mTLS certificate store by ID
+ */
+export declare function getMTlsCertificate(accountId: string, id: string): Promise<MTlsCertificateResponse>;
+
+/**
+ *  fetches an mTLS certificate from the account mTLS certificate store by name. will throw an error if no certificates are found, or multiple are found with that name
+ */
+export declare function getMTlsCertificateByName(accountId: string, name: string): Promise<MTlsCertificateResponse>;
+
 declare class Headers implements SpecIterable<[string, string]> {
     constructor (init?: HeadersInit)
     readonly append: (name: string, value: string) => void
@@ -691,6 +1264,7 @@ declare class Headers implements SpecIterable<[string, string]> {
     readonly get: (name: string) => string | null
     readonly has: (name: string) => boolean
     readonly set: (name: string, value: string) => void
+    readonly getSetCookie: () => string[]
     readonly forEach: (
     callbackfn: (value: string, key: string, iterable: Headers) => void,
     thisArg?: unknown
@@ -704,6 +1278,172 @@ declare class Headers implements SpecIterable<[string, string]> {
 
 declare type HeadersInit = string[][] | Record<string, string | ReadonlyArray<string>> | Headers
 
+/**
+ * The header type declaration of `undici`.
+ */
+declare type IncomingHttpHeaders = Record<string, string | string[] | undefined>;
+
+/**
+ *  lists mTLS certificates for an account. filtering by name is supported
+ */
+export declare function listMTlsCertificates(accountId: string, filter: MTlsCertificateListFilter): Promise<MTlsCertificateResponse[]>;
+
+/**
+ * details for uploading an mTLS certificate via the ssl api
+ */
+declare interface MTlsCertificateBody {
+    certificateChain: string;
+    privateKey: string;
+    name?: string;
+}
+
+/**
+ * supported filters for listing mTLS certificates via the ssl api
+ */
+declare interface MTlsCertificateListFilter {
+    name?: string;
+}
+
+/**
+ * the representation of an mTLS certificate in the account certificate store
+ */
+declare interface MTlsCertificateResponse {
+    id: string;
+    name?: string;
+    ca: boolean;
+    certificates: string;
+    expires_on: string;
+    issuer: string;
+    serial_number: string;
+    signature: string;
+    uploaded_on: string;
+}
+
+/**
+ * details for uploading an mTLS certificate from disk
+ */
+declare interface MTlsCertificateUploadDetails {
+    certificateChainFilename: string;
+    privateKeyFilename: string;
+    name?: string;
+}
+
+declare interface PagesPublishOptions {
+    /**
+     * Path to static assets to publish to Pages
+     */
+    directory: string;
+    /**
+     * The Cloudflare Account ID that owns the project that's
+     * being published
+     */
+    accountId: string;
+    /**
+     * The name of the project to be published
+     */
+    projectName: string;
+    /**
+     * Branch name to use. Defaults to production branch
+     */
+    branch?: string;
+    /**
+     * Whether or not to skip local file upload result caching
+     */
+    skipCaching?: boolean;
+    /**
+     * Commit message associated to deployment
+     */
+    commitMessage?: string;
+    /**
+     * Commit hash associated to deployment
+     */
+    commitHash?: string;
+    /**
+     * Whether or not the deployment should be considered to be
+     * in a dirty commit state
+     */
+    commitDirty?: boolean;
+    /**
+     * Path to the project's functions directory. Default uses
+     * the current working directory + /functions since this is
+     * typically called in a CLI
+     */
+    functionsDirectory?: string;
+    /**
+     * Whether to run bundling on `_worker.js` before deploying.
+     * Default: true
+     */
+    bundle?: boolean;
+}
+
+/**
+ * Publish a directory to an account/project.
+ * NOTE: You will need the `CLOUDFLARE_API_KEY` environment
+ * variable set
+ */
+declare function publish({ directory, accountId, projectName, branch, skipCaching, commitMessage, commitHash, commitDirty, functionsDirectory: customFunctionsDirectory, bundle, }: PagesPublishOptions): Promise<{
+    environment: "production" | "preview";
+    id: string;
+    project_id: string;
+    url: string;
+    project_name: string;
+    build_config: {
+        build_command: string;
+        destination_dir: string;
+        root_dir: string;
+        web_analytics_tag?: string | undefined;
+        web_analytics_token?: string | undefined;
+        fast_builds?: boolean | undefined;
+    };
+    created_on: string;
+    production_branch: string;
+    deployment_trigger: {
+        type: string;
+        metadata: {
+            branch: string;
+            commit_hash: string;
+            commit_message: string;
+        };
+    };
+    latest_stage: {
+        name: "build" | "queued" | "initialize" | "clone_repo" | "deploy";
+        status: "active" | "canceled" | "success" | "idle" | "failure" | "skipped";
+        started_on: string | null;
+        ended_on: string | null;
+    };
+    stages: {
+        name: "build" | "queued" | "initialize" | "clone_repo" | "deploy";
+        status: "active" | "canceled" | "success" | "idle" | "failure" | "skipped";
+        started_on: string | null;
+        ended_on: string | null;
+    }[];
+    aliases: string[];
+    modified_on: string;
+    short_id: string;
+    build_image_major_version: number;
+    kv_namespaces?: any;
+    source?: {
+        type: "github" | "gitlab";
+        config: {
+            owner: string;
+            repo_name: string;
+            production_branch?: string | undefined;
+            pr_comments_enabled?: boolean | undefined;
+            deployments_enabled?: boolean | undefined;
+            production_deployments_enabled?: boolean | undefined;
+            preview_deployment_setting?: "none" | "all" | "custom" | undefined;
+            preview_branch_includes?: string[] | undefined;
+            preview_branch_excludes?: string[] | undefined;
+        };
+    } | undefined;
+    env_vars?: any;
+    durable_object_namespaces?: any;
+    is_skipped?: boolean | undefined;
+    files?: {
+        [x: string]: string | undefined;
+    } | undefined;
+}>;
+
 declare type ReferrerPolicy =
 | ''
 | 'no-referrer'
@@ -731,6 +1471,7 @@ declare class Request implements BodyMixin {
 
     readonly keepalive: boolean
     readonly signal: AbortSignal
+    readonly duplex: RequestDuplex
 
     readonly body: ReadableStream | null
     readonly bodyUsed: boolean
@@ -774,6 +1515,8 @@ declare type RequestDestination =
 | 'worker'
 | 'xslt'
 
+declare type RequestDuplex = 'half'
+
 declare type RequestInfo = string | URL_2 | Request
 
 declare interface RequestInit {
@@ -790,6 +1533,7 @@ declare interface RequestInit {
     referrerPolicy?: ReferrerPolicy
     window?: null
     dispatcher?: Dispatcher
+    duplex?: RequestDuplex
 }
 
 declare type RequestMode = 'cors' | 'navigate' | 'no-cors' | 'same-origin'
@@ -864,10 +1608,81 @@ declare interface SpecIterator<T, TReturn = any, TNext = undefined> {
     next(...args: [] | [TNext]): IteratorResult<T, TReturn>;
 }
 
+declare type TailConsumer = {
+    /** The name of the service tail events will be forwarded to. */
+    service: string;
+    /** (Optional) The environt of the service. */
+    environment?: string;
+};
+
 /**
  *  unstable_dev starts a wrangler dev server, and returns a promise that resolves with utility functions to interact with it.
  */
-export declare function unstable_dev(script: string, options?: DevOptions, apiOptions?: DevApiOptions): Promise<UnstableDevWorker>;
+export declare function unstable_dev(script: string, options?: UnstableDevOptions, apiOptions?: unknown): Promise<UnstableDevWorker>;
+
+export declare const unstable_pages: {
+    publish: typeof publish;
+};
+
+export declare interface UnstableDevOptions {
+    config?: string;
+    env?: string;
+    ip?: string;
+    port?: number;
+    bundle?: boolean;
+    inspectorPort?: number;
+    localProtocol?: "http" | "https";
+    assets?: string;
+    site?: string;
+    siteInclude?: string[];
+    siteExclude?: string[];
+    nodeCompat?: boolean;
+    compatibilityDate?: string;
+    compatibilityFlags?: string[];
+    persist?: boolean;
+    persistTo?: string;
+    vars?: {
+        [key: string]: unknown;
+    };
+    kv?: {
+        binding: string;
+        id: string;
+        preview_id?: string;
+    }[];
+    durableObjects?: {
+        name: string;
+        class_name: string;
+        script_name?: string | undefined;
+        environment?: string | undefined;
+    }[];
+    r2?: {
+        binding: string;
+        bucket_name: string;
+        preview_bucket_name?: string;
+    }[];
+    moduleRoot?: string;
+    rules?: Rule[];
+    logLevel?: "none" | "info" | "error" | "log" | "warn" | "debug";
+    inspect?: boolean;
+    local?: boolean;
+    accountId?: string;
+    experimental?: {
+        processEntrypoint?: boolean;
+        additionalModules?: CfModule[];
+        d1Databases?: Environment["d1_databases"];
+        disableExperimentalWarning?: boolean;
+        disableDevRegistry?: boolean;
+        enablePagesAssetsServiceBinding?: EnablePagesAssetsServiceBindingOptions;
+        experimentalLocal?: boolean;
+        experimentalLocalRemoteKv?: boolean;
+        forceLocal?: boolean;
+        liveReload?: boolean;
+        showInteractiveDevSession?: boolean;
+        testMode?: boolean;
+        testScheduled?: boolean;
+        watch?: boolean;
+    };
+}
 
 export declare interface UnstableDevWorker {
     port: number;
@@ -877,6 +1692,16 @@ export declare interface UnstableDevWorker {
     waitUntilExit: () => Promise<void>;
 }
 
+/**
+ *  uploads an mTLS certificate and private key pair to the account mTLS certificate store
+ */
+export declare function uploadMTlsCertificate(accountId: string, body: MTlsCertificateBody): Promise<MTlsCertificateResponse>;
+
+/**
+ * reads an mTLS certificate and private key pair from disk and uploads it to the account mTLS certificate store
+ */
+export declare function uploadMTlsCertificateFromFs(accountId: string, details: MTlsCertificateUploadDetails): Promise<MTlsCertificateResponse>;
+
 declare type ZoneIdRoute = {
     pattern: string;
     zone_id: string;