wrangler 3.89.0 → 3.91.0

package/README.md

@@ -43,7 +43,7 @@ $ npm install wrangler --save-dev
 
 ## Configuration:
 
-Wrangler is configured via a `wrangler.toml` file in the project root. When utilizing the `wrangler init` command, a `wrangler.toml` file will be created for you.
+Wrangler is configured via a `wrangler.json` or `wrangler.toml` file in the project root. When utilizing the `wrangler init` command, a `wrangler.toml` file will be created for you.
 
 Example:
 

package/config-schema.json

@@ -93,7 +93,7 @@
       "properties": {
         "dir": {
           "deprecated": true,
-          "description": "The directory you wish to upload your Worker from, relative to the wrangler.toml file.\n\nDefaults to the directory containing the wrangler.toml file.",
+          "description": "The directory you wish to upload your Worker from, relative to the Wrangler configuration file.\n\nDefaults to the directory containing the Wrangler configuration file.",
           "type": "string"
         },
         "format": {
@@ -655,6 +655,11 @@
           "description": "Determines whether Wrangler will preserve bundled file names. Defaults to false. If left unset, files will be named using the pattern ${fileHash}-${basename}, for example, `34de60b44167af5c5a709e62a4e20c4f18c9e3b6-favicon.ico`.",
           "type": "boolean"
         },
+        "preview_urls": {
+          "default": "`true`",
+          "description": "Whether we use <version>-<name>.<subdomain>.workers.dev to serve Preview URLs for your Worker.",
+          "type": "boolean"
+        },
         "queues": {
           "additionalProperties": false,
           "default": "`{consumers:[],producers:[]}`",
@@ -1440,7 +1445,7 @@
         },
         "keep_vars": {
           "default": false,
-          "description": "By default, wrangler.toml is the source of truth for your environment configuration, like a terraform file.\n\nIf you change your vars in the dashboard, wrangler *will* override/delete them on its next deploy.\n\nIf you want to keep your dashboard vars when wrangler deploys, set this field to true.",
+          "description": "By default, the Wrangler configuration file is the source of truth for your environment configuration, like a terraform file.\n\nIf you change your vars in the dashboard, wrangler *will* override/delete them on its next deploy.\n\nIf you want to keep your dashboard vars when wrangler deploys, set this field to true.",
           "type": "boolean"
         },
         "kv-namespaces": {
@@ -1620,7 +1625,7 @@
           "description": "Specify the observability behavior of the Worker."
         },
         "pages_build_output_dir": {
-          "description": "The directory of static assets to serve.\n\nThe 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.",
+          "description": "The directory of static assets to serve.\n\nThe 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.",
           "type": "string"
         },
         "pipelines": {
@@ -1670,6 +1675,11 @@
           "description": "Determines whether Wrangler will preserve bundled file names. Defaults to false. If left unset, files will be named using the pattern ${fileHash}-${basename}, for example, `34de60b44167af5c5a709e62a4e20c4f18c9e3b6-favicon.ico`.",
           "type": "boolean"
         },
+        "preview_urls": {
+          "default": "`true`",
+          "description": "Whether we use <version>-<name>.<subdomain>.workers.dev to serve Preview URLs for your Worker.",
+          "type": "boolean"
+        },
         "queues": {
           "additionalProperties": false,
           "default": "`{consumers:[],producers:[]}`",
@@ -1874,7 +1884,7 @@
           "description": "The definition of a Worker Site, a feature that lets you upload static assets with your Worker.\n\nMore details at https://developers.cloudflare.com/workers/platform/sites",
           "properties": {
             "bucket": {
-              "description": "The directory containing your static assets.\n\nIt must be a path relative to your wrangler.toml file. Example: bucket = \"./public\"\n\nIf there is a `site` field then it must contain this `bucket` field.",
+              "description": "The directory containing your static assets.\n\nIt must be a path relative to your Wrangler configuration file. Example: bucket = \"./public\"\n\nIf there is a `site` field then it must contain this `bucket` field.",
               "type": "string"
             },
             "entry-point": {
@@ -2621,6 +2631,11 @@
           "description": "Determines whether Wrangler will preserve bundled file names. Defaults to false. If left unset, files will be named using the pattern ${fileHash}-${basename}, for example, `34de60b44167af5c5a709e62a4e20c4f18c9e3b6-favicon.ico`.",
           "type": "boolean"
         },
+        "preview_urls": {
+          "default": "`true`",
+          "description": "Whether we use <version>-<name>.<subdomain>.workers.dev to serve Preview URLs for your Worker.",
+          "type": "boolean"
+        },
         "queues": {
           "additionalProperties": false,
           "default": "`{consumers:[],producers:[]}`",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "3.89.0",
+  "version": "3.91.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -63,11 +63,11 @@
     "resolve.exports": "^2.0.2",
     "selfsigned": "^2.0.1",
     "source-map": "^0.6.1",
-    "unenv": "npm:unenv-nightly@2.0.0-20241111-080453-894aa31",
+    "unenv": "npm:unenv-nightly@2.0.0-20241121-161142-806b5c0",
     "workerd": "1.20241106.1",
     "xxhash-wasm": "^1.0.1",
     "@cloudflare/kv-asset-handler": "0.3.4",
-    "@cloudflare/workers-shared": "0.7.1",
+    "@cloudflare/workers-shared": "0.9.0",
     "miniflare": "3.20241106.1"
   },
   "devDependencies": {
@@ -141,8 +141,8 @@
     "yargs": "^17.7.2",
     "@cloudflare/cli": "1.1.1",
     "@cloudflare/pages-shared": "^0.11.69",
-    "@cloudflare/eslint-config-worker": "1.1.0",
-    "@cloudflare/workers-tsconfig": "0.0.0"
+    "@cloudflare/workers-tsconfig": "0.0.0",
+    "@cloudflare/eslint-config-worker": "1.1.0"
   },
   "peerDependencies": {
     "@cloudflare/workers-types": "^4.20241106.0"

package/wrangler-dist/cli.d.ts

@@ -762,7 +762,7 @@ declare type CloudchamberConfig = {
 /**
  * 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,
+ * 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
@@ -773,7 +773,7 @@ declare type CloudchamberConfig = {
  * - 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.
+ * - All top level fields in config and environments are optional in the Wrangler configuration file.
  *
  * Legend for the annotations:
  *
@@ -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.
      *
@@ -1056,9 +1056,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,7 +1468,7 @@ declare interface EnablePagesAssetsServiceBindingOptions {
 declare type Entry = {
     /** A worker's entrypoint */
     file: string;
-    /** A worker's directory. Usually where the wrangler.toml file is located */
+    /** 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;
@@ -1572,6 +1572,14 @@ declare interface EnvironmentInheritable {
      * @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.
@@ -2540,7 +2548,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 +2568,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 +2588,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).
@@ -2946,7 +2947,7 @@ 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.
      */
@@ -2957,7 +2958,7 @@ 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.
      */
@@ -25870,10 +25871,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 +25956,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;
@@ -26058,7 +26062,7 @@ declare interface StartDevWorkerInput {
 }
 
 declare type StartDevWorkerOptions = Omit<StartDevWorkerInput, "assets"> & {
-    /** A worker's directory. Usually where the wrangler.toml file is located */
+    /** A worker's directory. Usually where the Wrangler configuration file is located */
     projectRoot: string;
     build: StartDevWorkerInput["build"] & {
         nodejsCompatMode: NodeJSCompatMode;