prisma-upgrade-v7-esm-support

ESM Support

Prisma ORM v7 ships as an ES module only. Your project must be configured for ESM.

Required Changes

package.json

Add the type field:

{
  "type": "module",
  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js"
  }
}

tsconfig.json

Configure for ESM:

{
  "compilerOptions": {

Alternative: Node16/NodeNext

Import Syntax Changes

Named imports

File extensions

With moduleResolution: "Node16", add .js extensions:

With moduleResolution: "bundler", extensions are optional.

Minimum Versions

CommonJS Compatibility

If you must use CommonJS:

Dynamic import

Separate ESM file

Create an ESM wrapper:

Framework Considerations

Next.js

Next.js supports ESM. Ensure next.config.js → next.config.mjs:

Express

Update entry point:

Jest

Configure Jest for ESM:

Or use Vitest which has native ESM support.

Troubleshooting

"ERR_REQUIRE_ESM"

Your code is using require() on an ESM module. Switch to import.

"Cannot use import statement outside a module"

Add "type": "module" to package.json.

TypeScript compilation errors

Ensure module and moduleResolution are set correctly in tsconfig.json.