wrangler 4.62.0 → 4.64.0

package/wrangler-dist/cli.d.ts

@@ -1,6 +1,6 @@
-import { Rule as Rule$1, CfModule, Environment as Environment$1, CfScriptFormat, CfModuleType, Config as Config$1, CfKvNamespace, CfSendEmailBindings, CfBrowserBinding, CfAIBinding, CfImagesBinding, CfDurableObject, CfWorkflow, CfQueue, CfR2Bucket, CfD1Database, CfVectorize, CfHyperdrive, CfService, CfAnalyticsEngineDataset, CfDispatchNamespace, CfMTlsCertificate, CfPipeline, CfSecretsStoreSecrets, CfLogfwdrBinding, CfHelloWorld, CfRateLimit, CfWorkerLoader, CfVpcService, CfMediaBinding, DurableObjectMigration as DurableObjectMigration$1, ContainerApp as ContainerApp$1, ZoneIdRoute as ZoneIdRoute$1, ZoneNameRoute as ZoneNameRoute$1, CustomDomainRoute as CustomDomainRoute$1, CfTailConsumer, ContainerEngine as ContainerEngine$1, CfUnsafe, ConfigBindingOptions, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, RawConfig as RawConfig$1, PackageJSON, ParseError, CfWorkerInit, ComplianceConfig, UserError, FatalError } from '@cloudflare/workers-utils';
-export { ConfigBindingOptions as Experimental_ConfigBindingOptions, experimental_patchConfig, experimental_readRawConfig, defaultWranglerConfig as unstable_defaultWranglerConfig } from '@cloudflare/workers-utils';
-import { Json as Json$1, Request, Response as Response$1, NodeJSCompatMode, DispatchFetch, Miniflare, WorkerRegistry, MiniflareOptions, Mutex, WorkerOptions, ModuleRule, RemoteProxyConnectionString } from 'miniflare';
+import { Rule as Rule$1, CfModule, Environment as Environment$1, CfScriptFormat, CfModuleType, Config as Config$1, Binding, DurableObjectMigration as DurableObjectMigration$1, ContainerApp as ContainerApp$1, Trigger, CfTailConsumer, ServiceFetch, ContainerEngine as ContainerEngine$1, CfUnsafe, ConfigBindingOptions, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, RawConfig as RawConfig$1, PackageJSON, ParseError, CfWorkerInit, ComplianceConfig, UserError, FatalError } from '@cloudflare/workers-utils';
+export { Binding, ConfigBindingOptions as Experimental_ConfigBindingOptions, experimental_patchConfig, experimental_readRawConfig, defaultWranglerConfig as unstable_defaultWranglerConfig } from '@cloudflare/workers-utils';
+import { Json as Json$1, WorkerRegistry, Miniflare, MiniflareOptions, Mutex, Response as Response$1, NodeJSCompatMode, DispatchFetch, RemoteProxyConnectionString, WorkerOptions, ModuleRule, Request } from 'miniflare';
 import * as undici from 'undici';
 import { RequestInfo, RequestInit, Response, FormData } from 'undici';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
@@ -194,13 +194,13 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
             };
         };
         latest_stage: {
-            status: "canceled" | "active" | "idle" | "success" | "failure" | "skipped";
+            status: "canceled" | "active" | "success" | "idle" | "failure" | "skipped";
             name: "build" | "queued" | "deploy" | "initialize" | "clone_repo";
             started_on: string | null;
             ended_on: string | null;
         };
         stages: {
-            status: "canceled" | "active" | "idle" | "success" | "failure" | "skipped";
+            status: "canceled" | "active" | "success" | "idle" | "failure" | "skipped";
             name: "build" | "queued" | "deploy" | "initialize" | "clone_repo";
             started_on: string | null;
             ended_on: string | null;
@@ -238,13 +238,6 @@ declare const unstable_pages: {
     deploy: typeof deploy;
 };
 
-type _Params<ParamsArray extends [unknown?]> = ParamsArray extends [infer P] ? P : undefined;
-type _EventMethods = keyof Protocol.Events;
-type DevToolsEvent<Method extends _EventMethods> = Method extends unknown ? {
-    method: Method;
-    params: _Params<Protocol.Events[Method]>;
-} : never;
-
 type AssetsOptions = {
     directory: string;
     binding?: string;
@@ -323,6 +316,139 @@ interface CfAccount {
     accountId: string;
 }
 
+type _Params<ParamsArray extends [unknown?]> = ParamsArray extends [infer P] ? P : undefined;
+type _EventMethods = keyof Protocol.Events;
+type DevToolsEvent<Method extends _EventMethods> = Method extends unknown ? {
+    method: Method;
+    params: _Params<Protocol.Events[Method]>;
+} : never;
+
+type ErrorEvent = BaseErrorEvent<"ConfigController" | "BundlerController" | "LocalRuntimeController" | "RemoteRuntimeController" | "ProxyWorker" | "InspectorProxyWorker" | "MultiworkerRuntimeController"> | BaseErrorEvent<"ProxyController", {
+    config?: StartDevWorkerOptions;
+    bundle?: Bundle;
+}> | BaseErrorEvent<"BundlerController", {
+    config?: StartDevWorkerOptions;
+    filePath?: string;
+}>;
+type BaseErrorEvent<Source = string, Data = undefined> = {
+    type: "error";
+    reason: string;
+    cause: Error | SerializedError;
+    source: Source;
+    data: Data;
+};
+type ConfigUpdateEvent = {
+    type: "configUpdate";
+    config: StartDevWorkerOptions;
+};
+type BundleStartEvent = {
+    type: "bundleStart";
+    config: StartDevWorkerOptions;
+};
+type BundleCompleteEvent = {
+    type: "bundleComplete";
+    config: StartDevWorkerOptions;
+    bundle: Bundle;
+};
+type ReloadStartEvent = {
+    type: "reloadStart";
+    config: StartDevWorkerOptions;
+    bundle: Bundle;
+};
+type ReloadCompleteEvent = {
+    type: "reloadComplete";
+    config: StartDevWorkerOptions;
+    bundle: Bundle;
+    proxyData: ProxyData;
+};
+type DevRegistryUpdateEvent = {
+    type: "devRegistryUpdate";
+    registry: WorkerRegistry;
+};
+type PreviewTokenExpiredEvent = {
+    type: "previewTokenExpired";
+    proxyData: ProxyData;
+};
+type ReadyEvent = {
+    type: "ready";
+    proxyWorker: Miniflare;
+    url: URL;
+    inspectorUrl: URL | undefined;
+};
+type ProxyWorkerIncomingRequestBody = {
+    type: "play";
+    proxyData: ProxyData;
+} | {
+    type: "pause";
+};
+type ProxyWorkerOutgoingRequestBody = {
+    type: "error";
+    error: SerializedError;
+} | {
+    type: "previewTokenExpired";
+    proxyData: ProxyData;
+} | {
+    type: "debug-log";
+    args: Parameters<typeof console.debug>;
+};
+
+type InspectorProxyWorkerIncomingWebSocketMessage = {
+    type: ReloadStartEvent["type"];
+} | {
+    type: ReloadCompleteEvent["type"];
+    proxyData: ProxyData;
+};
+type InspectorProxyWorkerOutgoingWebsocketMessage = DevToolsEvent<"Runtime.consoleAPICalled"> | DevToolsEvent<"Runtime.exceptionThrown">;
+type InspectorProxyWorkerOutgoingRequestBody = {
+    type: "error";
+    error: SerializedError;
+} | {
+    type: "runtime-websocket-error";
+    error: SerializedError;
+} | {
+    type: "debug-log";
+    args: Parameters<typeof console.debug>;
+} | {
+    type: "load-network-resource";
+    url: string;
+};
+type SerializedError = {
+    message: string;
+    name?: string;
+    stack?: string | undefined;
+    cause?: unknown;
+};
+type UrlOriginParts = Pick<URL, "protocol" | "hostname" | "port">;
+type UrlOriginAndPathnameParts = Pick<URL, "protocol" | "hostname" | "port" | "pathname">;
+type ProxyData = {
+    userWorkerUrl: UrlOriginParts;
+    userWorkerInspectorUrl?: UrlOriginAndPathnameParts;
+    userWorkerInnerUrlOverrides?: Partial<UrlOriginParts>;
+    headers: Record<string, string>;
+    liveReload?: boolean;
+    proxyLogsToController?: boolean;
+};
+
+type ControllerEvent = ErrorEvent | ConfigUpdateEvent | BundleStartEvent | BundleCompleteEvent | ReloadStartEvent | ReloadCompleteEvent | DevRegistryUpdateEvent | PreviewTokenExpiredEvent;
+interface ControllerBus {
+    dispatch(event: ControllerEvent): void;
+}
+declare abstract class Controller {
+    #private;
+    protected bus: ControllerBus;
+    constructor(bus: ControllerBus);
+    teardown(): Promise<void>;
+    protected emitErrorEvent(event: ErrorEvent): void;
+}
+declare abstract class RuntimeController extends Controller {
+    abstract onBundleStart(_: BundleStartEvent): void;
+    abstract onBundleComplete(_: BundleCompleteEvent): void;
+    abstract onPreviewTokenExpired(_: PreviewTokenExpiredEvent): void;
+    protected emitReloadStartEvent(data: ReloadStartEvent): void;
+    protected emitReloadCompleteEvent(data: ReloadCompleteEvent): void;
+    protected emitDevRegistryUpdateEvent(data: DevRegistryUpdateEvent): void;
+}
+
 declare class ConfigController extends Controller {
     #private;
     latestInput?: StartDevWorkerInput;
@@ -334,6 +460,76 @@ declare class ConfigController extends Controller {
     emitConfigUpdateEvent(config: StartDevWorkerOptions): void;
 }
 
+declare class BundlerController extends Controller {
+    #private;
+    onConfigUpdate(event: ConfigUpdateEvent): void;
+    teardown(): Promise<void>;
+    emitBundleStartEvent(config: StartDevWorkerOptions): void;
+    emitBundleCompleteEvent(config: StartDevWorkerOptions, bundle: EsbuildBundle): void;
+}
+
+declare class ProxyController extends Controller {
+    ready: DeferredPromise<ReadyEvent>;
+    localServerReady: DeferredPromise<void>;
+    proxyWorker?: Miniflare;
+    proxyWorkerOptions?: MiniflareOptions;
+    private inspectorProxyWorkerWebSocket?;
+    protected latestConfig?: StartDevWorkerOptions;
+    protected latestBundle?: EsbuildBundle;
+    secret: `${string}-${string}-${string}-${string}-${string}`;
+    protected createProxyWorker(): void;
+    private reconnectInspectorProxyWorker;
+    runtimeMessageMutex: Mutex;
+    sendMessageToProxyWorker(message: ProxyWorkerIncomingRequestBody, retries?: number): Promise<void>;
+    sendMessageToInspectorProxyWorker(message: InspectorProxyWorkerIncomingWebSocketMessage, retries?: number): Promise<void>;
+    get inspectorEnabled(): boolean;
+    onConfigUpdate(data: ConfigUpdateEvent): void;
+    onBundleStart(data: BundleStartEvent): void;
+    onReloadStart(data: ReloadStartEvent): void;
+    onReloadComplete(data: ReloadCompleteEvent): void;
+    onProxyWorkerMessage(message: ProxyWorkerOutgoingRequestBody): void;
+    onInspectorProxyWorkerMessage(message: InspectorProxyWorkerOutgoingWebsocketMessage): void;
+    onInspectorProxyWorkerRequest(message: InspectorProxyWorkerOutgoingRequestBody): Promise<Response$1>;
+    _torndown: boolean;
+    teardown(): Promise<void>;
+    emitReadyEvent(proxyWorker: Miniflare, url: URL, inspectorUrl: URL | undefined): void;
+    emitPreviewTokenExpiredEvent(proxyData: ProxyData): void;
+    emitErrorEvent(data: ErrorEvent): void;
+    emitErrorEvent(reason: string, cause?: Error | SerializedError): void;
+}
+
+type ControllerFactory<C extends Controller> = (devEnv: DevEnv) => C;
+declare class DevEnv extends EventEmitter implements ControllerBus {
+    config: ConfigController;
+    bundler: BundlerController;
+    runtimes: RuntimeController[];
+    proxy: ProxyController;
+    startWorker(options: StartDevWorkerInput): Promise<Worker>;
+    constructor({ configFactory, bundlerFactory, runtimeFactories, proxyFactory, }?: {
+        configFactory?: ControllerFactory<ConfigController>;
+        bundlerFactory?: ControllerFactory<BundlerController>;
+        runtimeFactories?: ControllerFactory<RuntimeController>[];
+        proxyFactory?: ControllerFactory<ProxyController>;
+    });
+    /**
+     * Central message bus dispatch method.
+     * All events from controllers flow through here, making the event routing explicit and traceable.
+     *
+     * Event flow:
+     * - ConfigController emits configUpdate → BundlerController, ProxyController
+     * - BundlerController emits bundleStart → ProxyController, RuntimeControllers
+     * - BundlerController emits bundleComplete → RuntimeControllers
+     * - RuntimeController emits reloadStart → ProxyController
+     * - RuntimeController emits reloadComplete → ProxyController
+     * - RuntimeController emits devRegistryUpdate → ConfigController
+     * - ProxyController emits previewTokenExpired → RuntimeControllers
+     * - Any controller emits error → DevEnv error handler
+     */
+    dispatch(event: ControllerEvent): void;
+    private handleErrorEvent;
+    teardown(): Promise<void>;
+}
+
 type MiniflareWorker = Awaited<ReturnType<Miniflare["getWorker"]>>;
 interface Worker {
     ready: Promise<void>;
@@ -521,241 +717,6 @@ type Hook<T extends HookValues, Args extends unknown[] = []> = T | ((...args: Ar
 type AsyncHook<T extends HookValues, Args extends unknown[] = []> = Hook<T, Args> | Hook<Promise<T>, Args>;
 type Bundle = EsbuildBundle;
 type LogLevel = "debug" | "info" | "log" | "warn" | "error" | "none";
-type File<Contents = string, Path = string> = {
-    path: Path;
-} | {
-    contents: Contents;
-    path?: Path;
-};
-type BinaryFile = File<Uint8Array>;
-type QueueConsumer = NonNullable<Config$1["queues"]["consumers"]>[number];
-type Trigger = {
-    type: "workers.dev";
-} | {
-    type: "route";
-    pattern: string;
-} | ({
-    type: "route";
-} & ZoneIdRoute$1) | ({
-    type: "route";
-} & ZoneNameRoute$1) | ({
-    type: "route";
-} & CustomDomainRoute$1) | {
-    type: "cron";
-    cron: string;
-} | ({
-    type: "queue-consumer";
-} & QueueConsumer);
-type BindingOmit<T> = Omit<T, "binding">;
-type NameOmit<T> = Omit<T, "name">;
-type Binding = {
-    type: "plain_text";
-    value: string;
-} | {
-    type: "json";
-    value: Json$1;
-} | ({
-    type: "kv_namespace";
-} & BindingOmit<CfKvNamespace>) | ({
-    type: "send_email";
-} & NameOmit<CfSendEmailBindings>) | {
-    type: "wasm_module";
-    source: BinaryFile;
-} | {
-    type: "text_blob";
-    source: File;
-} | ({
-    type: "browser";
-} & BindingOmit<CfBrowserBinding>) | ({
-    type: "ai";
-} & BindingOmit<CfAIBinding>) | ({
-    type: "images";
-} & BindingOmit<CfImagesBinding>) | {
-    type: "version_metadata";
-} | {
-    type: "data_blob";
-    source: BinaryFile;
-} | ({
-    type: "durable_object_namespace";
-} & NameOmit<CfDurableObject>) | ({
-    type: "workflow";
-} & BindingOmit<CfWorkflow>) | ({
-    type: "queue";
-} & BindingOmit<CfQueue>) | ({
-    type: "r2_bucket";
-} & BindingOmit<CfR2Bucket>) | ({
-    type: "d1";
-} & BindingOmit<CfD1Database>) | ({
-    type: "vectorize";
-} & BindingOmit<CfVectorize>) | ({
-    type: "hyperdrive";
-} & BindingOmit<CfHyperdrive>) | ({
-    type: "service";
-} & BindingOmit<CfService>) | {
-    type: "fetcher";
-    fetcher: ServiceFetch;
-} | ({
-    type: "analytics_engine";
-} & BindingOmit<CfAnalyticsEngineDataset>) | ({
-    type: "dispatch_namespace";
-} & BindingOmit<CfDispatchNamespace>) | ({
-    type: "mtls_certificate";
-} & BindingOmit<CfMTlsCertificate>) | ({
-    type: "pipeline";
-} & BindingOmit<CfPipeline>) | ({
-    type: "secrets_store_secret";
-} & BindingOmit<CfSecretsStoreSecrets>) | ({
-    type: "logfwdr";
-} & NameOmit<CfLogfwdrBinding>) | ({
-    type: "unsafe_hello_world";
-} & BindingOmit<CfHelloWorld>) | ({
-    type: "ratelimit";
-} & NameOmit<CfRateLimit>) | ({
-    type: "worker_loader";
-} & BindingOmit<CfWorkerLoader>) | ({
-    type: "vpc_service";
-} & BindingOmit<CfVpcService>) | ({
-    type: "media";
-} & BindingOmit<CfMediaBinding>) | {
-    type: `unsafe_${string}`;
-} | {
-    type: "assets";
-};
-type ServiceFetch = (request: Request) => Promise<Response$1> | Response$1;
-
-type ErrorEvent = BaseErrorEvent<"ConfigController" | "BundlerController" | "LocalRuntimeController" | "RemoteRuntimeController" | "ProxyWorker" | "InspectorProxyWorker" | "MultiworkerRuntimeController"> | BaseErrorEvent<"ProxyController", {
-    config?: StartDevWorkerOptions;
-    bundle?: Bundle;
-}> | BaseErrorEvent<"BundlerController", {
-    config?: StartDevWorkerOptions;
-    filePath?: string;
-}>;
-type BaseErrorEvent<Source = string, Data = undefined> = {
-    type: "error";
-    reason: string;
-    cause: Error | SerializedError;
-    source: Source;
-    data: Data;
-};
-type ConfigUpdateEvent = {
-    type: "configUpdate";
-    config: StartDevWorkerOptions;
-};
-type BundleStartEvent = {
-    type: "bundleStart";
-    config: StartDevWorkerOptions;
-};
-type BundleCompleteEvent = {
-    type: "bundleComplete";
-    config: StartDevWorkerOptions;
-    bundle: Bundle;
-};
-type ReloadStartEvent = {
-    type: "reloadStart";
-    config: StartDevWorkerOptions;
-    bundle: Bundle;
-};
-type ReloadCompleteEvent = {
-    type: "reloadComplete";
-    config: StartDevWorkerOptions;
-    bundle: Bundle;
-    proxyData: ProxyData;
-};
-type DevRegistryUpdateEvent = {
-    type: "devRegistryUpdate";
-    registry: WorkerRegistry;
-};
-type PreviewTokenExpiredEvent = {
-    type: "previewTokenExpired";
-    proxyData: ProxyData;
-};
-type ReadyEvent = {
-    type: "ready";
-    proxyWorker: Miniflare;
-    url: URL;
-    inspectorUrl: URL | undefined;
-};
-type ProxyWorkerIncomingRequestBody = {
-    type: "play";
-    proxyData: ProxyData;
-} | {
-    type: "pause";
-};
-type ProxyWorkerOutgoingRequestBody = {
-    type: "error";
-    error: SerializedError;
-} | {
-    type: "previewTokenExpired";
-    proxyData: ProxyData;
-} | {
-    type: "debug-log";
-    args: Parameters<typeof console.debug>;
-};
-
-type InspectorProxyWorkerIncomingWebSocketMessage = {
-    type: ReloadStartEvent["type"];
-} | {
-    type: ReloadCompleteEvent["type"];
-    proxyData: ProxyData;
-};
-type InspectorProxyWorkerOutgoingWebsocketMessage = DevToolsEvent<"Runtime.consoleAPICalled"> | DevToolsEvent<"Runtime.exceptionThrown">;
-type InspectorProxyWorkerOutgoingRequestBody = {
-    type: "error";
-    error: SerializedError;
-} | {
-    type: "runtime-websocket-error";
-    error: SerializedError;
-} | {
-    type: "debug-log";
-    args: Parameters<typeof console.debug>;
-} | {
-    type: "load-network-resource";
-    url: string;
-};
-type SerializedError = {
-    message: string;
-    name?: string;
-    stack?: string | undefined;
-    cause?: unknown;
-};
-type UrlOriginParts = Pick<URL, "protocol" | "hostname" | "port">;
-type UrlOriginAndPathnameParts = Pick<URL, "protocol" | "hostname" | "port" | "pathname">;
-type ProxyData = {
-    userWorkerUrl: UrlOriginParts;
-    userWorkerInspectorUrl?: UrlOriginAndPathnameParts;
-    userWorkerInnerUrlOverrides?: Partial<UrlOriginParts>;
-    headers: Record<string, string>;
-    liveReload?: boolean;
-    proxyLogsToController?: boolean;
-};
-
-type ControllerEvent = ErrorEvent | ConfigUpdateEvent | BundleStartEvent | BundleCompleteEvent | ReloadStartEvent | ReloadCompleteEvent | DevRegistryUpdateEvent | PreviewTokenExpiredEvent;
-interface ControllerBus {
-    dispatch(event: ControllerEvent): void;
-}
-declare abstract class Controller {
-    #private;
-    protected bus: ControllerBus;
-    constructor(bus: ControllerBus);
-    teardown(): Promise<void>;
-    protected emitErrorEvent(event: ErrorEvent): void;
-}
-declare abstract class RuntimeController extends Controller {
-    abstract onBundleStart(_: BundleStartEvent): void;
-    abstract onBundleComplete(_: BundleCompleteEvent): void;
-    abstract onPreviewTokenExpired(_: PreviewTokenExpiredEvent): void;
-    protected emitReloadStartEvent(data: ReloadStartEvent): void;
-    protected emitReloadCompleteEvent(data: ReloadCompleteEvent): void;
-    protected emitDevRegistryUpdateEvent(data: DevRegistryUpdateEvent): void;
-}
-
-declare class BundlerController extends Controller {
-    #private;
-    onConfigUpdate(event: ConfigUpdateEvent): void;
-    teardown(): Promise<void>;
-    emitBundleStartEvent(config: StartDevWorkerOptions): void;
-    emitBundleCompleteEvent(config: StartDevWorkerOptions, bundle: EsbuildBundle): void;
-}
 
 type MaybePromise<T> = T | Promise<T>;
 type DeferredPromise<T> = {
@@ -765,68 +726,6 @@ type DeferredPromise<T> = {
 };
 declare function convertConfigBindingsToStartWorkerBindings(configBindings: ConfigBindingOptions): StartDevWorkerOptions["bindings"];
 
-declare class ProxyController extends Controller {
-    ready: DeferredPromise<ReadyEvent>;
-    localServerReady: DeferredPromise<void>;
-    proxyWorker?: Miniflare;
-    proxyWorkerOptions?: MiniflareOptions;
-    private inspectorProxyWorkerWebSocket?;
-    protected latestConfig?: StartDevWorkerOptions;
-    protected latestBundle?: EsbuildBundle;
-    secret: `${string}-${string}-${string}-${string}-${string}`;
-    protected createProxyWorker(): void;
-    private reconnectInspectorProxyWorker;
-    runtimeMessageMutex: Mutex;
-    sendMessageToProxyWorker(message: ProxyWorkerIncomingRequestBody, retries?: number): Promise<void>;
-    sendMessageToInspectorProxyWorker(message: InspectorProxyWorkerIncomingWebSocketMessage, retries?: number): Promise<void>;
-    get inspectorEnabled(): boolean;
-    onConfigUpdate(data: ConfigUpdateEvent): void;
-    onBundleStart(data: BundleStartEvent): void;
-    onReloadStart(data: ReloadStartEvent): void;
-    onReloadComplete(data: ReloadCompleteEvent): void;
-    onProxyWorkerMessage(message: ProxyWorkerOutgoingRequestBody): void;
-    onInspectorProxyWorkerMessage(message: InspectorProxyWorkerOutgoingWebsocketMessage): void;
-    onInspectorProxyWorkerRequest(message: InspectorProxyWorkerOutgoingRequestBody): Promise<Response$1>;
-    _torndown: boolean;
-    teardown(): Promise<void>;
-    emitReadyEvent(proxyWorker: Miniflare, url: URL, inspectorUrl: URL | undefined): void;
-    emitPreviewTokenExpiredEvent(proxyData: ProxyData): void;
-    emitErrorEvent(data: ErrorEvent): void;
-    emitErrorEvent(reason: string, cause?: Error | SerializedError): void;
-}
-
-type ControllerFactory<C extends Controller> = (devEnv: DevEnv) => C;
-declare class DevEnv extends EventEmitter implements ControllerBus {
-    config: ConfigController;
-    bundler: BundlerController;
-    runtimes: RuntimeController[];
-    proxy: ProxyController;
-    startWorker(options: StartDevWorkerInput): Promise<Worker>;
-    constructor({ configFactory, bundlerFactory, runtimeFactories, proxyFactory, }?: {
-        configFactory?: ControllerFactory<ConfigController>;
-        bundlerFactory?: ControllerFactory<BundlerController>;
-        runtimeFactories?: ControllerFactory<RuntimeController>[];
-        proxyFactory?: ControllerFactory<ProxyController>;
-    });
-    /**
-     * Central message bus dispatch method.
-     * All events from controllers flow through here, making the event routing explicit and traceable.
-     *
-     * Event flow:
-     * - ConfigController emits configUpdate → BundlerController, ProxyController
-     * - BundlerController emits bundleStart → ProxyController, RuntimeControllers
-     * - BundlerController emits bundleComplete → RuntimeControllers
-     * - RuntimeController emits reloadStart → ProxyController
-     * - RuntimeController emits reloadComplete → ProxyController
-     * - RuntimeController emits devRegistryUpdate → ConfigController
-     * - ProxyController emits previewTokenExpired → RuntimeControllers
-     * - Any controller emits error → DevEnv error handler
-     */
-    dispatch(event: ControllerEvent): void;
-    private handleErrorEvent;
-    teardown(): Promise<void>;
-}
-
 declare function startWorker(options: StartDevWorkerInput): Promise<Worker>;
 
 type ReadConfigCommandArgs = NormalizeAndValidateConfigArgs & {
@@ -2465,9 +2364,18 @@ interface EnvironmentMap {
  */
 declare function getVarsForDev(configPath: string | undefined, envFiles: string[] | undefined, vars: Config$1["vars"], env: string | undefined, silent?: boolean): Config$1["vars"];
 
+/** Makes a subset of properties in a type optional
+ *
+ * @example
+ * 	- type A = { s: string, b: boolean, n: number }
+ *  - Optional<A, 'b'|'n'> = { s: string, b?: boolean, n?: number }
+ */
+type Optional<T, K extends keyof T> = Omit<T, K> & Pick<Partial<T>, K>;
+
 type FrameworkInfo = {
     id: string;
     name: string;
+    class: typeof Framework;
 };
 
 type ConfigurationOptions = {
@@ -2492,14 +2400,14 @@ type ConfigurationResults = {
 declare abstract class Framework {
     readonly id: string;
     readonly name: string;
-    constructor(frameworkInfo: FrameworkInfo);
+    constructor(frameworkInfo: Pick<FrameworkInfo, "id" | "name">);
     isConfigured(_projectPath: string): boolean;
     abstract configure(options: ConfigurationOptions): Promise<ConfigurationResults> | ConfigurationResults;
     configurationDescription?: string;
     autoConfigSupported: boolean;
 }
 
-type AutoConfigDetails = {
+type AutoConfigDetailsBase = {
     /** The name of the worker */
     workerName: string;
     /** The path to the project (defaults to cwd) */
@@ -2508,13 +2416,20 @@ type AutoConfigDetails = {
     packageJson?: PackageJSON;
     /** Whether the project is already configured (no autoconfig required) */
     configured: boolean;
-    /** Details about the detected framework (if any) */
-    framework?: Framework;
+    /** Details about the detected framework. It can be a JS framework or 'Static' if no actual JS framework is used. */
+    framework: Framework;
     /** The build command used to build the project (if any) */
     buildCommand?: string;
     /** The output directory (if no framework is used, points to the raw asset files) */
-    outputDir?: string;
+    outputDir: string;
 };
+type AutoConfigDetailsForConfiguredProject = Optional<AutoConfigDetailsBase, "framework" | "outputDir"> & {
+    configured: true;
+};
+type AutoConfigDetailsForNonConfiguredProject = AutoConfigDetailsBase & {
+    configured: false;
+};
+type AutoConfigDetails = AutoConfigDetailsForConfiguredProject | AutoConfigDetailsForNonConfiguredProject;
 type AutoConfigOptions = {
     /** Whether to run autoconfig without actually applying any filesystem modification (default: false) */
     dryRun?: boolean;
@@ -2774,10 +2689,7 @@ declare class Logger {
     private formatMessage;
 }
 
-/**
- * Print all the bindings a worker using a given config would have access to
- */
-declare function printBindings(bindings: Partial<CfWorkerInit["bindings"]>, tailConsumers?: CfTailConsumer[], streamingTailConsumers?: CfTailConsumer[], containers?: ContainerApp$1[], context?: {
+type PrintContext = {
     log?: (message: string) => void;
     registry?: WorkerRegistry | null;
     local?: boolean;
@@ -2786,7 +2698,12 @@ declare function printBindings(bindings: Partial<CfWorkerInit["bindings"]>, tail
     name?: string;
     provisioning?: boolean;
     warnIfNoBindings?: boolean;
-}): void;
+    unsafeMetadata?: Record<string, unknown>;
+};
+/**
+ * Print all the bindings a worker using a given config would have access to
+ */
+declare function printBindings(bindings: Partial<CfWorkerInit["bindings"]>, tailConsumers?: CfTailConsumer[], streamingTailConsumers?: CfTailConsumer[], containers?: ContainerApp$1[], context?: Omit<PrintContext, "unsafeMetadata">): void;
 
 /**
  * Split an SQLQuery into an array of statements
@@ -3153,11 +3070,18 @@ declare function experimental_getWranglerCommands(): {
     globalFlags: ReturnType<typeof createCLIParser>["globalFlags"];
 };
 
+/**
+ * This file contains:
+ *
+ * - The main entrypoint for the CLI, which calls `main()` from `index.ts`.
+ * - The exports for the public API of the package.
+ */
+
 interface Unstable_ASSETSBindingsOptions {
     log: Logger;
     proxyPort?: number;
     directory?: string;
 }
-declare const generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request) => Promise<Response$1>;
+declare const unstable_generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request) => Promise<Response$1>;
 
-export { type Binding, type GetPlatformProxyOptions, type PlatformProxy, type RemoteProxySession, type SourcelessWorkerOptions, type StartRemoteProxySessionOptions, type Unstable_ASSETSBindingsOptions, type Config as Unstable_Config, type Unstable_DevOptions, type Unstable_DevWorker, type Unstable_MiniflareWorkerOptions, type RawConfig as Unstable_RawConfig, type RawEnvironment as Unstable_RawEnvironment, Framework as experimental_AutoConfigFramework, getDetailsForAutoConfig as experimental_getDetailsForAutoConfig, experimental_getWranglerCommands, runAutoConfig as experimental_runAutoConfig, getPlatformProxy, maybeStartOrUpdateRemoteProxySession, startRemoteProxySession, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, generateASSETSBinding as unstable_generateASSETSBinding, unstable_getDevCompatibilityDate, getDurableObjectClassNameToUseSQLiteMap as unstable_getDurableObjectClassNameToUseSQLiteMap, unstable_getMiniflareWorkerOptions, getVarsForDev as unstable_getVarsForDev, getWorkerNameFromProject as unstable_getWorkerNameFromProject, unstable_pages, printBindings as unstable_printBindings, readConfig as unstable_readConfig, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };
+export { type GetPlatformProxyOptions, type PlatformProxy, type RemoteProxySession, type SourcelessWorkerOptions, type StartRemoteProxySessionOptions, type Unstable_ASSETSBindingsOptions, type Config as Unstable_Config, type Unstable_DevOptions, type Unstable_DevWorker, type Unstable_MiniflareWorkerOptions, type RawConfig as Unstable_RawConfig, type RawEnvironment as Unstable_RawEnvironment, Framework as experimental_AutoConfigFramework, getDetailsForAutoConfig as experimental_getDetailsForAutoConfig, experimental_getWranglerCommands, runAutoConfig as experimental_runAutoConfig, getPlatformProxy, maybeStartOrUpdateRemoteProxySession, startRemoteProxySession, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, unstable_generateASSETSBinding, unstable_getDevCompatibilityDate, getDurableObjectClassNameToUseSQLiteMap as unstable_getDurableObjectClassNameToUseSQLiteMap, unstable_getMiniflareWorkerOptions, getVarsForDev as unstable_getVarsForDev, getWorkerNameFromProject as unstable_getWorkerNameFromProject, unstable_pages, printBindings as unstable_printBindings, readConfig as unstable_readConfig, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };