feat: add Waku to C3

Fixes cloudflare#7594.

Adding a C3 template for Waku, a minimal React framework. https://waku.gg/

- Tests
  - [ ] TODO (before merge)
  - [x] Tests included
  - [ ] Tests not necessary because:
- E2E Tests CI Job required? (Use "e2e" label or ask maintainer to run separately)
  - [ ] I don't know
  - [x] Required
  - [ ] Not required because:
- Public documentation
  - [ ] TODO (before merge)
  - [x] Cloudflare docs PR(s): <cloudflare/cloudflare-docs#20444>
  - [ ] Documentation not necessary because:

Author: rmarscher

.changeset/moody-hands-sort.md

@@ -0,0 +1,5 @@
+---
+"create-cloudflare": patch
+---
+
+feat(create-cloudflare): Add Waku workers template

packages/create-cloudflare/e2e/tests/frameworks/test-config.ts

@@ -625,37 +625,22 @@ function getFrameworkTestConfig(pm: string): NamedFrameworkTestConfig[] {
 			},
 			nodeCompat: false,
 		},
+		waku: {
+			testCommitMessage: true,
+			timeout: LONG_TIMEOUT,
+			unsupportedOSs: ["win32"],
+			verifyDeploy: {
+				route: "/",
+				expectedText: "Waku",
+			},
+			verifyPreview: {
+				route: "/",
+				expectedText: "Waku",
+			},
+			verifyBuildCfTypes: {
+				outputFile: "worker-configuration.d.ts",
+				envInterfaceName: "Env",
+			},
+		},
 	];
 }
-
-/**
- * Gets the list of experimental framework test configurations.
- */
-function getExperimentalFrameworkTestConfig() {
-	return [
-		// None right now
-	];
-}
-
-/**
- * Get a list of Framework test configurations based on the provided `options`.
- *
- * @param options - An object containing the following properties:
- *   - isExperimentalMode: A boolean indicating if experimental mode is enabled.
- *   - FrameworkTestFilter: A string that can be used to filter the tests by "name" or "name:(pages|workers)".
- */
-export function getFrameworksTests(): NamedFrameworkTestConfig[] {
-	const packageManager = detectPackageManager();
-	const frameworkTests = isExperimental
-		? getExperimentalFrameworkTestConfig()
-		: getFrameworkTestConfig(packageManager.name);
-	return frameworkTests.filter((testConfig) => {
-		if (!frameworkToTestFilter) {
-			return true;
-		}
-		if (frameworkToTestFilter.includes(":")) {
-			return testConfig.name === frameworkToTestFilter;
-		}
-		return testConfig.name.split(":")[0] === frameworkToTestFilter;
-	});
-}

packages/create-cloudflare/src/frameworks/package.json

@@ -17,6 +17,7 @@
 		"create-react-router": "7.6.3",
 		"create-solid": "0.6.5",
 		"create-vue": "3.17.0",
+		"create-waku": "0.12.2-0.23.6-0",
 		"gatsby": "5.14.5",
 		"sv": "0.8.18",
 		"nuxi": "3.25.1"

packages/create-cloudflare/src/templates.ts

@@ -44,6 +44,7 @@ import scheduledTemplate from "templates/scheduled/c3";
 import solidTemplate from "templates/solid/c3";
 import svelteTemplate from "templates/svelte/c3";
 import vueTemplate from "templates/vue/c3";
+import wakuTemplate from "templates/waku/c3";
 import { isInsideGitRepo } from "./git";
 import { validateProjectDirectory, validateTemplateUrl } from "./validators";
 import type { Option } from "@cloudflare/cli/interactive";
@@ -206,6 +207,7 @@ export function getFrameworkMap({ experimental = false }): TemplateMap {
 			solid: solidTemplate,
 			svelte: svelteTemplate,
 			vue: vueTemplate,
+			waku: wakuTemplate,
 		};
 	}
 }

packages/create-cloudflare/templates/waku/c3.ts

@@ -0,0 +1,36 @@
+import { logRaw } from "@cloudflare/cli";
+import { runFrameworkGenerator } from "frameworks/index";
+import { detectPackageManager } from "helpers/packageManagers";
+import type { TemplateConfig } from "../../../src/templates";
+import type { C3Context } from "types";
+
+const { npm } = detectPackageManager();
+
+const generate = async (ctx: C3Context) => {
+	await runFrameworkGenerator(ctx, [
+		"--project-name",
+		ctx.project.name,
+		"--template",
+		"07_cloudflare",
+	]);
+};
+
+const config: TemplateConfig = {
+	configVersion: 1,
+	id: "waku",
+	frameworkCli: "create-waku",
+	platform: "workers",
+	displayName: "Waku",
+	path: "templates/workers/waku",
+	generate,
+	transformPackageJson: async () => ({
+		scripts: {
+			deploy: `${npm} run build && wrangler deploy`,
+			preview: `${npm} run build && wrangler dev`,
+		},
+	}),
+	devScript: "dev",
+	deployScript: "deploy",
+	previewScript: "preview",
+};
+export default config;

packages/create-cloudflare/templates/waku/wrangler.jsonc

@@ -0,0 +1,19 @@
+{
+	"name": "<TBD>",
+	"main": "./dist/worker/serve-cloudflare.js",
+	// https://developers.cloudflare.com/workers/platform/compatibility-dates
+	"compatibility_date": "<TBD>",
+	// nodejs_als is required for Waku server-side request context
+	// It can be removed if only building static pages
+	"compatibility_flags": ["nodejs_als"],
+	// https://developers.cloudflare.com/workers/static-assets/binding/
+	"assets": {
+		"binding": "ASSETS",
+		"directory": "./dist/assets",
+		"html_handling": "drop-trailing-slash",
+		"not_found_handling": "404-page"
+	},
+	"vars": {
+		"MAX_ITEMS": 10
+	}
+}