[wrangler] Improve D1 database limit error message

[petebacondarwin]

Fixes #2913.

Improves the error message shown when users try to create a D1 database but have reached their account's database limit. The new message matches the user-friendly format used in the Cloudflare Dashboard and provides actionable guidance.

Before (raw API error):

✘ [ERROR] A request to the Cloudflare API (/accounts/.../d1/database) failed.

  System limit reached: databases per account (10) [code: 7406]

After (user-friendly message):

You have reached the maximum number of D1 databases for your account.
Please consider deleting unused databases, or visit the D1 documentation to learn more: https://developers.cloudflare.com/d1/

To list your existing databases, run: wrangler d1 list
To delete a database, run: wrangler d1 delete <database-name>

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: This is a CLI UX improvement - the error message itself provides all necessary guidance

---

[changeset-bot]

🦋 Changeset detected

Latest commit: 23a6de1

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

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

[claude]

Claude finished @petebacondarwin's task —— View job

---

Changeset Review

✅ All changesets look good

The changeset .changeset/friendly-d1-limit-error.md passes all validation criteria:

1. ✅ Version Type: patch is correct for a UX improvement to an error message
2. ✅ Changelog Quality: Clear, meaningful description with good context about what changed and why
3. ✅ Markdown Headers: No h1/h2/h3 headers used
4. ✅ Analytics: Not applicable (no analytics changes)
5. ✅ Dependabot: Not applicable (not a dependency update)
6. ✅ Experimental features: Not applicable (stable feature)

The changeset follows the recommended format with a clear title and helpful body that explains both the change and its benefit to users.

---

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@12472

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@12472

miniflare

npm i https://pkg.pr.new/miniflare@12472

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@12472

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@12472

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@12472

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@12472

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@12472

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@12472

wrangler

npm i https://pkg.pr.new/wrangler@12472

commit: 23a6de1

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 2 additional findings.