TML-2790: M:N SQLite demo examples + project plan expansion (slices 4–6) by tensordreams · Pull Request #742 · prisma/prisma-next

tensordreams · 2026-06-05T15:04:39Z

Supersedes #697 — that PR was auto-marked merged by GitHub when a botched force-push briefly made its head identical to its base (nothing was actually merged; the branch content is unchanged). Same commits, same review state.

Follow-on to the SQL ORM: Many-to-Many End to End project: M:N demo examples + the project-plan expansion they surfaced.

Stacked PR — top of the M:N stack: tml-2787 (#683) → … → tml-2729 (#667) → main (the whole stack is rebased onto the latest main).

SQLite demo M:N examples (`72ef8b793`, `883309ecc`)

The SQLite demo (examples/prisma-next-demo-sqlite, TS-authored) now demonstrates the full M:N ORM API via a pure Post ↔ Tag junction (PostTag):

Read: get-post-tags — .include(tags, t => t.select(...)).
Filter: get-posts-by-tag-filter — .where(p => p.tags.some/none/every(t => t.label.eq(...))).
Write (callback mutator): connect-post-tags / disconnect-post-tags / create-post-with-tags — .update/.create({ tags: t => t.connect/disconnect/create([...]) }) with readback.

Wired as 6 CLI commands + seed; smoke-tested end-to-end (SQLite is offline-runnable); emitted contract carries cardinality:N:M + through; emit:check + typecheck clean.

Why only SQLite (and the plan expansion) (`d711adfb6`)

Adding examples surfaced a real gap: the navigable M:N API is authorable only via the TS contract builder (rel.manyToMany), not PSL — PSL emits only 1:N/N:1 and routes M:N to explicit junction models. The PG demo emits from PSL, so it cant show M:N until PSL learns to author it. So:

Filed TML-2794 — PSL many-to-many authoring (the framework gap).
Filed TML-2795 — PG demo M:N examples + pre-existing dual-mode contract drift (blocked by TML-2794).
Amended the project spec + plan with follow-on slices 4–6 (SQLite examples [done], PSL M:N authoring [planned], PG demo [planned]) + slice specs/plans. Slice 5 is framework-scoped and flagged for possible promotion to its own project.

Scope / notes

This PR ships the SQLite examples + the planning docs only. PG demo examples + PSL authoring are tracked (TML-2794/2795) and specd but not implemented here. No production src/ changes — demo + project-docs only.

Refs: TML-2790.

coderabbitai · 2026-06-05T15:04:47Z

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 5275409b-1915-41be-bc03-f9eb5f550624

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch tml-2790-mn-demo-examples

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

github-actions · 2026-06-05T15:05:50Z

size-limit report 📦

Path	Size
postgres / no-emit	151.72 KB (0%)
postgres / emit	120.48 KB (0%)
mongo / no-emit	76.67 KB (0%)
mongo / emit	70.96 KB (0%)
cf-worker / no-emit	179.96 KB (0%)
cf-worker / emit	145.48 KB (0%)

pkg-pr-new · 2026-06-05T15:07:38Z

Open in StackBlitz

@prisma-next/extension-author-tools

npm i https://pkg.pr.new/@prisma-next/extension-author-tools@742

@prisma-next/mongo-runtime

npm i https://pkg.pr.new/@prisma-next/mongo-runtime@742

@prisma-next/family-mongo

npm i https://pkg.pr.new/@prisma-next/family-mongo@742

@prisma-next/sql-runtime

npm i https://pkg.pr.new/@prisma-next/sql-runtime@742

@prisma-next/family-sql

npm i https://pkg.pr.new/@prisma-next/family-sql@742

@prisma-next/extension-arktype-json

npm i https://pkg.pr.new/@prisma-next/extension-arktype-json@742

@prisma-next/middleware-cache

npm i https://pkg.pr.new/@prisma-next/middleware-cache@742

@prisma-next/mongo

npm i https://pkg.pr.new/@prisma-next/mongo@742

@prisma-next/extension-paradedb

npm i https://pkg.pr.new/@prisma-next/extension-paradedb@742

@prisma-next/extension-pgvector

npm i https://pkg.pr.new/@prisma-next/extension-pgvector@742

@prisma-next/extension-postgis

npm i https://pkg.pr.new/@prisma-next/extension-postgis@742

@prisma-next/postgres

npm i https://pkg.pr.new/@prisma-next/postgres@742

@prisma-next/sql-orm-client

npm i https://pkg.pr.new/@prisma-next/sql-orm-client@742

@prisma-next/sqlite

npm i https://pkg.pr.new/@prisma-next/sqlite@742

@prisma-next/extension-supabase

npm i https://pkg.pr.new/@prisma-next/extension-supabase@742

@prisma-next/target-mongo

npm i https://pkg.pr.new/@prisma-next/target-mongo@742

@prisma-next/adapter-mongo

npm i https://pkg.pr.new/@prisma-next/adapter-mongo@742

@prisma-next/driver-mongo

npm i https://pkg.pr.new/@prisma-next/driver-mongo@742

@prisma-next/contract

npm i https://pkg.pr.new/@prisma-next/contract@742

@prisma-next/utils

npm i https://pkg.pr.new/@prisma-next/utils@742

@prisma-next/config

npm i https://pkg.pr.new/@prisma-next/config@742

@prisma-next/errors

npm i https://pkg.pr.new/@prisma-next/errors@742

@prisma-next/framework-components

npm i https://pkg.pr.new/@prisma-next/framework-components@742

@prisma-next/operations

npm i https://pkg.pr.new/@prisma-next/operations@742

@prisma-next/ts-render

npm i https://pkg.pr.new/@prisma-next/ts-render@742

@prisma-next/contract-authoring

npm i https://pkg.pr.new/@prisma-next/contract-authoring@742

@prisma-next/ids

npm i https://pkg.pr.new/@prisma-next/ids@742

@prisma-next/psl-parser

npm i https://pkg.pr.new/@prisma-next/psl-parser@742

@prisma-next/psl-printer

npm i https://pkg.pr.new/@prisma-next/psl-printer@742

@prisma-next/cli

npm i https://pkg.pr.new/@prisma-next/cli@742

@prisma-next/cli-telemetry

npm i https://pkg.pr.new/@prisma-next/cli-telemetry@742

@prisma-next/emitter

npm i https://pkg.pr.new/@prisma-next/emitter@742

@prisma-next/migration-tools

npm i https://pkg.pr.new/@prisma-next/migration-tools@742

prisma-next

npm i https://pkg.pr.new/prisma-next@742

@prisma-next/vite-plugin-contract-emit

npm i https://pkg.pr.new/@prisma-next/vite-plugin-contract-emit@742

@prisma-next/mongo-codec

npm i https://pkg.pr.new/@prisma-next/mongo-codec@742

@prisma-next/mongo-contract

npm i https://pkg.pr.new/@prisma-next/mongo-contract@742

@prisma-next/mongo-value

npm i https://pkg.pr.new/@prisma-next/mongo-value@742

@prisma-next/mongo-contract-psl

npm i https://pkg.pr.new/@prisma-next/mongo-contract-psl@742

@prisma-next/mongo-contract-ts

npm i https://pkg.pr.new/@prisma-next/mongo-contract-ts@742

@prisma-next/mongo-emitter

npm i https://pkg.pr.new/@prisma-next/mongo-emitter@742

@prisma-next/mongo-schema-ir

npm i https://pkg.pr.new/@prisma-next/mongo-schema-ir@742

@prisma-next/mongo-query-ast

npm i https://pkg.pr.new/@prisma-next/mongo-query-ast@742

@prisma-next/mongo-orm

npm i https://pkg.pr.new/@prisma-next/mongo-orm@742

@prisma-next/mongo-query-builder

npm i https://pkg.pr.new/@prisma-next/mongo-query-builder@742

@prisma-next/mongo-lowering

npm i https://pkg.pr.new/@prisma-next/mongo-lowering@742

@prisma-next/mongo-wire

npm i https://pkg.pr.new/@prisma-next/mongo-wire@742

@prisma-next/sql-contract

npm i https://pkg.pr.new/@prisma-next/sql-contract@742

@prisma-next/sql-errors

npm i https://pkg.pr.new/@prisma-next/sql-errors@742

@prisma-next/sql-operations

npm i https://pkg.pr.new/@prisma-next/sql-operations@742

@prisma-next/sql-schema-ir

npm i https://pkg.pr.new/@prisma-next/sql-schema-ir@742

@prisma-next/sql-contract-psl

npm i https://pkg.pr.new/@prisma-next/sql-contract-psl@742

@prisma-next/sql-contract-ts

npm i https://pkg.pr.new/@prisma-next/sql-contract-ts@742

@prisma-next/sql-contract-emitter

npm i https://pkg.pr.new/@prisma-next/sql-contract-emitter@742

@prisma-next/sql-lane-query-builder

npm i https://pkg.pr.new/@prisma-next/sql-lane-query-builder@742

@prisma-next/sql-relational-core

npm i https://pkg.pr.new/@prisma-next/sql-relational-core@742

@prisma-next/sql-builder

npm i https://pkg.pr.new/@prisma-next/sql-builder@742

@prisma-next/target-postgres

npm i https://pkg.pr.new/@prisma-next/target-postgres@742

@prisma-next/target-sqlite

npm i https://pkg.pr.new/@prisma-next/target-sqlite@742

@prisma-next/adapter-postgres

npm i https://pkg.pr.new/@prisma-next/adapter-postgres@742

@prisma-next/adapter-sqlite

npm i https://pkg.pr.new/@prisma-next/adapter-sqlite@742

@prisma-next/driver-postgres

npm i https://pkg.pr.new/@prisma-next/driver-postgres@742

@prisma-next/driver-sqlite

npm i https://pkg.pr.new/@prisma-next/driver-sqlite@742

commit: 20e4a68

Adds Tag model, PostTag junction (composite PK post_tag_pkey), and rel.manyToMany() declarations on both Post.tags and Tag.posts. Re-emits contract.json / contract.d.ts; cardinality 'N:M' + through descriptor present in the generated artifacts. Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

Adds five ORM client modules exercising the Post↔Tag N:M relation: - get-post-tags: .include('tags', ...) — include read across junction - get-posts-by-tag-filter: .some()/.none()/.every() on N:M relation - connect-post-tags: update + t.connect([{id}]) callback mutator - disconnect-post-tags: update + t.disconnect([{id}]) callback mutator - create-post-with-tags: create + t.create([...]) nested mutation Seed extended with Tag rows + junction rows (typescript/orm/demo tags linked to First Post and Second Post). CLI commands registered in main.ts. Migration refs committed for offline db:init reproducibility. Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

Spec + plan amended for the follow-on scope (demos + authoring completeness): slice 4 SQLite demo examples (done, TML-2790), slice 5 PSL M:N authoring (TML-2794, framework gap — may promote to its own project), slice 6 PG demo examples + dual-mode reconciliation (TML-2795, blocked by slice 5). Slice specs + provisional dispatch plans for each. Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

…N examples The new main baseline (TML-2605) trips the no-bare-cast ratchet on the string->branded-id casts in the M:N example helpers (+10). Replace the bare `as PostId`/`as TagId` casts with castAs<T> to keep lint:casts at delta 0. Behaviour unchanged (casts are erased at runtime). Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

… models (TML-2807 rebase) The post_tag and tag models added by this branch were emitted before main emitted SqlModelStorage.namespaceId (TML-2807); re-emit so the demo contract matches a fresh emit. Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

…t<->Tag through The through descriptor now carries the junction's namespaceId; re-emit the demo contract so both M:N relations declare it. Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

…r upgrade instructions The check:upgrade-coverage gate requires every PR whose diff touches examples/ to also touch the in-flight user-skill instructions. The M:N demo additions need no user-side action (additive), so no new changes[] entry — the existing array stays; this records the incidental diff. Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

0.13.0 shipped without the M:N ORM-client examples, so the user-upgrade note belongs in a new 0.13→0.14 instructions directory, not the now-released 0.12→0.13 doc. The upgrade-coverage gate targets 0.13→0.14 after the release bump. Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

tensordreams requested a review from a team as a code owner June 5, 2026 15:04

tensordreams mentioned this pull request Jun 5, 2026

TML-2790: M:N SQLite demo examples + project plan expansion (slices 4–6) #697

Merged

tensordreams force-pushed the tml-2787-slice-3-write branch from 16dc690 to f3a7a5c Compare June 8, 2026 10:19

tensordreams force-pushed the tml-2790-mn-demo-examples branch from 1e62c8e to dbaf95a Compare June 8, 2026 10:19

tensordreams force-pushed the tml-2787-slice-3-write branch from f3a7a5c to b772b54 Compare June 8, 2026 11:19

tensordreams force-pushed the tml-2790-mn-demo-examples branch 2 times, most recently from e19ee4a to 074d298 Compare June 8, 2026 14:46

tensordreams force-pushed the tml-2787-slice-3-write branch from b772b54 to 0f9d0c2 Compare June 8, 2026 14:46

tensordreams force-pushed the tml-2790-mn-demo-examples branch from 074d298 to ce2608d Compare June 8, 2026 16:45

tensordreams force-pushed the tml-2787-slice-3-write branch from 0f9d0c2 to 2a360f4 Compare June 8, 2026 16:45

tensordreams force-pushed the tml-2790-mn-demo-examples branch from ce2608d to ac1c05d Compare June 9, 2026 11:07

tensordreams force-pushed the tml-2787-slice-3-write branch from 2a360f4 to 67fb93c Compare June 9, 2026 11:07

tensordreams force-pushed the tml-2790-mn-demo-examples branch from ac1c05d to a5f259c Compare June 9, 2026 16:37

tensordreams force-pushed the tml-2787-slice-3-write branch 2 times, most recently from 9feb292 to facaadf Compare June 9, 2026 16:39

tensordreams force-pushed the tml-2790-mn-demo-examples branch from a5f259c to 9829a58 Compare June 9, 2026 16:39

tensordreams force-pushed the tml-2787-slice-3-write branch from facaadf to 679770d Compare June 9, 2026 16:53

tensordreams force-pushed the tml-2790-mn-demo-examples branch from 9829a58 to 79ebfd0 Compare June 9, 2026 16:53

tensordreams added 9 commits June 9, 2026 19:17

chore(sqlite-demo): re-emit contract with junction namespaceId on Pos…

8db683b

…t<->Tag through The through descriptor now carries the junction's namespaceId; re-emit the demo contract so both M:N relations declare it. Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

chore(sqlite-demo): re-emit contract under code-unit canonicalization

e3dfdd9

Signed-off-by: Alexey Orlenko's AI Agent <robot@aqrln.net>

tensordreams force-pushed the tml-2787-slice-3-write branch from 679770d to 302e804 Compare June 9, 2026 17:21

tensordreams force-pushed the tml-2790-mn-demo-examples branch from 79ebfd0 to 20e4a68 Compare June 9, 2026 17:21

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

TML-2790: M:N SQLite demo examples + project plan expansion (slices 4–6)#742

TML-2790: M:N SQLite demo examples + project plan expansion (slices 4–6)#742
tensordreams wants to merge 9 commits into
tml-2787-slice-3-writefrom
tml-2790-mn-demo-examples

tensordreams commented Jun 5, 2026

Uh oh!

coderabbitai Bot commented Jun 5, 2026 •

edited

Loading

Review skipped

Uh oh!

github-actions Bot commented Jun 5, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Jun 5, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

tensordreams commented Jun 5, 2026

SQLite demo M:N examples (72ef8b793, 883309ecc)

Why only SQLite (and the plan expansion) (d711adfb6)

Scope / notes

Uh oh!

coderabbitai Bot commented Jun 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

github-actions Bot commented Jun 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

size-limit report 📦

Uh oh!

pkg-pr-new Bot commented Jun 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

SQLite demo M:N examples (`72ef8b793`, `883309ecc`)

Why only SQLite (and the plan expansion) (`d711adfb6`)

coderabbitai Bot commented Jun 5, 2026 •

edited

Loading

github-actions Bot commented Jun 5, 2026 •

edited

Loading

pkg-pr-new Bot commented Jun 5, 2026 •

edited

Loading