tml-2994: BetterAuth extension — managed contract space, contract-typed adapter, example

[SevInf]

Adds @prisma-next/extension-better-auth: a BetterAuth database adapter backed by Prisma Next's contract machinery. The auth schema ships as a managed contract space (the first extension space that ships table DDL — the framework owns db init/db update/verification for it), and BetterAuth's stringly-typed persistence interface is translated onto contract-typed ORM collections, so model/field mismatches are compile-time errors inside the package rather than runtime surprises in apps.

Closes TML-2994, TML-2995, TML-2996 (single-PR delivery of the BetterAuth Extension project; spec + review ledger under projects/extension-better-auth/).

Changes

• Contract space (/pack, /contract) — spaceId: 'better-auth' defines User/Session/Account/Verification (BetterAuth's canonical core schema: default table names in public, text ids, onDelete: Cascade FKs, User.email/Session.token uniques, User → Session[]/Account[] backrelations) from PSL source, with a baseline migration and refs/head.json. managed control — unlike the supabase space's external posture, prisma-next db init creates these tables and db update walks the space's migration graph. /contract ships extensionModel-branded handles so app contracts can declare cross-space FKs onto User (demonstrated by the example's Profile).
• Adapter (/adapter) — prismaNextAdapter(db) built on better-auth v1.5+ createAdapterFactory. The BetterAuth-model→collection map is as const satisfies Record<SpaceModelName, …> against the emitted contract.d.ts, so contract/adapter divergence fails pnpm typecheck in both directions; field/operator validation reads the shipped contract; unknown surfaces throw typed errors (UNKNOWN_MODEL/UNKNOWN_FIELD/UNSUPPORTED_OPERATOR/…). Native consumeOne rides Collection.delete()'s atomic find-first + narrowed DELETE … RETURNING (single-winner proven by an 8-way parallel race test); transaction rebinds a nested adapter onto the runtime's transaction scope (rollback proven); the join parameter translates onto Collection.include() with typed failure for unmapped targets (native path proven by collection spies — the fallback separate-queries path is never taken).
• Runtime descriptor (/runtime) — descriptor-only SqlRuntimeExtensionDescriptor (no facade), required for constructing a client over an aggregate contract that includes the space; discovered as a product gap when building the example (plain postgres({ contractJson: aggregate }) rejects pack-bearing contracts without it).
• Integration tests (test/integration) — BetterAuth's official conformance suite (@better-auth/test-utils/adapter) over PGlite: 156 passed / 0 failed, with 69 skips in four documented categories (project non-goals; 8 decode-dependent join tests pending TML-3015 — see below; one upstream test-utils bug that voids provided transaction implementations; one upstream test that leaks generateId state). Plus a managed-space lifecycle journey (emit → plan → init → update-no-op → verify, catalog-asserted) and a real betterAuth() sign-up → session e2e.
• Example (examples/better-auth) — full consumer story: three-step schema flow, sign-up → authenticated request over a minimal server, cross-space Profile → user FK (cascade observed live), and a self-testing suite that re-emits byte-identical artifacts, integrity-checks both spaces, and runs db init through the real CLI. Documents the two-views architecture (aggregate client + space view over one shared pool) that adapter consumers need because the emitted aggregate does not fold pack domain models.
• Docs — package README (two-views architecture first, plus the adapter's typed-seam contract); ADR 212 amendment legitimizing the src/contract/ PSL-authored layout and the managed table-DDL space variant; extension-precedent references updated (docs/architecture docs/subsystems/6., .agents/rules/contract-space-package-layout.mdc).

Why

• Managed space over app-owned tables: BetterAuth's ecosystem expects the ORM to own the auth schema's lifecycle. Shipping it as a managed contract space keeps contract emit → migration plan → db init as the only setup path (no manual SQL anywhere, including tests and the example) and proves extension spaces can carry table DDL through the existing computeExtensionSpaceApplyPath machinery — no framework changes were needed.
• Typed seam over passthrough: the adapter narrows BetterAuth's strings at exactly one contract-validated boundary and drives only the real collection API, so values always cross contract codecs (Date↔timestamptz, boolean↔bool round-trips are behaviourally tested) and the compile-time exhaustive map makes schema drift unshippable.
• Conformance suite as the bar: BetterAuth's own testAdapter suites (including join coverage with native joins enabled) are the acceptance test, not hand-rolled approximations. The run surfaced real product gaps now fixed here (cascade semantics, /runtime descriptor, User backrelations) — and one genuine ORM bug, split out as TML-3015 / PR tml-3015: decode to-many include() payloads through the codec boundary #966 (to-many include() payloads bypass the codec decode boundary); the 8 conformance tests blocked on it are disabled with per-test reasons and re-enable when it merges.
• Follow-up tickets filed rather than scope-crept: TML-3016 (detached-receiver codec factory bug), TML-3017 (@prisma/dev close-hang under churn), TML-3021 (migration serializer pretty/minified mismatch), TML-3020 (duplicate ADR numbers).

The projects/extension-better-auth/ folder (spec, plan, dispatch briefs, review ledger, QA script + run report) is transient per projects/README.md and is deleted at project close-out.

Summary by CodeRabbit

• New Features
  • Added a Better Auth extension with managed authentication tables, migrations, typed contract handles, runtime support, and a Prisma Next adapter.
  • Expanded adapter capabilities with contract-typed CRUD, filtering/sorting, joins, transactions, shared connection pool support, and structured validation errors.
  • Added an end-to-end Better Auth example with email/password auth, profiles, cross-space relations, and authenticated API access.
  • Allowed contract spaces to use grouped layouts (for PSL-authored variants) and to ship framework-managed table DDL.
• Documentation
  • Added detailed architecture and extension/example walkthrough documentation for the Better Auth extension.
• Tests
  • Added comprehensive end-to-end, integration, lifecycle, contract, migration, and type-level coverage.

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds a managed BetterAuth contract-space extension with Postgres migrations, a contract-typed adapter, shared-pool integration, branded cross-space handles, an end-to-end example, and adapter, lifecycle, and authentication tests.

Changes

BetterAuth extension and contract space

Layer / File(s)	Summary
Contract-space architecture and repository wiring .agents/rules/..., architecture.config.json, biome.jsonc, docs/architecture docs/...	Documents grouped PSL contract layouts, managed table DDL, extension package architecture, and migration reference-file handling.
BetterAuth contract space and pack artifacts packages/3-extensions/better-auth/...	Adds the BetterAuth schema, generated contract artifacts, branded handles, baseline migration, pack/runtime descriptors, exports, and package tooling.
Contract-typed BetterAuth adapter packages/3-extensions/better-auth/src/adapter/...	Adds model and relation validation, typed errors, where/order translation, CRUD operations, joins, transactions, atomic consumption, and shared-pool construction.
Example application and cross-space database views examples/better-auth/...	Adds the Profile contract, BetterAuth integration, shared pool/database wiring, HTTP routes, migrations, documentation, and generated contract artifacts.
Adapter and lifecycle validation packages/3-extensions/better-auth/test/..., test/integration/...	Adds adapter behavior, type, descriptor, runtime, conformance, managed-space lifecycle, and authentication flow coverage.

Estimated code review effort: 5 (Critical) | ~120 minutes

Possibly related PRs

• prisma/prisma-next#25 — Adds SQL-lane/Postgres lowering operator support used by the BetterAuth adapter’s comparison translation.

Suggested reviewers: jkomyno

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 36.96% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main additions: a BetterAuth extension with managed contract space, typed adapter, and example.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch tml-2994-better-auth-extension

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[pkg-pr-new]

Open in StackBlitz

@prisma-next/extension-author-tools

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

@prisma-next/mongo-runtime

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

@prisma-next/family-mongo

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

@prisma-next/sql-runtime

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

@prisma-next/family-sql

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

@prisma-next/extension-arktype-json

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

@prisma-next/extension-better-auth

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/extension-better-auth@968

@prisma-next/middleware-cache

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

@prisma-next/mongo

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

@prisma-next/extension-paradedb

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

@prisma-next/extension-pgvector

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

@prisma-next/extension-postgis

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

@prisma-next/postgres

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

@prisma-next/sql-orm-client

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

@prisma-next/sqlite

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

@prisma-next/extension-supabase

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

@prisma-next/target-mongo

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

@prisma-next/adapter-mongo

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

@prisma-next/driver-mongo

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

@prisma-next/contract

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

@prisma-next/utils

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

@prisma-next/config

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

@prisma-next/errors

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

@prisma-next/framework-components

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

@prisma-next/operations

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

@prisma-next/ts-render

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

@prisma-next/contract-authoring

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

@prisma-next/ids

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

@prisma-next/psl-parser

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

@prisma-next/psl-printer

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

@prisma-next/cli

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

@prisma-next/cli-telemetry

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

@prisma-next/config-loader

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

@prisma-next/emitter

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

@prisma-next/language-server

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/language-server@968

@prisma-next/migration-tools

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

prisma-next

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

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

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

@prisma-next/mongo-codec

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

@prisma-next/mongo-contract

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

@prisma-next/mongo-value

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

@prisma-next/mongo-contract-psl

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

@prisma-next/mongo-contract-ts

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

@prisma-next/mongo-emitter

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

@prisma-next/mongo-schema-ir

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

@prisma-next/mongo-query-ast

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

@prisma-next/mongo-orm

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

@prisma-next/mongo-query-builder

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

@prisma-next/mongo-lowering

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

@prisma-next/mongo-wire

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

@prisma-next/sql-contract

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

@prisma-next/sql-errors

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

@prisma-next/sql-operations

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

@prisma-next/sql-schema-ir

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

@prisma-next/sql-contract-psl

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

@prisma-next/sql-contract-ts

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

@prisma-next/sql-contract-emitter

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

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

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

@prisma-next/sql-relational-core

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

@prisma-next/sql-builder

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

@prisma-next/target-postgres

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

@prisma-next/target-sqlite

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

@prisma-next/adapter-postgres

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

@prisma-next/adapter-sqlite

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

@prisma-next/driver-postgres

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

@prisma-next/driver-sqlite

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

commit: 78de265

[github-actions]

size-limit report 📦

Path	Size
postgres / no-emit	156.35 KB (0%)
postgres / emit	131.37 KB (0%)
mongo / no-emit	98.71 KB (0%)
mongo / emit	89.43 KB (0%)
cf-worker / no-emit	182.94 KB (0%)
cf-worker / emit	155.41 KB (0%)

[coderabbitai]

Actionable comments posted: 8

🧹 Nitpick comments (4)

packages/3-extensions/better-auth/test/contract-handles.test.ts (2)

70-83: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Brand assertions via expectTypeOf may pass even if branding is lost.

toEqualTypeOf<TargetFieldRef<...>>() on branded refs can produce false positives because expectTypeOf can erase brand information. Consider an identity-check (Equal<A,B>) pattern to preserve the brand in the comparison.

Based on learnings, for branded types prefer a type-level identity check over expectTypeOf since the latter can erase brand info and produce false positives.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/3-extensions/better-auth/test/contract-handles.test.ts` around lines
70 - 83, Replace the branded-type assertions in the User.refs.id,
Session.refs.id, Account.refs.id, and Verification.refs.id tests with an
identity-check pattern such as Equal<A, B>, ensuring the comparison preserves
the better-auth brand. Keep the existing runtime spaceId, namespaceId, and
tableName assertions unchanged.

Source: Learnings

---

28-28: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Cross-package import reaches into another package's test source via a relative path.

../../../2-sql/1-core/contract/test/test-support reaches into the 2-sql/1-core/contract package's internals from this extension package. Prefer importing createTestSqlNamespace through that package's published export surface rather than a relative path into its test/ tree.

Based on learnings, cross-package imports should use the other package's published package name/export entrypoints rather than relative paths like ../../../<other-package>/....

#!/bin/bash
# Find the source of createTestSqlNamespace and whether it is exported via a package entrypoint.
rg -nP 'createTestSqlNamespace' -g '!**/contract-handles.test.ts' -C2
fd -t f 'package.json' packages/2-sql/1-core/contract --exec sh -c 'echo "== {} =="; jq -r ".name, (.exports|keys[]?)" {}'

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/3-extensions/better-auth/test/contract-handles.test.ts` at line 28,
Replace the relative import of createTestSqlNamespace in
contract-handles.test.ts with an import from the 2-sql/1-core/contract package’s
published name or export entrypoint. Use the package’s existing export surface
for this symbol and do not reach into its contract/test directory.

packages/3-extensions/better-auth/src/adapter/model-map.ts (1)

102-116: 🎯 Functional Correctness | 🔵 Trivial | 💤 Low value

Relation resolution only reads the first local/target field, silently dropping composite keys.

localField/targetField take only [0] of localFields/targetFields with an empty-string fallback. For this space's single-column FKs (userId→id) this is fine, but a future composite-key relation would silently resolve against a partial (or empty-string) key rather than failing.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/3-extensions/better-auth/src/adapter/model-map.ts` around lines 102
- 116, The relationsBySpaceModel mapping currently reduces localFields and
targetFields to their first entries, losing composite-key relations. Update the
relation construction to validate that each relation has exactly one local and
target field, preserving those values for single-column foreign keys and
explicitly rejecting or otherwise handling composite or empty field arrays
instead of using partial or empty-string keys.

examples/better-auth/migrations/app/20260713T0837_init/migration.ts (1)

24-35: 🚀 Performance & Scalability | 🔵 Trivial | ⚡ Quick win

Redundant index on userId.

Adding the UNIQUE constraint on userId (Lines 24-29) already creates an implicit unique b-tree index on that column in Postgres. The subsequent createIndex on the same single column (Lines 30-35) is redundant — it adds storage and write-maintenance cost on every insert/update without any additional query-planning benefit, since the unique index already covers equality/range lookups on userId.

♻️ Proposed fix: drop the redundant index

       this.addUnique({
         schema: 'public',
         table: 'profile',
         constraint: 'profile_userId_key',
         columns: ['userId'],
       }),
-      this.createIndex({
-        schema: 'public',
-        table: 'profile',
-        index: 'profile_userId_idx',
-        columns: ['userId'],
-      }),
       this.addForeignKey({

If this scaffold intentionally pairs FK columns with an explicit index regardless of an existing covering unique constraint (e.g. so the index survives if the unique constraint is later dropped), that convention would be worth confirming against other migrations in the repo.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@examples/better-auth/migrations/app/20260713T0837_init/migration.ts` around
lines 24 - 35, Remove the redundant createIndex operation for profile.userId
from the migration, while preserving the addUnique constraint
profile_userId_key. Do not add a replacement index unless the repository’s
migration convention explicitly requires one.

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@architecture.config.json`:
- Around line 519-542: Add architecture entries for the missing better-auth
adapter and runtime surfaces: register src/adapter/**, src/exports/adapter.ts,
src/runtime/**, and src/exports/runtime.ts with the same extensions, adapters,
and shared classifications used by the existing pack and contract entries.

In `@packages/3-extensions/better-auth/package.json`:
- Around line 58-72: Update the "./pack" entry in the package exports map to use
explicit "types" and "import" conditions, pointing to the appropriate
declaration and runtime files, matching the structure of "./contract",
"./adapter", and "./runtime".

In `@packages/3-extensions/better-auth/src/adapter/index.ts`:
- Around line 212-216: Update updateMany to pass its update payload through the
same asRecord guard used by update before calling assertKnownFields, preserving
the typed PrismaNextAdapterError with INVALID_OPERATOR_VALUE for non-object
payloads. Keep the existing model resolution, field validation, and scoped
updateCount flow unchanged.
- Around line 112-131: Update the singular operation paths for update, delete,
and consumeOne to return early when where is undefined or empty, preventing
execution against the unscoped collection. Keep scopeToWhere’s existing
raw-collection behavior and the bulk method behavior unchanged, and anchor the
changes to the singular operation implementations near scopeToWhere.

In `@packages/3-extensions/better-auth/src/adapter/model-map.ts`:
- Around line 1-4: Validate the imported contractJson at runtime before
fieldsBySpaceModel and relationsBySpaceModel consume it. Import the established
validateContract helper and pass contractJson through
validateContract<Contract>(...) using the fully typed Contract, then use the
validated result for both model/field and relation resolution while preserving
the existing SpaceModelName typing.

In `@packages/3-extensions/better-auth/src/contract/handles.ts`:
- Around line 21-97: Update the field definitions in User, Session, and Account
to mark every contract-nullable column as optional using the existing
nullability marker, including User.image, Session.ipAddress and userAgent, and
the nullable Account fields. Leave required identifiers and timestamps
unchanged, and ensure the handles match the nullability represented in
contract.json.

In `@packages/3-extensions/better-auth/test/adapter-crud.test.ts`:
- Around line 1-2: Update the file-header descriptions in
packages/3-extensions/better-auth/test/adapter-crud.test.ts lines 1-2 and
packages/3-extensions/better-auth/test/adapter-advanced.test.ts lines 1-2 to
identify the tests as using the PostgreSQL dev server rather than PGlite; no
other test behavior changes are needed.

In `@test/integration/test/extension-better-auth.harness.helpers.ts`:
- Around line 39-112: Update setupBetterAuthTestApp to guard all setup work
after database and tempRoot creation with cleanup on failure, ensuring
database.close() is attempted and tempRoot is removed before rethrowing the
original error. In the returned teardown method, make the bounded database-close
wait non-rejecting so rmSync(tempRoot, ...) always executes even when
database.close() rejects, while preserving the existing timeout behavior.

---

Nitpick comments:
In `@examples/better-auth/migrations/app/20260713T0837_init/migration.ts`:
- Around line 24-35: Remove the redundant createIndex operation for
profile.userId from the migration, while preserving the addUnique constraint
profile_userId_key. Do not add a replacement index unless the repository’s
migration convention explicitly requires one.

In `@packages/3-extensions/better-auth/src/adapter/model-map.ts`:
- Around line 102-116: The relationsBySpaceModel mapping currently reduces
localFields and targetFields to their first entries, losing composite-key
relations. Update the relation construction to validate that each relation has
exactly one local and target field, preserving those values for single-column
foreign keys and explicitly rejecting or otherwise handling composite or empty
field arrays instead of using partial or empty-string keys.

In `@packages/3-extensions/better-auth/test/contract-handles.test.ts`:
- Around line 70-83: Replace the branded-type assertions in the User.refs.id,
Session.refs.id, Account.refs.id, and Verification.refs.id tests with an
identity-check pattern such as Equal<A, B>, ensuring the comparison preserves
the better-auth brand. Keep the existing runtime spaceId, namespaceId, and
tableName assertions unchanged.
- Line 28: Replace the relative import of createTestSqlNamespace in
contract-handles.test.ts with an import from the 2-sql/1-core/contract package’s
published name or export entrypoint. Use the package’s existing export surface
for this symbol and do not reach into its contract/test directory.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 9ac67805-bbc2-48e4-bdc5-3a2267614c1d

📥 Commits

Reviewing files that changed from the base of the PR and between 7f47601 and e802411.

⛔ Files ignored due to path filters (24)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
• projects/extension-better-auth/plan.md is excluded by !projects/**
• projects/extension-better-auth/qa/manual-qa.md is excluded by !projects/**
• projects/extension-better-auth/qa/qa-run-2026-07-13.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/01-scaffold-and-contract-space.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/02-managed-space-lifecycle-test.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/03-branded-contract-handles-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/03-branded-contract-handles.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/04-adapter-core-crud-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/04-adapter-core-crud.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/05-adapter-consume-transaction-join.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/06-conformance-and-e2e-integration-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/06-conformance-and-e2e-integration-r3.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/06-conformance-and-e2e-integration.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/07-example-app-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/07-example-app-r3.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/07-example-app.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/08-docs-and-close-out-prep-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/08-docs-and-close-out-prep-r3.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/08-docs-and-close-out-prep.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/plan.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/spec.md is excluded by !projects/**
• projects/extension-better-auth/spec.md is excluded by !projects/**
• projects/extension-better-auth/trace.jsonl is excluded by !projects/**

📒 Files selected for processing (76)

• .agents/rules/contract-space-package-layout.mdc
• architecture.config.json
• biome.jsonc
• docs/architecture docs/adrs/ADR 212 - Contract spaces.md
• docs/architecture docs/adrs/ADR 231 - Stringly-typed third-party interfaces adapt over contract-typed collections.md
• docs/architecture docs/subsystems/6. Ecosystem Extensions & Packs.md
• examples/better-auth/.gitignore
• examples/better-auth/README.md
• examples/better-auth/biome.jsonc
• examples/better-auth/migrations/app/20260713T0837_init/end-contract.d.ts
• examples/better-auth/migrations/app/20260713T0837_init/end-contract.json
• examples/better-auth/migrations/app/20260713T0837_init/migration.json
• examples/better-auth/migrations/app/20260713T0837_init/migration.ts
• examples/better-auth/migrations/app/20260713T0837_init/ops.json
• examples/better-auth/migrations/better-auth/20260713T0717_create_auth_tables/migration.json
• examples/better-auth/migrations/better-auth/20260713T0717_create_auth_tables/ops.json
• examples/better-auth/migrations/better-auth/contract.d.ts
• examples/better-auth/migrations/better-auth/contract.json
• examples/better-auth/migrations/better-auth/refs/head.json
• examples/better-auth/package.json
• examples/better-auth/prisma-next.config.ts
• examples/better-auth/src/auth.ts
• examples/better-auth/src/main.ts
• examples/better-auth/src/prisma/contract.d.ts
• examples/better-auth/src/prisma/contract.json
• examples/better-auth/src/prisma/contract.ts
• examples/better-auth/src/prisma/db.ts
• examples/better-auth/src/server.ts
• examples/better-auth/test/example.integration.test.ts
• examples/better-auth/tsconfig.json
• examples/better-auth/vitest.config.ts
• packages/3-extensions/better-auth/README.md
• packages/3-extensions/better-auth/biome.jsonc
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/end-contract.d.ts
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/end-contract.json
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/migration.json
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/migration.ts
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/ops.json
• packages/3-extensions/better-auth/migrations/refs/head.json
• packages/3-extensions/better-auth/package.json
• packages/3-extensions/better-auth/prisma-next.config.ts
• packages/3-extensions/better-auth/src/adapter/db-surface.ts
• packages/3-extensions/better-auth/src/adapter/errors.ts
• packages/3-extensions/better-auth/src/adapter/index.ts
• packages/3-extensions/better-auth/src/adapter/join.ts
• packages/3-extensions/better-auth/src/adapter/model-map.ts
• packages/3-extensions/better-auth/src/adapter/where.ts
• packages/3-extensions/better-auth/src/contract/contract.d.ts
• packages/3-extensions/better-auth/src/contract/contract.json
• packages/3-extensions/better-auth/src/contract/contract.prisma
• packages/3-extensions/better-auth/src/contract/handles.ts
• packages/3-extensions/better-auth/src/exports/adapter.ts
• packages/3-extensions/better-auth/src/exports/contract.ts
• packages/3-extensions/better-auth/src/exports/pack.ts
• packages/3-extensions/better-auth/src/exports/runtime.ts
• packages/3-extensions/better-auth/src/pack/index.ts
• packages/3-extensions/better-auth/src/runtime/descriptor.ts
• packages/3-extensions/better-auth/test/adapter-advanced.test.ts
• packages/3-extensions/better-auth/test/adapter-crud.test.ts
• packages/3-extensions/better-auth/test/adapter-errors.test.ts
• packages/3-extensions/better-auth/test/adapter-types.test-d.ts
• packages/3-extensions/better-auth/test/contract-handles.test.ts
• packages/3-extensions/better-auth/test/contract-types.test-d.ts
• packages/3-extensions/better-auth/test/descriptor.test.ts
• packages/3-extensions/better-auth/test/runtime-descriptor.test.ts
• packages/3-extensions/better-auth/tsconfig.json
• packages/3-extensions/better-auth/tsconfig.prod.json
• packages/3-extensions/better-auth/tsdown.config.ts
• packages/3-extensions/better-auth/vitest.config.ts
• test/integration/package.json
• test/integration/test/extension-better-auth.betterauth-e2e.test.ts
• test/integration/test/extension-better-auth.conformance.e2e.test.ts
• test/integration/test/extension-better-auth.harness.helpers.ts
• test/integration/test/extension-better-auth.lifecycle.e2e.test.ts
• test/integration/test/fixtures/cli/cli-e2e-test-app/fixtures/better-auth-lifecycle/contract.ts
• test/integration/test/fixtures/cli/cli-e2e-test-app/fixtures/better-auth-lifecycle/prisma-next.config.with-db.ts

[coderabbitai]

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Confirm createDevDatabase provisions a real Postgres dev server (not PGlite).
rg -nP 'export (async )?function createDevDatabase|pglite|prisma/dev|`@electric-sql/pglite`' test/utils -C2

Repository: prisma/prisma-next

Length of output: 2646

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf '\n-- adapter-crud.test.ts --\n'
sed -n '1,12p' packages/3-extensions/better-auth/test/adapter-crud.test.ts

printf '\n-- adapter-advanced.test.ts --\n'
sed -n '1,12p' packages/3-extensions/better-auth/test/adapter-advanced.test.ts

printf '\n-- createDevDatabase implementation --\n'
sed -n '1,120p' test/utils/src/exports/index.ts

Repository: prisma/prisma-next

Length of output: 4766

---

File headers should say PostgreSQL dev server, not PGlite. Both suites use createDevDatabase() from @prisma-next/test-utils, which starts @prisma/dev’s Postgres dev server.

• packages/3-extensions/better-auth/test/adapter-crud.test.ts#L1-L2
• packages/3-extensions/better-auth/test/adapter-advanced.test.ts#L1-L2

📍 Affects 2 files

• packages/3-extensions/better-auth/test/adapter-crud.test.ts#L1-L2 (this comment)
• packages/3-extensions/better-auth/test/adapter-advanced.test.ts#L1-L2

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/3-extensions/better-auth/test/adapter-crud.test.ts` around lines 1 -
2, Update the file-header descriptions in
packages/3-extensions/better-auth/test/adapter-crud.test.ts lines 1-2 and
packages/3-extensions/better-auth/test/adapter-advanced.test.ts lines 1-2 to
identify the tests as using the PostgreSQL dev server rather than PGlite; no
other test behavior changes are needed.

Source: Learnings

[SevInf]

Use PSL

[SevInf]

Shouldn't AuthDb already be a subset of Db? Why do we need a separate one? We shouldn't need a separate insteance of DB for that

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@examples/better-auth/test/example.integration.test.ts`:
- Around line 118-128: Update the FK query in the integration test to verify the
documented public.profile(userId) → public.user(id) relationship, not merely a
cascade to a relation named user. Join pg_namespace and pg_attribute for both
tables, filter the public schema and the profile/user column names, and retain
the on_delete assertion.
- Around line 186-194: Make the test named “cascades profile deletion when the
user is deleted” self-contained by creating the Ada user and profile records
within the test or an existing shared setup helper before querying Profile.
Preserve the current database-level DELETE and cascade assertions, and ensure
the setup does not depend on the preceding test.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: cc0a0f92-0034-48e2-9e3f-d01cf092b228

📥 Commits

Reviewing files that changed from the base of the PR and between e6c506d and 78de265.

⛔ Files ignored due to path filters (24)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
• projects/extension-better-auth/plan.md is excluded by !projects/**
• projects/extension-better-auth/qa/manual-qa.md is excluded by !projects/**
• projects/extension-better-auth/qa/qa-run-2026-07-13.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/01-scaffold-and-contract-space.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/02-managed-space-lifecycle-test.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/03-branded-contract-handles-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/03-branded-contract-handles.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/04-adapter-core-crud-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/04-adapter-core-crud.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/05-adapter-consume-transaction-join.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/06-conformance-and-e2e-integration-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/06-conformance-and-e2e-integration-r3.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/06-conformance-and-e2e-integration.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/07-example-app-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/07-example-app-r3.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/07-example-app.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/08-docs-and-close-out-prep-r2.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/08-docs-and-close-out-prep-r3.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/dispatches/08-docs-and-close-out-prep.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/plan.md is excluded by !projects/**
• projects/extension-better-auth/slices/better-auth-extension/spec.md is excluded by !projects/**
• projects/extension-better-auth/spec.md is excluded by !projects/**
• projects/extension-better-auth/trace.jsonl is excluded by !projects/**

📒 Files selected for processing (69)

• .agents/rules/contract-space-package-layout.mdc
• architecture.config.json
• biome.jsonc
• docs/architecture docs/adrs/ADR 212 - Contract spaces.md
• docs/architecture docs/subsystems/6. Ecosystem Extensions & Packs.md
• examples/better-auth/.gitignore
• examples/better-auth/README.md
• examples/better-auth/biome.jsonc
• examples/better-auth/migrations/app/20260713T0837_init/end-contract.d.ts
• examples/better-auth/migrations/app/20260713T0837_init/end-contract.json
• examples/better-auth/migrations/app/20260713T0837_init/migration.json
• examples/better-auth/migrations/app/20260713T0837_init/migration.ts
• examples/better-auth/migrations/app/20260713T0837_init/ops.json
• examples/better-auth/migrations/better-auth/20260713T0717_create_auth_tables/migration.json
• examples/better-auth/migrations/better-auth/20260713T0717_create_auth_tables/ops.json
• examples/better-auth/migrations/better-auth/contract.d.ts
• examples/better-auth/migrations/better-auth/contract.json
• examples/better-auth/migrations/better-auth/refs/head.json
• examples/better-auth/package.json
• examples/better-auth/prisma-next.config.ts
• examples/better-auth/src/auth.ts
• examples/better-auth/src/main.ts
• examples/better-auth/src/prisma/contract.d.ts
• examples/better-auth/src/prisma/contract.json
• examples/better-auth/src/prisma/contract.prisma
• examples/better-auth/src/prisma/db.ts
• examples/better-auth/src/server.ts
• examples/better-auth/test/example.integration.test.ts
• examples/better-auth/tsconfig.json
• examples/better-auth/vitest.config.ts
• packages/3-extensions/better-auth/README.md
• packages/3-extensions/better-auth/biome.jsonc
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/end-contract.d.ts
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/end-contract.json
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/migration.json
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/migration.ts
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/ops.json
• packages/3-extensions/better-auth/migrations/refs/head.json
• packages/3-extensions/better-auth/package.json
• packages/3-extensions/better-auth/prisma-next.config.ts
• packages/3-extensions/better-auth/src/adapter/db-surface.ts
• packages/3-extensions/better-auth/src/adapter/errors.ts
• packages/3-extensions/better-auth/src/adapter/index.ts
• packages/3-extensions/better-auth/src/adapter/join.ts
• packages/3-extensions/better-auth/src/adapter/model-map.ts
• packages/3-extensions/better-auth/src/adapter/where.ts
• packages/3-extensions/better-auth/src/contract/contract.d.ts
• packages/3-extensions/better-auth/src/contract/contract.json
• packages/3-extensions/better-auth/src/contract/contract.prisma
• packages/3-extensions/better-auth/src/contract/handles.ts
• packages/3-extensions/better-auth/src/exports/adapter.ts
• packages/3-extensions/better-auth/src/exports/contract.ts
• packages/3-extensions/better-auth/src/exports/pack.ts
• packages/3-extensions/better-auth/src/exports/runtime.ts
• packages/3-extensions/better-auth/src/pack/index.ts
• packages/3-extensions/better-auth/src/runtime/descriptor.ts
• packages/3-extensions/better-auth/test/adapter-advanced.test.ts
• packages/3-extensions/better-auth/test/adapter-crud.test.ts
• packages/3-extensions/better-auth/test/adapter-errors.test.ts
• packages/3-extensions/better-auth/test/adapter-pool-form.test.ts
• packages/3-extensions/better-auth/test/adapter-types.test-d.ts
• packages/3-extensions/better-auth/test/contract-handles.test.ts
• packages/3-extensions/better-auth/test/contract-types.test-d.ts
• packages/3-extensions/better-auth/test/descriptor.test.ts
• packages/3-extensions/better-auth/test/runtime-descriptor.test.ts
• packages/3-extensions/better-auth/tsconfig.json
• packages/3-extensions/better-auth/tsconfig.prod.json
• packages/3-extensions/better-auth/tsdown.config.ts
• packages/3-extensions/better-auth/vitest.config.ts

🚧 Files skipped from review as they are similar to previous changes (63)

• packages/3-extensions/better-auth/biome.jsonc
• packages/3-extensions/better-auth/migrations/refs/head.json
• examples/better-auth/biome.jsonc
• examples/better-auth/migrations/better-auth/contract.d.ts
• examples/better-auth/.gitignore
• examples/better-auth/prisma-next.config.ts
• packages/3-extensions/better-auth/src/exports/contract.ts
• packages/3-extensions/better-auth/tsdown.config.ts
• examples/better-auth/src/prisma/contract.prisma
• packages/3-extensions/better-auth/tsconfig.prod.json
• examples/better-auth/migrations/better-auth/20260713T0717_create_auth_tables/migration.json
• examples/better-auth/migrations/app/20260713T0837_init/end-contract.json
• packages/3-extensions/better-auth/tsconfig.json
• examples/better-auth/migrations/better-auth/contract.json
• examples/better-auth/vitest.config.ts
• packages/3-extensions/better-auth/src/runtime/descriptor.ts
• biome.jsonc
• examples/better-auth/tsconfig.json
• packages/3-extensions/better-auth/src/exports/pack.ts
• packages/3-extensions/better-auth/vitest.config.ts
• examples/better-auth/migrations/better-auth/20260713T0717_create_auth_tables/ops.json
• packages/3-extensions/better-auth/README.md
• .agents/rules/contract-space-package-layout.mdc
• packages/3-extensions/better-auth/src/exports/runtime.ts
• examples/better-auth/src/auth.ts
• examples/better-auth/package.json
• packages/3-extensions/better-auth/src/contract/contract.prisma
• packages/3-extensions/better-auth/src/exports/adapter.ts
• examples/better-auth/migrations/app/20260713T0837_init/migration.json
• packages/3-extensions/better-auth/package.json
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/ops.json
• examples/better-auth/src/server.ts
• architecture.config.json
• packages/3-extensions/better-auth/src/pack/index.ts
• packages/3-extensions/better-auth/test/contract-handles.test.ts
• packages/3-extensions/better-auth/test/adapter-errors.test.ts
• packages/3-extensions/better-auth/src/adapter/errors.ts
• examples/better-auth/migrations/app/20260713T0837_init/migration.ts
• packages/3-extensions/better-auth/test/contract-types.test-d.ts
• packages/3-extensions/better-auth/src/contract/handles.ts
• examples/better-auth/migrations/app/20260713T0837_init/ops.json
• packages/3-extensions/better-auth/src/contract/contract.json
• examples/better-auth/src/main.ts
• docs/architecture docs/adrs/ADR 212 - Contract spaces.md
• packages/3-extensions/better-auth/src/adapter/where.ts
• examples/better-auth/migrations/app/20260713T0837_init/end-contract.d.ts
• packages/3-extensions/better-auth/test/runtime-descriptor.test.ts
• packages/3-extensions/better-auth/src/adapter/db-surface.ts
• packages/3-extensions/better-auth/prisma-next.config.ts
• examples/better-auth/src/prisma/db.ts
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/migration.ts
• packages/3-extensions/better-auth/src/adapter/join.ts
• packages/3-extensions/better-auth/test/descriptor.test.ts
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/migration.json
• packages/3-extensions/better-auth/src/contract/contract.d.ts
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/end-contract.json
• packages/3-extensions/better-auth/src/adapter/index.ts
• packages/3-extensions/better-auth/test/adapter-types.test-d.ts
• packages/3-extensions/better-auth/src/adapter/model-map.ts
• examples/better-auth/src/prisma/contract.d.ts
• packages/3-extensions/better-auth/migrations/20260713T0717_create_auth_tables/end-contract.d.ts
• docs/architecture docs/subsystems/6. Ecosystem Extensions & Packs.md
• examples/better-auth/README.md

[coderabbitai]

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Verify the schema and referenced column in the FK assertion.

This query can pass for any cascading profile FK targeting a relation named user; it does not prove the documented "public"."profile"(userId) → "public"."user"(id) contract. Include namespace and attribute joins in the query.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@examples/better-auth/test/example.integration.test.ts` around lines 118 -
128, Update the FK query in the integration test to verify the documented
public.profile(userId) → public.user(id) relationship, not merely a cascade to a
relation named user. Join pg_namespace and pg_attribute for both tables, filter
the public schema and the profile/user column names, and retain the on_delete
assertion.

[coderabbitai]

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Make the cascade test self-contained.

This test relies on the preceding test to create ada@example.com and profile-ada. Running it alone—or after the preceding test fails—does not exercise the cascade. Seed its user and profile within this test or a shared setup helper.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@examples/better-auth/test/example.integration.test.ts` around lines 186 -
194, Make the test named “cascades profile deletion when the user is deleted”
self-contained by creating the Ada user and profile records within the test or
an existing shared setup helper before querying Profile. Preserve the current
database-level DELETE and cascade assertions, and ensure the setup does not
depend on the preceding test.