wrangler 4.105.0 → 4.107.0

package/bin/wrangler.js

@@ -25,7 +25,6 @@ Consider using a Node.js version manager such as https://volta.sh/ or https://gi
 		process.execPath,
 		[
 			"--no-warnings",
-			"--experimental-vm-modules",
 			...process.execArgv,
 			path.join(__dirname, "../wrangler-dist/cli.js"),
 			...process.argv.slice(2),

package/config-schema.json

@@ -113,6 +113,12 @@
           "markdownDescription": "A list of migrations that should be uploaded with your Worker.\n\nThese define changes in your Durable Object declarations.\n\nMore details at https://developers.cloudflare.com/workers/learning/using-durable-objects#configuring-durable-object-classes-with-migrations",
           "default": []
         },
+        "exports": {
+          "$ref": "#/definitions/Exports",
+          "description": "Declarative exports configuration — a map of class name to export configuration.\n\nThe configuration of Durable Objects via `exports` is mutually exclusive with `migrations`.",
+          "markdownDescription": "Declarative exports configuration — a map of class name to export configuration.\n\nThe configuration of Durable Objects via `exports` is mutually exclusive with `migrations`.",
+          "default": {}
+        },
         "triggers": {
           "type": "object",
           "properties": {
@@ -1825,6 +1831,12 @@
           "markdownDescription": "A list of migrations that should be uploaded with your Worker.\n\nThese define changes in your Durable Object declarations.\n\nMore details at https://developers.cloudflare.com/workers/learning/using-durable-objects#configuring-durable-object-classes-with-migrations",
           "default": []
         },
+        "exports": {
+          "$ref": "#/definitions/Exports",
+          "description": "Declarative exports configuration — a map of class name to export configuration.\n\nThe configuration of Durable Objects via `exports` is mutually exclusive with `migrations`.",
+          "markdownDescription": "Declarative exports configuration — a map of class name to export configuration.\n\nThe configuration of Durable Objects via `exports` is mutually exclusive with `migrations`.",
+          "default": {}
+        },
         "triggers": {
           "type": "object",
           "properties": {
@@ -3481,6 +3493,175 @@
       "description": "Configuration in wrangler for Durable Object Migrations",
       "markdownDescription": "Configuration in wrangler for Durable Object Migrations"
     },
+    "Exports": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/ConfiguredExport"
+      },
+      "description": "The declarative `exports` map keyed by export name. Durable Object exports are mutually exclusive with `migrations` at the wrangler config layer.",
+      "markdownDescription": "The declarative `exports` map keyed by export name. Durable Object exports\nare mutually exclusive with `migrations` at the wrangler config layer."
+    },
+    "ConfiguredExport": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/DurableObjectExport"
+        },
+        {
+          "$ref": "#/definitions/WorkerEntrypointExport"
+        }
+      ]
+    },
+    "DurableObjectExport": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "durable-object"
+            },
+            "state": {
+              "type": "string",
+              "const": "created"
+            },
+            "storage": {
+              "$ref": "#/definitions/DurableObjectExportStorage"
+            }
+          },
+          "required": [
+            "type",
+            "storage"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "durable-object"
+            },
+            "state": {
+              "type": "string",
+              "const": "deleted"
+            }
+          },
+          "required": [
+            "type",
+            "state"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "durable-object"
+            },
+            "state": {
+              "type": "string",
+              "const": "renamed"
+            },
+            "renamed_to": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "state",
+            "renamed_to"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "durable-object"
+            },
+            "state": {
+              "type": "string",
+              "const": "transferred"
+            },
+            "transferred_to": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "state",
+            "transferred_to"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "durable-object"
+            },
+            "state": {
+              "type": "string",
+              "const": "expecting-transfer"
+            },
+            "storage": {
+              "$ref": "#/definitions/DurableObjectExportStorage"
+            },
+            "transfer_from": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "state",
+            "storage",
+            "transfer_from"
+          ],
+          "additionalProperties": false
+        }
+      ],
+      "description": "A single declarative Durable Object export entry in the `exports` config map. `type` is reserved for the export kind. `state` carries the Durable Object lifecycle and defaults to `\"created\"` (live) when omitted.\n\nMutually exclusive with  {@link  DurableObjectMigration }  at the config- validation boundary.\n\n - `created` (default, live): `storage` is required.  - `deleted` (tombstone): retire a provisioned namespace whose class has    been removed from code.  - `renamed` (tombstone): rewrite a provisioned namespace's class name to    `renamed_to`. The target name must also appear as a live (state    `\"created\"`) `durable-object` entry in the same map.  - `transferred` (tombstone): hand ownership of the namespace to another    script in the same account (`transferred_to`). Two-phase commit;    the target must first deploy an `expecting-transfer` entry naming this    script via `transfer_from`.  - `expecting-transfer` (live): receiving side of a two-phase transfer;    `storage` and `transfer_from` are both required.",
+      "markdownDescription": "A single declarative Durable Object export entry in the `exports` config\nmap. `type` is reserved for the export kind. `state` carries the Durable\nObject lifecycle and defaults to `\"created\"` (live) when omitted.\n\nMutually exclusive with  {@link  DurableObjectMigration }  at the config-\nvalidation boundary.\n\n - `created` (default, live): `storage` is required.\n - `deleted` (tombstone): retire a provisioned namespace whose class has\n   been removed from code.\n - `renamed` (tombstone): rewrite a provisioned namespace's class name to\n   `renamed_to`. The target name must also appear as a live (state\n   `\"created\"`) `durable-object` entry in the same map.\n - `transferred` (tombstone): hand ownership of the namespace to another\n   script in the same account (`transferred_to`). Two-phase commit;\n   the target must first deploy an `expecting-transfer` entry naming this\n   script via `transfer_from`.\n - `expecting-transfer` (live): receiving side of a two-phase transfer;\n   `storage` and `transfer_from` are both required."
+    },
+    "DurableObjectExportStorage": {
+      "type": "string",
+      "enum": [
+        "sqlite",
+        "legacy-kv"
+      ],
+      "description": "Storage backend for a declarative Durable Object export. See  {@link  DurableObjectExport } .",
+      "markdownDescription": "Storage backend for a declarative Durable Object export. See\n {@link  DurableObjectExport } ."
+    },
+    "WorkerEntrypointExport": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "worker"
+        },
+        "cache": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "description": "Whether cache is enabled for this entrypoint.",
+              "markdownDescription": "Whether cache is enabled for this entrypoint."
+            }
+          },
+          "required": [
+            "enabled"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    },
     "UserLimits": {
       "type": "object",
       "properties": {
@@ -3673,6 +3854,11 @@
           "type": "boolean",
           "description": "If cache is enabled for this Worker",
           "markdownDescription": "If cache is enabled for this Worker"
+        },
+        "cross_version_cache": {
+          "type": "boolean",
+          "description": "Whether cached assets may be reused across Worker versions.",
+          "markdownDescription": "Whether cached assets may be reused across Worker versions."
         }
       },
       "required": [
@@ -3685,16 +3871,16 @@
       "additionalProperties": false,
       "properties": {
         "logpush": {
-          "$ref": "#/definitions/interface-769040647-8409-18279-769040647-0-501432004818536"
+          "$ref": "#/definitions/interface-769040647-10589-20711-769040647-0-526752004818536"
         },
         "observability": {
-          "$ref": "#/definitions/interface-769040647-8409-18279-769040647-0-501432004818536"
+          "$ref": "#/definitions/interface-769040647-10589-20711-769040647-0-526752004818536"
         },
         "limits": {
-          "$ref": "#/definitions/interface-769040647-8409-18279-769040647-0-501432004818536"
+          "$ref": "#/definitions/interface-769040647-10589-20711-769040647-0-526752004818536"
         },
         "cache": {
-          "$ref": "#/definitions/interface-769040647-8409-18279-769040647-0-501432004818536"
+          "$ref": "#/definitions/interface-769040647-10589-20711-769040647-0-526752004818536"
         },
         "define": {
           "type": "object",
@@ -4956,7 +5142,7 @@
       "description": "Configuration for Worker Previews.\n\nThis defines the settings used when creating Preview deployments. Previews are branches of your Worker's main instance used to test features during feature development outside of production.\n\nThe `previews` block contains any intentionally divergent configuration intended solely for Previews, including:\n- All non-inheritable properties (environment variables and bindings like KV, D1, R2, etc.)\n- Select inheritable properties: `logpush`, `observability`, `limits`, `cache`",
       "markdownDescription": "Configuration for Worker Previews.\n\nThis defines the settings used when creating Preview deployments.\nPreviews are branches of your Worker's main instance used to test features\nduring feature development outside of production.\n\nThe `previews` block contains any intentionally divergent configuration intended solely for Previews, including:\n- All non-inheritable properties (environment variables and bindings like KV, D1, R2, etc.)\n- Select inheritable properties: `logpush`, `observability`, `limits`, `cache`"
     },
-    "interface-769040647-8409-18279-769040647-0-501432004818536": {
+    "interface-769040647-10589-20711-769040647-0-526752004818536": {
       "type": "object",
       "properties": {
         "name": {
@@ -5054,6 +5240,12 @@
           "markdownDescription": "A list of migrations that should be uploaded with your Worker.\n\nThese define changes in your Durable Object declarations.\n\nMore details at https://developers.cloudflare.com/workers/learning/using-durable-objects#configuring-durable-object-classes-with-migrations",
           "default": []
         },
+        "exports": {
+          "$ref": "#/definitions/Exports",
+          "description": "Declarative exports configuration — a map of class name to export configuration.\n\nThe configuration of Durable Objects via `exports` is mutually exclusive with `migrations`.",
+          "markdownDescription": "Declarative exports configuration — a map of class name to export configuration.\n\nThe configuration of Durable Objects via `exports` is mutually exclusive with `migrations`.",
+          "default": {}
+        },
         "triggers": {
           "type": "object",
           "properties": {
@@ -5318,6 +5510,7 @@
         "jsx_factory",
         "jsx_fragment",
         "migrations",
+        "exports",
         "triggers",
         "rules",
         "build",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.105.0",
+  "version": "4.107.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "assembly",
@@ -66,16 +66,16 @@
     "esbuild": "0.28.1",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20260625.1",
+    "workerd": "1.20260701.1",
     "@cloudflare/kv-asset-handler": "0.5.0",
     "@cloudflare/unenv-preset": "2.16.1",
-    "miniflare": "4.20260625.0"
+    "miniflare": "4.20260701.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@bomb.sh/tab": "^0.0.12",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20260625.1",
+    "@cloudflare/workers-types": "^4.20260701.1",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.5.1",
     "@sentry/node": "^7.86.0",
@@ -156,21 +156,21 @@
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
     "zod": "^4.4.3",
-    "@cloudflare/autoconfig": "0.1.1",
-    "@cloudflare/cli-shared-helpers": "0.1.10",
+    "@cloudflare/autoconfig": "0.1.2",
+    "@cloudflare/cli-shared-helpers": "0.1.11",
+    "@cloudflare/codemod": "1.1.0",
     "@cloudflare/config": "0.0.0",
     "@cloudflare/containers-shared": "0.16.0",
-    "@cloudflare/deploy-helpers": "0.2.4",
-    "@cloudflare/pages-shared": "^0.13.150",
+    "@cloudflare/pages-shared": "^0.13.152",
+    "@cloudflare/deploy-helpers": "0.3.0",
+    "@cloudflare/workers-auth": "0.4.0",
     "@cloudflare/workers-shared": "0.19.7",
-    "@cloudflare/workers-utils": "0.24.0",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-auth": "0.3.2",
-    "@cloudflare/workflows-shared": "0.11.2",
-    "@cloudflare/codemod": "1.1.0"
+    "@cloudflare/workers-utils": "0.25.0",
+    "@cloudflare/workflows-shared": "0.11.2"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20260625.1"
+    "@cloudflare/workers-types": "^4.20260701.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/wrangler-dist/cli.d.ts

@@ -1,4 +1,4 @@
-import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, StartDevWorkerInput, NodeJSCompatMode, CfScriptFormat, Config as Config$1, AsyncHook, CfAccount as CfAccount$1, AssetsOptions as AssetsOptions$1, Binding, ConfigBindingFieldName, RawConfig as RawConfig$1, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, ApiCredentials, ParseError, LoggerLevel, ComplianceConfig, UserError, FatalError } from '@cloudflare/workers-utils';
+import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, StartDevWorkerInput, Config as Config$1, NodeJSCompatMode, CfScriptFormat, AsyncHook, CfAccount as CfAccount$1, AssetsOptions as AssetsOptions$1, Binding, ConfigBindingFieldName, RawConfig as RawConfig$1, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, ApiCredentials, ParseError, LoggerLevel, 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, WorkerdStructuredLog, DispatchFetch, Miniflare, WorkerRegistry, MiniflareOptions, Mutex, Response as Response$1, RemoteProxyConnectionString, WorkerOptions, ModuleRule, Request } from 'miniflare';
 import * as undici from 'undici';
@@ -8,6 +8,7 @@ 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 { Rpc, ExportedHandler, D1Database, Workflow, Service } from '@cloudflare/workers-types/latest';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
 export { printBindings as unstable_printBindings } from '@cloudflare/deploy-helpers';
 import { URLSearchParams } from 'node:url';
@@ -335,6 +336,7 @@ type EsbuildBundle = {
 declare class ConfigController extends Controller {
     #private;
     latestInput?: StartDevWorkerInput;
+    latestWranglerConfig?: Config$1;
     latestConfig?: StartDevWorkerOptions;
     set(input: StartDevWorkerInput, throwErrors?: boolean): Promise<StartDevWorkerOptions | undefined>;
     patch(input: Partial<StartDevWorkerInput>): Promise<StartDevWorkerOptions | undefined>;
@@ -613,6 +615,7 @@ declare const dev: {
         experimentalProvision: boolean | undefined;
         experimentalAutoCreate: boolean;
         installSkills: boolean;
+        profile: string | undefined;
         script: string | undefined;
         name: string | undefined;
         compatibilityDate: string | undefined;
@@ -711,7 +714,7 @@ type AdditionalDevProps = {
     rules?: Rule$1[];
     showInteractiveDevSession?: boolean;
 };
-type DevArguments = Omit<(typeof dev)["args"], "installSkills">;
+type DevArguments = Omit<(typeof dev)["args"], "installSkills" | "profile">;
 type StartDevOptions = DevArguments & AdditionalDevProps & {
     forceLocal?: boolean;
     accountId?: string;
@@ -727,6 +730,42 @@ type StartDevOptions = DevArguments & AdditionalDevProps & {
 
 declare function convertConfigBindingsToStartWorkerBindings(configBindings: Partial<Pick<Config$1, ConfigBindingFieldName>>): StartDevWorkerOptions["bindings"];
 
+type WorkflowStepSelector = {
+    name: string;
+    index?: number;
+};
+type WorkflowInstanceModifier = {
+    disableSleeps(steps?: WorkflowStepSelector[]): Promise<void>;
+    disableRetryDelays(steps?: WorkflowStepSelector[]): Promise<void>;
+    mockStepResult(step: WorkflowStepSelector, stepResult: unknown): Promise<void>;
+    mockStepError(step: WorkflowStepSelector, error: Error, times?: number): Promise<void>;
+    forceStepTimeout(step: WorkflowStepSelector, times?: number): Promise<void>;
+    mockEvent(event: {
+        type: string;
+        payload: unknown;
+    }): Promise<void>;
+    forceEventTimeout(step: WorkflowStepSelector): Promise<void>;
+};
+type ModifierCallback = (modifier: WorkflowInstanceModifier) => Promise<void>;
+interface WorkflowInstanceIntrospector {
+    modify(fn: ModifierCallback): Promise<WorkflowInstanceIntrospector>;
+    waitForStepResult(step: WorkflowStepSelector): Promise<unknown>;
+    waitForStatus(status: string): Promise<void>;
+    getOutput(): Promise<unknown>;
+    getError(): Promise<{
+        name: string;
+        message: string;
+    }>;
+    dispose(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+interface WorkflowIntrospector {
+    modifyAll(fn: ModifierCallback): Promise<void>;
+    get(): Promise<WorkflowInstanceIntrospector[]>;
+    dispose(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
 type TestHarnessOptions = {
     /**
      * Base directory used to resolve relative worker config paths.
@@ -738,7 +777,19 @@ type TestHarnessOptions = {
      */
     workers: WorkerInput[];
 };
-type WorkerHandle<Env = Record<string, any>> = {
+type BindingName<Env, Type> = string extends keyof Env ? string : Extract<{
+    [K in keyof Env]-?: NonNullable<Env[K]> extends Type ? K : never;
+}[keyof Env], string>;
+type WorkerModule = {
+    default: WorkerExport;
+    [key: string]: WorkerExport | undefined;
+};
+type AnyExportedHandler = ExportedHandler<any, any, any, any>;
+type AnyEnv = Record<string, any>;
+type WorkerExport = (new (...args: any[]) => Rpc.WorkerEntrypointBranded) | Rpc.WorkerEntrypointBranded | AnyExportedHandler;
+type WorkerHandle<Env = AnyEnv, Module extends WorkerModule = {
+    default: AnyExportedHandler;
+}> = {
     /**
      * Dispatches a fetch event directly to this worker.
      * Relative URL inputs are resolved against the URL returned by `listen()`.
@@ -777,6 +828,38 @@ type WorkerHandle<Env = Record<string, any>> = {
      * ```
      */
     getEnv(): Promise<Env>;
+    /**
+     * Applies D1 migration files that have not already run to a D1 binding on this Worker.
+     *
+     * @example
+     * ```ts
+     * beforeEach(async () => {
+     *   await worker.applyD1Migrations("DATABASE");
+     * });
+     * ```
+     */
+    applyD1Migrations(bindingName: BindingName<Env, D1Database>): Promise<void>;
+    /**
+     * Creates an introspector for a specific Workflow instance.
+     */
+    introspectWorkflowInstance(bindingName: BindingName<Env, Workflow>, instanceId: string): Promise<WorkflowInstanceIntrospector>;
+    /**
+     * Creates an introspector for Workflow instances created after this method is called.
+     */
+    introspectWorkflow(bindingName: BindingName<Env, Workflow>): Promise<WorkflowIntrospector>;
+    /**
+     * Returns the default Worker export, including JSRPC methods.
+     *
+     * @example
+     * ```ts
+     * type ApiWorkerModule = typeof import("../src/api-worker");
+     *
+     * const worker = server.getWorker<Cloudflare.Env, ApiWorkerModule>("api-worker");
+     * const api = await worker.getExport();
+     * api.getMessage();
+     * ```
+     */
+    getExport(): Promise<Service<Module["default"]>>;
 };
 type TestHarness = {
     /**
@@ -825,7 +908,9 @@ type TestHarness = {
      * When no name is provided, this returns the primary Worker, which is the first
      * Worker in the server's `workers` options.
      */
-    getWorker<Env = Record<string, any>>(name?: string): WorkerHandle<Env>;
+    getWorker<Env = AnyEnv, Module extends WorkerModule = {
+        default: AnyExportedHandler;
+    }>(name?: string): WorkerHandle<Env, Module>;
     /**
      * Returns captured Workers runtime logs since the current server session
      * started or `clearLogs()` was last called.
@@ -879,6 +964,11 @@ type WorkerInput = {
      * Test-only secrets that override values loaded from `.dev.vars` and `.env` files.
      */
     secrets?: Record<string, string>;
+    /**
+     * Test-only service binding overrides. Keys are binding names in this
+     * Worker's environment, and values are Worker names in this test harness.
+     */
+    bindingOverrides?: Record<string, string>;
 } | {
     /**
      * Inline Wrangler config for this Worker.
@@ -918,12 +1008,12 @@ type ReadConfigOptions = ResolveConfigPathOptions & {
 declare function readConfig(args: ReadConfigCommandArgs, options?: ReadConfigOptions): Config$1;
 
 /**
- * Based on the migrations, infer what the current Durable Object class names are.
- * This includes unbound (ctx.exports) and bound DOs.
- * Returns class name mapped to whether it uses SQLite storage.
- * This is imperfect because you can delete a migration after it has been applied.
+ * Infer Durable Object class names and storage backends from migrations and
+ * live declarative `exports` entries.
+ *
+ * In practice only one of `migrations` or `exports` will have the Durable Object configuration.
  */
-declare function getDurableObjectClassNameToUseSQLiteMap(migrations: Config$1["migrations"] | undefined): Map<string, boolean>;
+declare function getDurableObjectClassNameToUseSQLiteMap(migrations: Config$1["migrations"] | undefined, exports?: Config$1["exports"] | undefined): Map<string, boolean>;
 
 /**
  * Note about this file:
@@ -1284,6 +1374,66 @@ type DurableObjectMigration = {
     /** The Durable Objects being removed. */
     deleted_classes?: string[];
 };
+/**
+ * Storage backend for a declarative Durable Object export. See
+ * {@link DurableObjectExport}.
+ */
+type DurableObjectExportStorage = "sqlite" | "legacy-kv";
+/**
+ * A single declarative Durable Object export entry in the `exports` config
+ * map. `type` is reserved for the export kind. `state` carries the Durable
+ * Object lifecycle and defaults to `"created"` (live) when omitted.
+ *
+ * Mutually exclusive with {@link DurableObjectMigration} at the config-
+ * validation boundary.
+ *
+ *  - `created` (default, live): `storage` is required.
+ *  - `deleted` (tombstone): retire a provisioned namespace whose class has
+ *    been removed from code.
+ *  - `renamed` (tombstone): rewrite a provisioned namespace's class name to
+ *    `renamed_to`. The target name must also appear as a live (state
+ *    `"created"`) `durable-object` entry in the same map.
+ *  - `transferred` (tombstone): hand ownership of the namespace to another
+ *    script in the same account (`transferred_to`). Two-phase commit;
+ *    the target must first deploy an `expecting-transfer` entry naming this
+ *    script via `transfer_from`.
+ *  - `expecting-transfer` (live): receiving side of a two-phase transfer;
+ *    `storage` and `transfer_from` are both required.
+ */
+type DurableObjectExport = {
+    type: "durable-object";
+    state?: "created";
+    storage: DurableObjectExportStorage;
+} | {
+    type: "durable-object";
+    state: "deleted";
+} | {
+    type: "durable-object";
+    state: "renamed";
+    renamed_to: string;
+} | {
+    type: "durable-object";
+    state: "transferred";
+    transferred_to: string;
+} | {
+    type: "durable-object";
+    state: "expecting-transfer";
+    storage: DurableObjectExportStorage;
+    transfer_from: string;
+};
+interface WorkerEntrypointExport {
+    type: "worker";
+    cache?: {
+        /** Whether cache is enabled for this entrypoint. */
+        enabled: boolean;
+    };
+}
+type ConfiguredExport = DurableObjectExport | WorkerEntrypointExport;
+/**
+ * The declarative `exports` map keyed by export name. Durable Object exports
+ * are mutually exclusive with `migrations` at the wrangler config layer.
+ */
+type Exports = Record<string, ConfiguredExport>;
 /**
  * The `EnvironmentInheritable` interface declares all the configuration fields for an environment
  * that can be inherited (and overridden) from the top-level environment.
@@ -1425,6 +1575,15 @@ interface EnvironmentInheritable {
      * @inheritable
      */
     migrations: DurableObjectMigration[];
+    /**
+     * Declarative exports configuration — a map of class name to export configuration.
+     *
+     * The configuration of Durable Objects via `exports` is mutually exclusive with `migrations`.
+     *
+     * @default {}
+     * @inheritable
+     */
+    exports: Exports;
     /**
      * "Cron" definitions to trigger a Worker's "scheduled" function.
      *
@@ -2508,6 +2667,8 @@ interface Observability {
 interface CacheOptions {
     /** If cache is enabled for this Worker */
     enabled: boolean;
+    /** Whether cached assets may be reused across Worker versions. */
+    cross_version_cache?: boolean;
 }
 type DockerConfiguration = {
     /** Socket used by miniflare to communicate with Docker */
@@ -3141,6 +3302,7 @@ interface CommonYargsOptions {
     "experimental-provision": boolean | undefined;
     "experimental-auto-create": boolean;
     "install-skills": boolean;
+    profile: string | undefined;
 }
 type CommonYargsArgv = Argv<CommonYargsOptions>;
 type RemoveIndex<T> = {
@@ -3176,7 +3338,8 @@ type Teams =
 	| "Product: Tunnels"
 	| "Product: Email Service"
 	| "Product: Browser Run"
-	| "Product: Artifacts";
+	| "Product: Artifacts"
+	| "Product: Flagship";
 
 /** Convert literal string types like 'foo-bar' to 'FooBar' */
 type PascalCase<S extends string> = string extends S ? string : S extends `${infer T}-${infer U}` ? `${Capitalize<T>}${PascalCase<U>}` : Capitalize<S>;
@@ -3340,6 +3503,14 @@ type CommandDefinition<NamedArgDefs extends NamedArgDefinitions = NamedArgDefini
          * @default false
          */
         supportTemporary?: boolean;
+        /**
+         * By default, the banner will print "Active profile: <name>" when a non-default
+         * profile is resolved. Set to `false` to suppress this line while still printing
+         * the rest of the banner.
+         *
+         * @default true
+         */
+        printActiveProfile?: boolean;
     };
     /**
      * A plain key-value object describing the CLI args for this command.
@@ -3509,6 +3680,11 @@ declare function createCLIParser(argv: string[]): {
             readonly type: "boolean";
             readonly default: false;
         };
+        readonly profile: {
+            readonly describe: "Use a specific auth profile";
+            readonly type: "string";
+            readonly requiresArg: true;
+        };
     };
     showHelpWithCategories: () => Promise<void>;
 };