wrangler 0.0.0-e2e6912bc → 0.0.0-e2f5756c2

package/wrangler-dist/cli.d.ts

@@ -6,7 +6,6 @@ import type { DispatchFetch } from 'miniflare';
 import { Duplex } from 'stream';
 import { EventEmitter } from 'events';
 import { EventEmitter as EventEmitter_2 } from 'node:events';
-import { IncomingMessage } from 'http';
 import type { IncomingRequestCfProperties } from '@cloudflare/workers-types/experimental';
 import { IpcNetConnectOpts } from 'net';
 import type { Json } from 'miniflare';
@@ -21,8 +20,6 @@ import { Readable } from 'stream';
 import { ReadableStream as ReadableStream_2 } from 'stream/web';
 import type { Request as Request_3 } from 'miniflare';
 import { Response as Response_3 } from 'miniflare';
-import { Server } from 'http';
-import { ServerResponse } from 'http';
 import { Socket } from 'net';
 import { TcpNetConnectOpts } from 'net';
 import { TLSSocket } from 'tls';
@@ -79,23 +76,36 @@ declare type AssetConfig = z.infer<typeof AssetConfigSchema>;
 declare const AssetConfigSchema: z.ZodObject<{
     html_handling: z.ZodOptional<z.ZodEnum<["auto-trailing-slash", "force-trailing-slash", "drop-trailing-slash", "none"]>>;
     not_found_handling: z.ZodOptional<z.ZodEnum<["single-page-application", "404-page", "none"]>>;
+    serve_directly: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     html_handling?: "none" | "auto-trailing-slash" | "force-trailing-slash" | "drop-trailing-slash";
     not_found_handling?: "none" | "single-page-application" | "404-page";
+    serve_directly?: boolean;
 }, {
     html_handling?: "none" | "auto-trailing-slash" | "force-trailing-slash" | "drop-trailing-slash";
     not_found_handling?: "none" | "single-page-application" | "404-page";
+    serve_directly?: boolean;
 }>;
 
 declare type Assets = {
     /** Absolute path to assets directory */
-    directory: string;
+    directory?: string;
+    /** Name of `env` binding property in the User Worker. */
     binding?: string;
+    /** How to handle HTML requests. */
     html_handling?: "auto-trailing-slash" | "force-trailing-slash" | "drop-trailing-slash" | "none";
+    /** How to handle requests that do not match an asset. */
     not_found_handling?: "single-page-application" | "404-page" | "none";
+    /**
+     * If true, then respond to requests that match an asset with that asset directly.
+     * If false, route every request to the User Worker, whether or not it matches an asset.
+     * */
+    experimental_serve_directly?: boolean;
 };
 
-declare type AssetsOptions = Pick<Assets, "directory" | "binding"> & {
+declare type AssetsOptions = {
+    directory: string;
+    binding?: string;
     routingConfig: RoutingConfig;
     assetConfig: AssetConfig;
 };
@@ -449,8 +459,8 @@ declare type CfCapnp = {
 
 declare interface CfD1Database {
     binding: string;
-    database_id: string;
-    database_name: string;
+    database_id?: string | typeof INHERIT_SYMBOL;
+    database_name?: string;
     preview_database_id?: string;
     database_internal_env?: string;
     migrations_table?: string;
@@ -488,7 +498,7 @@ declare interface CfHyperdrive {
  */
 declare interface CfKvNamespace {
     binding: string;
-    id: string;
+    id?: string | typeof INHERIT_SYMBOL;
 }
 
 declare interface CfLogfwdrBinding {
@@ -564,7 +574,7 @@ declare interface CfQueue {
 
 declare interface CfR2Bucket {
     binding: string;
-    bucket_name: string;
+    bucket_name?: string | typeof INHERIT_SYMBOL;
     jurisdiction?: string;
 }
 
@@ -759,28 +769,19 @@ declare type CloudchamberConfig = {
     ipv4?: boolean;
 };
 
-/**
- * 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 interface ComputedFields {
+    /** The path to the Wrangler configuration file (if any, and possibly redirected from the user Wrangler configuration) used to create this configuration. */
+    configPath: string | undefined;
+    /** The path to the user's Wrangler configuration file (if any), which may have been redirected to another file that used to create this configuration. */
+    userConfigPath: string | undefined;
+    /**
+     * The original top level name for the Worker in the raw configuration.
+     *
+     * When a raw configuration has been flattened to a single environment the worker name may have been replaced or transformed.
+     * It can be useful to know what the top-level name was before the flattening.
+     */
+    topLevelName: string | undefined;
+}
 
 declare class ConfigController extends Controller<ConfigControllerEventMap> {
     #private;
@@ -797,7 +798,6 @@ declare type ConfigControllerEventMap = ControllerEventMap & {
 };
 
 declare interface ConfigFields<Dev extends RawDevConfig> {
-    configPath: string | undefined;
     /**
      * A boolean to enable "legacy" style wrangler environments (from Wrangler v1).
      * These have been superseded by Services, but there may be projects that won't
@@ -826,7 +826,7 @@ declare interface ConfigFields<Dev extends RawDevConfig> {
         /**
          * The directory containing your static assets.
          *
-         * It must be a path relative to your wrangler.toml file.
+         * It must be a path relative to your Wrangler configuration file.
          * Example: bucket = "./public"
          *
          * If there is a `site` field then it must contain this `bucket` field.
@@ -904,7 +904,7 @@ declare interface ConfigFields<Dev extends RawDevConfig> {
         [key: string]: string;
     } | undefined;
     /**
-     * By default, wrangler.toml is the source of truth for your environment configuration, like a terraform file.
+     * By default, the Wrangler configuration file is the source of truth for your environment configuration, like a terraform file.
      *
      * If you change your vars in the dashboard, wrangler *will* override/delete them on its next deploy.
      *
@@ -932,6 +932,32 @@ url: string | URL_2 | UrlObject,
 options?: { dispatcher?: Dispatcher } & Omit<Dispatcher.ConnectOptions, 'origin' | 'path'>
 ): Promise<Dispatcher.ConnectData>;
 
+/**
+ * Configuration for a container application
+ */
+declare type ContainerApp = {
+    name: string;
+    instances: number;
+    scheduling_policy?: "regional" | "moon";
+    configuration: {
+        image: string;
+        labels?: {
+            name: string;
+            value: string;
+        }[];
+        secrets?: {
+            name: string;
+            type: "env";
+            secret: string;
+        }[];
+    };
+    constraints?: {
+        regions?: string[];
+        cities?: string[];
+        tier?: number;
+    };
+};
+
 declare abstract class Controller<EventMap extends ControllerEventMap = ControllerEventMap> extends TypedEventEmitterImpl<EventMap> {
     emitErrorEvent(data: ErrorEvent): void;
 }
@@ -1006,14 +1032,14 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
         type: string;
     };
     latest_stage: {
+        status: "canceled" | "active" | "idle" | "success" | "failure" | "skipped";
         name: "queued" | "build" | "deploy" | "initialize" | "clone_repo";
-        status: "active" | "idle" | "success" | "canceled" | "failure" | "skipped";
         started_on: string | null;
         ended_on: string | null;
     };
     stages: {
+        status: "canceled" | "active" | "idle" | "success" | "failure" | "skipped";
         name: "queued" | "build" | "deploy" | "initialize" | "clone_repo";
-        status: "active" | "idle" | "success" | "canceled" | "failure" | "skipped";
         started_on: string | null;
         ended_on: string | null;
     }[];
@@ -1021,8 +1047,8 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
     modified_on: string;
     short_id: string;
     build_image_major_version: number;
+    kv_namespaces?: any;
     source?: {
-        type: "github" | "gitlab";
         config: {
             owner: string;
             repo_name: string;
@@ -1030,12 +1056,12 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
             pr_comments_enabled?: boolean | undefined;
             deployments_enabled?: boolean | undefined;
             production_deployments_enabled?: boolean | undefined;
-            preview_deployment_setting?: "none" | "all" | "custom" | undefined;
+            preview_deployment_setting?: "none" | "custom" | "all" | undefined;
             preview_branch_includes?: string[] | undefined;
             preview_branch_excludes?: string[] | undefined;
         };
+        type: "github" | "gitlab";
     } | undefined;
-    kv_namespaces?: any;
     env_vars?: any;
     durable_object_namespaces?: any;
     is_skipped?: boolean | undefined;
@@ -1044,6 +1070,30 @@ 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.
  */
@@ -1056,9 +1106,9 @@ declare interface DeprecatedUpload {
     format?: "modules" | "service-worker";
     /**
      * The directory you wish to upload your Worker from,
-     * relative to the wrangler.toml file.
+     * relative to the Wrangler configuration file.
      *
-     * Defaults to the directory containing the wrangler.toml file.
+     * Defaults to the directory containing the Wrangler configuration file.
      *
      * @deprecated
      */
@@ -1468,8 +1518,8 @@ declare interface EnablePagesAssetsServiceBindingOptions {
 declare type Entry = {
     /** A worker's entrypoint */
     file: string;
-    /** A worker's directory. Usually where the wrangler.toml file is located */
-    directory: string;
+    /** A worker's directory. Usually where the Wrangler configuration file is located */
+    projectRoot: string;
     /** Is this a module worker or a service worker? */
     format: CfScriptFormat;
     /** The directory that contains all of a `--no-bundle` worker's modules. Usually `${directory}/src`. Defaults to path.dirname(file) */
@@ -1491,6 +1541,39 @@ 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.
@@ -1523,11 +1606,11 @@ declare interface EnvironmentInheritable {
     compatibility_date: string | undefined;
     /**
      * A list of flags that enable features from upcoming features of
-     * the Workers runtime, usually used together with compatibility_flags.
+     * the Workers runtime, usually used together with compatibility_date.
      *
-     * More details at https://developers.cloudflare.com/workers/platform/compatibility-dates
+     * More details at https://developers.cloudflare.com/workers/platform/compatibility-flags
      *
-     * @default `[]`
+     * @default []
      * @inheritable
      */
     compatibility_flags: string[];
@@ -1565,13 +1648,20 @@ declare interface EnvironmentInheritable {
      * Whether we use <name>.<subdomain>.workers.dev to
      * test and deploy your Worker.
      *
-     * // Carmen according to our tests the default is undefined
-     * // warning: you must force "workers_dev: true" in tests to match expected behavior
-     * @default `true` (This is a breaking change from Wrangler v1)
+     *
+     * @default true
      * @breaking
      * @inheritable
      */
     workers_dev: boolean | undefined;
+    /**
+     * Whether we use <version>-<name>.<subdomain>.workers.dev to
+     * serve Preview URLs for your Worker.
+     *
+     * @default true
+     * @inheritable
+     */
+    preview_urls: boolean | undefined;
     /**
      * A list of routes that your Worker should be published to.
      * Only one of `routes` or `route` is required.
@@ -1600,14 +1690,14 @@ declare interface EnvironmentInheritable {
     /**
      * The function to use to replace jsx syntax.
      *
-     * @default `"React.createElement"`
+     * @default "React.createElement"
      * @inheritable
      */
     jsx_factory: string;
     /**
      * The function to use to replace jsx fragment syntax.
      *
-     * @default `"React.Fragment"`
+     * @default "React.Fragment"
      * @inheritable
      */
     jsx_fragment: string;
@@ -1629,7 +1719,7 @@ declare interface EnvironmentInheritable {
      *
      * More details here https://developers.cloudflare.com/workers/platform/cron-triggers
      *
-     * @default `{crons:[]}`
+     * @default {crons:[]}
      * @inheritable
      */
     triggers: {
@@ -1715,7 +1805,7 @@ declare interface EnvironmentInheritable {
     /**
      * List of bindings that you will send to logfwdr
      *
-     * @default `{bindings:[]}`
+     * @default {bindings:[]}
      * @inheritable
      */
     logfwdr: {
@@ -1769,6 +1859,24 @@ declare interface EnvironmentInheritable {
     observability: Observability | 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]: Unstable_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.
@@ -1783,7 +1891,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{}`
+     * @default {}
      * @nonInheritable
      */
     define: Record<string, string>;
@@ -1793,7 +1901,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{}`
+     * @default {}
      * @nonInheritable
      */
     vars: Record<string, string | Json>;
@@ -1806,7 +1914,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{bindings:[]}`
+     * @default {bindings:[]}
      * @nonInheritable
      */
     durable_objects: {
@@ -1818,7 +1926,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     workflows: WorkflowBinding[];
@@ -1828,10 +1936,25 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{}`
+     * @default {}
      * @nonInheritable
      */
     cloudchamber: CloudchamberConfig;
+    /**
+     * Container related configuration
+     */
+    containers: {
+        /**
+         * Container app configuration
+         *
+         * NOTE: This field is not automatically inherited from the top level environment,
+         * and so must be specified in every named environment.
+         *
+         * @default {}
+         * @nonInheritable
+         */
+        app: ContainerApp[];
+    };
     /**
      * These specify any Workers KV Namespaces you want to
      * access from inside your Worker.
@@ -1842,14 +1965,14 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     kv_namespaces: {
         /** The binding name used to refer to the KV Namespace */
         binding: string;
         /** The ID of the KV namespace */
-        id: string;
+        id?: string;
         /** The ID of the KV namespace used during `wrangler dev` */
         preview_id?: string;
     }[];
@@ -1859,7 +1982,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     send_email: {
@@ -1876,7 +1999,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{consumers:[],producers:[]}`
+     * @default {consumers:[],producers:[]}
      * @nonInheritable
      */
     queues: {
@@ -1917,14 +2040,14 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     r2_buckets: {
         /** The binding name used to refer to the R2 bucket in the Worker. */
         binding: string;
         /** The name of this R2 bucket at the edge. */
-        bucket_name: string;
+        bucket_name?: string;
         /** The preview name of this R2 bucket at the edge. */
         preview_bucket_name?: string;
         /** The jurisdiction that the bucket exists in. Default if not present. */
@@ -1936,16 +2059,16 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     d1_databases: {
         /** The binding name used to refer to the D1 database in the Worker. */
         binding: string;
         /** The name of this D1 database. */
-        database_name: string;
+        database_name?: string;
         /** The UUID of this D1 database (not required). */
-        database_id: string;
+        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'). */
@@ -1961,7 +2084,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     vectorize: {
@@ -1976,7 +2099,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     hyperdrive: {
@@ -1993,7 +2116,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     services: {
@@ -2012,7 +2135,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     analytics_engine_datasets: {
@@ -2027,7 +2150,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{}`
+     * @default {}
      * @nonInheritable
      */
     browser: {
@@ -2039,7 +2162,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{}`
+     * @default {}
      * @nonInheritable
      */
     ai: {
@@ -2058,7 +2181,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `{}`
+     * @default {}
      * @nonInheritable
      */
     unsafe: {
@@ -2098,7 +2221,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     mtls_certificates: {
@@ -2113,7 +2236,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     tail_consumers?: TailConsumer[];
@@ -2123,7 +2246,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     dispatch_namespaces: {
@@ -2140,7 +2263,7 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default `[]`
+     * @default []
      * @nonInheritable
      */
     pipelines: {
@@ -2151,7 +2274,7 @@ declare interface EnvironmentNonInheritable {
     }[];
 }
 
-declare type ErrorEvent = BaseErrorEvent<"ConfigController" | "BundlerController" | "LocalRuntimeController" | "RemoteRuntimeController" | "ProxyWorker" | "InspectorProxyWorker"> | BaseErrorEvent<"ProxyController", {
+declare type ErrorEvent = BaseErrorEvent<"ConfigController" | "BundlerController" | "LocalRuntimeController" | "RemoteRuntimeController" | "ProxyWorker" | "InspectorProxyWorker" | "MultiworkerRuntimeController"> | BaseErrorEvent<"ProxyController", {
     config?: StartDevWorkerOptions;
     bundle?: Bundle;
 }> | BaseErrorEvent<"BundlerController", {
@@ -2360,6 +2483,14 @@ declare class ExecutionContext {
     passThroughOnException(): void;
 }
 
+export declare const experimental_patchConfig: (configPath: string, patch: Unstable_RawConfig, isArrayInsertion?: boolean) => string;
+
+export declare const experimental_readRawConfig: (args: ReadConfigCommandArgs, options?: ReadConfigOptions) => {
+    rawConfig: Unstable_RawConfig;
+    configPath: string | undefined;
+    userConfigPath: string | undefined;
+};
+
 declare function fetch_2 (
 input: RequestInfo,
 init?: RequestInit_2
@@ -2540,7 +2671,7 @@ declare class FormData_2 {
 declare type FormDataEntryValue = string | File
 
 /**
- * By reading from a `wrangler.toml` file this function generates proxy binding objects that can be
+ * By reading from a Wrangler configuration file this function generates proxy binding objects that can be
  * used to simulate the interaction with bindings during local development in a Node.js environment
  *
  * @deprecated use `getPlatformProxy` instead
@@ -2560,7 +2691,7 @@ declare function getGlobalDispatcher(): Dispatcher;
 declare function getGlobalOrigin(): URL | undefined;
 
 /**
- * By reading from a `wrangler.toml` file this function generates proxy objects that can be
+ * By reading from a Wrangler configuration file this function generates proxy objects that can be
  * used to simulate the interaction with the Cloudflare platform during local development
  * in a Node.js environment
  *
@@ -2580,19 +2711,12 @@ export declare type GetPlatformProxyOptions = {
     /**
      * The path to the config file to use.
      * If no path is specified the default behavior is to search from the
-     * current directory up the filesystem for a `wrangler.toml` to use.
+     * current directory up the filesystem for a Wrangler configuration file to use.
      *
      * Note: this field is optional but if a path is specified it must
      *       point to a valid file on the filesystem
      */
     configPath?: string;
-    /**
-     * Flag to indicate the utility to read a json config file (`wrangler.json`/`wrangler.jsonc`)
-     * instead of the toml one (`wrangler.toml`)
-     *
-     * Note: this feature is experimental
-     */
-    experimentalJsonConfig?: boolean;
     /**
      * Indicates if and where to persist the bindings data, if not present or `true` it defaults to the same location
      * used by wrangler v3: `.wrangler/state/v3` (so that the same data can be easily used by the caller and wrangler).
@@ -2601,12 +2725,6 @@ export declare type GetPlatformProxyOptions = {
     persist?: boolean | {
         path: string;
     };
-    /**
-     * Use the experimental file-based dev registry for service discovery
-     *
-     * Note: this feature is experimental
-     */
-    experimentalRegistry?: boolean;
 };
 
 declare function getSetCookies (headers: Headers_2): Cookie[]
@@ -2637,16 +2755,14 @@ declare type Hook<T extends HookValues, Args extends unknown[] = []> = T | ((...
 declare type HookValues = string | number | boolean | object | undefined | null;
 
 /**
- * @property terminate Terminates HTTP server.
+ * The header type declaration of `undici`.
  */
-declare type HttpTerminator = {
-    readonly terminate: () => Promise<void>;
-};
+declare type IncomingHttpHeaders = Record<string, string | string[] | undefined>;
 
 /**
- * The header type declaration of `undici`.
+ * A symbol to inherit a binding from the deployed worker.
  */
-declare type IncomingHttpHeaders = Record<string, string | string[] | undefined>;
+declare const INHERIT_SYMBOL: unique symbol;
 
 declare type InspectorProxyWorkerIncomingWebSocketMessage = {
     type: ReloadStartEvent["type"];
@@ -2680,8 +2796,8 @@ declare class Logger {
     #private;
     constructor();
     private overrideLoggerLevel?;
-    get loggerLevel(): "error" | "none" | "warn" | "info" | "log" | "debug";
-    set loggerLevel(val: "error" | "none" | "warn" | "info" | "log" | "debug");
+    get loggerLevel(): "log" | "error" | "none" | "debug" | "info" | "warn";
+    set loggerLevel(val: "log" | "error" | "none" | "debug" | "info" | "warn");
     columns: number;
     debug: (...args: unknown[]) => void;
     debugWithSanitization: (label: string, ...args: unknown[]) => void;
@@ -2928,13 +3044,24 @@ declare interface MultiCacheQueryOptions extends CacheQueryOptions {
 
 declare type NameOmit<T> = Omit<T, "name">;
 
+declare type NormalizeAndValidateConfigArgs = {
+    name?: string;
+    env?: string;
+    "legacy-env"?: boolean;
+    "dispatch-namespace"?: string;
+    remote?: boolean;
+    localProtocol?: string;
+    upstreamProtocol?: string;
+    script?: string;
+};
+
 declare interface Observability {
     /** If observability is enabled for this Worker */
-    enabled: boolean;
+    enabled?: boolean;
     /** The sampling rate */
     head_sampling_rate?: number;
     logs?: {
-        enabled: boolean;
+        enabled?: boolean;
         /** The sampling rate */
         head_sampling_rate?: number;
         /** Set to false to disable invocation logs */
@@ -2946,18 +3073,7 @@ declare interface PagesConfigFields {
     /**
      * The directory of static assets to serve.
      *
-     * The presence of this field in `wrangler.toml` indicates a Pages project,
-     * and will prompt the handling of the configuration file according to the
-     * Pages-specific validation rules.
-     */
-    pages_build_output_dir?: string;
-}
-
-declare interface PagesConfigFields {
-    /**
-     * The directory of static assets to serve.
-     *
-     * The presence of this field in `wrangler.toml` indicates a Pages project,
+     * The presence of this field in a Wrangler configuration file indicates a Pages project,
      * and will prompt the handling of the configuration file according to the
      * Pages-specific validation rules.
      */
@@ -25576,10 +25692,19 @@ declare type ProxyWorkerOutgoingRequestBody = {
     args: Parameters<typeof console.debug>;
 };
 
-declare type QueueConsumer = NonNullable<Config["queues"]["consumers"]>[number];
+declare type QueueConsumer = NonNullable<Unstable_Config["queues"]["consumers"]>[number];
 
 declare type RawDevConfig = Partial<DevConfig>;
 
+declare type ReadConfigCommandArgs = NormalizeAndValidateConfigArgs & {
+    config?: string;
+    script?: string;
+};
+
+declare type ReadConfigOptions = ResolveConfigPathOptions & {
+    hideWarnings?: boolean;
+};
+
 declare type ReadyEvent = {
     type: "ready";
     proxyWorker: Miniflare;
@@ -25708,6 +25833,10 @@ declare type RequestMode = 'cors' | 'navigate' | 'no-cors' | 'same-origin'
 
 declare type RequestRedirect = 'error' | 'follow' | 'manual'
 
+declare type ResolveConfigPathOptions = {
+    useRedirectIfAvailable?: boolean;
+};
+
 declare class Response_2 implements BodyMixin {
     constructor (body?: BodyInit, init?: ResponseInit_2)
 
@@ -25870,10 +25999,13 @@ declare type RoutingConfig = z.infer<typeof RoutingConfigSchema>;
 
 declare const RoutingConfigSchema: z.ZodObject<{
     has_user_worker: z.ZodOptional<z.ZodBoolean>;
+    invoke_user_worker_ahead_of_assets: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     has_user_worker?: boolean;
+    invoke_user_worker_ahead_of_assets?: boolean;
 }, {
     has_user_worker?: boolean;
+    invoke_user_worker_ahead_of_assets?: boolean;
 }>;
 
 /**
@@ -25952,7 +26084,7 @@ declare interface StartDevWorkerInput {
     name?: string;
     /**
      * The javascript or typescript entry-point of the worker.
-     * This is the `main` property of a wrangler.toml.
+     * This is the `main` property of a Wrangler configuration file.
      * You can specify a file path or provide the contents directly.
      */
     entrypoint?: string;
@@ -26002,7 +26134,7 @@ declare interface StartDevWorkerInput {
         jsxFactory?: string;
         jsxFragment?: string;
         tsconfig?: string;
-        nodejsCompatMode?: Hook<NodeJSCompatMode, [Config]>;
+        nodejsCompatMode?: Hook<NodeJSCompatMode, [Unstable_Config]>;
         moduleRoot?: string;
     };
     /** Options applying to the worker's development preview environment. */
@@ -26016,7 +26148,7 @@ declare interface StartDevWorkerInput {
         /** Whether the worker runs on the edge or locally. */
         remote?: boolean;
         /** Cloudflare Account credentials. Can be provided upfront or as a function which will be called only when required. */
-        auth?: AsyncHook<CfAccount, [Pick<Config, "account_id">]>;
+        auth?: AsyncHook<CfAccount, [Pick<Unstable_Config, "account_id">]>;
         /** Whether local storage (KV, Durable Objects, R2, D1, etc) is persisted. You can also specify the directory to persist data to. */
         persist?: string;
         /** Controls which logs are logged 🤙. */
@@ -26043,14 +26175,16 @@ declare interface StartDevWorkerInput {
         /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
         mockFetch?: undici.MockAgent;
         /** Describes the registry of other Workers running locally */
-        registry?: WorkerRegistry;
+        registry?: WorkerRegistry | null;
         testScheduled?: boolean;
         /** Whether to use Vectorize mixed mode -- the worker is run locally but accesses to Vectorize are made remotely */
         bindVectorizeToProd?: boolean;
+        /** Treat this as the primary worker in a multiworker setup (i.e. the first Worker in Miniflare's options) */
+        multiworkerPrimary?: boolean;
     };
     legacy?: {
-        site?: Hook<Config["site"], [Config]>;
-        legacyAssets?: Hook<Config["legacy_assets"], [Config]>;
+        site?: Hook<Unstable_Config["site"], [Unstable_Config]>;
+        legacyAssets?: Hook<Unstable_Config["legacy_assets"], [Unstable_Config]>;
         enableServiceEnvironments?: boolean;
     };
     unsafe?: Omit<CfUnsafe, "bindings">;
@@ -26058,8 +26192,8 @@ declare interface StartDevWorkerInput {
 }
 
 declare type StartDevWorkerOptions = Omit<StartDevWorkerInput, "assets"> & {
-    /** A worker's directory. Usually where the wrangler.toml file is located */
-    directory: string;
+    /** A worker's directory. Usually where the Wrangler configuration file is located */
+    projectRoot: string;
     build: StartDevWorkerInput["build"] & {
         nodejsCompatMode: NodeJSCompatMode;
         format: CfScriptFormat;
@@ -26071,8 +26205,8 @@ declare type StartDevWorkerOptions = Omit<StartDevWorkerInput, "assets"> & {
         processEntrypoint: boolean;
     };
     legacy: StartDevWorkerInput["legacy"] & {
-        legacyAssets?: Config["legacy_assets"];
-        site?: Config["site"];
+        legacyAssets?: Unstable_Config["legacy_assets"];
+        site?: Unstable_Config["site"];
     };
     dev: StartDevWorkerInput["dev"] & {
         persist: string;
@@ -26080,6 +26214,7 @@ declare type StartDevWorkerOptions = Omit<StartDevWorkerInput, "assets"> & {
     };
     entrypoint: string;
     assets?: AssetsOptions;
+    name: string;
 };
 
 /** A faster version of `request`. */
@@ -26251,10 +26386,39 @@ declare namespace undici {
     }
 }
 
+export declare interface Unstable_ASSETSBindingsOptions {
+    log: Logger;
+    proxyPort?: number;
+    directory?: string;
+}
+
+/**
+ * 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 a Wrangler configuration file,
+ * 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 configuration 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).
+ */
+export declare type Unstable_Config = ComputedFields & ConfigFields<DevConfig> & PagesConfigFields & Environment;
+
 /**
  *  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?: UnstableDevOptions, apiOptions?: unknown): Promise<UnstableDevWorker>;
+export declare function unstable_dev(script: string, options?: Unstable_DevOptions, apiOptions?: unknown): Promise<Unstable_DevWorker>;
 
 export declare class unstable_DevEnv extends EventEmitter_2 {
     config: ConfigController;
@@ -26272,37 +26436,7 @@ export declare class unstable_DevEnv extends EventEmitter_2 {
     emitErrorEvent(ev: ErrorEvent): void;
 }
 
-export declare const unstable_generateASSETSBinding: (opts: UnstableASSETSBindingsOptions) => (request: Request_3) => Promise<Response_3>;
-
-export declare function unstable_getMiniflareWorkerOptions(configPath: string, env?: string): {
-    workerOptions: SourcelessWorkerOptions;
-    define: Record<string, string>;
-    main?: string;
-};
-
-export declare const unstable_pages: {
-    deploy: typeof deploy;
-};
-
-/**
- * Split an SQLQuery into an array of statements
- */
-export declare function unstable_splitSqlQuery(sql: string): string[];
-
-export declare function unstable_startWorker(options: StartDevWorkerInput): Promise<Worker>;
-
-export declare const unstable_startWorkerRegistryServer: (port: number) => Promise<{
-    server: Server<IncomingMessage, ServerResponse>;
-    terminator: HttpTerminator;
-}>;
-
-export declare interface UnstableASSETSBindingsOptions {
-    log: Logger;
-    proxyPort?: number;
-    directory?: string;
-}
-
-export declare interface UnstableDevOptions {
+export declare interface Unstable_DevOptions {
     config?: string;
     env?: string;
     ip?: string;
@@ -26325,7 +26459,7 @@ export declare interface UnstableDevOptions {
     vars?: Record<string, string | Json>;
     kv?: {
         binding: string;
-        id: string;
+        id?: string;
         preview_id?: string;
     }[];
     durableObjects?: {
@@ -26342,7 +26476,7 @@ export declare interface UnstableDevOptions {
     }[];
     r2?: {
         binding: string;
-        bucket_name: string;
+        bucket_name?: string;
         preview_bucket_name?: string;
     }[];
     ai?: {
@@ -26377,7 +26511,7 @@ export declare interface UnstableDevOptions {
     };
 }
 
-export declare interface UnstableDevWorker {
+export declare interface Unstable_DevWorker {
     port: number;
     address: string;
     stop: () => Promise<void>;
@@ -26385,6 +26519,46 @@ export declare interface UnstableDevWorker {
     waitUntilExit: () => Promise<void>;
 }
 
+export declare const unstable_generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request_3) => Promise<Response_3>;
+
+export declare function unstable_getMiniflareWorkerOptions(configPath: string, env?: string): Unstable_MiniflareWorkerOptions;
+
+export declare function unstable_getMiniflareWorkerOptions(config: Unstable_Config): Unstable_MiniflareWorkerOptions;
+
+export declare interface Unstable_MiniflareWorkerOptions {
+    workerOptions: SourcelessWorkerOptions;
+    define: Record<string, string>;
+    main?: string;
+}
+
+export declare const unstable_pages: {
+    deploy: typeof deploy;
+};
+
+export declare type Unstable_RawConfig = Partial<ConfigFields<RawDevConfig>> & PagesConfigFields & Unstable_RawEnvironment & DeprecatedConfigFields & EnvironmentMap & {
+    $schema?: string;
+};
+
+/**
+ * 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.
+ */
+export declare type Unstable_RawEnvironment = Partial<Environment> & EnvironmentDeprecated;
+
+/**
+ * Get the Wrangler configuration; read it from the give `configPath` if available.
+ */
+export declare function unstable_readConfig(args: ReadConfigCommandArgs, options?: ReadConfigOptions): Unstable_Config;
+
+/**
+ * Split an SQLQuery into an array of statements
+ */
+export declare function unstable_splitSqlQuery(sql: string): string[];
+
+export declare function unstable_startWorker(options: StartDevWorkerInput): Promise<Worker>;
+
 /** Upgrade to a different protocol. */
 declare function upgrade(
 url: string | URL_2 | UrlObject,