wrangler 3.61.0 → 3.63.0

package/wrangler-dist/cli.d.ts

@@ -28,7 +28,6 @@ import { TLSSocket } from 'tls';
 import { URL as URL_2 } from 'url';
 import { UrlObject } from 'url';
 import { URLSearchParams as URLSearchParams_2 } from 'url';
-import { WebSocket as WebSocket_2 } from 'miniflare';
 import type { WorkerOptions } from 'miniflare';
 import { Writable } from 'stream';
 
@@ -73,6 +72,8 @@ declare type ApiCredentials = {
     authEmail: string;
 };
 
+declare type AsyncHook<T extends HookValues, Args extends unknown[] = []> = Hook<T, Args> | Hook<Promise<T>, Args>;
+
 declare class BalancedPool extends Dispatcher {
     constructor(url: string | string[] | URL_2 | URL_2[], options?: Pool.Options);
 
@@ -175,7 +176,7 @@ declare type BodyInit =
 | ArrayBuffer
 | AsyncIterable<Uint8Array>
 | Blob_2
-| FormData_2
+| FormData
 | Iterable<Uint8Array>
 | NodeJS.ArrayBufferView
 | URLSearchParams_2
@@ -188,7 +189,7 @@ declare interface BodyMixin {
 
     readonly arrayBuffer: () => Promise<ArrayBuffer>
     readonly blob: () => Promise<Blob_2>
-    readonly formData: () => Promise<FormData_2>
+    readonly formData: () => Promise<FormData>
     readonly json: () => Promise<unknown>
     readonly text: () => Promise<string>
 }
@@ -399,26 +400,11 @@ 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;
@@ -437,20 +423,13 @@ declare interface CfConstellation {
 declare interface CfD1Database {
     binding: string;
     database_id: string;
-    database_name?: 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;
@@ -471,19 +450,6 @@ 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;
@@ -498,10 +464,6 @@ declare interface CfKvNamespace {
     id: string;
 }
 
-declare interface CfLogfwdr {
-    bindings: CfLogfwdrBinding[];
-}
-
 declare interface CfLogfwdrBinding {
     name: string;
     destination: string;
@@ -562,10 +524,6 @@ declare interface CfMTlsCertificate {
     certificate_id: string;
 }
 
-declare interface CfPlacement {
-    mode: "smart";
-}
-
 declare interface CfQueue {
     binding: string;
     queue_name: string;
@@ -599,18 +557,6 @@ declare interface CfService {
     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;
@@ -624,98 +570,11 @@ declare interface CfUnsafeBinding {
 
 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.
@@ -882,11 +741,13 @@ declare type CloudchamberConfig = {
 declare type Config = ConfigFields<DevConfig> & PagesConfigFields & Environment;
 
 declare class ConfigController extends Controller<ConfigControllerEventMap> {
-    config?: StartDevWorkerOptions;
-    setOptions(_: StartDevWorkerOptions): void;
-    updateOptions(_: Partial<StartDevWorkerOptions>): void;
+    #private;
+    latestInput?: StartDevWorkerInput;
+    latestConfig?: StartDevWorkerOptions;
+    set(input: StartDevWorkerInput): Promise<StartDevWorkerOptions | undefined>;
+    patch(input: Partial<StartDevWorkerInput>): Promise<StartDevWorkerOptions | undefined>;
     teardown(): Promise<void>;
-    emitConfigUpdateEvent(data: ConfigUpdateEvent): void;
+    emitConfigUpdateEvent(config: StartDevWorkerOptions): void;
 }
 
 declare type ConfigControllerEventMap = ControllerEventMap & {
@@ -990,6 +851,13 @@ declare interface ConfigFields<Dev extends RawDevConfig> {
     data_blobs: {
         [key: string]: string;
     } | undefined;
+    /**
+     * A map of module aliases. Lets you swap out a module for any others.
+     * Corresponds with esbuild's `alias` config
+     */
+    alias: {
+        [key: string]: string;
+    } | undefined;
     /**
      * By default, wrangler.toml is the source of truth for your environment configuration, like a terraform file.
      *
@@ -1108,8 +976,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;
@@ -1121,8 +989,8 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
             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;
@@ -1207,17 +1075,6 @@ declare type DevToolsEvent<Method extends _EventMethods> = Method extends unknow
     params: _Params<ProtocolMapping.Events[Method]>;
 } : never;
 
-declare interface DevWorker {
-    ready: Promise<void>;
-    config?: StartDevWorkerOptions;
-    setOptions(options: StartDevWorkerOptions): void;
-    updateOptions(options: Partial<StartDevWorkerOptions>): void;
-    fetch: DispatchFetch;
-    scheduled(cron?: string): Promise<void>;
-    queue(queueName: string, ...messages: unknown[]): Promise<void>;
-    dispose(): Promise<void>;
-}
-
 declare namespace DiagnosticsChannel {
     interface Request {
         origin?: string | URL_2;
@@ -1368,7 +1225,7 @@ declare namespace Dispatcher {
         path: string;
         method: HttpMethod;
         /** Default: `null` */
-        body?: string | Buffer | Uint8Array | Readable | null | FormData_2;
+        body?: string | Buffer | Uint8Array | Readable | null | FormData;
         /** Default: `null` */
         headers?: IncomingHttpHeaders | string[] | null;
         /** Query string params to be embedded in the request URL. Default: `null` */
@@ -2451,11 +2308,11 @@ declare class File extends Blob_2 {
     readonly [Symbol.toStringTag]: string
 }
 
-declare type File_2<Contents = string> = {
-    path: string;
+declare type File_2<Contents = string, Path = string> = {
+    path: Path;
 } | {
     contents: Contents;
-    path?: string;
+    path?: Path;
 };
 
 declare interface FilePropertyBag extends BlobPropertyBag {
@@ -2502,7 +2359,7 @@ declare class FileReader {
 /**
  * Provides a way to easily construct a set of key/value pairs representing form fields and their values, which can then be easily sent using fetch().
  */
-declare class FormData_2 {
+declare class FormData {
     /**
      * Appends a new value onto an existing key inside a FormData object,
      * or adds the key if it does not already exist.
@@ -2567,7 +2424,7 @@ declare class FormData_2 {
      * Executes given callback function for each field of the FormData instance
      */
     forEach: (
-    callbackfn: (value: FormDataEntryValue, key: string, iterable: FormData_2) => void,
+    callbackfn: (value: FormDataEntryValue, key: string, iterable: FormData) => void,
     thisArg?: unknown
     ) => void
 
@@ -2641,7 +2498,12 @@ export declare type GetPlatformProxyOptions = {
      */
     environment?: string;
     /**
-     * The path to the config object to use (default `wrangler.toml`)
+     * 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.
+     *
+     * Note: this field is optional but if a path is specified it must
+     *       point to a valid file on the filesystem
      */
     configPath?: string;
     /**
@@ -2659,6 +2521,12 @@ 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): Cookie[]
@@ -2684,7 +2552,9 @@ declare class Headers implements SpecIterable<[string, string]> {
 
 declare type HeadersInit = string[][] | Record<string, string | ReadonlyArray<string>> | Headers
 
-declare type Hook<T extends string | number | object> = T | Promise<T> | (() => T | Promise<T>);
+declare type Hook<T extends HookValues, Args extends unknown[] = []> = T | ((...args: Args) => T);
+
+declare type HookValues = string | number | boolean | object | undefined | null;
 
 /**
  * @property terminate Terminates HTTP server.
@@ -2727,6 +2597,7 @@ declare interface Interceptable extends Dispatcher {
 }
 
 declare class Logger {
+    #private;
     constructor();
     loggerLevel: "error" | "none" | "warn" | "info" | "log" | "debug";
     columns: number;
@@ -2737,7 +2608,10 @@ declare class Logger {
     warn: (...args: unknown[]) => void;
     error: (...args: unknown[]) => void;
     table<Keys extends string>(data: TableRow<Keys>[]): void;
+    console<M extends Exclude<keyof Console, "Console">>(method: M, ...args: Parameters<Console[M]>): void;
     private doLog;
+    static registerBeforeLogHook(callback: (() => void) | undefined): void;
+    static registerAfterLogHook(callback: (() => void) | undefined): void;
     private formatMessage;
 }
 
@@ -2783,6 +2657,8 @@ declare interface MIMEType {
     essence: string
 }
 
+declare type MiniflareWorker = Awaited<ReturnType<Miniflare["getWorker"]>>;
+
 /** A mocked Agent class that implements the Agent API. It allows one to intercept HTTP requests made through undici and return mocked responses instead. */
 declare class MockAgent<TMockAgentOptions extends MockAgent.Options = MockAgent.Options> extends Dispatcher {
     constructor(options?: MockAgent.Options)
@@ -25534,12 +25410,12 @@ declare class ProxyController extends Controller<ProxyControllerEventMap> {
     ready: DeferredPromise<ReadyEvent>;
     proxyWorker?: Miniflare;
     proxyWorkerOptions?: MiniflareOptions;
-    inspectorProxyWorkerWebSocket?: DeferredPromise<WebSocket_2>;
+    private inspectorProxyWorkerWebSocket?;
     protected latestConfig?: StartDevWorkerOptions;
     protected latestBundle?: EsbuildBundle;
     secret: `${string}-${string}-${string}-${string}-${string}`;
     protected createProxyWorker(): void;
-    reconnectInspectorProxyWorker(): Promise<WebSocket_2 | undefined>;
+    private reconnectInspectorProxyWorker;
     runtimeMessageMutex: Mutex;
     sendMessageToProxyWorker(message: ProxyWorkerIncomingRequestBody, retries?: number): Promise<void>;
     sendMessageToInspectorProxyWorker(message: InspectorProxyWorkerIncomingWebSocketMessage, retries?: number): Promise<void>;
@@ -25552,7 +25428,7 @@ declare class ProxyController extends Controller<ProxyControllerEventMap> {
     onInspectorProxyWorkerRequest(message: InspectorProxyWorkerOutgoingRequestBody): Promise<Response_2>;
     _torndown: boolean;
     teardown(): Promise<void>;
-    emitReadyEvent(proxyWorker: Miniflare): void;
+    emitReadyEvent(proxyWorker: Miniflare, url: URL, inspectorUrl: URL): void;
     emitPreviewTokenExpiredEvent(proxyData: ProxyData): void;
     emitErrorEvent(data: ErrorEvent): void;
     emitErrorEvent(reason: string, cause?: Error | SerializedError): void;
@@ -25599,6 +25475,8 @@ declare type RawDevConfig = Partial<DevConfig>;
 declare type ReadyEvent = {
     type: "ready";
     proxyWorker: Miniflare;
+    url: URL;
+    inspectorUrl: URL;
 };
 
 declare class RedirectHandler implements Dispatcher.DispatchHandlers{
@@ -25654,7 +25532,7 @@ declare class Request implements BodyMixin {
 
     readonly arrayBuffer: () => Promise<ArrayBuffer>
     readonly blob: () => Promise<Blob_2>
-    readonly formData: () => Promise<FormData_2>
+    readonly formData: () => Promise<FormData>
     readonly json: () => Promise<unknown>
     readonly text: () => Promise<string>
 
@@ -25738,7 +25616,7 @@ declare class Response implements BodyMixin {
 
     readonly arrayBuffer: () => Promise<ArrayBuffer>
     readonly blob: () => Promise<Blob_2>
-    readonly formData: () => Promise<FormData_2>
+    readonly formData: () => Promise<FormData>
     readonly json: () => Promise<unknown>
     readonly text: () => Promise<string>
 
@@ -25951,7 +25829,7 @@ declare interface SpecIterator<T, TReturn = any, TNext = undefined> {
     next(...args: [] | [TNext]): IteratorResult<T, TReturn>;
 }
 
-declare interface StartDevWorkerOptions {
+declare interface StartDevWorkerInput {
     /** The name of the worker. */
     name?: string;
     /**
@@ -25959,27 +25837,18 @@ declare interface StartDevWorkerOptions {
      * This is the `main` property of a wrangler.toml.
      * You can specify a file path or provide the contents directly.
      */
-    script: File_2<string>;
+    entrypoint?: string;
     /** The configuration of the worker. */
-    config?: File_2<Config>;
+    config?: string;
     /** The compatibility date for the workerd runtime. */
     compatibilityDate?: string;
     /** The compatibility flags for the workerd runtime. */
     compatibilityFlags?: string[];
+    env?: string;
     /** The bindings available to the worker. The specified bindind type will be exposed to the worker on the `env` object under the same key. */
     bindings?: Record<string, Binding>;
     /** The triggers which will cause the worker's exported default handlers to be called. */
     triggers?: Trigger[];
-    /** Options applying to (legacy) Worker Sites. Please consider using Cloudflare Pages. */
-    site?: {
-        path: string;
-        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.
      *
@@ -25987,27 +25856,23 @@ declare interface StartDevWorkerOptions {
      * Otherwise, Wrangler will use the user's preference.
      */
     sendMetrics?: boolean;
-    usageModel?: "bundled" | "unbound";
-    _bindings?: CfWorkerInit["bindings"];
-    _entry?: Entry;
-    _projectRoot?: string;
-    _serveAssetsFromWorker?: boolean;
-    _assets?: Config["assets"];
-    _processEntrypoint?: boolean;
-    _additionalModules?: CfModule[];
     /** 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. */
         bundle?: boolean;
+        additionalModules?: CfModule[];
         findAdditionalModules?: boolean;
+        processEntrypoint?: boolean;
         /** Specifies types of modules matched by globs. */
         moduleRules?: Rule[];
         /** Replace global identifiers with constant expressions, e.g. { debug: 'true', version: '"1.0.0"' }. Only takes effect if bundle: true. */
         define?: Record<string, string>;
+        /** Alias modules */
+        alias?: Record<string, string>;
         /** Whether the bundled worker is minified. Only takes effect if bundle: true. */
         minify?: boolean;
         /** Options controlling a custom build step. */
-        custom: {
+        custom?: {
             /** Custom shell command to run before bundling. Runs even if bundle. */
             command?: string;
             /** The cwd to run the command in. */
@@ -26018,7 +25883,8 @@ declare interface StartDevWorkerOptions {
         jsxFactory?: string;
         jsxFragment?: string;
         tsconfig?: string;
-        nodejsCompatMode?: NodeJSCompatMode;
+        nodejsCompatMode?: Hook<NodeJSCompatMode, [Config]>;
+        moduleRoot?: string;
     };
     /** Options applying to the worker's development preview environment. */
     dev?: {
@@ -26031,11 +25897,9 @@ declare interface StartDevWorkerOptions {
         /** 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?: Hook<CfAccount>;
+        auth?: AsyncHook<CfAccount>;
         /** Whether local storage (KV, Durable Objects, R2, D1, etc) is persisted. You can also specify the directory to persist data to. */
-        persist?: boolean | {
-            path: string;
-        };
+        persist?: string;
         /** Controls which logs are logged 🤙. */
         logLevel?: LogLevel;
         /** Whether the worker server restarts upon source/config file changes. */
@@ -26059,12 +25923,40 @@ 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;
+        /** Describes the registry of other Workers running locally */
+        registry?: WorkerRegistry;
         testScheduled?: boolean;
     };
+    legacy?: {
+        site?: Hook<Config["site"], [Config]>;
+        assets?: Hook<Config["assets"], [Config]>;
+        enableServiceEnvironments?: boolean;
+    };
+    unsafe?: Omit<CfUnsafe, "bindings">;
 }
 
+declare type StartDevWorkerOptions = StartDevWorkerInput & {
+    /** A worker's directory. Usually where the wrangler.toml file is located */
+    directory: string;
+    build: StartDevWorkerInput["build"] & {
+        nodejsCompatMode: NodeJSCompatMode;
+        format: CfScriptFormat;
+        moduleRoot: string;
+        moduleRules: Rule[];
+        define: Record<string, string>;
+        additionalModules: CfModule[];
+        processEntrypoint: boolean;
+    };
+    legacy: StartDevWorkerInput["legacy"] & {
+        assets?: Config["assets"];
+        site?: Config["site"];
+    };
+    dev: StartDevWorkerInput["dev"] & {
+        persist: string;
+    };
+    entrypoint: string;
+};
+
 /** A faster version of `request`. */
 declare function stream(
 url: string | URL_2 | UrlObject,
@@ -26077,7 +25969,7 @@ declare type TableRow<Keys extends string> = Record<Keys, string>;
 declare type TailConsumer = {
     /** The name of the service tail events will be forwarded to. */
     service: string;
-    /** (Optional) The environt of the service. */
+    /** (Optional) The environment of the service. */
     environment?: string;
 };
 
@@ -26114,7 +26006,9 @@ declare interface TypedEventEmitter<EventMap extends Record<string | symbol, unk
     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 const TypedEventEmitterImpl: {
+    new <EventMap extends Record<string | symbol, unknown[]>>(): TypedEventEmitter<EventMap>;
+};
 
 declare namespace Undici {
     var Dispatcher: Dispatcher
@@ -26143,7 +26037,7 @@ declare namespace Undici {
     var Headers: Headers;
     var Response: Response;
     var Request: Request;
-    var FormData: FormData_2;
+    var FormData: FormData;
     var File: File;
     var FileReader: FileReader;
     var caches: caches;
@@ -26211,7 +26105,7 @@ declare namespace undici {
         ProgressEventInit,
         ProgressEvent,
         FormDataEntryValue,
-        FormData_2 as FormData,
+        FormData,
         DiagnosticsChannel,
         BinaryType,
         WebSocketEventMap,
@@ -26242,7 +26136,7 @@ export declare class unstable_DevEnv extends EventEmitter_2 {
     bundler: BundlerController;
     runtimes: RuntimeController[];
     proxy: ProxyController;
-    startWorker(options: StartDevWorkerOptions): DevWorker;
+    startWorker(options: StartDevWorkerInput): Promise<Worker>;
     constructor({ config, bundler, runtimes, proxy, }?: {
         config?: ConfigController | undefined;
         bundler?: BundlerController | undefined;
@@ -26255,7 +26149,7 @@ export declare class unstable_DevEnv extends EventEmitter_2 {
 
 export declare const unstable_generateASSETSBinding: (opts: UnstableASSETSBindingsOptions) => (request: Request_2) => Promise<Response_2>;
 
-export declare function unstable_getMiniflareWorkerOptions(configPath: string, environment?: string): {
+export declare function unstable_getMiniflareWorkerOptions(configPath: string, env?: string): {
     workerOptions: SourcelessWorkerOptions;
     define: Record<string, string>;
     main?: string;
@@ -26270,6 +26164,8 @@ export declare const unstable_pages: {
  */
 export declare function unstable_splitSqlQuery(sql: string): string[];
 
+export declare function unstable_startWorker(options: StartDevWorkerInput): Promise<Worker>;
+
 export declare function unstable_startWorkerRegistryServer(port: number): Promise<{
     server: Server<IncomingMessage, ServerResponse>;
     terminator: HttpTerminator;
@@ -26349,6 +26245,7 @@ export declare interface UnstableDevOptions {
         testScheduled?: boolean;
         watch?: boolean;
         devEnv?: boolean;
+        fileBasedRegistry?: boolean;
     };
 }
 
@@ -26443,6 +26340,19 @@ declare interface WebSocketInit {
     headers?: HeadersInit
 }
 
+declare interface Worker {
+    ready: Promise<void>;
+    url: Promise<URL>;
+    inspectorUrl: Promise<URL>;
+    config: StartDevWorkerOptions;
+    setConfig: ConfigController["set"];
+    patchConfig: ConfigController["patch"];
+    fetch: DispatchFetch;
+    scheduled: MiniflareWorker["scheduled"];
+    queue: MiniflareWorker["queue"];
+    dispose(): Promise<void>;
+}
+
 declare type WorkerDefinition = {
     port: number | undefined;
     protocol: "http" | "https" | undefined;
@@ -26463,6 +26373,8 @@ declare type WorkerEntrypointsDefinition = Record<"default" | string, {
     port: number;
 } | undefined>;
 
+declare type WorkerRegistry = Record<string, WorkerDefinition>;
+
 declare type ZoneIdRoute = {
     pattern: string;
     zone_id: string;