V3 Backport [#8889]: Add warning to Wrangler if using the Bun runtime and an error is encountered (#8955)

* fast fail wrangler when Bun detected

* add test for bun error

* Create cold-donuts-fetch.md

* improve changeset

* improve changeset

* fix rebase

* soft fail

* fix snapshot

* fix v3 backport

* clarify messaging

---------

Co-authored-by: Samuel Macleod <[email protected]>

Author: workers-devprod

.changeset/cold-donuts-fetch.md

@@ -0,0 +1,5 @@
+---
+"wrangler": patch
+---
+
+When Wrangler encounters an error, if the Bun runtime is detected it will now warn users that Wrangler does not officially support Bun.

packages/wrangler/src/__tests__/index.test.ts

@@ -334,5 +334,17 @@ describe("wrangler", () => {
 			Note that there is a newer version of Wrangler available (123.123.123). Consider checking whether upgrading resolves this error."
 		`);
 		});
+
+		it("should display a warning if Bun is in use", async () => {
+			const original = process.versions.bun;
+			process.versions.bun = "v1";
+			await logPossibleBugMessage();
+			expect(std.warn).toMatchInlineSnapshot(`
+				"▲ [WARNING] Wrangler does not support the Bun runtime. Please try this command again using Node.js via \`npm\` or \`pnpm\`. Alternatively, make sure you're not passing the \`--bun\` flag when running \`bun run wrangler ...\`
+
+				"
+			`);
+			process.versions.bun = original;
+		});
 	});
 });

packages/wrangler/src/utils/logPossibleBugMessage.ts

@@ -6,6 +6,12 @@ import { fgGreenColor, resetColor } from "./constants";
  * Write a message to the log that tells the user what they might do after we have reported an unexpected error.
  */
 export async function logPossibleBugMessage() {
+	if (process.versions.bun) {
+		logger.warn(
+			`Wrangler does not support the Bun runtime. Please try this command again using Node.js via \`npm\` or \`pnpm\`. Alternatively, make sure you're not passing the \`--bun\` flag when running \`bun run wrangler ...\``
+		);
+		return;
+	}
 	logger.log(
 		`${fgGreenColor}%s${resetColor}`,
 		"If you think this is a bug then please create an issue at https://github.com/cloudflare/workers-sdk/issues/new/choose"