Fix cron trigger documentation links and inline testing instructions (#11139)

* fix: update cron trigger docs links and inline testing instructions

- Updated documentation links to point to the correct cron triggers page
- Inlined instructions for testing cron triggers locally in the error message
- Users now see the curl command directly in the warning instead of having to click through to docs

Co-Authored-By: Steve Faulkner <southpolesteve@gmail.com>

* Address PR feedback: remove Miniflare reference from warning message

Changed 'Miniflare does not currently trigger scheduled Workers automatically' to 'Scheduled Workers are not automatically triggered during local development' to make the message more user-friendly and avoid referencing internal implementation details.

Co-Authored-By: Steve Faulkner <southpolesteve@gmail.com>

* Address PR feedback: update endpoint, use logger.once.warn, and improve messaging

- Update curl endpoint from /cdn-cgi/mf/scheduled to /cdn-cgi/handler/scheduled
- Replace manual didWarnMiniflareCronSupport flag with logger.once.warn()
- Remove 'wrangler dev --local' recommendation since warning appears during dev
- Make host/port dynamic using config.initialIp and config.initialPort
- Handle IPv6 addresses with brackets and 0.0.0.0/:: as localhost
- Update template files to use new endpoint and remove --local flag

Co-Authored-By: Steve Faulkner <southpolesteve@gmail.com>

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: Steve Faulkner <southpolesteve@gmail.com>

Author: devin-ai-integration[bot]

.changeset/easy-cars-lick.md

@@ -0,0 +1,5 @@
+---
+"wrangler": patch
+---
+
+Updated cron trigger documentation links and improved error message to include instructions for testing cron triggers locally

packages/wrangler/src/dev/miniflare/index.ts

@@ -817,8 +817,6 @@ export function buildSitesOptions({
 	}
 }
 
-let didWarnMiniflareCronSupport = false;
-
 export type Options = Extract<MiniflareOptions, { workers: WorkerOptions[] }>;
 
 export async function buildMiniflareOptions(
@@ -829,12 +827,20 @@ export async function buildMiniflareOptions(
 	onDevRegistryUpdate?: (registry: WorkerRegistry) => void
 ): Promise<Options> {
 	if (config.crons?.length && !config.testScheduled) {
-		if (!didWarnMiniflareCronSupport) {
-			didWarnMiniflareCronSupport = true;
-			logger.warn(
-				"Miniflare does not currently trigger scheduled Workers automatically.\nRefer to https://developers.cloudflare.com/workers/configuration/cron-triggers/#test-cron-triggers for more details "
-			);
-		}
+		const host =
+			config.initialIp === "0.0.0.0" || config.initialIp === "::"
+				? "localhost"
+				: config.initialIp.includes(":")
+					? `[${config.initialIp}]`
+					: config.initialIp;
+		const port = config.initialPort;
+
+		logger.once.warn(
+			`Scheduled Workers are not automatically triggered during local development.\n` +
+				`To manually trigger a scheduled event, run:\n` +
+				`  curl "http://${host}:${port}/cdn-cgi/handler/scheduled"\n` +
+				`For more details, see https://developers.cloudflare.com/workers/configuration/cron-triggers/#test-cron-triggers-locally`
+		);
 	}
 
 	const upstream =

packages/wrangler/templates/new-worker-scheduled.js

@@ -1,10 +1,10 @@
 /**
  * Welcome to Cloudflare Workers! This is your first scheduled worker.
  *
- * - Run `wrangler dev --local` in your terminal to start a development server
- * - Run `curl "http://localhost:8787/cdn-cgi/mf/scheduled"` to trigger the scheduled event
+ * - Run `wrangler dev` in your terminal to start a development server
+ * - Run `curl "http://localhost:8787/cdn-cgi/handler/scheduled"` to trigger the scheduled event
  * - Go back to the console to see what your worker has logged
- * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers)
+ * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/configuration/cron-triggers/)
  * - Run `wrangler publish --name my-worker` to publish your worker
  *
  * Learn more at https://developers.cloudflare.com/workers/runtime-apis/scheduled-event/

packages/wrangler/templates/new-worker-scheduled.ts

@@ -1,10 +1,10 @@
 /**
  * Welcome to Cloudflare Workers! This is your first scheduled worker.
  *
- * - Run `wrangler dev --local` in your terminal to start a development server
- * - Run `curl "http://localhost:8787/cdn-cgi/mf/scheduled"` to trigger the scheduled event
+ * - Run `wrangler dev` in your terminal to start a development server
+ * - Run `curl "http://localhost:8787/cdn-cgi/handler/scheduled"` to trigger the scheduled event
  * - Go back to the console to see what your worker has logged
- * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers)
+ * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/configuration/cron-triggers/)
  * - Run `wrangler deploy --name my-worker` to deploy your worker
  *
  * Learn more at https://developers.cloudflare.com/workers/runtime-apis/scheduled-event/