wrangler 3.58.0 → 3.60.0

package/wrangler-dist/cli.d.ts

@@ -94,51 +94,68 @@ declare type BaseErrorEvent<Source = string, Data = undefined> = {
     data: Data;
 };
 
+declare type BinaryFile = File_2<Uint8Array>;
+
 declare type BinaryType = 'blob' | 'arraybuffer'
 
 declare type Binding = {
-    type: "kv";
-    id: string;
+    type: "plain_text";
+    value: string;
 } | {
-    type: "r2";
-    bucket_name: string;
+    type: "json";
+    value: Json;
+} | ({
+    type: "kv_namespace";
+} & BindingOmit<CfKvNamespace>) | ({
+    type: "send_email";
+} & BindingOmit<CfSendEmailBindings>) | {
+    type: "wasm_module";
+    source: BinaryFile;
 } | {
-    type: "d1";
-    /** The binding name used to refer to the D1 database in the worker. */
-    binding: string;
-    /** The name of this D1 database. */
-    database_name: string;
-    /** The UUID of this D1 database (not required). */
-    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;
+    type: "text_blob";
+    source: File_2;
 } | {
-    type: "durable-object";
-    className: string;
-    service?: ServiceDesignator;
+    type: "browser";
 } | {
-    type: "service";
-    service: ServiceDesignator | ServiceFetch;
+    type: "ai";
 } | {
-    type: "queue-producer";
-    name: string;
+    type: "version_metadata";
 } | {
+    type: "data_blob";
+    source: BinaryFile;
+} | ({
+    type: "durable_object_namespace";
+} & BindingOmit<CfDurableObject>) | ({
+    type: "queue";
+} & BindingOmit<CfQueue>) | ({
+    type: "r2_bucket";
+} & BindingOmit<CfR2Bucket>) | ({
+    type: "d1";
+} & Omit<CfD1Database, "binding">) | ({
+    type: "vectorize";
+} & Omit<CfVectorize, "binding">) | ({
     type: "constellation";
-    project_id: string;
-} | {
-    type: "var";
-    value: string | Json | Uint8Array;
-} | {
-    type: `unsafe-${string}`;
-    [key: string]: unknown;
+} & Omit<CfConstellation, "binding">) | ({
+    type: "hyperdrive";
+} & Omit<CfHyperdrive, "binding">) | ({
+    type: "service";
+} & Omit<CfService, "binding">) | {
+    type: "fetcher";
+    fetcher: ServiceFetch;
+} | ({
+    type: "analytics_engine";
+} & Omit<CfAnalyticsEngineDataset, "binding">) | ({
+    type: "dispatch_namespace";
+} & Omit<CfDispatchNamespace, "binding">) | ({
+    type: "mtls_certificate";
+} & Omit<CfMTlsCertificate, "binding">) | ({
+    type: "logfwdr";
+} & Omit<CfLogfwdrBinding, "name">) | {
+    type: `unsafe_${string}`;
 };
 
+declare type BindingOmit<T> = Omit<T, "binding" | "name">;
+
 /**
  * Result of the `getBindingsProxy` utility
  */
@@ -264,23 +281,26 @@ declare namespace buildConnector {
     }
 }
 
+declare type Bundle = EsbuildBundle;
+
 declare type BundleCompleteEvent = {
     type: "bundleComplete";
     config: StartDevWorkerOptions;
-    bundle: EsbuildBundle;
+    bundle: Bundle;
 };
 
-declare class BundlerController extends Controller {
+declare class BundlerController extends Controller<BundlerControllerEventMap> {
     onConfigUpdate(_: ConfigUpdateEvent): void;
     teardown(): Promise<void>;
     emitBundleStartEvent(data: BundleStartEvent): void;
     emitBundleCompletetEvent(data: BundleCompleteEvent): void;
-    on(event: "bundleStart", listener: (_: BundleStartEvent) => void): this;
-    on(event: "bundleComplete", listener: (_: BundleCompleteEvent) => void): this;
-    on(event: "error", listener: (_: ErrorEvent) => void): this;
-    once: typeof BundlerController.on;
 }
 
+declare type BundlerControllerEventMap = ControllerEventMap & {
+    bundleStart: [BundleStartEvent];
+    bundleComplete: [BundleCompleteEvent];
+};
+
 declare type BundleStartEvent = {
     type: "bundleStart";
     config: StartDevWorkerOptions;
@@ -378,6 +398,68 @@ declare interface CfAccount {
     accountId: string;
 }
 
+/**
+ * A binding to the AI project
+ */
+declare interface CfAIBinding {
+    binding: string;
+    staging?: boolean;
+}
+
+declare interface CfAnalyticsEngineDataset {
+    binding: string;
+    dataset?: string;
+}
+
+/**
+ * A binding to a browser
+ */
+declare interface CfBrowserBinding {
+    binding: string;
+}
+
+declare type CfCapnp = {
+    base_path?: never;
+    source_schemas?: never;
+    compiled_schema: string;
+} | {
+    base_path: string;
+    source_schemas: string[];
+    compiled_schema?: never;
+};
+
+declare interface CfConstellation {
+    binding: string;
+    project_id: string;
+}
+
+declare interface CfD1Database {
+    binding: string;
+    database_id: string;
+    database_name?: string;
+    preview_database_id?: string;
+    database_internal_env?: string;
+    migrations_table?: string;
+    migrations_dir?: string;
+}
+
+/**
+ * A binding to a data blob (in service-worker format)
+ */
+declare interface CfDataBlobBindings {
+    [key: string]: string | Uint8Array;
+}
+
+declare interface CfDispatchNamespace {
+    binding: string;
+    namespace: string;
+    outbound?: {
+        service: string;
+        environment?: string;
+        parameters?: string[];
+    };
+}
+
 /**
  * A Durable Object.
  */
@@ -388,6 +470,42 @@ declare interface CfDurableObject {
     environment?: string;
 }
 
+declare interface CfDurableObjectMigrations {
+    old_tag?: string;
+    new_tag: string;
+    steps: {
+        new_classes?: string[];
+        renamed_classes?: {
+            from: string;
+            to: string;
+        }[];
+        deleted_classes?: string[];
+    }[];
+}
+
+declare interface CfHyperdrive {
+    binding: string;
+    id: string;
+    localConnectionString?: string;
+}
+
+/**
+ * A KV namespace.
+ */
+declare interface CfKvNamespace {
+    binding: string;
+    id: string;
+}
+
+declare interface CfLogfwdr {
+    bindings: CfLogfwdrBinding[];
+}
+
+declare interface CfLogfwdrBinding {
+    name: string;
+    destination: string;
+}
+
 /**
  * An imported module.
  */
@@ -419,6 +537,12 @@ declare interface CfModule {
      * }
      */
     content: string | Buffer;
+    /**
+     * An optional sourcemap for this module if it's of a ESM or CJS type, this will only be present
+     * if we're deploying with sourcemaps enabled. Since we copy extra modules that aren't bundled
+     * we need to also copy the relevant sourcemaps into the final out directory.
+     */
+    sourceMap?: CfWorkerSourceMap;
     /**
      * The module type.
      *
@@ -430,13 +554,193 @@ declare interface CfModule {
 /**
  * A module type.
  */
-declare type CfModuleType = "esm" | "commonjs" | "compiled-wasm" | "text" | "buffer" | "python" | "python-requirement";
+declare type CfModuleType = "esm" | "commonjs" | "compiled-wasm" | "text" | "buffer" | "python" | "python-requirement" | "nodejs-compat-module";
+
+declare interface CfMTlsCertificate {
+    binding: string;
+    certificate_id: string;
+}
+
+declare interface CfPlacement {
+    mode: "smart";
+}
+
+declare interface CfQueue {
+    binding: string;
+    queue_name: string;
+    delivery_delay?: number;
+}
+
+declare interface CfR2Bucket {
+    binding: string;
+    bucket_name: string;
+    jurisdiction?: string;
+}
 
 /**
  * The type of Worker
  */
 declare type CfScriptFormat = "modules" | "service-worker";
 
+/**
+ * A binding to send email.
+ */
+declare interface CfSendEmailBindings {
+    name: string;
+    destination_address?: string;
+    allowed_destination_addresses?: string[];
+}
+
+declare interface CfService {
+    binding: string;
+    service: string;
+    environment?: string;
+    entrypoint?: string;
+}
+
+declare interface CfTailConsumer {
+    service: string;
+    environment?: string;
+}
+
+/**
+ * A binding to a text blob (in service-worker format)
+ */
+declare interface CfTextBlobBindings {
+    [key: string]: string;
+}
+
+declare interface CfUnsafe {
+    bindings: CfUnsafeBinding[] | undefined;
+    metadata: CfUnsafeMetadata | undefined;
+    capnp: CfCapnp | undefined;
+}
+
+declare interface CfUnsafeBinding {
+    name: string;
+    type: string;
+}
+
+declare type CfUnsafeMetadata = Record<string, unknown>;
+
+declare interface CfUserLimits {
+    cpu_ms?: number;
+}
+
+/**
+ * A map of variable names to values.
+ */
+declare interface CfVars {
+    [key: string]: string | Json;
+}
+
+declare interface CfVectorize {
+    binding: string;
+    index_name: string;
+}
+
+/**
+ * A binding to the Worker Version's metadata
+ */
+declare interface CfVersionMetadataBinding {
+    binding: string;
+}
+
+/**
+ * A binding to a wasm module (in service-worker format)
+ */
+declare interface CfWasmModuleBindings {
+    [key: string]: string | Uint8Array;
+}
+
+/**
+ * Options for creating a `CfWorker`.
+ */
+declare interface CfWorkerInit {
+    /**
+     * The name of the worker.
+     */
+    name: string | undefined;
+    /**
+     * The entrypoint module.
+     */
+    main: CfModule;
+    /**
+     * The list of additional modules.
+     */
+    modules: CfModule[] | undefined;
+    /**
+     * The list of source maps to include on upload.
+     */
+    sourceMaps: CfWorkerSourceMap[] | undefined;
+    /**
+     * All the bindings
+     */
+    bindings: {
+        vars: CfVars | undefined;
+        kv_namespaces: CfKvNamespace[] | undefined;
+        send_email: CfSendEmailBindings[] | undefined;
+        wasm_modules: CfWasmModuleBindings | undefined;
+        text_blobs: CfTextBlobBindings | undefined;
+        browser: CfBrowserBinding | undefined;
+        ai: CfAIBinding | undefined;
+        version_metadata: CfVersionMetadataBinding | undefined;
+        data_blobs: CfDataBlobBindings | undefined;
+        durable_objects: {
+            bindings: CfDurableObject[];
+        } | undefined;
+        queues: CfQueue[] | undefined;
+        r2_buckets: CfR2Bucket[] | undefined;
+        d1_databases: CfD1Database[] | undefined;
+        vectorize: CfVectorize[] | undefined;
+        constellation: CfConstellation[] | undefined;
+        hyperdrive: CfHyperdrive[] | undefined;
+        services: CfService[] | undefined;
+        analytics_engine_datasets: CfAnalyticsEngineDataset[] | undefined;
+        dispatch_namespaces: CfDispatchNamespace[] | undefined;
+        mtls_certificates: CfMTlsCertificate[] | undefined;
+        logfwdr: CfLogfwdr | undefined;
+        unsafe: CfUnsafe | undefined;
+    };
+    migrations: CfDurableObjectMigrations | undefined;
+    compatibility_date: string | undefined;
+    compatibility_flags: string[] | undefined;
+    usage_model: "bundled" | "unbound" | undefined;
+    keepVars: boolean | undefined;
+    keepSecrets: boolean | undefined;
+    logpush: boolean | undefined;
+    placement: CfPlacement | undefined;
+    tail_consumers: CfTailConsumer[] | undefined;
+    limits: CfUserLimits | undefined;
+    annotations?: Record<string, string | undefined>;
+}
+
+declare interface CfWorkerSourceMap {
+    /**
+     * The name of the source map.
+     *
+     * @example
+     * 'out.js.map'
+     */
+    name: string;
+    /**
+     * The content of the source map, which is a JSON object described by the v3
+     * spec.
+     *
+     * @example
+     * {
+     *   "version" : 3,
+     *   "file": "out.js",
+     *   "sourceRoot": "",
+     *   "sources": ["foo.js", "bar.js"],
+     *   "sourcesContent": [null, null],
+     *   "names": ["src", "maps", "are", "fun"],
+     *   "mappings": "A,AAAB;;ABCDE;"
+     * }
+     */
+    content: string | Buffer;
+}
+
 /**
  * A basic HTTP/1.1 client, mapped on top a single TCP/TLS connection. Pipelining is disabled by default.
  */
@@ -553,17 +857,41 @@ declare type CloudchamberConfig = {
     memory?: string;
 };
 
-declare class ConfigController extends EventEmitter_2 {
+/**
+ * This is the static type definition for the configuration object.
+ *
+ * It reflects a normalized and validated version of the configuration that you can write in wrangler.toml,
+ * and optionally augment with arguments passed directly to wrangler.
+ *
+ * For more information about the configuration object, see the
+ * documentation at https://developers.cloudflare.com/workers/cli-wrangler/configuration
+ *
+ * Notes:
+ *
+ * - Fields that are only specified in `ConfigFields` and not `Environment` can only appear
+ * in the top level config and should not appear in any environments.
+ * - Fields that are specified in `PagesConfigFields` are only relevant for Pages projects
+ * - All top level fields in config and environments are optional in the wrangler.toml file.
+ *
+ * Legend for the annotations:
+ *
+ * - `@breaking`: the deprecation/optionality is a breaking change from Wrangler v1.
+ * - `@todo`: there's more work to be done (with details attached).
+ */
+declare type Config = ConfigFields<DevConfig> & PagesConfigFields & Environment;
+
+declare class ConfigController extends Controller<ConfigControllerEventMap> {
     config?: StartDevWorkerOptions;
     setOptions(_: StartDevWorkerOptions): void;
     updateOptions(_: Partial<StartDevWorkerOptions>): void;
     teardown(): Promise<void>;
     emitConfigUpdateEvent(data: ConfigUpdateEvent): void;
-    on(event: "configUpdate", listener: (_: ConfigUpdateEvent) => void): this;
-    on(event: "error", listener: (_: ErrorEvent) => void): this;
-    once: typeof ConfigController.on;
 }
 
+declare type ConfigControllerEventMap = ControllerEventMap & {
+    configUpdate: [ConfigUpdateEvent];
+};
+
 declare interface ConfigFields<Dev extends RawDevConfig> {
     configPath: string | undefined;
     /**
@@ -699,7 +1027,7 @@ declare interface ConfigFields<Dev extends RawDevConfig> {
 /**
  * The possible types for a `Rule`.
  */
-declare type ConfigModuleRuleType = "ESModule" | "CommonJS" | "CompiledWasm" | "Text" | "Data" | "PythonModule" | "PythonRequirement";
+declare type ConfigModuleRuleType = "ESModule" | "CommonJS" | "CompiledWasm" | "Text" | "Data" | "PythonModule" | "PythonRequirement" | "NodeJsCompatModule";
 
 declare type ConfigUpdateEvent = {
     type: "configUpdate";
@@ -712,9 +1040,14 @@ url: string | URL_2 | UrlObject,
 options?: { dispatcher?: Dispatcher } & Omit<Dispatcher.ConnectOptions, 'origin' | 'path'>
 ): Promise<Dispatcher.ConnectData>;
 
-declare abstract class Controller extends EventEmitter_2 {
+declare abstract class Controller<EventMap extends ControllerEventMap = ControllerEventMap> extends TypedEventEmitterImpl<EventMap> {
+    emitErrorEvent(data: ErrorEvent): void;
 }
 
+declare type ControllerEventMap = {
+    error: [ErrorEvent];
+};
+
 declare interface Cookie {
     name: string
     value: string
@@ -756,7 +1089,7 @@ attributes?: { name?: string, domain?: string }
  * NOTE: You will need the `CLOUDFLARE_API_KEY` environment
  * variable set
  */
-declare function deploy({ directory, accountId, projectName, branch, skipCaching, commitMessage, commitHash, commitDirty, functionsDirectory: customFunctionsDirectory, bundle, args, }: PagesDeployOptions): Promise<{
+declare function deploy({ directory, accountId, projectName, branch, skipCaching, commitMessage, commitHash, commitDirty, functionsDirectory: customFunctionsDirectory, bundle, sourceMaps, args, }: PagesDeployOptions): Promise<{
     url: string;
     id: string;
     environment: "production" | "preview";
@@ -819,30 +1152,6 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
     } | undefined;
 }>;
 
-declare interface DeprecatedConfigFields {
-    /**
-     * The project "type". A holdover from Wrangler v1.x.
-     * Valid values were "webpack", "javascript", and "rust".
-     *
-     * @deprecated DO NOT USE THIS. Most common features now work out of the box with wrangler, including modules, jsx, typescript, etc. If you need anything more, use a custom build.
-     * @breaking
-     */
-    type?: "webpack" | "javascript" | "rust";
-    /**
-     * Path to the webpack config to use when building your worker.
-     * A holdover from Wrangler v1.x, used with `type: "webpack"`.
-     *
-     * @deprecated DO NOT USE THIS. Most common features now work out of the box with wrangler, including modules, jsx, typescript, etc. If you need anything more, use a custom build.
-     * @breaking
-     */
-    webpack_config?: string;
-    /**
-     * Configuration only used by a standalone use of the miniflare binary.
-     * @deprecated
-     */
-    miniflare?: unknown;
-}
-
 /**
  * Deprecated upload configuration.
  */
@@ -1280,39 +1589,6 @@ declare type Entry = {
 declare interface Environment extends EnvironmentInheritable, EnvironmentNonInheritable {
 }
 
-/**
- * The environment configuration properties that have been deprecated.
- */
-declare interface EnvironmentDeprecated {
-    /**
-     * The zone ID of the zone you want to deploy to. You can find this
-     * in your domain page on the dashboard.
-     *
-     * @deprecated This is unnecessary since we can deduce this from routes directly.
-     */
-    zone_id?: string;
-    /**
-     * Legacy way of defining KVNamespaces that is no longer supported.
-     *
-     * @deprecated DO NOT USE. This was a legacy bug from Wrangler v1, that we do not want to support.
-     */
-    "kv-namespaces"?: string;
-    /**
-     * A list of services that your Worker should be bound to.
-     *
-     * @default `[]`
-     * @deprecated DO NOT USE. We'd added this to test the new service binding system, but the proper way to test experimental features is to use `unsafe.bindings` configuration.
-     */
-    experimental_services?: {
-        /** The binding name used to refer to the Service */
-        name: string;
-        /** The name of the Service being bound */
-        service: string;
-        /** The Service's environment */
-        environment: string;
-    }[];
-}
-
 /**
  * The `EnvironmentInheritable` interface declares all the configuration fields for an environment
  * that can be inherited (and overridden) from the top-level environment.
@@ -1564,24 +1840,6 @@ declare interface EnvironmentInheritable {
     } | undefined;
 }
 
-declare interface EnvironmentMap {
-    /**
-     * The `env` section defines overrides for the configuration for different environments.
-     *
-     * All environment fields can be specified at the top level of the config indicating the default environment settings.
-     *
-     * - Some fields are inherited and overridable in each environment.
-     * - But some are not inherited and must be explicitly specified in every environment, if they are specified at the top level.
-     *
-     * For more information, see the documentation at https://developers.cloudflare.com/workers/cli-wrangler/configuration#environments
-     *
-     * @default {}
-     */
-    env?: {
-        [envName: string]: RawEnvironment;
-    };
-}
-
 /**
  * The `EnvironmentNonInheritable` interface declares all the configuration fields for an environment
  * that cannot be inherited from the top-level environment, and must be defined specifically.
@@ -1956,7 +2214,7 @@ declare interface EnvironmentNonInheritable {
 
 declare type ErrorEvent = BaseErrorEvent<"ConfigController" | "BundlerController" | "LocalRuntimeController" | "RemoteRuntimeController" | "ProxyWorker" | "InspectorProxyWorker"> | BaseErrorEvent<"ProxyController", {
     config?: StartDevWorkerOptions;
-    bundle?: EsbuildBundle;
+    bundle?: Bundle;
 }>;
 
 declare namespace Errors {
@@ -2086,6 +2344,7 @@ declare namespace Errors {
 declare type EsbuildBundle = {
     id: number;
     path: string;
+    entrypointSource: string;
     entry: Entry;
     type: CfModuleType;
     modules: CfModule[];
@@ -2420,7 +2679,7 @@ declare class Headers implements SpecIterable<[string, string]> {
 
 declare type HeadersInit = string[][] | Record<string, string | ReadonlyArray<string>> | Headers
 
-declare type Hook<T, Args extends unknown[] = unknown[]> = T | Promise<T> | ((...args: Args) => T | Promise<T>);
+declare type Hook<T extends string | number | object> = T | Promise<T> | (() => T | Promise<T>);
 
 /**
  * @property terminate Terminates HTTP server.
@@ -2464,7 +2723,7 @@ declare interface Interceptable extends Dispatcher {
 
 declare class Logger {
     constructor();
-    loggerLevel: "none" | "error" | "warn" | "info" | "log" | "debug";
+    loggerLevel: "error" | "none" | "warn" | "info" | "log" | "debug";
     columns: number;
     debug: (...args: unknown[]) => void;
     debugWithSanitization: (label: string, ...args: unknown[]) => void;
@@ -2682,7 +2941,7 @@ declare class MockScope<TData extends object = object> {
 }
 
 declare interface ModuleRule {
-    type: "ESModule" | "CommonJS" | "NodeJSCompat" | "CompiledWasm" | "Text" | "Data";
+    type: "ESModule" | "CommonJS" | "NodeJsCompatModule" | "CompiledWasm" | "Text" | "Data";
     include?: string[];
     fallthrough?: boolean;
 }
@@ -2759,6 +3018,10 @@ declare interface PagesDeployOptions {
      * Default: true
      */
     bundle?: boolean;
+    /**
+     * Whether to upload any server-side sourcemaps with this deployment
+     */
+    sourceMaps: boolean;
     /**
      * Command line args passed to the `pages deploy` cmd
      */
@@ -23138,7 +23401,7 @@ declare namespace ProxyAgent {
     }
 }
 
-declare class ProxyController extends EventEmitter_2 {
+declare class ProxyController extends Controller<ProxyControllerEventMap> {
     ready: DeferredPromise<ReadyEvent>;
     proxyWorker?: Miniflare;
     proxyWorkerOptions?: MiniflareOptions;
@@ -23162,17 +23425,19 @@ declare class ProxyController extends EventEmitter_2 {
     teardown(): Promise<void>;
     emitReadyEvent(proxyWorker: Miniflare): void;
     emitPreviewTokenExpiredEvent(proxyData: ProxyData): void;
-    emitErrorEvent(reason: string, cause: Error | SerializedError): void;
-    on(event: "ready", listener: (_: ReadyEvent) => void): this;
-    on(event: "previewTokenExpired", listener: (_: PreviewTokenExpiredEvent) => void): this;
-    on(event: "error", listener: (_: ErrorEvent) => void): this;
-    once: typeof ProxyController.on;
+    emitErrorEvent(data: ErrorEvent): void;
+    emitErrorEvent(reason: string, cause?: Error | SerializedError): void;
 }
 
+declare type ProxyControllerEventMap = ControllerEventMap & {
+    ready: [ReadyEvent];
+    previewTokenExpired: [PreviewTokenExpiredEvent];
+};
+
 declare type ProxyData = {
     userWorkerUrl: UrlOriginParts;
     userWorkerInspectorUrl: UrlOriginAndPathnameParts;
-    userWorkerInnerUrlOverrides: Partial<UrlOriginParts>;
+    userWorkerInnerUrlOverrides?: Partial<UrlOriginParts>;
     headers: Record<string, string>;
     liveReload?: boolean;
     proxyLogsToController?: boolean;
@@ -23198,20 +23463,10 @@ declare type ProxyWorkerOutgoingRequestBody = {
     args: Parameters<typeof console.debug>;
 };
 
-declare type RawConfig = Partial<ConfigFields<RawDevConfig>> & PagesConfigFields & RawEnvironment & DeprecatedConfigFields & EnvironmentMap & {
-    $schema?: string;
-};
+declare type QueueConsumer = NonNullable<Config["queues"]["consumers"]>[number];
 
 declare type RawDevConfig = Partial<DevConfig>;
 
-/**
- * The raw environment configuration that we read from the config file.
- *
- * All the properties are optional, and will be replaced with defaults in the configuration that
- * is used in the rest of the codebase.
- */
-declare type RawEnvironment = Partial<Environment> & EnvironmentDeprecated;
-
 declare type ReadyEvent = {
     type: "ready";
     proxyWorker: Miniflare;
@@ -23237,14 +23492,14 @@ declare type ReferrerPolicy =
 declare type ReloadCompleteEvent = {
     type: "reloadComplete";
     config: StartDevWorkerOptions;
-    bundle: EsbuildBundle;
+    bundle: Bundle;
     proxyData: ProxyData;
 };
 
 declare type ReloadStartEvent = {
     type: "reloadStart";
     config: StartDevWorkerOptions;
-    bundle: EsbuildBundle;
+    bundle: Bundle;
 };
 
 declare class Request implements BodyMixin {
@@ -23505,19 +23760,20 @@ declare type Rule = {
     fallthrough?: boolean;
 };
 
-declare abstract class RuntimeController extends Controller {
+declare abstract class RuntimeController extends Controller<RuntimeControllerEventMap> {
     abstract onBundleStart(_: BundleStartEvent): void;
     abstract onBundleComplete(_: BundleCompleteEvent): void;
     abstract onPreviewTokenExpired(_: PreviewTokenExpiredEvent): void;
     abstract teardown(): Promise<void>;
     abstract emitReloadStartEvent(data: ReloadStartEvent): void;
-    abstract emitReloadCompletetEvent(data: ReloadCompleteEvent): void;
-    on(event: "reloadStart", listener: (_: ReloadStartEvent) => void): this;
-    on(event: "reloadComplete", listener: (_: ReloadCompleteEvent) => void): this;
-    on(event: "error", listener: (_: ErrorEvent) => void): this;
-    once: typeof RuntimeController.on;
+    abstract emitReloadCompleteEvent(data: ReloadCompleteEvent): void;
 }
 
+declare type RuntimeControllerEventMap = ControllerEventMap & {
+    reloadStart: [ReloadStartEvent];
+    reloadComplete: [ReloadCompleteEvent];
+};
+
 /**
  * Convert a MIMEType object to a string.
  * @see https://mimesniff.spec.whatwg.org/#serialize-a-mime-type
@@ -23531,12 +23787,7 @@ declare type SerializedError = {
     cause?: unknown;
 };
 
-declare interface ServiceDesignator {
-    name: string;
-    env?: string;
-}
-
-declare type ServiceFetch = (request: Request_2) => Promise<Response_2>;
+declare type ServiceFetch = (request: Request_2) => Promise<Response_2> | Response_2;
 
 declare function setCookie (headers: Headers, cookie: Cookie): void
 
@@ -23573,7 +23824,7 @@ declare interface SpecIterator<T, TReturn = any, TNext = undefined> {
 
 declare interface StartDevWorkerOptions {
     /** The name of the worker. */
-    name: string;
+    name?: string;
     /**
      * The javascript or typescript entry-point of the worker.
      * This is the `main` property of a wrangler.toml.
@@ -23581,9 +23832,7 @@ declare interface StartDevWorkerOptions {
      */
     script: File_2<string>;
     /** The configuration of the worker. */
-    config?: File_2<string | RawConfig> & {
-        env?: string;
-    };
+    config?: File_2<Config>;
     /** The compatibility date for the workerd runtime. */
     compatibilityDate?: string;
     /** The compatibility flags for the workerd runtime. */
@@ -23598,6 +23847,19 @@ declare interface StartDevWorkerOptions {
         include?: string[];
         exclude?: string[];
     };
+    /** Service environments. Providing support for existing workers with this property. Don't use this for new workers. */
+    env?: string;
+    /** Wrangler environments, defaults to true. */
+    legacyEnv?: boolean;
+    /**
+     * Whether Wrangler should send usage metrics to Cloudflare for this project.
+     *
+     * When defined this will override any user settings.
+     * Otherwise, Wrangler will use the user's preference.
+     */
+    sendMetrics?: boolean;
+    usageModel?: "bundled" | "unbound";
+    _bindings?: CfWorkerInit["bindings"];
     /** Options applying to the worker's build step. Applies to deploy and dev. */
     build?: {
         /** Whether the worker and its dependencies are bundled. Defaults to true. */
@@ -23649,7 +23911,7 @@ declare interface StartDevWorkerOptions {
             httpsCertPath?: string;
         };
         /** Controls what request.url looks like inside the worker. */
-        urlOverrides?: {
+        origin?: {
             hostname?: string;
             secure?: boolean;
         };
@@ -23657,6 +23919,8 @@ declare interface StartDevWorkerOptions {
         outboundService?: ServiceFetch;
         /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
         mockFetch?: undici.MockAgent;
+        /** Gets a fetcher to a specific worker, used for multi-worker development */
+        getRegisteredWorker?(name: string): WorkerDefinition | undefined;
     };
 }
 
@@ -23681,30 +23945,35 @@ declare type Trigger = {
 } | {
     type: "route";
     pattern: string;
-    customDomain: true;
-} | {
+} | ({
     type: "route";
-    pattern: string;
-    zoneId: string;
-    customDomain?: true;
-    zoneName?: never;
-} | {
+} & ZoneIdRoute) | ({
     type: "route";
-    pattern: string;
-    zoneName: string;
-    customDomain?: true;
-    zoneId?: never;
-} | {
-    type: "schedule";
-    schedule: string;
-} | {
+} & ZoneNameRoute) | ({
+    type: "route";
+} & CustomDomainRoute) | {
+    type: "cron";
+    cron: string;
+} | ({
     type: "queue-consumer";
-    name: string;
-    maxBatchSize?: number;
-    maxBatchTimeout?: number;
-    maxRetries?: string;
-    deadLetterQueue?: string;
-};
+} & QueueConsumer);
+
+declare interface TypedEventEmitter<EventMap extends Record<string | symbol, unknown[]>> extends EventEmitter_2 {
+    addListener<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
+    on<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
+    once<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
+    removeListener<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
+    off<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
+    removeAllListeners(event?: keyof EventMap): this;
+    listeners<Name extends keyof EventMap>(eventName: Name): ((...args: EventMap[Name]) => void)[];
+    rawListeners<Name extends keyof EventMap>(eventName: Name): ((...args: EventMap[Name]) => void)[];
+    emit<Name extends keyof EventMap>(eventName: Name, ...args: EventMap[Name]): boolean;
+    listenerCount<Name extends keyof EventMap>(eventName: Name, listener?: (...args: EventMap[Name]) => void): number;
+    prependListener<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
+    prependOnceListener<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
+}
+
+declare const TypedEventEmitterImpl: new <EventMap extends Record<string | symbol, unknown[]>>() => TypedEventEmitter<EventMap>;
 
 declare namespace Undici {
     var Dispatcher: Dispatcher
@@ -23928,7 +24197,6 @@ export declare interface UnstableDevOptions {
     inspect?: boolean;
     local?: boolean;
     accountId?: string;
-    updateCheck?: boolean;
     experimental?: {
         processEntrypoint?: boolean;
         additionalModules?: CfModule[];
@@ -23942,6 +24210,7 @@ export declare interface UnstableDevOptions {
         testMode?: boolean;
         testScheduled?: boolean;
         watch?: boolean;
+        devEnv?: boolean;
     };
 }
 
@@ -24036,6 +24305,21 @@ declare interface WebSocketInit {
     headers?: HeadersInit
 }
 
+declare type WorkerDefinition = {
+    port: number | undefined;
+    protocol: "http" | "https" | undefined;
+    host: string | undefined;
+    mode: "local" | "remote";
+    headers?: Record<string, string>;
+    entrypointAddresses?: WorkerEntrypointsDefinition;
+    durableObjects: {
+        name: string;
+        className: string;
+    }[];
+    durableObjectsHost?: string;
+    durableObjectsPort?: number;
+};
+
 declare type WorkerEntrypointsDefinition = Record<"default" | string, {
     host: string;
     port: number;