feat: Support prisma >6.7 in standard starter (#457)

## Context
* Updates the standard starter
  * to use prisma 6.7
  * to use the new `prisma-client` generator: prisma will now generate code to a gitignored `generated/prisma` dir
  * to use the new `queryCompiler` flag to reduce the size of the WASM (by around ~350KB)

---

## 🔁 Prisma >6.7 migration guide for existing projects

Prisma introduced a new client generator ([`prisma-client`](https://www.prisma.io/docs/orm/prisma-schema/overview/generators#prisma-client-early-access)) that lets us generate a client specific to Cloudflare workers (via workerd runtime) and ESM - this makes for much simpler and less error prone Vite integration.

This guide walks you through upgrading an existing RedwoodSDK Standard Starter project.

### **1\. ✅ Update Dependencies**

Update the following packages in your package.json:

```
- "@prisma/adapter-d1": "~6.5.0",
- "@prisma/client": "~6.5.0",
- "prisma": "~6.5.0",
+ "@prisma/adapter-d1": "~6.8.2",
+ "@prisma/client": "~6.8.2",
+ "prisma": "~6.8.2",
```

Also upgrade wrangler to at least ^4.16.0.

```
- "wrangler": "^4.14.1"
+ "wrangler": "^4.16.0"
```

* * * * *

### **2\. 🧬 Update **

### **schema.prisma**

Change the generator block to use the new prisma-client:

```
-generator client {
-  provider        = "prisma-client-js"
-  previewFeatures = ["driverAdapters"]
-  output          = "../node_modules/.prisma/client"
+generator client {
+  provider = "prisma-client"
+  runtime = "workerd"
+  moduleFormat = "esm"
+  generatedFileExtension = "ts"
+  importFileExtension = "ts"
+  output = "../generated/prisma"
+  previewFeatures = ["queryCompiler", "driverAdapters"]
}
```

* * * * *

### **3\. 🗂️ Adjust TypeScript Paths**

In tsconfig.json:

```
- ".prisma/*": ["./node_modules/.prisma/*"]
+"@/*": ["./src/*"],
+ "@generated/*": ["./generated/*"]
```

Then update imports from `@prisma/client` to `@/db.`

* * * * *

### **4\. 🛠️ Refactor DB Client Usage**

Replace your `src/db.ts` with the latest in the standard starter: 

https://github.com/redwoodjs/sdk/blob/main/starters/standard/src/db.ts

* * * * *

### 5\. 📁 Add to **.gitignore**

```
+generated/
```

* * * * *

### **6\. 📦 Re-generate Client**

After updating schema.prisma:

```
pnpm prisma generate
```

* * * * *

### **7\. 🧪 Test Everything**

Check your queries work in development and deployments.

---

## Notes
### Steps taken
https://gist.github.com/justinvdm/24a9f316f7c5148be852c4660e5f0481

### Update: 21 May 2025
- Submitted PR for the relevant fix required in `@cloudflare/vite-plugin`: cloudflare/workers-sdk#9322
- Got this PR working on both prisma <6.7 and >6.7 (assuming cloudflare/workers-sdk#9322 fix is in and PR upgraded to use it)
- See [action log](https://gist.github.com/justinvdm/24a9f316f7c5148be852c4660e5f0481) for more detail on steps taken

### Update: 19 May 2025
-   **Goal**: ==Upgrade to Prisma >=6.7, remove Prisma-specific Vite logic from RedwoodSDK, avoid WASM if possible, and maintain backwards compatibility.

-   **Steps Taken**:

    -   Upgraded to Prisma 6.8.2 with queryCompiler and driverAdapters.

    -   Tried out different vite configurations and aliases to target new Prisma client structure.

    -   Tested various entry points (edge.js, index.js, wasm.js) and generation configs

    -   Validated new `prisma-client` generator for `workerd` + `esm `output.

-   **Current Status**: Generated client works and loads in dev with SDK changes. DB client instantiation succeeds. Queries fail due to WASM module resolution error during runtime.

-   **Blocking Issue**: Cloudflare's Vite plugin fails to resolve Prisma's WASM module path, likely due to pnpm's path format (`__`) interfering with Cloudflare's module detection regex. Investigating patch to regex logic in `@cloudflare/vite-plugin`.

-   **Findings**:
    -   **Not WASM free (yet?):** Prisma is not WASM free yet, but they're gradually moving the components out of rust into ts. There's still a **1.66MB** wasm file we must work with. Previously it was **2MB**.

    -   **Cloudflare's plugin appears to mangle WASM imports** when the file path includes double underscores (__), likely due to greedy regex

    -   **Switching to Prisma's new ESM generator is promising** for us to avoid complexities - e.g. we can avoid having to get optimizeDeps to esm-ify the `require`s in the generated prisma client (though we'll still need some logic for <6.7)

-   **Next Step**: Investigate patch, then corresponding PR for Cloudflare's Vite plugin to fix its WASM module resolution regex handling for __ in paths.

Author: justinvdm

pnpm-lock.yaml

@@ -1,4 +1,6 @@
 import enhancedResolve from "enhanced-resolve";
+import { pathExists } from "fs-extra";
+import { resolve } from "path";
 
 export type PrismaCheckResult = {
   isUsingPrisma: boolean;

sdk/src/vite/checkIsUsingPrisma.mts

@@ -30,7 +30,7 @@
     "@types/react-dom": "^19.1.2",
     "typescript": "^5.8.3",
     "vite": "^6.2.6",
-    "wrangler": "^4.14.1"
+    "wrangler": "^4.16.0"
   },
   "pnpm": {
     "onlyBuiltDependencies": [

starters/minimal/package.json

@@ -63,4 +63,6 @@ coverage
 *.tmp
 *.temp
 
-.wrangler
+.wrangler
+
+generated/

starters/standard/.gitignore

@@ -27,8 +27,8 @@
     "prepare": "vibe-rules install cursor"
   },
   "dependencies": {
-    "@prisma/adapter-d1": "~6.5.0",
-    "@prisma/client": "~6.5.0",
+    "@prisma/adapter-d1": "~6.8.2",
+    "@prisma/client": "~6.8.2",
     "@simplewebauthn/browser": "^13.1.0",
     "@simplewebauthn/server": "^13.1.1",
     "rwsdk": "0.0.84-test.20250522031443"
@@ -37,11 +37,11 @@
     "@types/node": "^22.14.0",
     "@types/react": "^19.1.2",
     "@types/react-dom": "^19.1.2",
-    "prisma": "~6.5.0",
+    "prisma": "~6.8.2",
     "typescript": "^5.8.3",
     "vibe-rules": "^0.2.31",
     "vite": "^6.2.6",
-    "wrangler": "^4.14.1"
+    "wrangler": "^4.16.0"
   },
   "pnpm": {
     "onlyBuiltDependencies": [

starters/standard/package.json

@@ -5,10 +5,15 @@
 // Try Prisma Accelerate: https://pris.ly/cli/accelerate-init
 
 generator client {
-  provider        = "prisma-client-js"
-  previewFeatures = ["driverAdapters"]
-  output          = "../node_modules/.prisma/client"
+  provider = "prisma-client"
 
+  runtime                = "workerd"
+  moduleFormat           = "esm"
+  generatedFileExtension = "ts"
+  importFileExtension    = "ts"
+
+  output          = "../generated/prisma"
+  previewFeatures = ["queryCompiler", "driverAdapters"]
 }
 
 datasource db {

starters/standard/prisma/schema.prisma

@@ -1,15 +1,23 @@
-import { PrismaClient } from "@prisma/client";
+import { PrismaClient } from "@generated/prisma";
 import { PrismaD1 } from "@prisma/adapter-d1";
-import { env } from "cloudflare:workers";
+
+export type * from "@generated/prisma";
 
 export let db: PrismaClient;
 
-// context(justinvdm, 21-05-2025): For prisma-client-js generator or cases where
+// context(justinvdm, 21-05-2025):
+// We need to instantiate the client via a function rather that at the module level for several reasons:
+// * For prisma-client-js generator or cases where
 // there are dynamic import to the prisma wasm modules, we need to make sure we
 // are instantiating the prisma client later in the flow when the wasm would
-// have been initialized.
-export const setupDb = async () => {
+// have been initialized
+// * So that we can encapsulate workarounds, e.g. see `SELECT 1` workaround below
+export const setupDb = async (env: Env) => {
   db = new PrismaClient({
+    // context(justinvdm, 21-05-2025): prisma-client generated type appears to
+    // consider D1 adapter incompatible, though in runtime (dev and production)
+    // it works
+    // @ts-ignore
     adapter: new PrismaD1(env.DB),
   });
 

starters/standard/src/db.ts

@@ -1,8 +1,9 @@
 import { defineScript } from "rwsdk/worker";
 import { db, setupDb } from "@/db";
+import { env } from "cloudflare:workers";
 
 export default defineScript(async () => {
-  await setupDb();
+  await setupDb(env);
 
   await db.$executeRawUnsafe(`\
     DELETE FROM User;

starters/standard/src/scripts/seed.ts

@@ -6,8 +6,7 @@ import { setCommonHeaders } from "@/app/headers";
 import { userRoutes } from "@/app/pages/user/routes";
 import { sessions, setupSessionStore } from "./session/store";
 import { Session } from "./session/durableObject";
-import { db, setupDb } from "./db";
-import type { User } from "@prisma/client";
+import { type User, db, setupDb } from "@/db";
 import { env } from "cloudflare:workers";
 export { SessionDurableObject } from "./session/durableObject";
 
@@ -19,8 +18,8 @@ export type AppContext = {
 export default defineApp([
   setCommonHeaders(),
   async ({ ctx, request, headers }) => {
+    await setupDb(env);
     setupSessionStore(env);
-    await setupDb();
 
     try {
       ctx.session = await sessions.load(request);

starters/standard/src/worker.tsx

@@ -21,7 +21,7 @@
     ],
     "paths": {
       "@/*": ["./src/*"],
-      ".prisma/*": ["./node_modules/.prisma/*"]
+      "@generated/*": ["./generated/*"]
     },
     /* Enable importing .json files */
     "resolveJsonModule": true,