Upgrade Prisma from 5.20.0 to 6.2.0

[Philzen]

See https://www.prisma.io/docs/orm/more/upgrade-guides/upgrading-versions/upgrading-to-prisma-6

Especially 6.2 brings exciting new features, most importantly json and enum fields for SQLite, but also the omit-feature (the antagonist to include), the updateManyAndReturn batch function, or the support for auto-generated cuid2 and ulid values.

For a quick overview of the new features and improvements since 5.20, refer to the release notes:

• https://github.com/prisma/prisma/releases/tag/6.2.0
• https://github.com/prisma/prisma/releases/tag/6.1.0
• https://github.com/prisma/prisma/releases/tag/6.0.0
• https://github.com/prisma/prisma/releases/tag/5.22.0
• https://github.com/prisma/prisma/releases/tag/5.21.0

This is, of course, a candidate for the next major version of RedwoodJS. The migration process looks smooth, we should never- theless start on a writeup to highlight the new features and the most important migration steps.

---

TODOs:

• Convert prisma-related Buffers to Uint8Arrays

  • redwood/packages/cli/src/commands/generate/service/service.js

    Lines 69 to 70 in 1260433

    	case 'Bytes':
    	return `Buffer.from([${randIntArray}])`

  • redwood/packages/cli/src/commands/generate/service/service.js

    Line 165 in 1260433

    return jsonString.replace(/"Buffer\.from\(([^)]+)\)"/g, 'Buffer.from($1)')

  • redwood/packages/cli/src/commands/generate/service/templates/test.ts.template

    Line 32 in 1260433

    return jsonString.replace(/"Buffer\.from\(([^)]+)\)"/g, 'Buffer.from($1)')

  • redwood/packages/cli/src/commands/generate/helpers.js

    Line 313 in 1260433

    Bytes: 'Buffer',

  • Check "internal"-package graphqlCodeGen (i can't exactly pin it down, but there is also a mapping from GraphQL Byte → Prisma Buffer), but there is a test and the mapping object in the generator implementation:

    • redwood/packages/internal/src/__tests__/graphqlCodeGen.test.ts

      Line 95 in 1260433

      expect(data).toContain('Byte: Buffer;')

    • redwood/packages/internal/src/generate/graphqlCodeGen.ts

      Line 295 in 1260433

      Byte: 'Buffer',

  • Check DBAuthHandler (not sure about those)

    • redwood/packages/auth-providers/dbAuth/api/src/DbAuthHandler.ts

      Line 1056 in 1260433

      Buffer.from(credentialPublicKey),

    • redwood/packages/auth-providers/dbAuth/api/src/__tests__/DbAuthHandler.fetch.test.js

      Line 2234 in 1260433

      publicKey: Buffer.from([

    • redwood/packages/auth-providers/dbAuth/api/src/__tests__/DbAuthHandler.fetch.test.js

      Line 2502 in 1260433

      body: Buffer.from(

    • redwood/packages/auth-providers/dbAuth/api/src/__tests__/DbAuthHandler.test.js

      Line 603 in 1260433

      body: Buffer.from(`{"foo":"bar", "baz":123}`, 'utf8'),

    • redwood/packages/auth-providers/dbAuth/api/src/__tests__/DbAuthHandler.test.js

      Line 2050 in 1260433

      publicKey: Buffer.from([

    • redwood/packages/auth-providers/dbAuth/api/src/__tests__/DbAuthHandler.test.js

      Line 2299 in 1260433

      body: Buffer.from(

  • confirm all other occurences of Buffer are not prisma-related
• Codemods?
  • convert Buffer inputs on any byte datatypes
  • remove fulltextIndex preview option
  • migrate fulltextSearch preview option for Postgres and drop it for MySQL
  • Migrate NotfoundError to PrismaClientKnownRequestError
• Release Notes:
  • Describe Codemods
  • Explain Breaking changes potentially requiring attention
    • Mention newly forbidden keywords
    • Mention schema change for implicit m-n relations on PostgreSQL
  • Most importantly: mention all the awesome new features since 5.20!
    • enum and JSON field type support for SQLite
    • omit
    • support for auto-generated cuid2 and ulid values
    • updateManyAndReturn
    • …

[Tobbe]

Thanks for getting started on this. Very exciting! Would love to be able to upgrade to the latest Prisma version

[Philzen]

This was a whole lot simpler than expected :)

Also yarn rwfw'd my main project against this branch which worked without any hiccups.

[Tobbe]

Looking at the breaking changes for Prisma v6 this one stood out to me

Usage of Buffer
Prisma v6 replaces the usage of Buffer with Uint8Array to represent fields of type Bytes. Make sure to replace all your occurrences of the Buffer type with the new Uint8Array.

I'm worried/concerned about how that might affect the Prisma <-> GQL type mapping. Might be a non-issue. But I'd like us to look into at least, before we merge this PR.

And we should also think about any codemods we could write for any of the breaking changes they've listed.
And of course what our release and update notes should be for this

[Philzen]

I'm worried/concerned about how that might affect the Prisma <-> GQL type mapping. Might be a non-issue. But I'd like us to look into at least, before we merge this PR.

That's a great catch that seems to definitely apply – I did a little scan and started a checklist in the PR description, not sure if that is the best medium to do this in a structured manner (if you have the access rights to edit it, that would be sort of practical).

The necessary changes seem obvious. but i would love someone to do it who can also end-to-end test these and knows what they're doing. 😉

[Tobbe]

if you have the access rights to edit it

I do 🙂 ✏️

and knows what they're doing

Not me! 😅