DC-5244 Cloudflare Worker example (#8388)

* example project created

* test added

* alternate dbs removed

* exmaple project updated

Author: aidankmcalister

.github/tests/orm/cloudflare-workers/run.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+
+set -eu
+
+echo "🔍 Starting test setup..."
+
+echo "📂 Current working directory before REPO_ROOT: $(pwd)"
+echo "📁 Listing contents:"
+ls -la
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+echo "📌 Detected repo root: $REPO_ROOT"
+
+cd "$REPO_ROOT/orm/cloudflare-workers"
+echo "📂 Changed directory to: $(pwd)"
+
+echo "📦 Installing test deps..."
+npm install
+
+# Go to Node script dir and install its deps
+NODE_SCRIPT_DIR="../../.github/get-ppg-dev"
+pushd "$NODE_SCRIPT_DIR" > /dev/null
+npm install
+
+# Start Prisma Dev server
+LOG_FILE="./ppg-dev-url.log"
+rm -f "$LOG_FILE"
+touch "$LOG_FILE"
+
+echo "🚀 Starting Prisma Dev in background..."
+node index.js >"$LOG_FILE" &
+NODE_PID=$!
+
+# Wait for DATABASE_URL
+echo "🔎 Waiting for Prisma Dev to emit DATABASE_URL..."
+MAX_WAIT=60
+WAITED=0
+until grep -q '^prisma+postgres://' "$LOG_FILE"; do
+  sleep 1
+  WAITED=$((WAITED + 1))
+  if [ "$WAITED" -ge "$MAX_WAIT" ]; then
+    echo "❌ Timeout waiting for DATABASE_URL"
+    cat "$LOG_FILE"
+    kill "$NODE_PID" || true
+    exit 1
+  fi
+done
+
+DB_URL=$(grep '^prisma+postgres://' "$LOG_FILE" | tail -1)
+export DATABASE_URL="$DB_URL"
+echo "✅ DATABASE_URL: $DATABASE_URL"
+
+popd > /dev/null
+
+npm install
+npx prisma migrate dev --name init --schema prisma/schema.prisma
+npx prisma db seed
+npm run dev &
+pid=$!
+
+sleep 15
+
+# check frontend
+curl --fail 'http://localhost:3000/'
+
+kill "$pid"
+echo "🛑 App stopped (PID $pid)"
+kill "$NODE_PID"
+wait "$NODE_PID" || true

orm/cloudflare-workers/README.md

@@ -0,0 +1,102 @@
+# Cloudflare Workers Example
+
+This example shows how to implement a simple API using [Cloudflare Workers](https://workers.cloudflare.com) and [Prisma ORM](https://www.prisma.io/docs). The example creates a serverless worker that interacts with a PostgreSQL database to create and count users.
+
+## Getting started
+
+### 1. Download the example and navigate to the project directory
+
+Download this example:
+
+```
+npx try-prisma@latest --template orm/cloudflare-workers
+```
+
+Then navigate to the project directory
+
+```
+cd cloudflare-workers
+```
+
+<details><summary><strong>Alternative:</strong> Clone the entire repo</summary>
+
+Clone this repository:
+
+```
+git clone [email protected]:prisma/prisma-examples.git --depth=1
+```
+
+Install npm dependencies:
+
+```
+cd prisma-examples/orm/cloudflare-workers
+npm install
+```
+
+</details>
+
+### 2. Create a Prisma Postgres instance
+
+This example uses a [Prisma Postgres](https://prisma.io/postgres) database by default. To get started with the project, you will need to setup a Prisma Postgres connection string:
+
+1. Set up a new Prisma Postgres instance in the [Prisma Data Platform Console](https://console.prisma.io) and copy the database connection URL.
+
+2. Add your database url to the `.env`
+
+That's it, your project is now configured to use Prisma Postgres!
+
+
+### 3. Generate Prisma Client
+
+Run the following command to generate the Prisma Client. This is what you will be using to interact with your database.
+
+```
+npm run generate
+```
+
+### 4. Start the Cloudflare Worker
+
+```
+npm run dev
+```
+
+The server is now running at http://localhost:8788
+
+### 5. Test the API
+
+The API supports full CRUD operations. Here are some example `curl` commands:
+
+**Create a user:**
+```bash
+curl -X POST http://localhost:8788/users \
+  -H "Content-Type: application/json" \
+  -d '{"email":"[email protected]","name":"John Doe"}'
+```
+
+**Get all users:**
+```bash
+curl http://localhost:8788/users
+```
+
+**Get a specific user:**
+```bash
+curl http://localhost:8788/users/1
+```
+
+**Update a user:**
+```bash
+curl -X PUT http://localhost:8788/users/1 \
+  -H "Content-Type: application/json" \
+  -d '{"name":"John Updated"}'
+```
+
+**Delete a user:**
+```bash
+curl -X DELETE http://localhost:8788/users/1
+```
+
+## Next steps
+
+- Check out the [Prisma docs](https://www.prisma.io/docs)
+- Share your feedback on the [Prisma Discord](https://pris.ly/discord/)
+- Create issues and ask questions on [GitHub](https://github.com/prisma/prisma/)

orm/cloudflare-workers/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "prisma-cloudflare-worker-3",
+	"version": "0.0.0",
+	"private": true,
+	"scripts": {
+		"deploy": "wrangler deploy",
+		"dev": "wrangler dev",
+		"start": "wrangler dev",
+		"test": "vitest",
+		"cf-typegen": "wrangler types",
+		"migrate": "prisma migrate dev",
+		"generate": "prisma generate",
+		"studio": "prisma studio"
+	},
+	"devDependencies": {
+		"@cloudflare/vitest-pool-workers": "^0.8.19",
+		"@types/pg": "^8.15.6",
+		"dotenv-cli": "^11.0.0",
+		"prisma": "^7.0.0",
+		"typescript": "^5.5.2",
+		"vitest": "~3.2.0",
+		"wrangler": "^4.49.1"
+	},
+	"dependencies": {
+		"@prisma/adapter-pg": "^7.0.0",
+		"@prisma/client": "^7.0.0",
+		"dotenv": "^17.2.3",
+		"pg": "^8.16.3"
+	}
+}

orm/cloudflare-workers/prisma.config.ts

@@ -0,0 +1,14 @@
+// This file was generated by Prisma and assumes you have installed the following:
+// npm install --save-dev prisma dotenv
+import "dotenv/config";
+import { defineConfig, env } from "prisma/config";
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+  },
+  datasource: {
+    url: env("DATABASE_URL"),
+  },
+});

orm/cloudflare-workers/prisma/schema.prisma

@@ -0,0 +1,21 @@
+// This is your Prisma schema file,
+// learn more about it in the docs: https://pris.ly/d/prisma-schema
+
+// Looking for ways to speed up your queries, or scale easily with your serverless or edge functions?
+// Try Prisma Accelerate: https://pris.ly/cli/accelerate-init
+
+generator client {
+  provider = "prisma-client"
+  runtime  = "cloudflare"
+  output   = "../src/generated/prisma"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+
+model User {
+  id    Int    @id @default(autoincrement())
+  email String
+  name  String
+}