wrangler 4.26.1 → 4.28.0

package/config-schema.json

@@ -2340,7 +2340,7 @@
           "additionalProperties": {
             "type": "string"
           },
-          "description": "Image variables to be passed along the image at build time."
+          "description": "Image variables available to the image at build-time only. For runtime env vars, refer to https://developers.cloudflare.com/containers/examples/env-vars-and-secrets/"
         },
         "class_name": {
           "type": "string",
@@ -2357,13 +2357,36 @@
           "default": "default"
         },
         "instance_type": {
-          "type": "string",
-          "enum": [
-            "dev",
-            "basic",
-            "standard"
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "dev"
+            },
+            {
+              "type": "string",
+              "const": "basic"
+            },
+            {
+              "type": "string",
+              "const": "standard"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "vcpu": {
+                  "type": "number"
+                },
+                "memory_mib": {
+                  "type": "number"
+                },
+                "disk_mb": {
+                  "type": "number"
+                }
+              },
+              "additionalProperties": false
+            }
           ],
-          "description": "The instance type to be used for the container. dev = 1/16 vCPU, 256 MiB memory, and 2 GB disk basic = 1/4 vCPU, 1 GiB memory, and 4 GB disk standard = 1/2 vCPU, 4 GiB memory, and 4 GB disk",
+          "description": "The instance type to be used for the container. Select from one of the following named instance types:  - dev: 1/16 vCPU, 256 MiB memory, and 2 GB disk  - basic: 1/4 vCPU, 1 GiB memory, and 4 GB disk  - standard: 1/2 vCPU, 4 GiB memory, and 4 GB disk\n\nCustomers on an enterprise plan have the additional option to set custom limits.",
           "default": "dev"
         },
         "rollout_step_percentage": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.26.1",
+  "version": "4.28.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -54,15 +54,15 @@
     "esbuild": "0.25.4",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.19",
-    "workerd": "1.20250726.0",
-    "@cloudflare/kv-asset-handler": "0.4.0",
-    "@cloudflare/unenv-preset": "2.5.0",
-    "miniflare": "4.20250726.0"
+    "workerd": "1.20250803.0",
+    "miniflare": "4.20250803.0",
+    "@cloudflare/unenv-preset": "2.6.0",
+    "@cloudflare/kv-asset-handler": "0.4.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20250726.0",
+    "@cloudflare/workers-types": "^4.20250803.0",
     "@cspotcode/source-map-support": "0.8.1",
     "@iarna/toml": "^3.0.0",
     "@sentry/node": "^7.86.0",
@@ -94,6 +94,7 @@
     "date-fns": "^4.1.0",
     "devtools-protocol": "^0.0.1182435",
     "dotenv": "^16.3.1",
+    "dotenv-expand": "^12.0.2",
     "execa": "^6.1.0",
     "find-up": "^6.3.0",
     "get-port": "^7.0.0",
@@ -138,12 +139,12 @@
     "@cloudflare/cli": "1.1.1",
     "@cloudflare/containers-shared": "0.2.8",
     "@cloudflare/eslint-config-worker": "1.1.0",
-    "@cloudflare/pages-shared": "^0.13.58",
+    "@cloudflare/pages-shared": "^0.13.60",
     "@cloudflare/workers-shared": "0.18.5",
     "@cloudflare/workers-tsconfig": "0.0.0"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20250726.0"
+    "@cloudflare/workers-types": "^4.20250803.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/wrangler-dist/cli.d.ts

@@ -73,7 +73,8 @@ type ContainerApp = {
      */
     image_build_context?: string;
     /**
-     * Image variables to be passed along the image at build time.
+     * Image variables available to the image at build-time only.
+     * For runtime env vars, refer to https://developers.cloudflare.com/containers/examples/env-vars-and-secrets/
      * @optional
      */
     image_vars?: Record<string, string>;
@@ -89,13 +90,24 @@ type ContainerApp = {
     scheduling_policy?: "default" | "moon" | "regional";
     /**
      * The instance type to be used for the container.
-     * dev = 1/16 vCPU, 256 MiB memory, and 2 GB disk
-     * basic = 1/4 vCPU, 1 GiB memory, and 4 GB disk
-     * standard = 1/2 vCPU, 4 GiB memory, and 4 GB disk
+     * Select from one of the following named instance types:
+     *  - dev: 1/16 vCPU, 256 MiB memory, and 2 GB disk
+     *  - basic: 1/4 vCPU, 1 GiB memory, and 4 GB disk
+     *  - standard: 1/2 vCPU, 4 GiB memory, and 4 GB disk
+     *
+     * Customers on an enterprise plan have the additional option to set custom limits.
+     *
      * @optional
      * @default "dev"
      */
-    instance_type?: "dev" | "basic" | "standard";
+    instance_type?: "dev" | "basic" | "standard" | {
+        /** @defaults to 0.0625 (1/16 vCPU) */
+        vcpu?: number;
+        /** @defaults to 256 MiB */
+        memory_mib?: number;
+        /** @defaults to 2 GB */
+        disk_mb?: number;
+    };
     /**
      * @deprecated Use top level `containers` fields instead.
      * `configuration.image` should be `image`
@@ -1537,6 +1549,7 @@ interface EnablePagesAssetsServiceBindingOptions {
 interface Unstable_DevOptions {
     config?: string;
     env?: string;
+    envFiles?: string[];
     ip?: string;
     port?: number;
     bundle?: boolean;
@@ -1904,6 +1917,13 @@ interface StartDevWorkerInput {
     /** Specify the compliance region mode of the Worker. */
     complianceRegion?: Config["compliance_region"];
     env?: string;
+    /**
+     * An array of paths to the .env files to load for this worker, relative to the project directory.
+     *
+     * If not specified, defaults to the standard `.env` files as given by `getDefaultEnvFiles()`.
+     * The project directory is where the Wrangler configuration file is located or the current working directory otherwise.
+     */
+    envFiles?: 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>;
     migrations?: DurableObjectMigration[];
@@ -1990,7 +2010,7 @@ interface StartDevWorkerInput {
         /** Describes the registry of other Workers running locally */
         registry?: WorkerRegistry | null;
         testScheduled?: boolean;
-        /** Whether to use Vectorize mixed mode -- the worker is run locally but accesses to Vectorize are made remotely */
+        /** Whether to use Vectorize as a remote binding -- the worker is run locally but accesses to Vectorize are made remotely */
         bindVectorizeToProd?: boolean;
         /** Whether to use Images local mode -- this is lower fidelity, but doesn't require network access */
         imagesLocalMode?: boolean;
@@ -2396,6 +2416,36 @@ declare class ExecutionContext {
     props: any;
 }
 
+/**
+ * Get the Worker `vars` bindings for a `wrangler dev` instance of a Worker.
+ *
+ * The `vars` bindings can be specified in the Wrangler configuration file.
+ * But "secret" `vars` are usually only provided at the server -
+ * either by creating them in the Dashboard UI, or using the `wrangler secret` command.
+ *
+ * It is useful during development, to provide these types of variable locally.
+ * When running `wrangler dev` we will look for a file called `.dev.vars`, situated
+ * next to the User's Wrangler configuration file (or in the current working directory if there is no
+ * Wrangler configuration). If the `--env <env>` option is set, we'll first look for
+ * `.dev.vars.<env>`.
+ *
+ * If there are no `.dev.vars*` file, (and CLOUDFLARE_LOAD_DEV_VARS_FROM_DOT_ENV is not "false")
+ * we will look for `.env*` files in the same directory.
+ * If the `envFiles` option is set, we'll look for the `.env` files at those paths instead of the defaults.
+ *
+ * Any values in these files (all formatted like `.env` files) will add to or override `vars`
+ * bindings provided in the Wrangler configuration file.
+ *
+ * @param configPath - The path to the Wrangler configuration file, if defined.
+ * @param envFiles - An array of paths to .env files to load; if `undefined` the default .env files will be used (see `getDefaultEnvFiles()`).
+ * The `envFiles` paths are resolved against the directory of the Wrangler configuration file, if there is one, otherwise against the current working directory.
+ * @param vars - The existing `vars` bindings from the Wrangler configuration.
+ * @param env - The specific environment name (e.g., "staging") or `undefined` if no specific environment is set.
+ * @param silent - If true, will not log any messages about the loaded .dev.vars files or .env files.
+ * @returns The merged `vars` bindings, including those loaded from `.dev.vars` or `.env` files.
+ */
+declare function getVarsForDev(configPath: string | undefined, envFiles: string[] | undefined, vars: Config["vars"], env: string | undefined, silent?: boolean): Config["vars"];
+
 /**
  * Options for the `getPlatformProxy` utility
  */
@@ -2413,6 +2463,23 @@ type GetPlatformProxyOptions = {
      *       point to a valid file on the filesystem
      */
     configPath?: string;
+    /**
+     * Paths to `.env` files to load environment variables from, relative to the project directory.
+     *
+     * The project directory is computed as the directory containing `configPath` or the current working directory if `configPath` is undefined.
+     *
+     * If `envFiles` is defined, only the files in the array will be considered for loading local dev variables.
+     * If `undefined`, the default behavior is:
+     *  - compute the project directory as that containing the Wrangler configuration file,
+     *    or the current working directory if no Wrangler configuration file is specified.
+     *  - look for `.env` and `.env.local` files in the project directory.
+     *  - if the `environment` option is specified, also look for `.env.<environment>` and `.env.<environment>.local`
+     *    files in the project directory
+     *  - resulting in an `envFiles` array like: `[".env", ".env.local", ".env.<environment>", ".env.<environment>.local"]`.
+     *
+     * The values from files earlier in the `envFiles` array (e.g. `envFiles[x]`) will be overridden by values from files later in the array (e.g. `envFiles[x+1)`).
+     */
+    envFiles?: string[];
     /**
      * Indicates if and where to persist the bindings data, if not present or `true` it defaults to the same location
      * used by wrangler: `.wrangler/state/v3` (so that the same data can be easily used by the caller and wrangler).
@@ -2594,4 +2661,4 @@ interface Unstable_ASSETSBindingsOptions {
 }
 declare const generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request) => Promise<Response$1>;
 
-export { type ConfigBindingOptions as Experimental_ConfigBindingOptions, type RemoteProxySession as Experimental_RemoteProxySession, type GetPlatformProxyOptions, type PlatformProxy, type SourcelessWorkerOptions, type Unstable_ASSETSBindingsOptions, type Binding as Unstable_Binding, 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 StartRemoteProxySessionOptions as experimental_StartRemoteProxySessionOptions, maybeStartOrUpdateRemoteProxySession as experimental_maybeStartOrUpdateRemoteProxySession, experimental_patchConfig, pickRemoteBindings as experimental_pickRemoteBindings, experimental_readRawConfig, startRemoteProxySession as experimental_startRemoteProxySession, getPlatformProxy, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, generateASSETSBinding as unstable_generateASSETSBinding, unstable_getMiniflareWorkerOptions, unstable_pages, readConfig as unstable_readConfig, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };
+export { type ConfigBindingOptions as Experimental_ConfigBindingOptions, type RemoteProxySession as Experimental_RemoteProxySession, type GetPlatformProxyOptions, type PlatformProxy, type SourcelessWorkerOptions, type Unstable_ASSETSBindingsOptions, type Binding as Unstable_Binding, 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 StartRemoteProxySessionOptions as experimental_StartRemoteProxySessionOptions, maybeStartOrUpdateRemoteProxySession as experimental_maybeStartOrUpdateRemoteProxySession, experimental_patchConfig, pickRemoteBindings as experimental_pickRemoteBindings, experimental_readRawConfig, startRemoteProxySession as experimental_startRemoteProxySession, getPlatformProxy, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, generateASSETSBinding as unstable_generateASSETSBinding, unstable_getMiniflareWorkerOptions, getVarsForDev as unstable_getVarsForDev, unstable_pages, readConfig as unstable_readConfig, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };