[wrangler] Guide Preview configuration onboarding

[podonnell-dev]

Fixes WC-5927 and WC-5834.

First two commit are same as #15478 (already reviewed)

Last commit 58656af is handling previews onboarding. When a user runs npx wrangler preview and has no local previews block, we recommend a code snippet for the user to paste into wrangler config.

There are generally two paths:

• user configured preview settings in dashboard (base configuration)
• user has some production settings and is trying previews for the first time

We expect that regardless of where the user is coming from, they receive a configuration with REPLACE_ME placeholders. We also handle a few specific cases for user guidance

---

• 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): Worker Previews docs: restructure resources, update cross-references cloudflare-docs#31775
  • Documentation not necessary because: private beta

A picture of a cute animal (not mandatory, but encouraged)

[changeset-bot]

🦋 Changeset detected

Latest commit: 4d9e0fc

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

This PR includes changesets to release 3 packages

Name	Type
wrangler	Minor
@cloudflare/vite-plugin	Patch
@cloudflare/vitest-plugin	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

[pkg-pr-new]

@cloudflare/autoconfig

npm i https://pkg.pr.new/@cloudflare/autoconfig@15600

@cloudflare/build-output-utils

npm i https://pkg.pr.new/@cloudflare/build-output-utils@15600

@cloudflare/codemods

npm i https://pkg.pr.new/@cloudflare/codemods@15600

@cloudflare/config

npm i https://pkg.pr.new/@cloudflare/config@15600

@cloudflare/containers-shared

npm i https://pkg.pr.new/@cloudflare/containers-shared@15600

create-cloudflare

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

@cloudflare/deploy-helpers

npm i https://pkg.pr.new/@cloudflare/deploy-helpers@15600

@cloudflare/kv-asset-handler

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

miniflare

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

@cloudflare/pages-functions

npm i https://pkg.pr.new/@cloudflare/pages-functions@15600

@cloudflare/pages-shared

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

@cloudflare/unenv-preset

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

@cloudflare/vite-plugin

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

@cloudflare/vitest-plugin

npm i https://pkg.pr.new/@cloudflare/vitest-plugin@15600

@cloudflare/workers-auth

npm i https://pkg.pr.new/@cloudflare/workers-auth@15600

@cloudflare/workers-editor-shared

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

@cloudflare/workers-utils

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

wrangler

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

commit: 4d9e0fc

[workers-devprod]

Codeowners approval required for this PR:

• ✅ @cloudflare/wrangler

Show detailed file reviewers

[anowardear062-svg]

This is the most important part

[dario-piotrowicz]

Generally looks good to me, I just left some small comments here and there 🙂

Please let's fix all the typescript/eslint issues and address devin's comments too (in particular this one: #15600 (comment))

Besides that this for me is good to go 😄

[podonnell-dev]

aligning supported bindings here while fixing ai.staging validation. my general rule is: if we supported this in previews during this private beta, then it should be present (ie. no API layer changes) 2b80826

[podonnell-dev]

last bug 🤞 459e8c2

ignoring local config warnings if base config (settings in dashboard) are present. this was your previous point, i'm making this more explicit now

[podonnell-dev]

lint fix eca9254

[podonnell-dev]

fixing tests: f40d193

[dario-piotrowicz]

LGTM 😄

(Besides all the broken docs links, which seems to be expected since wrangler preview is private beta 🙂)

[workers-devprod]

Codeowners reviews satisfied