wrangler 4.98.0 → 4.99.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.98.0",
+  "version": "4.99.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "assembly",
@@ -54,16 +54,16 @@
     "esbuild": "0.27.3",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20260603.1",
-    "@cloudflare/kv-asset-handler": "0.5.0",
+    "workerd": "1.20260609.1",
     "@cloudflare/unenv-preset": "2.16.1",
-    "miniflare": "4.20260603.0"
+    "@cloudflare/kv-asset-handler": "0.5.0",
+    "miniflare": "4.20260609.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@bomb.sh/tab": "^0.0.12",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20260603.1",
+    "@cloudflare/workers-types": "^4.20260609.1",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.5.1",
     "@sentry/node": "^7.86.0",
@@ -149,15 +149,15 @@
     "@cloudflare/codemod": "1.1.0",
     "@cloudflare/containers-shared": "0.15.1",
     "@cloudflare/deploy-helpers": "0.1.2",
-    "@cloudflare/pages-shared": "^0.13.143",
+    "@cloudflare/pages-shared": "^0.13.144",
     "@cloudflare/workers-auth": "0.1.1",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-shared": "0.19.6",
+    "@cloudflare/workers-utils": "0.23.0",
     "@cloudflare/workflows-shared": "0.11.1",
-    "@cloudflare/workers-utils": "0.23.0"
+    "@cloudflare/workers-shared": "0.19.6"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20260603.1"
+    "@cloudflare/workers-types": "^4.20260609.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/wrangler-dist/cli.d.ts

@@ -1,14 +1,14 @@
-import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, ApiCredentials, Config as Config$1, Binding, DurableObjectMigration as DurableObjectMigration$1, ContainerApp as ContainerApp$1, Trigger, CfTailConsumer, ServiceFetch, ContainerEngine as ContainerEngine$1, CfUnsafe, CfScriptFormat, AssetsOptions as AssetsOptions$1, ConfigBindingFieldName, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, RawConfig as RawConfig$1, PackageJSON, ParseError, ComplianceConfig, UserError, FatalError } from '@cloudflare/workers-utils';
+import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, ApiCredentials, Config as Config$1, Binding, DurableObjectMigration as DurableObjectMigration$1, ContainerApp as ContainerApp$1, Trigger, CfTailConsumer, ServiceFetch, ContainerEngine as ContainerEngine$1, CfUnsafe, CfScriptFormat, AssetsOptions as AssetsOptions$1, ConfigBindingFieldName, RawConfig as RawConfig$1, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, PackageJSON, ParseError, ComplianceConfig, UserError, FatalError } from '@cloudflare/workers-utils';
 export { Binding, 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 { Json as Json$1, WorkerRegistry, Miniflare, MiniflareOptions, Mutex, Response as Response$1, NodeJSCompatMode, WorkerdStructuredLog, DispatchFetch, RemoteProxyConnectionString, WorkerOptions, ModuleRule, Request } from 'miniflare';
 import * as undici from 'undici';
 import { RequestInfo, RequestInit, Response, FormData } from 'undici';
 import { Metafile } from 'esbuild';
 import Protocol from 'devtools-protocol/types/protocol-mapping';
 import { EventEmitter } from 'node:events';
 import { ContainerNormalizedConfig } from '@cloudflare/containers-shared';
+import { FetcherScheduledOptions, FetcherScheduledResult, IncomingRequestCfProperties } from '@cloudflare/workers-types/experimental';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
-import { IncomingRequestCfProperties } from '@cloudflare/workers-types/experimental';
 import { URLSearchParams } from 'node:url';
 import { Argv, PositionalOptions, Options, ArgumentsCamelCase, InferredOptionTypes, InferredOptionType } from 'yargs';
 import Cloudflare from 'cloudflare';
@@ -470,6 +470,7 @@ declare abstract class RuntimeController extends Controller {
     abstract onBundleStart(_: BundleStartEvent): void;
     abstract onBundleComplete(_: BundleCompleteEvent): void;
     abstract onPreviewTokenExpired(_: PreviewTokenExpiredEvent): void;
+    abstract get mf(): Miniflare | undefined;
     protected emitReloadStartEvent(data: ReloadStartEvent): void;
     protected emitReloadCompleteEvent(data: ReloadCompleteEvent): void;
     protected emitDevRegistryUpdateEvent(data: DevRegistryUpdateEvent): void;
@@ -582,8 +583,8 @@ interface StartDevWorkerInput {
      * This is the `main` property of a Wrangler configuration file.
      */
     entrypoint?: string;
-    /** The configuration path of the worker. */
-    config?: string;
+    /** The configuration path of the worker, or a normalized configuration object. */
+    config?: string | Config$1;
     /** The compatibility date for the workerd runtime. */
     compatibilityDate?: string;
     /** The compatibility flags for the workerd runtime. */
@@ -696,11 +697,15 @@ interface StartDevWorkerInput {
         };
         /** A hook for outbound fetch calls from within the worker. */
         outboundService?: ServiceFetch;
+        /** Handles structured runtime logs. */
+        structuredLogsHandler?: (log: WorkerdStructuredLog) => void;
         /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
         mockFetch?: undici.MockAgent;
         testScheduled?: boolean;
         /** Treat this as the primary worker in a multiworker setup (i.e. the first Worker in Miniflare's options) */
         multiworkerPrimary?: boolean;
+        /** Whether to infer the local request origin from configured routes. */
+        inferOriginFromRoutes?: boolean;
         containerBuildId?: string;
         /** Whether to build and connect to containers during local dev. Requires Docker daemon to be running. Defaults to true. */
         enableContainers?: boolean;
@@ -726,7 +731,9 @@ interface StartDevWorkerInput {
     assets?: string;
     experimental?: Record<string, never>;
 }
-type StartDevWorkerOptions = Omit<StartDevWorkerInput, "assets" | "containers" | "dev"> & {
+type StartDevWorkerOptions = Omit<StartDevWorkerInput, "assets" | "config" | "containers" | "dev"> & {
+    /** The configuration path of the worker */
+    config?: string;
     /** A worker's directory. Usually where the Wrangler configuration file is located */
     projectRoot: string;
     build: StartDevWorkerInput["build"] & {
@@ -768,6 +775,169 @@ declare function convertConfigBindingsToStartWorkerBindings(configBindings: Part
 
 declare function startWorker(options: StartDevWorkerInput): Promise<Worker>;
 
+type TestHarnessOptions = {
+    /**
+     * Base directory used to resolve relative worker config paths.
+     * Defaults to `process.cwd()`.
+     */
+    root?: string | undefined;
+    /**
+     * Workers to run in this server. The first worker is the primary worker.
+     */
+    workers: WorkerInput[];
+};
+type WorkerHandle = {
+    /**
+     * Dispatches a fetch event directly to this worker.
+     * Relative URL inputs are resolved against the URL returned by `listen()`.
+     *
+     * @example
+     * ```ts
+     * const response = await worker.fetch("/", {
+     *   method: "POST",
+     *   body: "Hello, world!"
+     * });
+     * ```
+     */
+    fetch: DispatchFetch;
+    /**
+     * Dispatches a scheduled event directly to this Worker.
+     *
+     * @example
+     * ```ts
+     * const result = await worker.scheduled({
+     *   cron: "0 * * * *",
+     *   scheduledTime: new Date(),
+     * });
+     * ```
+     */
+    scheduled(options: FetcherScheduledOptions): Promise<FetcherScheduledResult>;
+};
+type TestHarness = {
+    /**
+     * Starts the server and returns its current URL.
+     * Calling this more than once returns the same running server session until
+     * the server is closed or reset.
+     *
+     * If no options were passed to `createTestHarness()`, call `update(options)`
+     * before starting the server.
+     */
+    listen(): Promise<{
+        url: URL;
+    }>;
+    /**
+     * Dispatches a fetch request through the server.
+     *
+     * - Relative URLs are resolved against the current server URL. Absolute URLs
+     * are also accepted, and can be used to control the hostname seen by the Worker.
+     * - Requests are matched against each Worker's configured routes and dispatched to
+     * the first matching Worker, or to the primary Worker if no routes match.
+     * - To dispatch directly to a specific Worker, use `server.getWorker(name).fetch()`.
+     *
+     * @example
+     * ```ts
+     * const server = createTestHarness({
+     *   workers: [
+     *     { configPath: "./wrangler.dashboard.jsonc" }, // No route pattern
+     *     { configPath: "./wrangler.api.jsonc" }, // Route pattern: "example.com/api/*"
+     *     { configPath: "./wrangler.admin.jsonc" }, // Route pattern: "admin.example.com/*"
+     *   ]
+     * });
+     *
+     * await server.fetch("/users");
+     * // Dispatches a request to the dashboard Worker (the first Worker) with URL "http://localhost:{port}/users"
+     *
+     * await server.fetch("http://admin.example.com/accounts");
+     * // Dispatches a request to the admin Worker with URL "http://admin.example.com/accounts"
+     *
+     * await server.fetch("http://example.com/api/data");
+     * // Dispatches a request to the API Worker with URL "http://example.com/api/data"
+     * ```
+     */
+    fetch: DispatchFetch;
+    /**
+     * Returns a handle for dispatching events directly to a Worker.
+     * When no name is provided, this returns the primary Worker, which is the first
+     * Worker in the server's `workers` options.
+     */
+    getWorker(name?: string): WorkerHandle;
+    /**
+     * Returns captured Workers runtime logs since the current server session
+     * started or `clearLogs()` was last called.
+     */
+    getLogs(): WorkerdStructuredLog[];
+    /**
+     * Clears captured Workers runtime logs.
+     */
+    clearLogs(): void;
+    /**
+     * Prints a diagnostic timeline for this test server.
+     *
+     * Use this to trace the sequence of server events and Workers runtime logs
+     * leading up to a test failure. Call `server.debug()` from your test runner's
+     * failure or cleanup hook when the current test has failed.
+     */
+    debug(): void;
+    /**
+     * Updates the server configuration and reloads the running Workers.
+     *
+     * If the server has not started yet, this configures the options that will be
+     * used by `listen()`.
+     */
+    update(options: TestHarnessOptions | ((currentOptions: TestHarnessOptions) => TestHarnessOptions)): Promise<void>;
+    /**
+     * Restores the server to the options used when the current session first
+     * started. Storage is recreated, and the server URL may change after reset.
+     */
+    reset(): Promise<void>;
+    /**
+     * Stops the server and releases all runtime resources.
+     */
+    close(): Promise<void>;
+};
+type InlineConfig = Omit<RawConfig$1, "env">;
+type WorkerInput = {
+    /**
+     * Path to a Wrangler config file for this Worker.
+     * Relative paths resolve from server `root`.
+     */
+    configPath: string | URL;
+    /**
+     * Wrangler environment to load from the config file.
+     */
+    env?: string;
+    /**
+     * Test-only vars that override vars from the Wrangler config.
+     */
+    vars?: Record<string, Json$1>;
+    /**
+     * Test-only secrets that override values loaded from `.dev.vars` and `.env` files.
+     */
+    secrets?: Record<string, string>;
+} | {
+    /**
+     * Inline Wrangler config for this Worker.
+     */
+    config: InlineConfig;
+};
+/**
+ * Creates a local test server for running Workers.
+ *
+ * The server can run one or more Workers from Wrangler config files, including
+ * generated configs from Vite, or from inline configuration objects.
+ *
+ * @example
+ * ```ts
+ * const server = createTestHarness({
+ *   workers: [{ configPath: "./wrangler.jsonc" }],
+ * });
+ * await server.listen();
+ * const response = await server.fetch("/api/users");
+ * await server.close();
+ * ```
+ */
+declare function createTestHarness(options?: TestHarnessOptions): TestHarness;
+
 type ReadConfigCommandArgs = NormalizeAndValidateConfigArgs & {
     config?: string;
     script?: string;
@@ -3506,4 +3676,4 @@ interface Unstable_ASSETSBindingsOptions {
 }
 declare const unstable_generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request) => Promise<Response$1>;
 
-export { type Experimental_GenerateTypesOptions, type Experimental_GenerateTypesResult, 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, generateTypes as experimental_generateTypes, 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, resolveNamedTunnel as unstable_resolveNamedTunnel, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };
+export { type Experimental_GenerateTypesOptions, type Experimental_GenerateTypesResult, type GetPlatformProxyOptions, type PlatformProxy, type RemoteProxySession, type SourcelessWorkerOptions, type StartRemoteProxySessionOptions, type TestHarness, type TestHarnessOptions, 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, type WorkerHandle, createTestHarness, Framework as experimental_AutoConfigFramework, generateTypes as experimental_generateTypes, 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, resolveNamedTunnel as unstable_resolveNamedTunnel, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };