wrangler 0.0.0-e3cab74 → 0.0.0-e3d46ab3

package/src/index.tsx

@@ -1,2327 +0,0 @@
-import * as fs from "node:fs";
-import { writeFile, mkdir } from "node:fs/promises";
-import path from "node:path";
-import { setTimeout } from "node:timers/promises";
-import TOML from "@iarna/toml";
-import { findUp } from "find-up";
-import getPort from "get-port";
-import { render } from "ink";
-import React from "react";
-import onExit from "signal-exit";
-import makeCLI from "yargs";
-import { version as wranglerVersion } from "../package.json";
-import { toFormData } from "./api/form_data";
-import { fetchResult } from "./cfetch";
-import { findWranglerToml, readConfig } from "./config";
-import Dev from "./dev";
-import { confirm, prompt } from "./dialogs";
-import { getEntry } from "./entry";
-import {
-  getNamespaceId,
-  listNamespaces,
-  listNamespaceKeys,
-  putKeyValue,
-  putBulkKeyValue,
-  deleteBulkKeyValue,
-  createNamespace,
-  isValidNamespaceBinding,
-  getKeyValue,
-} from "./kv";
-import { getPackageManager } from "./package-manager";
-import { pages } from "./pages";
-import { formatMessage, ParseError, parseJSON, readFileSync } from "./parse";
-import publish from "./publish";
-import { createR2Bucket, deleteR2Bucket, listR2Buckets } from "./r2";
-import { getAssetPaths } from "./sites";
-import {
-  createTail,
-  jsonPrintLogs,
-  prettyPrintLogs,
-  translateCLICommandToFilterMessage,
-} from "./tail";
-import {
-  login,
-  logout,
-  listScopes,
-  initialise as initialiseUserConfig,
-  loginOrRefreshIfRequired,
-  getAccountId,
-  validateScopeKeys,
-} from "./user";
-import { whoami } from "./whoami";
-
-import type { Config } from "./config";
-import type { TailCLIFilters } from "./tail";
-import type { RawData } from "ws";
-import type Yargs from "yargs";
-
-type ConfigPath = string | undefined;
-
-const resetColor = "\x1b[0m";
-const fgGreenColor = "\x1b[32m";
-
-function getRules(config: Config): Config["rules"] {
-  const rules = config.rules ?? config.build?.upload?.rules ?? [];
-
-  if (config.rules && config.build?.upload?.rules) {
-    throw new Error(
-      `You cannot configure both [rules] and [build.upload.rules] in your wrangler.toml. Delete the \`build.upload\` section.`
-    );
-  }
-
-  if (config.build?.upload?.rules) {
-    console.warn(
-      `Deprecation notice: The \`build.upload.rules\` config field is no longer used, the rules should be specified via the \`rules\` config field. Delete the \`build.upload\` field from the configuration file, and add this:
-
-${TOML.stringify({ rules: config.build.upload.rules })}`
-    );
-  }
-  return rules;
-}
-
-function isLegacyEnv(args: unknown, config: Config): boolean {
-  return (
-    (args as { "legacy-env": boolean | undefined })["legacy-env"] ??
-    config.legacy_env
-  );
-}
-
-function getScriptName(
-  args: { name: string | undefined; env: string | undefined },
-  config: Config
-): string | undefined {
-  const shortScriptName = args.name ?? config.name;
-  if (!shortScriptName) {
-    return;
-  }
-
-  return isLegacyEnv(args, config)
-    ? `${shortScriptName}${args.env ? `-${args.env}` : ""}`
-    : shortScriptName;
-}
-
-// a helper to demand one of a set of options
-// via https://github.com/yargs/yargs/issues/1093#issuecomment-491299261
-function demandOneOfOption(...options: string[]) {
-  return function (argv: Yargs.Arguments) {
-    const count = options.filter((option) => argv[option]).length;
-    const lastOption = options.pop();
-
-    if (count === 0) {
-      throw new CommandLineArgsError(
-        `Exactly one of the arguments ${options.join(
-          ", "
-        )} and ${lastOption} is required`
-      );
-    } else if (count > 1) {
-      throw new CommandLineArgsError(
-        `Arguments ${options.join(
-          ", "
-        )} and ${lastOption} are mutually exclusive`
-      );
-    }
-
-    return true;
-  };
-}
-
-class CommandLineArgsError extends Error {}
-class DeprecationError extends Error {
-  constructor(message: string) {
-    super(`DEPRECATION WARNING:\n${message}`);
-  }
-}
-
-export async function main(argv: string[]): Promise<void> {
-  const wrangler = makeCLI(argv)
-    // We handle errors ourselves in a try-catch around `yargs.parse`.
-    // If you want the "help info" to be displayed then throw an instance of `CommandLineArgsError`.
-    // Otherwise we just log the error that was thrown without any "help info".
-    .showHelpOnFail(false)
-    .fail((msg, error) => {
-      if (!error) {
-        // If there is only a `msg` then this came from yargs own validation, so wrap in a `CommandLineArgsError`.
-        error = new CommandLineArgsError(msg);
-      }
-      throw error;
-    })
-    .scriptName("wrangler")
-    .wrap(null);
-
-  // the default is to simply print the help menu
-  wrangler.command(
-    ["*"],
-    false,
-    () => {},
-    (args) => {
-      if (args._.length > 0) {
-        throw new CommandLineArgsError(`Unknown command: ${args._}.`);
-      } else {
-        wrangler.showHelp("log");
-      }
-    }
-  );
-
-  // You will note that we use the form for all commands where we use the builder function
-  // to define options and subcommands.
-  // Further we return the result of this builder even though it's not completely necessary.
-  // The reason is that it's required for type inference of the args in the handle function.
-  // I wish we could enforce this pattern, but this comment will have to do for now.
-  // (It's also annoying that choices[] doesn't get inferred as an enum. 🤷‍♂.)
-
-  // [DEPRECATED] generate
-  wrangler.command(
-    // we definitely want to move away from us cloning github templates
-    // we can do something better here, let's see
-    "generate [name] [template]",
-    false,
-    (yargs) => {
-      return yargs
-        .positional("name", {
-          describe: "Name of the Workers project",
-          default: "worker",
-        })
-        .positional("template", {
-          describe: "a link to a GitHub template",
-          default: "https://github.com/cloudflare/worker-template",
-        });
-    },
-    () => {
-      // "👯 [DEPRECATED]. Scaffold a Cloudflare Workers project from a public GitHub repository.",
-      throw new DeprecationError(
-        "`wrangler generate` has been deprecated, please refer to TODO://some/path for alternatives"
-      );
-    }
-  );
-
-  // init
-  wrangler.command(
-    "init [name]",
-    "📥 Create a wrangler.toml configuration file",
-    (yargs) => {
-      return yargs
-        .positional("name", {
-          describe: "The name of your worker",
-          type: "string",
-        })
-        .option("yes", {
-          describe: 'Answer "yes" to any prompts for new projects',
-          type: "boolean",
-          alias: "y",
-        });
-    },
-    async (args) => {
-      if ("type" in args) {
-        let message = "The --type option is no longer supported.";
-        if (args.type === "webpack") {
-          message +=
-            "\nIf you wish to use webpack then you will need to create a custom build.";
-          // TODO: Add a link to docs
-        }
-        throw new CommandLineArgsError(message);
-      }
-
-      // TODO: make sure args.name is a valid identifier for a worker name
-
-      const creationDirectory = path.join(process.cwd(), args.name ?? "");
-
-      const packageManager = await getPackageManager(creationDirectory);
-
-      // TODO: ask which directory to make the worker in (defaults to args.name)
-      // TODO: if args.name isn't provided, ask what to name the worker
-
-      const wranglerTomlDestination = path.join(
-        creationDirectory,
-        "./wrangler.toml"
-      );
-      let justCreatedWranglerToml = false;
-      const workerName =
-        args.name || path.basename(path.resolve(process.cwd()));
-      if (fs.existsSync(wranglerTomlDestination)) {
-        console.warn(`${wranglerTomlDestination} file already exists!`);
-        const shouldContinue = await confirm(
-          "Do you want to continue initializing this project?"
-        );
-        if (!shouldContinue) {
-          return;
-        }
-      } else {
-        await mkdir(creationDirectory, { recursive: true });
-        const compatibilityDate = new Date().toISOString().substring(0, 10);
-        try {
-          await writeFile(
-            wranglerTomlDestination,
-            TOML.stringify({
-              name: workerName,
-              compatibility_date: compatibilityDate,
-            }) + "\n"
-          );
-          console.log(`✨ Successfully created wrangler.toml`);
-          justCreatedWranglerToml = true;
-        } catch (err) {
-          throw new Error(
-            `Failed to create wrangler.toml.\n${(err as Error).message ?? err}`
-          );
-        }
-      }
-
-      let pathToPackageJson = await findUp("package.json");
-      let shouldCreatePackageJson = false;
-      const yesFlag = args.yes ?? false;
-      if (!pathToPackageJson) {
-        // If no package.json exists, ask to create one
-        shouldCreatePackageJson =
-          yesFlag ||
-          (await confirm(
-            "No package.json found. Would you like to create one?"
-          ));
-
-        if (shouldCreatePackageJson) {
-          await writeFile(
-            path.join(creationDirectory, "./package.json"),
-            JSON.stringify(
-              {
-                name: workerName,
-                version: "0.0.0",
-                devDependencies: {
-                  wrangler: wranglerVersion,
-                },
-                private: true,
-              },
-              null,
-              "  "
-            ) + "\n"
-          );
-          await packageManager.install();
-          console.log(`✨ Created package.json`);
-          pathToPackageJson = path.join(creationDirectory, "package.json");
-        } else {
-          return;
-        }
-      } else {
-        // If package.json exists and wrangler isn't installed,
-        // then ask to add wrangler to devDependencies
-        const packageJson = parseJSON(
-          readFileSync(pathToPackageJson),
-          pathToPackageJson
-        );
-        if (
-          !(
-            packageJson.devDependencies?.wrangler ||
-            packageJson.dependencies?.wrangler
-          )
-        ) {
-          const shouldInstall =
-            yesFlag ||
-            (await confirm(
-              "Would you like to install wrangler into your package.json?"
-            ));
-          if (shouldInstall) {
-            await packageManager.addDevDeps(`wrangler@${wranglerVersion}`);
-            console.log(`✨ Installed wrangler`);
-          }
-        }
-      }
-
-      let isTypescriptProject = false;
-      let pathToTSConfig = await findUp("tsconfig.json");
-      if (!pathToTSConfig) {
-        // If there's no tsconfig, offer to create one
-        // and install @cloudflare/workers-types
-        if (yesFlag || (await confirm("Would you like to use TypeScript?"))) {
-          isTypescriptProject = true;
-          await writeFile(
-            path.join(creationDirectory, "./tsconfig.json"),
-            readFileSync(path.join(__dirname, "../templates/tsconfig.json"))
-          );
-          await packageManager.addDevDeps(
-            "@cloudflare/workers-types",
-            "typescript"
-          );
-
-          console.log(
-            `✨ Created tsconfig.json, installed @cloudflare/workers-types into devDependencies`
-          );
-          pathToTSConfig = path.join(creationDirectory, "tsconfig.json");
-        }
-      } else {
-        isTypescriptProject = true;
-        // If there's a tsconfig, check if @cloudflare/workers-types
-        // is already installed, and offer to install it if not
-        const packageJson = parseJSON(
-          readFileSync(pathToPackageJson),
-          pathToPackageJson
-        );
-        if (
-          !(
-            packageJson.devDependencies?.["@cloudflare/workers-types"] ||
-            packageJson.dependencies?.["@cloudflare/workers-types"]
-          )
-        ) {
-          const shouldInstall = await confirm(
-            "Would you like to install the type definitions for Workers into your package.json?"
-          );
-          if (shouldInstall) {
-            await packageManager.addDevDeps("@cloudflare/workers-types");
-            // We don't update the tsconfig.json because
-            // it could be complicated in existing projects
-            // and we don't want to break them. Instead, we simply
-            // tell the user that they need to update their tsconfig.json
-            console.log(
-              `✨ Installed @cloudflare/workers-types.\nPlease add "@cloudflare/workers-types" to compilerOptions.types in your tsconfig.json`
-            );
-          }
-        }
-      }
-
-      const packageJsonContent = parseJSON(
-        readFileSync(pathToPackageJson),
-        pathToPackageJson
-      );
-      const shouldWritePackageJsonScripts =
-        !packageJsonContent.scripts?.start &&
-        !packageJsonContent.scripts?.publish &&
-        shouldCreatePackageJson;
-
-      async function writePackageJsonScriptsAndUpdateWranglerToml(
-        isWritingScripts: boolean,
-        isCreatingWranglerToml: boolean,
-        packagePath: string,
-        scriptPath: string
-      ) {
-        if (isCreatingWranglerToml) {
-          // rewrite wrangler.toml with main = "path/to/script"
-          const parsedWranglerToml = TOML.parse(
-            readFileSync(wranglerTomlDestination)
-          );
-          fs.writeFileSync(
-            wranglerTomlDestination,
-            TOML.stringify({
-              name: parsedWranglerToml.name,
-              main: scriptPath,
-              compatibility_date: parsedWranglerToml.compatibility_date,
-            })
-          );
-        }
-        const isNamedWorker =
-          isCreatingWranglerToml && path.dirname(packagePath) !== process.cwd();
-
-        if (isWritingScripts) {
-          await writeFile(
-            packagePath,
-            JSON.stringify(
-              {
-                ...packageJsonContent,
-                scripts: {
-                  ...packageJsonContent.scripts,
-                  start: isCreatingWranglerToml
-                    ? `wrangler dev`
-                    : `wrangler dev ${scriptPath}`,
-                  publish: isCreatingWranglerToml
-                    ? `wrangler publish`
-                    : `wrangler publish ${scriptPath}`,
-                },
-              },
-              null,
-              2
-            ) + "\n"
-          );
-          console.log(
-            `\nTo start developing your Worker, run \`${
-              isNamedWorker ? `cd ${args.name} && ` : ""
-            }npm start\``
-          );
-          console.log(
-            `To publish your Worker to the Internet, run \`npm run publish\``
-          );
-        } else {
-          console.log(
-            `\nTo start developing your Worker, run \`npx wrangler dev\`${
-              isCreatingWranglerToml ? "" : ` ${scriptPath}`
-            }`
-          );
-          console.log(
-            `To publish your Worker to the Internet, run \`npx wrangler publish\`${
-              isCreatingWranglerToml ? "" : ` ${scriptPath}`
-            }`
-          );
-        }
-      }
-
-      if (isTypescriptProject) {
-        if (!fs.existsSync(path.join(creationDirectory, "./src/index.ts"))) {
-          let shouldCreateSource = false;
-
-          shouldCreateSource =
-            yesFlag ||
-            (await confirm(
-              `Would you like to create a Worker at src/index.ts?`
-            ));
-
-          if (shouldCreateSource) {
-            await mkdir(path.join(creationDirectory, "./src"), {
-              recursive: true,
-            });
-            await writeFile(
-              path.join(creationDirectory, "./src/index.ts"),
-              readFileSync(path.join(__dirname, "../templates/new-worker.ts"))
-            );
-
-            console.log(`✨ Created src/index.ts`);
-
-            await writePackageJsonScriptsAndUpdateWranglerToml(
-              shouldWritePackageJsonScripts,
-              justCreatedWranglerToml,
-              pathToPackageJson,
-              "src/index.ts"
-            );
-          }
-        }
-      } else {
-        if (!fs.existsSync("./src/index.js")) {
-          const shouldCreateSource = await confirm(
-            `Would you like to create a Worker at src/index.js?`
-          );
-          if (shouldCreateSource) {
-            await mkdir(path.join(creationDirectory, "./src"), {
-              recursive: true,
-            });
-            await writeFile(
-              path.join(path.join(creationDirectory, "./src/index.js")),
-              readFileSync(path.join(__dirname, "../templates/new-worker.js"))
-            );
-
-            console.log(`✨ Created src/index.js`);
-
-            await writePackageJsonScriptsAndUpdateWranglerToml(
-              shouldWritePackageJsonScripts,
-              justCreatedWranglerToml,
-              pathToPackageJson,
-              "src/index.js"
-            );
-          }
-        }
-      }
-    }
-  );
-
-  // build
-  wrangler.command(
-    "build",
-    false,
-    (yargs) => {
-      return yargs.option("env", {
-        describe: "Perform on a specific environment",
-      });
-    },
-    () => {
-      // "[DEPRECATED] 🦀 Build your project (if applicable)",
-      throw new DeprecationError(
-        "`wrangler build` has been deprecated, please refer to TODO://some/path for alternatives"
-      );
-    }
-  );
-
-  // login
-  wrangler.command(
-    // this needs scopes as an option?
-    "login",
-    false, // we don't need to show this in the menu
-    // "🔓 Login to Cloudflare",
-    (yargs) => {
-      // TODO: This needs some copy editing
-      // I mean, this entire app does, but this too.
-      return yargs
-        .option("scopes-list", {
-          describe: "List all the available OAuth scopes with descriptions",
-        })
-        .option("scopes", {
-          describe: "Pick the set of applicable OAuth scopes when logging in",
-          array: true,
-          type: "string",
-        });
-
-      // TODO: scopes
-    },
-    async (args) => {
-      if (args["scopes-list"]) {
-        listScopes();
-        return;
-      }
-      if (args.scopes) {
-        if (args.scopes.length === 0) {
-          // don't allow no scopes to be passed, that would be weird
-          listScopes();
-          return;
-        }
-        if (!validateScopeKeys(args.scopes)) {
-          throw new CommandLineArgsError(
-            `One of ${args.scopes} is not a valid authentication scope. Run "wrangler login --list-scopes" to see the valid scopes.`
-          );
-        }
-        await login({ scopes: args.scopes });
-        return;
-      }
-      await login();
-
-      // TODO: would be nice if it optionally saved login
-      // credentials inside node_modules/.cache or something
-      // this way you could have multiple users on a single machine
-    }
-  );
-
-  // logout
-  wrangler.command(
-    // this needs scopes as an option?
-    "logout",
-    false, // we don't need to show this in the menu
-    // "🚪 Logout from Cloudflare",
-    () => {},
-    async () => {
-      await logout();
-    }
-  );
-
-  // whoami
-  wrangler.command(
-    "whoami",
-    "🕵️  Retrieve your user info and test your auth config",
-    () => {},
-    async () => {
-      await whoami();
-    }
-  );
-
-  // config
-  wrangler.command(
-    "config",
-    false,
-    () => {},
-    () => {
-      // "🕵️  Authenticate Wrangler with a Cloudflare API Token",
-      throw new DeprecationError(
-        "`wrangler config` has been deprecated, please refer to TODO://some/path for alternatives"
-      );
-    }
-  );
-
-  // dev
-  wrangler.command(
-    "dev [script]",
-    "👂 Start a local server for developing your worker",
-    (yargs) => {
-      return yargs
-        .positional("script", {
-          describe: "The path to an entry point for your worker",
-          type: "string",
-        })
-        .option("name", {
-          describe: "Name of the worker",
-          type: "string",
-        })
-        .option("format", {
-          choices: ["modules", "service-worker"] as const,
-          describe: "Choose an entry type",
-        })
-        .option("env", {
-          describe: "Perform on a specific environment",
-          type: "string",
-        })
-        .option("compatibility-date", {
-          describe: "Date to use for compatibility checks",
-          type: "string",
-        })
-        .option("compatibility-flags", {
-          describe: "Flags to use for compatibility checks",
-          type: "array",
-          alias: "compatibility-flag",
-        })
-        .option("latest", {
-          describe: "Use the latest version of the worker runtime",
-          type: "boolean",
-          default: true,
-        })
-        .option("ip", {
-          describe: "IP address to listen on",
-          type: "string",
-          default: "127.0.0.1",
-        })
-        .option("port", {
-          describe: "Port to listen on",
-          type: "number",
-        })
-        .option("inspector-port", {
-          describe: "Port for devtools to connect to",
-          type: "number",
-        })
-        .option("host", {
-          type: "string",
-          describe:
-            "Host to forward requests to, defaults to the zone of project",
-        })
-        .option("local-protocol", {
-          default: "http",
-          describe: "Protocol to listen to requests on, defaults to http.",
-          choices: ["http", "https"],
-        })
-        .option("experimental-public", {
-          describe: "Static assets to be served",
-          type: "string",
-        })
-        .option("site", {
-          describe: "Root folder of static assets for Workers Sites",
-          type: "string",
-        })
-        .option("site-include", {
-          describe:
-            "Array of .gitignore-style patterns that match file or directory names from the sites directory. Only matched items will be uploaded.",
-          type: "string",
-          array: true,
-        })
-        .option("site-exclude", {
-          describe:
-            "Array of .gitignore-style patterns that match file or directory names from the sites directory. Matched items will not be uploaded.",
-          type: "string",
-          array: true,
-        })
-        .option("upstream-protocol", {
-          default: "https",
-          describe:
-            "Protocol to forward requests to host on, defaults to https.",
-          choices: ["http", "https"],
-        })
-        .option("jsx-factory", {
-          describe: "The function that is called for each JSX element",
-          type: "string",
-        })
-        .option("jsx-fragment", {
-          describe: "The function that is called for each JSX fragment",
-          type: "string",
-        })
-        .option("local", {
-          alias: "l",
-          describe: "Run on my machine",
-          type: "boolean",
-          default: false, // I bet this will a point of contention. We'll revisit it.
-        })
-        .option("experimental-enable-local-persistence", {
-          describe: "Enable persistence for this session (only for local mode)",
-          type: "boolean",
-        });
-    },
-    async (args) => {
-      const config = readConfig(
-        (args.config as ConfigPath) ||
-          (args.script && findWranglerToml(path.dirname(args.script)))
-      );
-      const entry = getEntry(config, "dev", args.script);
-
-      if (args["experimental-public"]) {
-        console.warn(
-          "🚨  The --experimental-public field is experimental and will change in the future."
-        );
-      }
-
-      if (args.public) {
-        throw new Error(
-          "🚨  The --public field has been renamed to --experimental-public, and will change behaviour in the future."
-        );
-      }
-
-      if (config.site?.["entry-point"]) {
-        console.warn(
-          "Deprecation notice: The `site.entry-point` config field is no longer used.\n" +
-            "The entry-point is specified via the command line (e.g. `wrangler dev path/to/script`).\n" +
-            "Please remove the `site.entry-point` field from the `wrangler.toml` file."
-        );
-      }
-
-      if (!args.local) {
-        // -- snip, extract --
-        const loggedIn = await loginOrRefreshIfRequired();
-        if (!loggedIn) {
-          // didn't login, let's just quit
-          console.log("Did not login, quitting...");
-          return;
-        }
-
-        if (!config.account_id) {
-          config.account_id = await getAccountId();
-          if (!config.account_id) {
-            throw new Error("No account id found, quitting...");
-          }
-        }
-        // -- snip, end --
-      }
-
-      const environments = config.env ?? {};
-      const envRootObj = args.env ? environments[args.env] || {} : config;
-
-      const { waitUntilExit } = render(
-        <Dev
-          name={getScriptName(args, config)}
-          entry={entry}
-          env={args.env}
-          zone={undefined}
-          rules={getRules(config)}
-          legacyEnv={isLegacyEnv(args, config)}
-          buildCommand={config.build || {}}
-          format={args.format || config.build?.upload?.format}
-          initialMode={args.local ? "local" : "remote"}
-          jsxFactory={args["jsx-factory"] || envRootObj?.jsx_factory}
-          jsxFragment={args["jsx-fragment"] || envRootObj?.jsx_fragment}
-          enableLocalPersistence={
-            args["experimental-enable-local-persistence"] || false
-          }
-          accountId={config.account_id}
-          assetPaths={getAssetPaths(
-            config,
-            args.site,
-            args.siteInclude,
-            args.siteExclude
-          )}
-          port={
-            args.port || config.dev?.port || (await getPort({ port: 8787 }))
-          }
-          inspectorPort={
-            args["inspector-port"] ?? (await getPort({ port: 9229 }))
-          }
-          public={args["experimental-public"]}
-          compatibilityDate={
-            args["compatibility-date"] ||
-            config.compatibility_date ||
-            new Date().toISOString().substring(0, 10)
-          }
-          compatibilityFlags={
-            (args["compatibility-flags"] as string[]) ||
-            config.compatibility_flags
-          }
-          usageModel={envRootObj.usage_model}
-          bindings={{
-            kv_namespaces: envRootObj.kv_namespaces?.map(
-              ({ binding, preview_id, id: _id }) => {
-                // In `dev`, we make folks use a separate kv namespace called
-                // `preview_id` instead of `id` so that they don't
-                // break production data. So here we check that a `preview_id`
-                // has actually been configured.
-                // This whole block of code will be obsoleted in the future
-                // when we have copy-on-write for previews on edge workers.
-                if (!preview_id) {
-                  // TODO: This error has to be a _lot_ better, ideally just asking
-                  // to create a preview namespace for the user automatically
-                  throw new Error(
-                    `In development, you should use a separate kv namespace than the one you'd use in production. Please create a new kv namespace with "wrangler kv:namespace create <name> --preview" and add its id as preview_id to the kv_namespace "${binding}" in your wrangler.toml`
-                  ); // Ugh, I really don't like this message very much
-                }
-                return {
-                  binding,
-                  id: preview_id,
-                };
-              }
-            ),
-            vars: envRootObj.vars,
-            wasm_modules: config.wasm_modules,
-            text_blobs: config.text_blobs,
-            durable_objects: envRootObj.durable_objects,
-            r2_buckets: envRootObj.r2_buckets,
-            unsafe: envRootObj.unsafe?.bindings,
-          }}
-        />
-      );
-      await waitUntilExit();
-    }
-  );
-
-  // publish
-  wrangler.command(
-    "publish [script]",
-    "🆙 Publish your Worker to Cloudflare.",
-    (yargs) => {
-      return yargs
-        .option("env", {
-          type: "string",
-          describe: "Perform on a specific environment",
-        })
-        .positional("script", {
-          describe: "The path to an entry point for your worker",
-          type: "string",
-        })
-        .option("name", {
-          describe: "Name of the worker",
-          type: "string",
-        })
-        .option("format", {
-          choices: ["modules", "service-worker"] as const,
-          describe: "Choose an entry type",
-        })
-        .option("compatibility-date", {
-          describe: "Date to use for compatibility checks",
-          type: "string",
-        })
-        .option("compatibility-flags", {
-          describe: "Flags to use for compatibility checks",
-          type: "array",
-          alias: "compatibility-flag",
-        })
-        .option("latest", {
-          describe: "Use the latest version of the worker runtime",
-          type: "boolean",
-          default: false,
-        })
-        .option("experimental-public", {
-          describe: "Static assets to be served",
-          type: "string",
-        })
-        .option("site", {
-          describe: "Root folder of static assets for Workers Sites",
-          type: "string",
-        })
-        .option("site-include", {
-          describe:
-            "Array of .gitignore-style patterns that match file or directory names from the sites directory. Only matched items will be uploaded.",
-          type: "string",
-          array: true,
-        })
-        .option("site-exclude", {
-          describe:
-            "Array of .gitignore-style patterns that match file or directory names from the sites directory. Matched items will not be uploaded.",
-          type: "string",
-          array: true,
-        })
-        .option("triggers", {
-          describe: "cron schedules to attach",
-          alias: ["schedule", "schedules"],
-          type: "array",
-        })
-        .option("routes", {
-          describe: "Routes to upload",
-          alias: "route",
-          type: "array",
-        })
-        .option("jsx-factory", {
-          describe: "The function that is called for each JSX element",
-          type: "string",
-        })
-        .option("jsx-fragment", {
-          describe: "The function that is called for each JSX fragment",
-          type: "string",
-        });
-    },
-    async (args) => {
-      if (args["experimental-public"]) {
-        console.warn(
-          "🚨  The --experimental-public field is experimental and will change in the future."
-        );
-      }
-      if (args.public) {
-        throw new Error(
-          "🚨  The --public field has been renamed to --experimental-public, and will change behaviour in the future."
-        );
-      }
-
-      const config = readConfig(
-        (args.config as ConfigPath) ||
-          (args.script && findWranglerToml(path.dirname(args.script)))
-      );
-      const entry = getEntry(config, "publish", args.script);
-
-      if (args.latest) {
-        console.warn(
-          "⚠️  Using the latest version of the Workers runtime. To silence this warning, please choose a specific version of the runtime with --compatibility-date, or add a compatibility_date to your wrangler.toml.\n"
-        );
-      }
-
-      // -- snip, extract --
-      const loggedIn = await loginOrRefreshIfRequired();
-      if (!loggedIn) {
-        // didn't login, let's just quit
-        console.log("Did not login, quitting...");
-        return;
-      }
-
-      if (!config.account_id) {
-        config.account_id = await getAccountId();
-        if (!config.account_id) {
-          throw new Error("No account id found, quitting...");
-        }
-      }
-      // -- snip, end --
-
-      const assetPaths = getAssetPaths(
-        config,
-        args["experimental-public"] || args.site,
-        args.siteInclude,
-        args.siteExclude
-      );
-      await publish({
-        config,
-        name: getScriptName(args, config),
-        rules: getRules(config),
-        format: args.format || config.build?.upload?.format,
-        entry,
-        env: args.env,
-        compatibilityDate: args.latest
-          ? new Date().toISOString().substring(0, 10)
-          : args["compatibility-date"],
-        compatibilityFlags: args["compatibility-flags"] as string[],
-        triggers: args.triggers,
-        jsxFactory: args["jsx-factory"],
-        jsxFragment: args["jsx-fragment"],
-        routes: args.routes,
-        assetPaths,
-        legacyEnv: isLegacyEnv(args, config),
-        experimentalPublic: args["experimental-public"] !== undefined,
-      });
-    }
-  );
-
-  // tail
-  wrangler.command(
-    "tail [name]",
-    "🦚 Starts a log tailing session for a published Worker.",
-    (yargs) => {
-      return (
-        yargs
-          .positional("name", {
-            describe: "Name of the worker",
-            type: "string",
-          })
-          // TODO: auto-detect if this should be json or pretty based on atty
-          .option("format", {
-            default: "json",
-            choices: ["json", "pretty"],
-            describe: "The format of log entries",
-          })
-          .option("status", {
-            choices: ["ok", "error", "canceled"],
-            describe: "Filter by invocation status",
-            array: true,
-          })
-          .option("header", {
-            type: "string",
-            describe: "Filter by HTTP header",
-          })
-          .option("method", {
-            type: "string",
-            describe: "Filter by HTTP method",
-            array: true,
-          })
-          .option("sampling-rate", {
-            type: "number",
-            describe: "Adds a percentage of requests to log sampling rate",
-          })
-          .option("search", {
-            type: "string",
-            describe: "Filter by a text match in console.log messages",
-          })
-          .option("ip", {
-            type: "string",
-            describe:
-              'Filter by the IP address the request originates from. Use "self" to filter for your own IP',
-            array: true,
-          })
-          .option("env", {
-            type: "string",
-            describe: "Perform on a specific environment",
-          })
-          .option("debug", {
-            type: "boolean",
-            hidden: true,
-            default: false,
-            describe:
-              "If a log would have been filtered out, send it through anyway alongside the filter which would have blocked it.",
-          })
-      );
-    },
-    async (args) => {
-      const config = readConfig(args.config as ConfigPath);
-
-      const scriptName = getScriptName(args, config);
-
-      if (!scriptName) {
-        throw new Error("Missing script name");
-      }
-
-      // -- snip, extract --
-      const loggedIn = await loginOrRefreshIfRequired();
-      if (!loggedIn) {
-        // didn't login, let's just quit
-        console.log("Did not login, quitting...");
-        return;
-      }
-
-      if (!config.account_id) {
-        config.account_id = await getAccountId();
-        if (!config.account_id) {
-          throw new Error("No account id found, quitting...");
-        }
-      }
-      // -- snip, end --
-
-      const accountId = config.account_id;
-
-      const cliFilters: TailCLIFilters = {
-        status: args.status as ("ok" | "error" | "canceled")[],
-        header: args.header,
-        method: args.method,
-        samplingRate: args["sampling-rate"],
-        search: args.search,
-        clientIp: args.ip,
-      };
-
-      const filters = translateCLICommandToFilterMessage(
-        cliFilters,
-        args.debug
-      );
-
-      const { tail, expiration, deleteTail } = await createTail(
-        accountId,
-        scriptName,
-        filters,
-        !isLegacyEnv(args, config) ? args.env : undefined
-      );
-
-      const scriptDisplayName = `${scriptName}${
-        args.env && !isLegacyEnv(args, config) ? ` (${args.env})` : ""
-      }`;
-
-      console.log(
-        `successfully created tail, expires at ${expiration.toLocaleString()}`
-      );
-
-      onExit(async () => {
-        tail.terminate();
-        await deleteTail();
-      });
-
-      const printLog: (data: RawData) => void =
-        args.format === "pretty" ? prettyPrintLogs : jsonPrintLogs;
-
-      tail.on("message", printLog);
-
-      while (tail.readyState !== tail.OPEN) {
-        switch (tail.readyState) {
-          case tail.CONNECTING:
-            await setTimeout(100);
-            break;
-          case tail.CLOSING:
-            await setTimeout(100);
-            break;
-          case tail.CLOSED:
-            throw new Error(
-              `Connection to ${scriptDisplayName} closed unexpectedly.`
-            );
-        }
-      }
-
-      console.log(`Connected to ${scriptDisplayName}, waiting for logs...`);
-
-      tail.on("close", async () => {
-        tail.terminate();
-        await deleteTail();
-      });
-    }
-  );
-
-  // preview
-  wrangler.command(
-    "preview [method] [body]",
-    false,
-    (yargs) => {
-      return yargs
-        .positional("method", {
-          type: "string",
-          describe: "Type of request to preview your worker",
-        })
-        .positional("body", {
-          type: "string",
-          describe: "Body string to post to your preview worker request.",
-        })
-        .option("env", {
-          type: "string",
-          describe: "Perform on a specific environment",
-        })
-        .option("watch", {
-          default: true,
-          describe: "Enable live preview",
-          type: "boolean",
-        });
-    },
-    async (args) => {
-      if (args.method || args.body) {
-        throw new DeprecationError(
-          "The `wrangler preview` command has been deprecated.\n" +
-            "Try using `wrangler dev` to to try out a worker during development.\n"
-        );
-      }
-
-      // Delegate to `wrangler dev`
-      console.warn(
-        "***************************************************\n" +
-          "The `wrangler preview` command has been deprecated.\n" +
-          "Attempting to run `wrangler dev` instead.\n" +
-          "***************************************************\n"
-      );
-
-      const config = readConfig(args.config as ConfigPath);
-      const entry = getEntry(config, "dev");
-
-      // -- snip, extract --
-      const loggedIn = await loginOrRefreshIfRequired();
-      if (!loggedIn) {
-        // didn't login, let's just quit
-        console.log("Did not login, quitting...");
-        return;
-      }
-
-      if (!config.account_id) {
-        config.account_id = await getAccountId();
-        if (!config.account_id) {
-          throw new Error("No account id found, quitting...");
-        }
-      }
-      // -- snip, end --
-
-      const environments = config.env ?? {};
-      const envRootObj = args.env ? environments[args.env] || {} : config;
-
-      const { waitUntilExit } = render(
-        <Dev
-          name={config.name}
-          entry={entry}
-          rules={getRules(config)}
-          env={args.env}
-          zone={undefined}
-          legacyEnv={isLegacyEnv(args, config)}
-          buildCommand={config.build || {}}
-          format={config.build?.upload?.format}
-          initialMode={args.local ? "local" : "remote"}
-          jsxFactory={envRootObj?.jsx_factory}
-          jsxFragment={envRootObj?.jsx_fragment}
-          enableLocalPersistence={false}
-          accountId={config.account_id}
-          assetPaths={undefined}
-          port={config.dev?.port}
-          public={undefined}
-          compatibilityDate={
-            config.compatibility_date ||
-            new Date().toISOString().substring(0, 10)
-          }
-          compatibilityFlags={
-            (args["compatibility-flags"] as string[]) ||
-            config.compatibility_flags
-          }
-          usageModel={config.usage_model}
-          bindings={{
-            kv_namespaces: envRootObj.kv_namespaces?.map(
-              ({ binding, preview_id, id: _id }) => {
-                // In `dev`, we make folks use a separate kv namespace called
-                // `preview_id` instead of `id` so that they don't
-                // break production data. So here we check that a `preview_id`
-                // has actually been configured.
-                // This whole block of code will be obsoleted in the future
-                // when we have copy-on-write for previews on edge workers.
-                if (!preview_id) {
-                  // TODO: This error has to be a _lot_ better, ideally just asking
-                  // to create a preview namespace for the user automatically
-                  throw new Error(
-                    `In development, you should use a separate kv namespace than the one you'd use in production. Please create a new kv namespace with "wrangler kv:namespace create <name> --preview" and add its id as preview_id to the kv_namespace "${binding}" in your wrangler.toml`
-                  ); // Ugh, I really don't like this message very much
-                }
-                return {
-                  binding,
-                  id: preview_id,
-                };
-              }
-            ),
-            vars: envRootObj.vars,
-            wasm_modules: config.wasm_modules,
-            text_blobs: config.text_blobs,
-            durable_objects: envRootObj.durable_objects,
-            r2_buckets: envRootObj.r2_buckets,
-            unsafe: envRootObj.unsafe?.bindings,
-          }}
-          inspectorPort={await getPort({ port: 9229 })}
-        />
-      );
-      await waitUntilExit();
-    }
-  );
-
-  // route
-  wrangler.command(
-    "route",
-    false, // I think we want to hide this command
-    // "➡️  List or delete worker routes",
-    (routeYargs) => {
-      return routeYargs
-        .command(
-          "list",
-          "List the routes associated with a zone",
-          (yargs) => {
-            return yargs
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("zone", {
-                type: "string",
-                describe: "Zone id",
-              })
-              .positional("zone", {
-                describe: "Zone id",
-                type: "string",
-              });
-          },
-          async (args) => {
-            console.log(":route list", args);
-            // TODO: use environment (current wrangler doesn't do so?)
-            // TODO: don't get `zone_id` from config at all and require the command line arg `--zone`.
-            const config = readConfig(args.config as ConfigPath);
-            const zone = args.zone || config.zone_id;
-            if (!zone) {
-              throw new Error("missing zone id");
-            }
-
-            console.log(await fetchResult(`/zones/${zone}/workers/routes`));
-          }
-        )
-        .command(
-          "delete <id>",
-          "Delete a route associated with a zone",
-          (yargs) => {
-            return yargs
-              .positional("id", {
-                describe: "The hash of the route ID to delete.",
-                type: "string",
-              })
-              .option("zone", {
-                type: "string",
-                describe: "zone id",
-              })
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              });
-          },
-          async (args) => {
-            console.log(":route delete", args);
-            // TODO: use environment (current wrangler doesn't do so?)
-            const config = readConfig(args.config as ConfigPath);
-            const zone = args.zone || config.zone_id;
-            if (!zone) {
-              throw new Error("missing zone id");
-            }
-
-            console.log(
-              await fetchResult(`/zones/${zone}/workers/routes/${args.id}`, {
-                method: "DELETE",
-              })
-            );
-          }
-        );
-    }
-  );
-
-  // subdomain
-  wrangler.command(
-    "subdomain [name]",
-    false,
-    // "👷 Create or change your workers.dev subdomain.",
-    (yargs) => {
-      return yargs.positional("name", { type: "string" });
-    },
-    () => {
-      throw new DeprecationError(
-        "`wrangler subdomain` has been deprecated, please refer to TODO://some/path for alternatives"
-      );
-    }
-  );
-
-  // secret
-  wrangler.command(
-    "secret",
-    "🤫 Generate a secret that can be referenced in the worker script",
-    (secretYargs) => {
-      return secretYargs
-        .command(
-          "put <key>",
-          "Create or update a secret variable for a script",
-          (yargs) => {
-            return yargs
-              .positional("key", {
-                describe: "The variable name to be accessible in the script",
-                type: "string",
-              })
-              .option("name", {
-                describe: "Name of the worker",
-                type: "string",
-              })
-              .option("env", {
-                type: "string",
-                describe:
-                  "Binds the secret to the Worker of the specific environment",
-              });
-          },
-          async (args) => {
-            const config = readConfig(args.config as ConfigPath);
-
-            const scriptName = getScriptName(args, config);
-            if (!scriptName) {
-              throw new Error("Missing script name");
-            }
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            const secretValue = await prompt(
-              "Enter a secret value:",
-              "password"
-            );
-
-            console.log(
-              `🌀 Creating the secret for script ${scriptName} ${
-                args.env && !isLegacyEnv(args, config) ? `(${args.env})` : ""
-              }`
-            );
-
-            async function submitSecret() {
-              const url =
-                !args.env || isLegacyEnv(args, config)
-                  ? `/accounts/${config.account_id}/workers/scripts/${scriptName}/secrets`
-                  : `/accounts/${config.account_id}/workers/services/${scriptName}/environments/${args.env}/secrets`;
-
-              return await fetchResult(url, {
-                method: "PUT",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({
-                  name: args.key,
-                  text: secretValue,
-                  type: "secret_text",
-                }),
-              });
-            }
-
-            try {
-              await submitSecret();
-            } catch (e) {
-              // @ts-expect-error non-standard property on Error
-              if (e.code === 10007) {
-                // upload a draft worker
-                // TODO: log a warning
-                await fetchResult(
-                  !args["legacy-env"] && args.env
-                    ? `/accounts/${config.account_id}/workers/services/${scriptName}/environments/${args.env}`
-                    : `/accounts/${config.account_id}/workers/scripts/${scriptName}`,
-                  {
-                    method: "PUT",
-                    body: toFormData({
-                      name: scriptName,
-                      main: {
-                        name: scriptName,
-                        content: `export default { fetch() {} }`,
-                        type: "esm",
-                      },
-                      bindings: {
-                        kv_namespaces: [],
-                        vars: {},
-                        durable_objects: { bindings: [] },
-                        r2_buckets: [],
-                        wasm_modules: {},
-                        text_blobs: {},
-                        unsafe: [],
-                      },
-                      modules: [],
-                      migrations: undefined,
-                      compatibility_date: undefined,
-                      compatibility_flags: undefined,
-                      usage_model: undefined,
-                    }),
-                  }
-                );
-
-                // and then try again
-                await submitSecret();
-                // TODO: delete the draft worker if this failed too?
-              }
-            }
-            console.log(`✨ Success! Uploaded secret ${args.key}`);
-          }
-        )
-        .command(
-          "delete <key>",
-          "Delete a secret variable from a script",
-          (yargs) => {
-            return yargs
-              .positional("key", {
-                describe: "The variable name to be accessible in the script",
-                type: "string",
-              })
-              .option("name", {
-                describe: "Name of the worker",
-                type: "string",
-              })
-              .option("env", {
-                type: "string",
-                describe:
-                  "Binds the secret to the Worker of the specific environment",
-              });
-          },
-          async (args) => {
-            const config = readConfig(args.config as ConfigPath);
-
-            const scriptName = getScriptName(args, config);
-            if (!scriptName) {
-              throw new Error("Missing script name");
-            }
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            if (
-              await confirm(
-                `Are you sure you want to permanently delete the variable ${
-                  args.key
-                } on the script ${scriptName}${
-                  args.env && !isLegacyEnv(args, config) ? ` (${args.env})` : ""
-                }?`
-              )
-            ) {
-              console.log(
-                `🌀 Deleting the secret ${args.key} on script ${scriptName}${
-                  args.env && !isLegacyEnv(args, config) ? ` (${args.env})` : ""
-                }`
-              );
-
-              const url =
-                !args.env || isLegacyEnv(args, config)
-                  ? `/accounts/${config.account_id}/workers/scripts/${scriptName}/secrets`
-                  : `/accounts/${config.account_id}/workers/services/${scriptName}/environments/${args.env}/secrets`;
-
-              await fetchResult(`${url}/${args.key}`, { method: "DELETE" });
-              console.log(`✨ Success! Deleted secret ${args.key}`);
-            }
-          }
-        )
-        .command(
-          "list",
-          "List all secrets for a script",
-          (yargs) => {
-            return yargs
-              .option("name", {
-                describe: "Name of the worker",
-                type: "string",
-              })
-              .option("env", {
-                type: "string",
-                describe:
-                  "Binds the secret to the Worker of the specific environment.",
-              });
-          },
-          async (args) => {
-            const config = readConfig(args.config as ConfigPath);
-
-            const scriptName = getScriptName(args, config);
-            if (!scriptName) {
-              throw new Error("Missing script name");
-            }
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            const url =
-              !args.env || isLegacyEnv(args, config)
-                ? `/accounts/${config.account_id}/workers/scripts/${scriptName}/secrets`
-                : `/accounts/${config.account_id}/workers/services/${scriptName}/environments/${args.env}/secrets`;
-
-            console.log(JSON.stringify(await fetchResult(url), null, "  "));
-          }
-        );
-    }
-  );
-
-  // kv
-  // :namespace
-  wrangler.command(
-    "kv:namespace",
-    "🗂️  Interact with your Workers KV Namespaces",
-    (namespaceYargs) => {
-      return namespaceYargs
-        .command(
-          "create <namespace>",
-          "Create a new namespace",
-          (yargs) => {
-            return yargs
-              .positional("namespace", {
-                describe: "The name of the new namespace",
-                type: "string",
-                demandOption: true,
-              })
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("preview", {
-                type: "boolean",
-                describe: "Interact with a preview namespace",
-              });
-          },
-          async (args) => {
-            if (args._.length > 2) {
-              const extraArgs = args._.slice(2).join(" ");
-              throw new CommandLineArgsError(
-                `Unexpected additional positional arguments "${extraArgs}".`
-              );
-            }
-
-            if (!isValidNamespaceBinding(args.namespace)) {
-              throw new CommandLineArgsError(
-                `The namespace binding name "${args.namespace}" is invalid. It can only have alphanumeric and _ characters, and cannot begin with a number.`
-              );
-            }
-
-            const config = readConfig(args.config as ConfigPath);
-            if (!config.name) {
-              console.warn(
-                "No configured name present, using `worker` as a prefix for the title"
-              );
-            }
-
-            const name = config.name || "worker";
-            const environment = args.env ? `-${args.env}` : "";
-            const preview = args.preview ? "_preview" : "";
-            const title = `${name}${environment}-${args.namespace}${preview}`;
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            // TODO: generate a binding name stripping non alphanumeric chars
-
-            console.log(`🌀 Creating namespace with title "${title}"`);
-            const namespaceId = await createNamespace(config.account_id, title);
-
-            console.log("✨ Success!");
-            const envString = args.env ? ` under [env.${args.env}]` : "";
-            const previewString = args.preview ? "preview_" : "";
-            console.log(
-              `Add the following to your configuration file in your kv_namespaces array${envString}:`
-            );
-            console.log(
-              `{ binding = "${args.namespace}", ${previewString}id = "${namespaceId}" }`
-            );
-
-            // TODO: automatically write this block to the wrangler.toml config file??
-          }
-        )
-        .command(
-          "list",
-          "Outputs a list of all KV namespaces associated with your account id.",
-          {},
-          async (args) => {
-            const config = readConfig(args.config as ConfigPath);
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            // TODO: we should show bindings if they exist for given ids
-
-            console.log(
-              JSON.stringify(
-                await listNamespaces(config.account_id),
-                null,
-                "  "
-              )
-            );
-          }
-        )
-        .command(
-          "delete",
-          "Deletes a given namespace.",
-          (yargs) => {
-            return yargs
-              .option("binding", {
-                type: "string",
-                describe: "The name of the namespace to delete",
-              })
-              .option("namespace-id", {
-                type: "string",
-                describe: "The id of the namespace to delete",
-              })
-              .check(demandOneOfOption("binding", "namespace-id"))
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("preview", {
-                type: "boolean",
-                describe: "Interact with a preview namespace",
-              });
-          },
-          async (args) => {
-            const config = readConfig(args.config as ConfigPath);
-
-            let id;
-            try {
-              id = getNamespaceId(args, config);
-            } catch (e) {
-              throw new CommandLineArgsError(
-                "Not able to delete namespace.\n" + ((e as Error).message ?? e)
-              );
-            }
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            await fetchResult<{ id: string }>(
-              `/accounts/${config.account_id}/storage/kv/namespaces/${id}`,
-              { method: "DELETE" }
-            );
-
-            // TODO: recommend they remove it from wrangler.toml
-
-            // test-mf wrangler kv:namespace delete --namespace-id 2a7d3d8b23fc4159b5afa489d6cfd388
-            // Are you sure you want to delete namespace 2a7d3d8b23fc4159b5afa489d6cfd388? [y/n]
-            // n
-            // 💁  Not deleting namespace 2a7d3d8b23fc4159b5afa489d6cfd388
-            // ➜  test-mf wrangler kv:namespace delete --namespace-id 2a7d3d8b23fc4159b5afa489d6cfd388
-            // Are you sure you want to delete namespace 2a7d3d8b23fc4159b5afa489d6cfd388? [y/n]
-            // y
-            // 🌀  Deleting namespace 2a7d3d8b23fc4159b5afa489d6cfd388
-            // ✨  Success
-            // ⚠️  Make sure to remove this "kv-namespace" entry from your configuration file!
-            // ➜  test-mf
-
-            // TODO: do it automatically
-
-            // TODO: delete the preview namespace as well?
-          }
-        );
-    }
-  );
-
-  // :key
-  wrangler.command(
-    "kv:key",
-    "🔑 Individually manage Workers KV key-value pairs",
-    (kvKeyYargs) => {
-      return kvKeyYargs
-        .command(
-          "put <key> [value]",
-          "Writes a single key/value pair to the given namespace.",
-          (yargs) => {
-            return yargs
-              .positional("key", {
-                type: "string",
-                describe: "The key to write to",
-                demandOption: true,
-              })
-              .positional("value", {
-                type: "string",
-                describe: "The value to write",
-              })
-              .option("binding", {
-                type: "string",
-                describe: "The binding of the namespace to write to",
-              })
-              .option("namespace-id", {
-                type: "string",
-                describe: "The id of the namespace to write to",
-              })
-              .check(demandOneOfOption("binding", "namespace-id"))
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("preview", {
-                type: "boolean",
-                describe: "Interact with a preview namespace",
-              })
-              .option("ttl", {
-                type: "number",
-                describe: "Time for which the entries should be visible",
-              })
-              .option("expiration", {
-                type: "number",
-                describe:
-                  "Time since the UNIX epoch after which the entry expires",
-              })
-              .option("path", {
-                type: "string",
-                describe: "Read value from the file at a given path",
-              })
-              .check(demandOneOfOption("value", "path"));
-          },
-          async ({ key, ttl, expiration, ...args }) => {
-            const config = readConfig(args.config as ConfigPath);
-            const namespaceId = getNamespaceId(args, config);
-            // One of `args.path` and `args.value` must be defined
-            const value = args.path
-              ? readFileSync(args.path)
-              : // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                args.value!;
-
-            if (args.path) {
-              console.log(
-                `writing the contents of ${args.path} to the key "${key}" on namespace ${namespaceId}`
-              );
-            } else {
-              console.log(
-                `writing the value "${value}" to key "${key}" on namespace ${namespaceId}`
-              );
-            }
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            await putKeyValue(config.account_id, namespaceId, key, value, {
-              expiration,
-              expiration_ttl: ttl,
-            });
-          }
-        )
-        .command(
-          "list",
-          "Outputs a list of all keys in a given namespace.",
-          (yargs) => {
-            return yargs
-              .option("binding", {
-                type: "string",
-                describe: "The name of the namespace to list",
-              })
-              .option("namespace-id", {
-                type: "string",
-                describe: "The id of the namespace to list",
-              })
-              .check(demandOneOfOption("binding", "namespace-id"))
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("preview", {
-                type: "boolean",
-                // In the case of listing keys we will default to non-preview mode
-                default: false,
-                describe: "Interact with a preview namespace",
-              })
-              .option("prefix", {
-                type: "string",
-                describe: "A prefix to filter listed keys",
-              });
-          },
-          async ({ prefix, ...args }) => {
-            // TODO: support for limit+cursor (pagination)
-            const config = readConfig(args.config as ConfigPath);
-            const namespaceId = getNamespaceId(args, config);
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            const results = await listNamespaceKeys(
-              config.account_id,
-              namespaceId,
-              prefix
-            );
-            console.log(JSON.stringify(results, undefined, 2));
-          }
-        )
-        .command(
-          "get <key>",
-          "Reads a single value by key from the given namespace.",
-          (yargs) => {
-            return yargs
-              .positional("key", {
-                describe: "The key value to get.",
-                type: "string",
-                demandOption: true,
-              })
-              .option("binding", {
-                type: "string",
-                describe: "The name of the namespace to get from",
-              })
-              .option("namespace-id", {
-                type: "string",
-                describe: "The id of the namespace to get from",
-              })
-              .check(demandOneOfOption("binding", "namespace-id"))
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("preview", {
-                type: "boolean",
-                describe: "Interact with a preview namespace",
-              })
-              .option("preview", {
-                type: "boolean",
-                // In the case of getting key values we will default to non-preview mode
-                default: false,
-                describe: "Interact with a preview namespace",
-              });
-          },
-          async ({ key, ...args }) => {
-            const config = readConfig(args.config as ConfigPath);
-            const namespaceId = getNamespaceId(args, config);
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            console.log(await getKeyValue(config.account_id, namespaceId, key));
-          }
-        )
-        .command(
-          "delete <key>",
-          "Removes a single key value pair from the given namespace.",
-          (yargs) => {
-            return yargs
-              .positional("key", {
-                describe: "The key value to delete",
-                type: "string",
-                demandOption: true,
-              })
-              .option("binding", {
-                type: "string",
-                describe: "The name of the namespace to delete from",
-              })
-              .option("namespace-id", {
-                type: "string",
-                describe: "The id of the namespace to delete from",
-              })
-              .check(demandOneOfOption("binding", "namespace-id"))
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("preview", {
-                type: "boolean",
-                describe: "Interact with a preview namespace",
-              });
-          },
-          async ({ key, ...args }) => {
-            const config = readConfig(args.config as ConfigPath);
-            const namespaceId = getNamespaceId(args, config);
-
-            console.log(
-              `deleting the key "${key}" on namespace ${namespaceId}`
-            );
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            await fetchResult(
-              `/accounts/${config.account_id}/storage/kv/namespaces/${namespaceId}/values/${key}`,
-              { method: "DELETE" }
-            );
-          }
-        );
-    }
-  );
-
-  // :bulk
-  wrangler.command(
-    "kv:bulk",
-    "💪 Interact with multiple Workers KV key-value pairs at once",
-    (kvBulkYargs) => {
-      return kvBulkYargs
-        .command(
-          "put <filename>",
-          "Upload multiple key-value pairs to a namespace",
-          (yargs) => {
-            return yargs
-              .positional("filename", {
-                describe: `The JSON file of key-value pairs to upload, in form [{"key":..., "value":...}"...]`,
-                type: "string",
-                demandOption: true,
-              })
-              .option("binding", {
-                type: "string",
-                describe: "The name of the namespace to insert values into",
-              })
-              .option("namespace-id", {
-                type: "string",
-                describe: "The id of the namespace to insert values into",
-              })
-              .check(demandOneOfOption("binding", "namespace-id"))
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("preview", {
-                type: "boolean",
-                describe: "Interact with a preview namespace",
-              });
-          },
-          async ({ filename, ...args }) => {
-            // The simplest implementation I could think of.
-            // This could be made more efficient with a streaming parser/uploader
-            // but we'll do that in the future if needed.
-
-            const config = readConfig(args.config as ConfigPath);
-            const namespaceId = getNamespaceId(args, config);
-            const content = parseJSON(readFileSync(filename), filename);
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            console.log(
-              await putBulkKeyValue(config.account_id, namespaceId, content)
-            );
-          }
-        )
-        .command(
-          "delete <filename>",
-          "Delete multiple key-value pairs from a namespace",
-          (yargs) => {
-            return yargs
-              .positional("filename", {
-                describe: `The JSON file of keys to delete, in the form ["key1", "key2", ...]`,
-                type: "string",
-                demandOption: true,
-              })
-              .option("binding", {
-                type: "string",
-                describe: "The name of the namespace to delete from",
-              })
-              .option("namespace-id", {
-                type: "string",
-                describe: "The id of the namespace to delete from",
-              })
-              .check(demandOneOfOption("binding", "namespace-id"))
-              .option("env", {
-                type: "string",
-                describe: "Perform on a specific environment",
-              })
-              .option("preview", {
-                type: "boolean",
-                describe: "Interact with a preview namespace",
-              });
-          },
-          async ({ filename, ...args }) => {
-            const config = readConfig(args.config as ConfigPath);
-            const namespaceId = getNamespaceId(args, config);
-            const content = parseJSON(readFileSync(filename), filename);
-
-            // -- snip, extract --
-            const loggedIn = await loginOrRefreshIfRequired();
-            if (!loggedIn) {
-              // didn't login, let's just quit
-              console.log("Did not login, quitting...");
-              return;
-            }
-
-            if (!config.account_id) {
-              config.account_id = await getAccountId();
-              if (!config.account_id) {
-                throw new Error("No account id found, quitting...");
-              }
-            }
-            // -- snip, end --
-
-            console.log(
-              await deleteBulkKeyValue(config.account_id, namespaceId, content)
-            );
-          }
-        );
-    }
-  );
-
-  wrangler.command("pages", "⚡️ Configure Cloudflare Pages", pages);
-
-  wrangler.command("r2", "📦 Interact with an R2 store", (r2Yargs) => {
-    return r2Yargs.command("bucket", "Manage R2 buckets", (r2BucketYargs) => {
-      r2BucketYargs.command(
-        "create <name>",
-        "Create a new R2 bucket",
-        (yargs) => {
-          return yargs.positional("name", {
-            describe: "The name of the new bucket",
-            type: "string",
-            demandOption: true,
-          });
-        },
-        async (args) => {
-          // We expect three values in `_`: `r2`, `bucket`, `create`.
-          if (args._.length > 3) {
-            const extraArgs = args._.slice(3).join(" ");
-            throw new CommandLineArgsError(
-              `Unexpected additional positional arguments "${extraArgs}".`
-            );
-          }
-
-          const config = readConfig(args.config as ConfigPath);
-
-          // -- snip, extract --
-          const loggedIn = await loginOrRefreshIfRequired();
-          if (!loggedIn) {
-            // didn't login, let's just quit
-            console.log("Did not login, quitting...");
-            return;
-          }
-
-          if (!config.account_id) {
-            config.account_id = await getAccountId();
-            if (!config.account_id) {
-              throw new Error("No account id found, quitting...");
-            }
-          }
-          // -- snip, end --
-
-          console.log(`Creating bucket ${args.name}.`);
-          await createR2Bucket(config.account_id, args.name);
-          console.log(`Created bucket ${args.name}.`);
-        }
-      );
-
-      r2BucketYargs.command("list", "List R2 buckets", {}, async (args) => {
-        const config = readConfig(args.config as ConfigPath);
-
-        // -- snip, extract --
-        const loggedIn = await loginOrRefreshIfRequired();
-        if (!loggedIn) {
-          // didn't login, let's just quit
-          console.log("Did not login, quitting...");
-          return;
-        }
-
-        if (!config.account_id) {
-          config.account_id = await getAccountId();
-          if (!config.account_id) {
-            throw new Error("No account id found, quitting...");
-          }
-        }
-        // -- snip, end --
-
-        console.log(
-          JSON.stringify(await listR2Buckets(config.account_id), null, 2)
-        );
-      });
-
-      r2BucketYargs.command(
-        "delete <name>",
-        "Delete an R2 bucket",
-        (yargs) => {
-          return yargs.positional("name", {
-            describe: "The name of the bucket to delete",
-            type: "string",
-            demandOption: true,
-          });
-        },
-        async (args) => {
-          // We expect three values in `_`: `r2`, `bucket`, `delete`.
-          if (args._.length > 3) {
-            const extraArgs = args._.slice(3).join(" ");
-            throw new CommandLineArgsError(
-              `Unexpected additional positional arguments "${extraArgs}".`
-            );
-          }
-
-          const config = readConfig(args.config as ConfigPath);
-
-          // -- snip, extract --
-          const loggedIn = await loginOrRefreshIfRequired();
-          if (!loggedIn) {
-            // didn't login, let's just quit
-            console.log("Did not login, quitting...");
-            return;
-          }
-
-          if (!config.account_id) {
-            config.account_id = await getAccountId();
-            if (!config.account_id) {
-              throw new Error("No account id found, quitting...");
-            }
-          }
-          // -- snip, end --
-
-          console.log(`Deleting bucket ${args.name}.`);
-          await deleteR2Bucket(config.account_id, args.name);
-          console.log(`Deleted bucket ${args.name}.`);
-        }
-      );
-      return r2BucketYargs;
-    });
-  });
-
-  wrangler
-    .option("legacy-env", {
-      type: "boolean",
-      describe: "Use legacy environments",
-    })
-    .option("config", {
-      alias: "c",
-      describe: "Path to .toml configuration file",
-      type: "string",
-    });
-
-  wrangler.group(["config", "help", "version", "legacy-env"], "Flags:");
-  wrangler.help().alias("h", "help");
-  wrangler.version(wranglerVersion).alias("v", "version");
-  wrangler.exitProcess(false);
-
-  try {
-    await initialiseUserConfig();
-    await wrangler.parse();
-  } catch (e) {
-    if (e instanceof CommandLineArgsError) {
-      wrangler.showHelp("error");
-      console.error(""); // Just adds a bit of space
-      console.error(e.message);
-    } else if (e instanceof ParseError) {
-      console.error("");
-      e.notes.push({
-        text: "\nIf you think this is a bug, please open an issue at: https://github.com/cloudflare/wrangler2/issues/new",
-      });
-      console.error(formatMessage(e));
-    } else {
-      console.error(e instanceof Error ? e.message : e);
-      console.error(""); // Just adds a bit of space
-      console.error(
-        `${fgGreenColor}%s${resetColor}`,
-        "If you think this is a bug then please create an issue at https://github.com/cloudflare/wrangler2/issues/new."
-      );
-    }
-    throw e;
-  }
-}