[wrangler] fix: check permissions on authentication error with API token set

[mrbbot]

Fixes #4078.

What this PR solves / how to test:

The API tokens set with the CLOUDFLARE_API_TOKEN environment variable may not include all required permissions for Wrangler. This change ensures the error message for authentication errors includes a suggestion to check token permissions. Ideally, authentication errors would inclusion the name of the required permission that was missing, but they don't. 🙁

Author has addressed the following:

• Tests
  • Included
  • Not necessary because:
• Changeset (Changeset guidelines)
  • Included
  • Not necessary because:
• Associated docs
  • Issue(s)/PR(s):
  • Not necessary because: this is an improvement to error messaging

Note for PR author:

We want to celebrate and highlight awesome PR review! If you think this PR received a particularly high-caliber review, please assign it the label highlight pr review so future reviewers can take inspiration and learn from it.

[changeset-bot]

🦋 Changeset detected

Latest commit: a8acdb0

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
wrangler	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

A wrangler prerelease is available for testing. You can install this latest build in your project with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/7387050874/npm-package-wrangler-4597

You can reference the automatically updated head of this PR with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/prs/7387050874/npm-package-wrangler-4597

Or you can use npx with this latest build directly:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/7387050874/npm-package-wrangler-4597 dev path/to/script.js

Additional artifacts:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/7387050874/npm-package-miniflare-4597

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/7387050874/npm-package-cloudflare-pages-shared-4597

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/7387050874/npm-package-create-cloudflare-4597 --no-auto-update

Note that these links will no longer work once the GitHub Actions artifact expires.

---

[email protected] includes the following runtime dependencies:

Package	Constraint	Resolved
miniflare	workspace:*	3.20231030.4
workerd	1.20231030.0	1.20231030.0
workerd --version	1.20231030.0	2023-10-30

|

Please ensure constraints are pinned, and miniflare/workerd minor versions match.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (850c4d6) 75.54% compared to head (a8acdb0) 75.22%.
Report is 33 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4597      +/-   ##
==========================================
- Coverage   75.54%   75.22%   -0.32%     
==========================================
  Files         242      242              
  Lines       12905    13027     +122     
  Branches     3318     3348      +30     
==========================================
+ Hits         9749     9800      +51     
- Misses       3156     3227      +71     

Files	Coverage Δ
packages/wrangler/src/index.ts	89.23% <100.00%> (+0.15%)	⬆️

... and 18 files with indirect coverage changes

[petebacondarwin]

Minor textual change suggestion. Otherwise LGTM.