feat(prisma)!: Prisma v7 (#1337)

Author: Tobbe

.changesets/release_notes_major.md

@@ -5,6 +5,31 @@ prisma.config.cjs. The config is for the cli.
 Need to remove it from `schema.prisma` and add it to the config file. Point to
 Prisma docs for this.
 
+## SQLite `DATABASE_URL` path change
+
+If your project uses SQLite, update your `DATABASE_URL` from:
+
+- `file:./dev.db`
+
+to:
+
+- `file:./db/dev.db`
+
+This keeps the SQLite database file in `api/db/dev.db`, which is where Cedar's
+Prisma 7 setup expects it to live.
+
+In practice, this means updating the value in the env file your project uses,
+for example:
+
+```js
+DATABASE_URL=file:./db/dev.db
+```
+
+If you leave the old value in place, Prisma CLI commands and runtime database
+access can end up pointing at different files, which may show up as errors like
+"table does not exist" even though the expected tables exist in another SQLite
+file.
+
 Testing potentially works differently. If you just have `DATABASE_URL` in your
 prisma.config.cjs file, it will be replaced by `TEST_DATABASE_URL` just like
 before. But if you need a specific `directUrl`, you should put that in your

.github/actions/set-up-rsc-project/setUpRscProject.mts

@@ -5,6 +5,24 @@ import type { ExecOptions } from '@actions/exec'
 
 import { CEDAR_FRAMEWORK_PATH } from '../actionsLib.mjs'
 
+const CEDAR_APP_TEMPLATE_PATH = path.join(
+  CEDAR_FRAMEWORK_PATH,
+  'packages',
+  'create-cedar-app',
+  'templates',
+  'ts',
+)
+
+const PRISMA_SCHEMA_DATASOURCE_URL_OLD = /^\s*url\s*=\s*env\([^)]*\)\s*\n/m
+
+const CEDAR_APP_TEMPLATE_API_PACKAGE_JSON_PATH = path.join(
+  CEDAR_APP_TEMPLATE_PATH,
+  'api',
+  'package.json',
+)
+
+const PRISMA_SCHEMA_GENERATOR_OLD = /generator client \{[^}]*\}/s
+
 /**
  * Exec a command.
  * Output will be streamed to the live console.
@@ -95,7 +113,100 @@ async function setUpRscProject(
   })
   console.log()
 
+  // TODO: Remove this block once Prisma v7 support has been merged into a
+  // canary release of create-cedar-app, at which point the created project
+  // will already be Prisma v7 compatible.
+  console.log('Updating project for Prisma v7 compatibility')
+  updateProjectForPrisma7(rscProjectPath)
+  console.log()
+
+  console.log('Installing new Prisma v7 dependencies')
+  await execInProject('yarn install')
+  console.log()
+
   console.log(`Building project in ${rscProjectPath}`)
   await execInProject(`node ${cedarBinPath} build -v`)
   console.log()
 }
+
+/**
+ * @param {string} rscProjectPath
+ * @returns {void}
+ */
+function updateProjectForPrisma7(rscProjectPath) {
+  // Copy prisma.config.cjs from template (Prisma v7 format)
+  const prismaConfigPath = path.join(rscProjectPath, 'api', 'prisma.config.cjs')
+  fs.copyFileSync(
+    path.join(CEDAR_APP_TEMPLATE_PATH, 'api', 'prisma.config.cjs'),
+    prismaConfigPath,
+  )
+  console.log('  Updated api/prisma.config.cjs')
+
+  // Update schema.prisma: remove datasource url line and replace generator block
+  // (Can't copy the template wholesale because the project has extra models from
+  // the RSC setup steps.)
+  const schemaPath = path.join(rscProjectPath, 'api', 'db', 'schema.prisma')
+  const templateSchema = fs.readFileSync(
+    path.join(CEDAR_APP_TEMPLATE_PATH, 'api', 'db', 'schema.prisma'),
+    'utf8',
+  )
+  const generatorMatch = templateSchema.match(PRISMA_SCHEMA_GENERATOR_OLD)
+  const templateGenerator = generatorMatch ? generatorMatch[0] : null
+  if (!templateGenerator) {
+    throw new Error('Could not find generator block in template schema.prisma')
+  }
+  const schemaContent = fs.readFileSync(schemaPath, 'utf8')
+  const updatedSchema = schemaContent
+    .replace(PRISMA_SCHEMA_DATASOURCE_URL_OLD, '')
+    .replace(PRISMA_SCHEMA_GENERATOR_OLD, templateGenerator)
+  fs.writeFileSync(schemaPath, updatedSchema, 'utf8')
+  console.log('  Updated api/db/schema.prisma')
+
+  // Copy api/src/lib/db.ts from template (Prisma v7 client initialisation)
+  const dbTsPath = path.join(rscProjectPath, 'api', 'src', 'lib', 'db.ts')
+  fs.copyFileSync(
+    path.join(CEDAR_APP_TEMPLATE_PATH, 'api', 'src', 'lib', 'db.ts'),
+    dbTsPath,
+  )
+  console.log('  Updated api/src/lib/db.ts')
+
+  // Copy api/tsconfig.json from template (Prisma v7 / Node16 module resolution)
+  const apiTsconfigPath = path.join(rscProjectPath, 'api', 'tsconfig.json')
+  fs.copyFileSync(
+    path.join(CEDAR_APP_TEMPLATE_PATH, 'api', 'tsconfig.json'),
+    apiTsconfigPath,
+  )
+  console.log('  Updated api/tsconfig.json')
+
+  // Merge @prisma/adapter-better-sqlite3 and better-sqlite3 from template into
+  // api/package.json (the canary-generated project won't have these deps)
+  const apiPackageJsonPath = path.join(rscProjectPath, 'api', 'package.json')
+  const apiPackageJson = JSON.parse(fs.readFileSync(apiPackageJsonPath, 'utf8'))
+  const templateApiPackageJson = JSON.parse(
+    fs.readFileSync(CEDAR_APP_TEMPLATE_API_PACKAGE_JSON_PATH, 'utf8'),
+  )
+  const depsToAdd = ['@prisma/adapter-better-sqlite3', 'better-sqlite3']
+  for (const dep of depsToAdd) {
+    apiPackageJson.dependencies[dep] = templateApiPackageJson.dependencies[dep]
+  }
+  fs.writeFileSync(
+    apiPackageJsonPath,
+    JSON.stringify(apiPackageJson, null, 2) + '\n',
+    'utf8',
+  )
+  console.log('  Updated api/package.json')
+
+  // Copy scripts/tsconfig.json from template (Prisma v7 / Node16 module resolution)
+  const scriptsTsconfigPath = path.join(
+    rscProjectPath,
+    'scripts',
+    'tsconfig.json',
+  )
+  if (fs.existsSync(scriptsTsconfigPath)) {
+    fs.copyFileSync(
+      path.join(CEDAR_APP_TEMPLATE_PATH, 'scripts', 'tsconfig.json'),
+      scriptsTsconfigPath,
+    )
+    console.log('  Updated scripts/tsconfig.json')
+  }
+}

.github/actions/set-up-test-project-esm/setUpTestProjectEsm.mjs

@@ -66,6 +66,9 @@ async function setUpTestProjectEsm({ canary }) {
 
   console.log('Running prisma migrate reset')
   await execInProject('yarn cedar prisma migrate reset --force')
+
+  console.log('Running prisma db seed')
+  await execInProject('yarn cedar prisma db seed')
 }
 
 setUpTestProjectEsm({ canary })

.github/actions/set-up-test-project/setUpTestProject.mts

@@ -74,4 +74,7 @@ export async function setUpTestProject({
 
   console.log('Running prisma migrate reset')
   await execInProject('yarn cedar prisma migrate reset --force')
+
+  console.log('Running prisma db seed')
+  await execInProject('yarn cedar prisma db seed')
 }

__fixtures__/empty-project/.env.defaults

@@ -4,7 +4,7 @@
 # into version control.
 
 # schema.prisma defaults
-DATABASE_URL=file:./dev.db
+DATABASE_URL=file:./db/dev.db
 
 # location of the test database for api service scenarios (defaults to ./.redwood/test.db if not set)
 # TEST_DATABASE_URL=file:./.redwood/test.db

__fixtures__/empty-project/api/db/schema.prisma

@@ -1,7 +1,5 @@
 datasource db {
-  provider  = "sqlite"
-  url       = env("DATABASE_URL")
-  directUrl = env("DIRECT_URL")
+  provider = "sqlite"
 }
 
 generator client {

__fixtures__/esm-test-project/.env.defaults

@@ -4,7 +4,7 @@
 # into version control.
 
 # schema.prisma defaults
-DATABASE_URL=file:./dev.db
+DATABASE_URL=file:./db/dev.db
 
 # location of the test database for api service scenarios (defaults to ./.redwood/test.db if not set)
 # TEST_DATABASE_URL=file:./.redwood/test.db

__fixtures__/esm-test-project/.gitignore

@@ -7,6 +7,7 @@
 .redwood/*
 !.redwood/README.md
 dev.db*
+api/db/generated/prisma
 dist
 dist-babel
 node_modules

__fixtures__/esm-test-project/api/db/schema.prisma

@@ -6,12 +6,14 @@
 
 datasource db {
   provider = "sqlite"
-  url      = env("DATABASE_URL")
 }
 
 generator client {
-  provider      = "prisma-client-js"
-  binaryTargets = "native"
+  provider               = "prisma-client"
+  output                 = "./generated/prisma"
+  moduleFormat           = "cjs"
+  generatedFileExtension = "mts"
+  importFileExtension    = "mts"
 }
 
 // Define your own datamodels here and run `yarn cedar prisma migrate dev`

__fixtures__/esm-test-project/api/package.json

@@ -6,6 +6,8 @@
   "dependencies": {
     "@cedarjs/api": "2.8.0",
     "@cedarjs/auth-dbauth-api": "2.8.0",
-    "@cedarjs/graphql-server": "2.8.0"
+    "@cedarjs/graphql-server": "2.8.0",
+    "@prisma/adapter-better-sqlite3": "7.4.2",
+    "better-sqlite3": "12.6.2"
   }
 }