Merge remote-tracking branch 'origin/production' into penalosa/improve-testing-docs

Author: penalosa

.github/CODEOWNERS

@@ -17,7 +17,7 @@
 
 # AI
 
-/src/content/docs/agents/ @irvinebroque @rita3ko @elithrar @thomasgauvin @threepointone
+/src/content/docs/agents/ @irvinebroque @rita3ko @elithrar @thomasgauvin @threepointone @kodster28 @KianNH
 /src/content/docs/ai-gateway/ @kathayl @G4brym @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
 /src/content/docs/workers-ai/ @rita3ko @craigsdennis @markdembo @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
 /src/content/docs/vectorize/ @elithrar @vy-ton @sejoker @mchenco @cloudflare/pcx-technical-writing
@@ -30,7 +30,7 @@
 
 /src/content/docs/analytics/ @46bit @jherre @jimhawkridge @soheiokamoto @victor-perov @angelampcosta @cloudflare/pcx-technical-writing
 /src/content/docs/data-localization/ @soheiokamoto @angelampcosta @cloudflare/pcx-technical-writing
-/src/content/docs/logs/ @cmackenzie1 @jherre @soheiokamoto @victor-perov @angelampcosta @cloudflare/pcx-technical-writing
+/src/content/docs/logs/ @jherre @soheiokamoto @victor-perov @angelampcosta @cloudflare/pcx-technical-writing
 
 # API & Zones
 

public/_redirects

@@ -415,6 +415,7 @@
 /email-security/setup/api-deployment/office365-api/ /email-security/setup/post-delivery-deployment/api/office365-api/ 301
 /email-security/email-configuration/retract-settings/gmail-retraction/ /email-security/deployment/api/setup/gsuite-bcc-setup/add-retraction/ 301
 /cloudflare-one/insights/email-monitoring/email-security-logs/ /cloudflare-one/insights/email-monitoring/enable-logs/ 301
+/cloudflare-one/insights/email-monitoring/phishing-report/ /cloudflare-one/insights/email-monitoring/download-disposition-report/ 301 
 
 
 # firewall
@@ -999,6 +1000,7 @@
 /rules/url-forwarding/bulk-redirects/use-cases/ /rules/url-forwarding/examples/ 301
 /rules/url-forwarding/single-redirects/examples/ /rules/url-forwarding/examples/ 301
 /rules/url-forwarding/dynamic-redirects/parameters/ /rules/url-forwarding/single-redirects/settings/ 301
+/rules/transform/manage/ /rules/transform/ 301
 
 # ruleset engine
 /ruleset-engine/rules-language/fields/standard-fields/ /ruleset-engine/rules-language/fields/reference/ 301
@@ -1842,20 +1844,13 @@
 /http-applications/* /version-management/:splat 301
 /http3/* https://www.cloudflare.com/learning/performance/what-is-http3/ 301
 /railgun/* / 301
-/rules/bulk-redirects/* /rules/url-forwarding/bulk-redirects/:splat 301
-/rules/url-forwarding/dynamic-redirects/* /rules/url-forwarding/single-redirects/:splat 301
 /ssl/ssl-tls/* /ssl/reference/:splat 301
 /ssl/reference/cipher-suites/* /ssl/edge-certificates/additional-options/cipher-suites/:splat 301
 /ssl/reference/migration-guides/digicert-update/* /ssl/reference/migration-guides/ 301
 /support/account-management-billing/billing-cloudflare-add-on-services/* https://www.cloudflare.com/plans/ 301
 /tenant/tutorial/* /tenant/get-started/ 301
-/waf/managed-rulesets/* /waf/managed-rules/:splat 301
-/firewall/recipes/* /waf/custom-rules/use-cases/:splat 301
 /workers/wrangler-legacy/* /workers/wrangler/migration/v1-to-v2/wrangler-legacy/:splat 301
-/waf/custom-rulesets/* /waf/account/custom-rulesets/:splat 301
-/waf/custom-rules/custom-rulesets/* /waf/account/custom-rulesets/:splat 301
-/waf/exposed-credentials-check/* /waf/managed-rules/check-for-exposed-credentials/:splat 301
-/waf/security-events/* /waf/analytics/security-events/:splat 301
+/firewall/recipes/* /waf/custom-rules/use-cases/:splat 301
 /web3/polygon-gateway/* /web3/ 301
 /vectorize/configuration/* /vectorize/best-practices/:splat 301
 
@@ -1904,15 +1899,6 @@
 ## Secure your Internet Traffic
 /learning-paths/secure-internet-traffic/connect-devices/* /learning-paths/secure-internet-traffic/connect-devices-networks/:splat 301
 
-
-# Old WAF changelog entries
-/waf/change-log/2019-* /waf/change-log/historical-2019/ 301
-/waf/change-log/2020-* /waf/change-log/historical-2020/ 301
-/waf/change-log/2021-* /waf/change-log/historical-2021/ 301
-/waf/change-log/2022-* /waf/change-log/historical-2022/ 301
-/waf/change-log/2023-* /waf/change-log/historical-2023/ 301
-/waf/change-log/2024-* /waf/change-log/historical-2024/ 301
-
 # Cloudflare for SaaS
 /ssl/ssl-for-saas/common-tasks/* /cloudflare-for-platforms/cloudflare-for-saas/ 301
 /ssl/ssl-for-saas/reference/* /cloudflare-for-platforms/cloudflare-for-saas/reference/ 301
@@ -1928,6 +1914,24 @@
 /magic-wan/connector/* /magic-wan/configuration/connector/:splat 301
 /magic-wan/configuration/connector/dhcp/* /magic-wan/configuration/connector/network-options/dhcp/:splat 301
 
+# Rules
+/rules/bulk-redirects/* /rules/url-forwarding/bulk-redirects/:splat 301
+/rules/url-forwarding/dynamic-redirects/* /rules/url-forwarding/single-redirects/:splat 301
+/rules/custom-error-responses/* /rules/custom-errors/:splat 301
+
+# WAF
+/waf/managed-rulesets/* /waf/managed-rules/:splat 301
+/waf/custom-rulesets/* /waf/account/custom-rulesets/:splat 301
+/waf/custom-rules/custom-rulesets/* /waf/account/custom-rulesets/:splat 301
+/waf/exposed-credentials-check/* /waf/managed-rules/check-for-exposed-credentials/:splat 301
+/waf/security-events/* /waf/analytics/security-events/:splat 301
+/waf/change-log/2019-* /waf/change-log/historical-2019/ 301
+/waf/change-log/2020-* /waf/change-log/historical-2020/ 301
+/waf/change-log/2021-* /waf/change-log/historical-2021/ 301
+/waf/change-log/2022-* /waf/change-log/historical-2022/ 301
+/waf/change-log/2023-* /waf/change-log/historical-2023/ 301
+/waf/change-log/2024-* /waf/change-log/historical-2024/ 301
+
 # Workers
 /workers/reference/apis/* /workers/runtime-apis/:splat 301
 /workers/templates/pages/* /workers/examples/:splat 301

src/assets/images/changelog-next/rules/rules-overview.gif

@@ -1,4 +1,4 @@
-import { useState } from "react";
+import { useEffect, useState, type ChangeEvent } from "react";
 import FieldBadges from "./fields/FieldBadges";
 import Markdown from "react-markdown";
 import type { CollectionEntry } from "astro:content";
@@ -25,7 +25,7 @@ const FieldCatalog = ({ fields }: { fields: Fields }) => {
 	const categories = [
 		...new Set(
 			fields
-				.map((field) => field.categories)
+				.map((field) => field.categories ?? [])
 				.flat()
 				.sort(),
 		),
@@ -57,6 +57,21 @@ const FieldCatalog = ({ fields }: { fields: Fields }) => {
 		return true;
 	});
 
+	useEffect(() => {
+		// On component load, check for deep-links to categories in the query param
+		const params = new URLSearchParams(window.location.search);
+		const categories = params.getAll("field-category");
+		const searchTerm = params.get("search-term") ?? "";
+
+		if (!categories && !searchTerm) return;
+
+		setFilters({
+			...filters,
+			search: searchTerm,
+			categories: categories,
+		});
+	}, []);
+
 	return (
 		<div className="md:flex">
 			<div className="mr-8 w-full md:w-1/4">
@@ -79,19 +94,18 @@ const FieldCatalog = ({ fields }: { fields: Fields }) => {
 								type="checkbox"
 								className="mr-2"
 								value={category}
-								onClick={(e) => {
-									const target = e.target as HTMLInputElement;
-
-									if (target.checked) {
+								checked={filters.categories.includes(category)}
+								onChange={(e: ChangeEvent<HTMLInputElement>) => {
+									if (e.target.checked) {
 										setFilters({
 											...filters,
-											categories: [...filters.categories, target.value],
+											categories: [...filters.categories, e.target.value],
 										});
 									} else {
 										setFilters({
 											...filters,
 											categories: filters.categories.filter(
-												(f) => f !== target.value,
+												(f) => f !== e.target.value,
 											),
 										});
 									}
@@ -122,7 +136,7 @@ const FieldCatalog = ({ fields }: { fields: Fields }) => {
 						>
 							<div className="-mb-1 flex items-center">
 								<span
-									className="font-semibold text-lg text-ellipsis overflow-hidden whitespace-nowrap"
+									className="overflow-hidden text-ellipsis whitespace-nowrap text-lg font-semibold"
 									title={`${field.name}: ${field.data_type}`}
 								>
 									{field.name}

src/assets/images/changelog-next/rules/rules-templates.gif

@@ -27,8 +27,8 @@ const resources = await getCollection("docs", ({ data }) => {
 			const description = page.data.description;
 			return (
 				<li>
-					<a href={`/${page.id}/`}>{page.data.title}</a>
-					{description && `: ${description}`}
+					<!-- prettier-ignore -->
+					<a href={`/${page.id}/`}>{page.data.title}</a>{description && `: ${description}`}
 				</li>
 			);
 		})

src/assets/images/changelog-next/rules/snippets-new-editor.png

@@ -45,7 +45,7 @@ if (language === "toml") {
 ---
 
 <Tabs syncKey="wranglerConfig">
-	<TabItem label="wrangler.json" icon="seti:json">
+	<TabItem label="wrangler.jsonc" icon="seti:json">
 		<Code lang="jsonc" code={json} />
 	</TabItem>
 	<TabItem label="wrangler.toml" icon="setting">

src/components/FieldCatalog.tsx

@@ -0,0 +1,46 @@
+---
+import { z } from "astro:schema";
+import { Code } from "@astrojs/starlight/components";
+import Details from "~/components/Details.astro";
+import Render from "~/components/Render.astro";
+
+type Props = z.infer<typeof props>;
+
+const props = z.object({
+	name: z.string(),
+});
+
+const { name } = props.parse(Astro.props);
+
+const worker = `import { Buffer } from 'node:buffer';
+export interface Env {
+    AI: Ai;
+}
+const URL = "https://pub-dbcf9f0bd3af47ca9d40971179ee62de.r2.dev/02f6edc0-1f7b-4272-bd17-f05335104725/audio.mp3";
+export default {
+    async fetch(request, env, ctx): Promise<Response> {
+        const mp3 = await fetch(URL);
+        if (!mp3.ok) {
+      		return Response.json({ error: \`Failed to fetch MP3: \${mp3.status}\` });
+    		}
+        const mp3Buffer = await mp3.arrayBuffer();
+        const base64 = Buffer.from(mp3Buffer, 'binary').toString("base64");
+        try {
+            const res = await env.AI.run("${name}", {
+                "audio": base64
+            });
+            return Response.json(res);
+        }
+        catch (e) {
+            console.error(e);
+            return Response.json({ error: "An unexpected error occurred" });
+        }
+    },
+} satisfies ExportedHandler<Env>
+ `;
+---
+
+<Details header="Workers - TypeScript">
+	<Code code={worker} lang="ts" />
+	<Render file="nodejs-compat-howto" product="workers" />
+</Details>

src/components/ResourcesBySelector.astro

@@ -0,0 +1,20 @@
+---
+title: New Rules Templates for One-Click Rule Creation
+description: Quickly set up common rules with pre-built templates.
+products:
+  - rules
+date: 2024-09-05T11:00:00Z
+---
+
+Now, you can create **common rule configurations** in just **one click** using Rules Templates.
+
+![Rules Templates](~/assets/images/changelog-next/rules/rules-templates.gif)
+
+What you can do:
+- **Pick a pre-built rule** – Choose from a library of templates.
+- **One-click setup** – Deploy best practices instantly.
+- **Customize as needed** – Adjust templates to fit your setup.
+
+Template cards are now also available directly in the rule builder for each product.
+
+Need more ideas? Check out the [Examples gallery](/rules/examples/) in our documentation.