Merge remote-tracking branch 'origin/production' into kathayl-patch-12-1

Author: ToriLindsay

.github/CODEOWNERS

@@ -120,9 +120,9 @@
 /public/realtime/ @cloudflare/pcx-technical-writing @cloudflare/calls @roerohan @ravindra-dyte
 /src/content/docs/stream/ @tsmith512 @ToriLindsay @cloudflare/pcx-technical-writing @renandincer @third774
 /src/content/release-notes/stream.yaml @tsmith512 @ToriLindsay @cloudflare/pcx-technical-writing
-/src/content/docs/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @mikenomitch @korinne @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1 @cloudflare/wrangler
-/src/content/partials/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @mikenomitch @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1 @cloudflare/wrangler
-/src/assets/images/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1 @cloudflare/wrangler
+/src/content/docs/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @mikenomitch @korinne @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1
+/src/content/partials/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @mikenomitch @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1
+/src/assets/images/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1
 /src/content/release-notes/workers.yaml @cloudflare/workers-docs @GregBrimble @WalshyDev @aninibread @cloudflare/deploy-config @cloudflare/pcx-technical-writing @irvinebroque @mikenomitch
 /src/content/docs/zaraz/ @ToriLindsay @kathayl @bjesus @jonnyparris @simonabadoiu @cloudflare/pcx-technical-writing
 /src/content/release-notes/zaraz.yaml @bjesus @jonnyparris @simonabadoiu @cloudflare/pcx-technical-writing

package-lock.json

@@ -42,7 +42,7 @@
 		"@expressive-code/plugin-line-numbers": "0.41.3",
 		"@floating-ui/react": "0.27.16",
 		"@iarna/toml": "2.2.5",
-		"@lottiefiles/dotlottie-react": "0.16.0",
+		"@lottiefiles/dotlottie-react": "0.16.1",
 		"@marsidev/react-turnstile": "1.3.0",
 		"@microsoft/fetch-event-source": "2.0.1",
 		"@nanostores/react": "1.0.0",

package.json

@@ -0,0 +1,93 @@
+diff --git a/node_modules/@astrojs/starlight-docsearch/DocSearch.astro b/node_modules/@astrojs/starlight-docsearch/DocSearch.astro
+index f50c208..5309557 100644
+--- a/node_modules/@astrojs/starlight-docsearch/DocSearch.astro
++++ b/node_modules/@astrojs/starlight-docsearch/DocSearch.astro
+@@ -109,15 +109,20 @@ const docsearchTranslations: DocSearchTranslationProps = {
+ 		.DocSearch-Button-Keys {
+ 			margin-inline-start: auto;
+ 		}
+-		.DocSearch-Button-Keys::before {
+-			content: '';
+-			width: 1em;
+-			height: 1em;
+-			-webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M17 2H7a5 5 0 0 0-5 5v10a5 5 0 0 0 5 5h10a5 5 0 0 0 5-5V7a5 5 0 0 0-5-5Zm3 15a3 3 0 0 1-3 3H7a3 3 0 0 1-3-3V7a3 3 0 0 1 3-3h10a3 3 0 0 1 3 3v10Z'%3E%3C/path%3E%3Cpath d='M15.293 6.707a1 1 0 1 1 1.414 1.414l-8.485 8.486a1 1 0 0 1-1.414-1.415l8.485-8.485Z'%3E%3C/path%3E%3C/svg%3E");
+-			mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M17 2H7a5 5 0 0 0-5 5v10a5 5 0 0 0 5 5h10a5 5 0 0 0 5-5V7a5 5 0 0 0-5-5Zm3 15a3 3 0 0 1-3 3H7a3 3 0 0 1-3-3V7a3 3 0 0 1 3-3h10a3 3 0 0 1 3 3v10Z'%3E%3C/path%3E%3Cpath d='M15.293 6.707a1 1 0 1 1 1.414 1.414l-8.485 8.486a1 1 0 0 1-1.414-1.415l8.485-8.485Z'%3E%3C/path%3E%3C/svg%3E");
+-			-webkit-mask-size: 100%;
+-			mask-size: 100%;
+-			background-color: currentColor;
++		.DocSearch-Button-Key:first-child {
++			margin-right: 0.4em;
++		}
++		.DocSearch-Button-Key {
++			display: inline-block;
++			font-size: 0.75em;
++			font-weight: 600;
++			opacity: 0.8;
++			border: 1px solid var(--sl-color-gray-4);
++			border-radius: 0.25rem;
++			padding: 0.125rem 0.375rem;
++			background-color: var(--sl-color-gray-6);
++			color: var(--sl-color-gray-1);
++			line-height: 1;
+ 		}
+ 	}
+ </style>
+@@ -128,6 +133,7 @@ const docsearchTranslations: DocSearchTranslationProps = {
+ 	class StarlightDocSearch extends HTMLElement {
+ 		constructor() {
+ 			super();
++
+ 			window.addEventListener('DOMContentLoaded', async () => {
+ 				const { default: docsearch } = await import('@docsearch/js');
+ 				const options = { ...config, container: 'sl-doc-search' };
+@@ -136,6 +142,27 @@ const docsearchTranslations: DocSearchTranslationProps = {
+ 					Object.assign(options, translations);
+ 				} catch {}
+ 				docsearch(options);
++
++				const keyboardShortcuts = options.keyboardShortcuts ?? {};
++				const slashEnabled = keyboardShortcuts?.['/'] !== false;
++				const ctrlCmdKEnabled = keyboardShortcuts?.['Ctrl/Cmd+K'] !== false;
++
++				if (slashEnabled && !ctrlCmdKEnabled) {
++					const styleContainer = document.createElement('style');
++					styleContainer.innerHTML = `
++						.DocSearch-Button-Keys::before {
++							content: '';
++							width: 1em;
++							height: 1em;
++							-webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M17 2H7a5 5 0 0 0-5 5v10a5 5 0 0 0 5 5h10a5 5 0 0 0 5-5V7a5 5 0 0 0-5-5Zm3 15a3 3 0 0 1-3 3H7a3 3 0 0 1-3-3V7a3 3 0 0 1 3-3h10a3 3 0 0 1 3 3v10Z'%3E%3C/path%3E%3Cpath d='M15.293 6.707a1 1 0 1 1 1.414 1.414l-8.485 8.486a1 1 0 0 1-1.414-1.415l8.485-8.485Z'%3E%3C/path%3E%3C/svg%3E");
++							mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M17 2H7a5 5 0 0 0-5 5v10a5 5 0 0 0 5 5h10a5 5 0 0 0 5-5V7a5 5 0 0 0-5-5Zm3 15a3 3 0 0 1-3 3H7a3 3 0 0 1-3-3V7a3 3 0 0 1 3-3h10a3 3 0 0 1 3 3v10Z'%3E%3C/path%3E%3Cpath d='M15.293 6.707a1 1 0 1 1 1.414 1.414l-8.485 8.486a1 1 0 0 1-1.414-1.415l8.485-8.485Z'%3E%3C/path%3E%3C/svg%3E");
++							-webkit-mask-size: 100%;
++							mask-size: 100%;
++							background-color: currentColor;
++						}
++					`;
++					document.head.appendChild(styleContainer);
++				}
+ 			});
+ 		}
+ 	}
+diff --git a/node_modules/@astrojs/starlight-docsearch/index.ts b/node_modules/@astrojs/starlight-docsearch/index.ts
+index e8cc7e5..6c88e07 100644
+--- a/node_modules/@astrojs/starlight-docsearch/index.ts
++++ b/node_modules/@astrojs/starlight-docsearch/index.ts
+@@ -43,6 +43,18 @@ const DocSearchConfigSchema = z
+ 		 * @see https://www.algolia.com/doc/api-reference/search-api-parameters/
+ 		 */
+ 		searchParameters: z.custom<SearchOptions>(),
++		/**
++		 * Configuration for keyboard shortcuts that trigger the DocSearch modal.
++		 * @see https://docsearch.algolia.com/docs/api/#keyboardshortcuts
++		 */
++		keyboardShortcuts: z
++			.object({
++				/** Enable/disable Ctrl/Cmd+K shortcut. @default true */
++				'Ctrl/Cmd+K': z.boolean().optional(),
++				/** Enable/disable / shortcut. @default true */
++				'/': z.boolean().optional(),
++			})
++			.optional(),
+ 	})
+ 	.strict()
+ 	.or(

patches/@astrojs+starlight-docsearch+0.6.0.patch

@@ -492,6 +492,15 @@
 /ddos-protection/managed-rulesets/adjust-rules/false-positive/ /ddos-protection/managed-rulesets/http/http-overrides/override-examples/#legitimate-traffic-is-incorrectly-identified-as-an-attack-and-causes-a-false-positive 301
 /ddos-protection/managed-rulesets/adjust-rules/ /ddos-protection/managed-rulesets/http/http-overrides/override-examples/ 301
 
+# developer spotlight
+/developer-spotlight/tutorials/ /developer-spotlight/ 301
+/developer-spotlight/tutorials/create-sitemap-from-sanity-cms/ /developer-spotlight/ 301
+/developer-spotlight/tutorials/creating-a-recommendation-api/ /developer-spotlight/ 301
+/developer-spotlight/tutorials/custom-access-control-for-files/ /developer-spotlight/ 301
+/developer-spotlight/tutorials/fullstack-authentication-with-next-js-and-cloudflare-d1/ /developer-spotlight/ 301
+/developer-spotlight/tutorials/handle-form-submission-with-astro-resend/ /developer-spotlight/ 301
+/developer-spotlight/application-guide/ /developer-spotlight/ 301
+
 # dns
 /dns/additional-options/cname-flattening/ /dns/cname-flattening/ 301
 /dns/additional-options/dnssec/ /dns/dnssec/ 301
@@ -1610,6 +1619,7 @@
 /turnstile/glossary/ /turnstile/ 301
 /turnstile/get-started/supported-browsers/ /cloudflare-challenges/reference/supported-browsers/ 301
 /turnstile/troubleshooting/troubleshooting-faqs/ /turnstile/frequently-asked-questions/#troubleshooting 301
+/turnstile/tutorials/protecting-your-payment-form-from-attackers-bots-using-turnstile/ /developer-spotlight/ 301
 
 # waf
 /waf/about/ /waf/concepts/ 301
@@ -1905,8 +1915,8 @@
 /workers/configuration/bindings/about-service-bindings/ /workers/runtime-apis/bindings/service-bindings/ 301
 /workers/tutorials/localize-a-website/ /pages/tutorials/localize-a-website/ 301
 /workers/tutorials/manage-projects-with-lerna/ /pages/configuration/monorepos/#monorepo-management-tools 301
-/workers/tutorials/create-sitemap-from-sanity-cms/ /developer-spotlight/tutorials/create-sitemap-from-sanity-cms/ 301
-/workers/tutorials/custom-access-control-for-files-in-r2-using-d1-and-workers/ /developer-spotlight/tutorials/custom-access-control-for-files/ 301
+/workers/tutorials/create-sitemap-from-sanity-cms/ /developer-spotlight/ 301
+/workers/tutorials/custom-access-control-for-files-in-r2-using-d1-and-workers/ /developer-spotlight/ 301
 /workers/tutorials/generate-dynamic-og-images-using-workers/ /workers/tutorials/ 302
 /workers/static-assets/migrate-from-pages/ /workers/static-assets/migration-guides/migrate-from-pages/ 301
 /workers/static-assets/compatibility-matrix/ /workers/static-assets/migration-guides/migrate-from-pages/ 301
@@ -1939,6 +1949,8 @@
 /workers/testing/miniflare/get-started/migrating/ /workers/testing/miniflare/migrations/from-v2/ 301
 /workers/databases/native-integrations/fauna/ /workers/databases/native-integrations/ 301
 /workers/tutorials/store-data-with-fauna/ https://fauna.com/blog/the-future-of-fauna 301
+/workers/tutorials/live-cursors-with-nextjs-rpc-do/ /developer-spotlight/ 301
+/workers/tutorials/automated-analytics-reporting/ /developer-spotlight/ 301
 
 # workers ai
 /workers-ai/models/llm/ /workers-ai/models/#text-generation 301
@@ -1955,9 +1967,11 @@
 /workers-ai/configuration/function-calling/ /workers-ai/function-calling/ 301
 /workers-ai/platform/storage-options/ /workers/platform/storage-options/ 301
 /workers-ai/configuration/workers-ai-sdk/ /workers-ai/configuration/bindings/ 301
-/workers-ai/tutorials/creating-a-recommendation-api/ /developer-spotlight/tutorials/creating-a-recommendation-api/ 301
+/workers-ai/tutorials/creating-a-recommendation-api/ /developer-spotlight/ 301
 /workers/observability/baselime-integration/ /workers/observability/integrations/baselime-integration/ 301
 /workers-ai/tutorials/image-generator-flux/ /workers-ai/tutorials/image-generation-playground/ 301
+/workers-ai/guides/tutorials/build-a-voice-notes-app-with-auto-transcription/ /developer-spotlight/ 301
+/workers-ai/tutorials/build-ai-interview-practice-tool/ /developer-spotlight/ 301
 
 # Workers AI reorganization redirects
 # Function calling

patches/@docsearch+js+3.8.2.patch

@@ -10,17 +10,37 @@
 
 <script>
 	import { track } from "~/util/zaraz";
+	import { openGlobalSearch } from "~/util/search";
 
 	const { pathname } = window.location;
 
 	const anchor = document.getElementById("404-search-link");
+	const pretty = decodeURIComponent(
+		pathname.replaceAll("/", " ").replaceAll("-", " ").trim(),
+	);
 
 	if (anchor) {
-		const pretty = pathname.replaceAll("/", " ").replaceAll("-", " ").trim();
-
 		anchor.setAttribute("href", `/search/?q=${encodeURIComponent(pretty)}`);
 		anchor.addEventListener("click", () => {
 			track("serp from location", { value: "404", query: pretty });
 		});
 	}
+
+	document.addEventListener(
+		"keydown",
+		(keyboardEvent) => {
+			if (
+				(keyboardEvent.metaKey || keyboardEvent.ctrlKey) &&
+				keyboardEvent.key === "k"
+			) {
+				keyboardEvent.preventDefault();
+				keyboardEvent.stopPropagation();
+
+				openGlobalSearch(pretty);
+			}
+		},
+		{
+			capture: true,
+		},
+	);
 </script>

public/__redirects

@@ -0,0 +1,105 @@
+---
+import { z } from "astro:schema";
+import { PackageManagers } from "starlight-package-managers";
+import { commands, getCommand } from "~/util/wrangler";
+import WranglerArg from "./WranglerArg.astro";
+import Details from "./Details.astro";
+
+function validateArg(value: any, expected: string): boolean {
+	if (Array.isArray(expected)) {
+		for (const choice of expected) {
+			if (value === choice) {
+				return true;
+			}
+		}
+
+		return false;
+	}
+
+	return typeof value === expected;
+}
+
+type Props = z.input<typeof props>;
+
+const props = z.object({
+	command: z.string(),
+	positionals: z.array(z.string()).optional(),
+	flags: z.record(z.string(), z.any()).optional(),
+	showArgs: z.boolean().default(false),
+});
+
+const { command, positionals, flags, showArgs } = props.parse(Astro.props);
+
+const definition = getCommand(command);
+
+const { globalFlags } = commands;
+
+let args = [];
+
+if (flags) {
+	for (const [key, value] of Object.entries(flags)) {
+		const flagDef = definition.args?.[key];
+
+		if (!flagDef) {
+			throw new Error(
+				`[WranglerCLI] Received "${key}" for "${command}" but no such arg exists`,
+			);
+		}
+
+		const type = flagDef.type ?? flagDef.choices;
+		const valid = validateArg(value, type);
+
+		if (!valid) {
+			throw new Error(
+				`[WranglerCLI] Expected "${type}" for "${key}" but got "${typeof value}"`,
+			);
+		}
+
+		args.push(...[`--${key}`, value]);
+	}
+}
+
+if (positionals) {
+	const positionalsDef = definition.positionalArgs ?? [];
+
+	if (positionalsDef.length === 0) {
+		throw new Error(
+			`[WranglerCLI] Expected 0 positional arguments for "${command}" but received ${positionals.length}`,
+		);
+	}
+
+	args.push(...positionals);
+}
+---
+
+<PackageManagers
+	pkg="wrangler"
+	type="exec"
+	args={`${command} ${args.join(" ")}`}
+/>
+
+{
+	showArgs && definition.args && (
+		<Details header="Arguments">
+			<p>
+				<strong>Command flags</strong>
+			</p>
+			<ul>
+				{Object.entries(definition.args)
+					.filter(([_, value]) => !value.hidden)
+					.map(([key, value]) => {
+						return <WranglerArg key={key} definition={value} />;
+					})}
+			</ul>
+
+			<p>
+				<strong>Global flags</strong>
+			</p>
+			<ul>
+				{Object.entries(globalFlags).map(([key, value]) => {
+					return <WranglerArg key={key} definition={value} />;
+				})}
+			</ul>
+		</Details>
+	)
+}