Add pages-functions-test fixture

Manual test fixture for the @cloudflare/pages-functions package.
Demonstrates compiling a functions directory and running with wrangler.

Author: ascorbic

fixtures/pages-functions-test/README.md

@@ -0,0 +1,35 @@
+# Pages Functions Test Fixture
+
+Test fixture for `@cloudflare/pages-functions` package.
+
+## Usage
+
+From the workers-sdk root:
+
+```bash
+# Build the pages-functions package first
+pnpm --filter @cloudflare/pages-functions build
+
+# Install deps for this fixture
+pnpm --filter pages-functions-test install
+
+# Compile functions -> worker, then bundle, then run dev
+pnpm --filter pages-functions-test dev
+```
+
+## What it does
+
+1. `build.mjs` uses `compileFunctions()` to compile `functions/` into `dist/worker.js`
+2. esbuild bundles `dist/worker.js` (with path-to-regexp) into `dist/bundled.js`
+3. wrangler runs the bundled worker
+
+## Test endpoints
+
+- `GET /` - Index route
+- `GET /api/hello` - Static API route
+- `POST /api/hello` - POST handler
+- `GET /api/:id` - Dynamic route
+- `PUT /api/:id` - Update handler
+- `DELETE /api/:id` - Delete handler
+
+All routes go through the root middleware which adds `X-Middleware: active` header.

fixtures/pages-functions-test/_routes.json

@@ -0,0 +1,8 @@
+{
+  "version": 1,
+  "description": "Generated by @cloudflare/pages-functions",
+  "include": [
+    "/*"
+  ],
+  "exclude": []
+}

fixtures/pages-functions-test/build.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * Build script that uses @cloudflare/pages-functions to compile
+ * the functions directory into a worker entrypoint.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { compileFunctions } from "@cloudflare/pages-functions";
+
+// Ensure dist directory exists
+mkdirSync("./dist", { recursive: true });
+
+// Compile the functions directory
+const result = await compileFunctions("./functions");
+
+// Write the generated worker entrypoint
+writeFileSync("./dist/worker.js", result.code);
+console.log("✓ Generated dist/worker.js");
+
+// Write _routes.json
+writeFileSync("./_routes.json", JSON.stringify(result.routesJson, null, 2));
+console.log("✓ Generated _routes.json");
+
+console.log("\nRoutes:");
+for (const route of result.routes) {
+	const method = route.method || "ALL";
+	console.log(`  ${method.padEnd(6)} ${route.routePath}`);
+}

fixtures/pages-functions-test/functions/_middleware.ts

@@ -0,0 +1,5 @@
+export const onRequest = async (context) => {
+	const response = await context.next();
+	response.headers.set("X-Middleware", "active");
+	return response;
+};

fixtures/pages-functions-test/functions/api/[id].ts

@@ -0,0 +1,15 @@
+export const onRequestGet = (context) => {
+	const { id } = context.params;
+	return Response.json({ message: `Getting item ${id}` });
+};
+
+export const onRequestPut = async (context) => {
+	const { id } = context.params;
+	const body = await context.request.json();
+	return Response.json({ message: `Updating item ${id}`, data: body });
+};
+
+export const onRequestDelete = (context) => {
+	const { id } = context.params;
+	return Response.json({ message: `Deleted item ${id}` });
+};

fixtures/pages-functions-test/functions/api/hello.ts

@@ -0,0 +1,11 @@
+export const onRequestGet = () => {
+	return Response.json({ message: "Hello from GET /api/hello" });
+};
+
+export const onRequestPost = async (context) => {
+	const body = await context.request.json();
+	return Response.json({
+		message: "Hello from POST /api/hello",
+		received: body,
+	});
+};

fixtures/pages-functions-test/functions/index.ts

@@ -0,0 +1,3 @@
+export const onRequest = () => {
+	return new Response("Hello from the index!");
+};

fixtures/pages-functions-test/package.json

@@ -0,0 +1,14 @@
+{
+	"name": "@fixture/pages-functions-test",
+	"private": true,
+	"scripts": {
+		"build": "node build.mjs",
+		"dev": "node build.mjs && wrangler dev"
+	},
+	"dependencies": {
+		"@cloudflare/pages-functions": "workspace:*"
+	},
+	"devDependencies": {
+		"wrangler": "workspace:*"
+	}
+}

fixtures/pages-functions-test/turbo.json

@@ -0,0 +1,8 @@
+{
+	"extends": ["//"],
+	"tasks": {
+		"build": {
+			"dependsOn": ["@cloudflare/pages-functions#build"]
+		}
+	}
+}

fixtures/pages-functions-test/wrangler.jsonc

@@ -0,0 +1,5 @@
+{
+	"name": "pages-functions-test",
+	"main": "dist/worker.js",
+	"compatibility_date": "2026-01-20",
+}