ossrules.md

prisma-8

Use when working in a project that depends on @prisma/orm-postgres, @prisma/orm-sqlite, or @prisma/orm-mongo (Prisma 8, formerly Prisma Next): editing contract.prisma or a contract.ts builder, running `prisma contract emit`, planning or applying migrations, editing migration.ts, writing db.orm / db.sql / db.query queries, wiring db.ts or middleware, integrating a build tool, using the Supabase extension or RLS, or reading a dotted error code such as MIGRATION.HASH_MISMATCH. Use when the user asks "what is Prisma 8", "where do I start", or compares it to another ORM. Use when the user asks to upgrade or bump Prisma 8 in an app or an extension package. Use when you see @internal/* or @prisma/orm-* imports, prisma.config.ts with definePrismaConfig, or contract.json / contract.d.ts. Do not use for Prisma ORM 7 or earlier (schema.prisma + @prisma/client).

Install
npx skills add 'https://github.com/prisma/orm/tree/main/skills/prisma-8'
Download bundle ↓
main · fac8604 ↗Scanned 2026-09-17

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

upgrading/extension/upgrades/8.0.0-rc.6-to-8.0.0-rc.7/instructions.md

upgrading/extension/upgrades/8.0.0-rc.6-to-8.0.0-rc.7/instructions.mdBrowse 76 files
View on GitHub
483 tokens

1,924 bytes
Token encoding: o200k_base
Snapshot fac8604

← Back to SKILL.md

from: "8.0.0-rc.6" to: "8.0.0-rc.7" changes:

  • id: rename-orm-pagination-methods summary: | Rename ORM collection pagination calls from .take(n) to .limit(n) and from .skip(n) to .offset(n). This applies to SQL and Mongo ORM collections, including relation refinements and grouped SQL collections. Do not rename Mongo query-builder .skip(n) calls: that lower-level API continues to mirror the $skip pipeline stage.
  • id: contract-space-restamp summary: | The emitted contract.json / contract.d.ts embed the toolchain version, which moves to 8.0.0-rc.7. Rebuild the extension's contract space (the package's build:contract-space script) once after upgrading so the emitted artifacts match the installed toolchain. The toolchain also re-released against @prisma/cli-engine@0.2.3 (a CLI-side change with no ORM-facing surface). detection: glob: "**/contract.json" contains: - '"version": "8.0.0-rc.6"'

8.0.0-rc.6 → 8.0.0-rc.7 — Extension author upgrade instructions

rename-orm-pagination-methods

Find calls on Prisma 8 ORM collections in extension source and tests, then apply these translations:

  • .take(n) → .limit(n)
  • .skip(n) → .offset(n)

Apply the same translation inside include(...) refinement callbacks, combine(...) branches, and after SQL ORM groupBy(...). Leave Mongo query-builder chains that start from mongoQuery(...).from(...) or an equivalent query-builder factory unchanged: their .limit(...) and .skip(...) methods name Mongo aggregation pipeline stages rather than the ORM collection API.

contract-space-restamp

For every contract.json matched by detection, run the extension package's build:contract-space script (or its emit command) once after upgrading. The only expected diff beyond the pagination rename is the embedded version moving to 8.0.0-rc.7.

← All Prisma ORM skillsProject instructions →