Add an example for importing cloudflare:* modules (#1067)

Author: vicb

examples/playground15/app/api/cloudflare/route.ts

@@ -0,0 +1,17 @@
+import module from "node:module";
+
+export const dynamic = "force-dynamic";
+
+export async function GET() {
+	if (globalThis.Cloudflare) {
+		// Importing `cloudflare:*` does not work in dev (using `next dev`) because the Node runtime is used there.
+		// Then you should avoid it to write portable code.
+		// To access `env` and bindings, using `getCloudflareContext()` is the preferred way.
+		// See https://opennext.js.org/cloudflare/bindings
+		const req = module.createRequire("file:///");
+		const { env } = req("cloudflare:workers");
+		return Response.json({ cloudflare: true, env });
+	}
+
+	return Response.json({ cloudflare: false });
+}

examples/playground15/e2e/cloudflare.spec.ts

@@ -14,3 +14,14 @@ test.describe("playground/cloudflare", () => {
 		expect(nextConfig.output).toEqual("standalone");
 	});
 });
+
+test.describe("using cloudflare:* modules", () => {
+	test("NextConfig", async ({ page }) => {
+		const res = await page.request.get("/api/cloudflare");
+		expect(res.status()).toEqual(200);
+		const { cloudflare, env } = await res.json();
+		expect(cloudflare).toBe(true);
+		expect(env.NEXTJS_ENV).toEqual("development");
+		expect(env.ASSETS).toBeDefined();
+	});
+});